{"id":15717014,"url":"https://github.com/pqrs-org/karabiner-elements","last_synced_at":"2026-01-31T02:18:51.420Z","repository":{"id":37602472,"uuid":"63037806","full_name":"pqrs-org/Karabiner-Elements","owner":"pqrs-org","description":"Karabiner-Elements is a powerful tool for customizing keyboards on macOS","archived":false,"fork":false,"pushed_at":"2025-05-06T09:21:22.000Z","size":110395,"stargazers_count":19923,"open_issues_count":1211,"forks_count":858,"subscribers_count":205,"default_branch":"main","last_synced_at":"2025-05-06T17:14:52.442Z","etag":null,"topics":["keyboard","macos"],"latest_commit_sha":null,"homepage":"https://karabiner-elements.pqrs.org/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pqrs-org.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["tekezo"],"custom":["https://karabiner-elements.pqrs.org/docs/pricing/"]}},"created_at":"2016-07-11T04:57:55.000Z","updated_at":"2025-05-06T16:40:55.000Z","dependencies_parsed_at":"2024-04-19T00:35:22.312Z","dependency_job_id":"9dd0658e-5a70-4a9a-9e75-d9e913fd47d4","html_url":"https://github.com/pqrs-org/Karabiner-Elements","commit_stats":null,"previous_names":["tekezo/karabiner-elements"],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pqrs-org%2FKarabiner-Elements","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pqrs-org%2FKarabiner-Elements/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pqrs-org%2FKarabiner-Elements/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pqrs-org%2FKarabiner-Elements/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pqrs-org","download_url":"https://codeload.github.com/pqrs-org/Karabiner-Elements/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000824,"owners_count":21997441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["keyboard","macos"],"created_at":"2024-10-03T21:48:28.564Z","updated_at":"2026-01-31T02:18:51.412Z","avatar_url":"https://github.com/pqrs-org.png","language":"C++","funding_links":["https://github.com/sponsors/tekezo","https://karabiner-elements.pqrs.org/docs/pricing/"],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/pqrs-org/Karabiner-Elements/workflows/Karabiner-Elements%20CI/badge.svg)](https://github.com/pqrs-org/Karabiner-Elements/actions)\n[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://github.com/pqrs-org/Karabiner-Elements/blob/main/LICENSE.md)\n\n# Karabiner-Elements\n\nKarabiner-Elements is a powerful key remapper for macOS.\n\n## Download\n\nYou can download Karabiner-Elements from the [official site](https://karabiner-elements.pqrs.org/).\n\nAlternatively, for users of [homebrew](https://brew.sh/), Karabiner-Elements may be installed with `brew install --cask karabiner-elements`.\n\n### Old releases\n\nYou can download previous versions of Karabiner-Elements from [Release notes](https://karabiner-elements.pqrs.org/docs/releasenotes/).\n\n## Supported systems\n\n- macOS 26 Tahoe\n    - Both Intel-based Macs and Apple Silicon Macs\n- macOS 15 Sequoia\n    - Both Intel-based Macs and Apple Silicon Macs\n- macOS 14 Sonoma\n    - Both Intel-based Macs and Apple Silicon Macs\n- macOS 13 Ventura\n    - Both Intel-based Macs and Apple Silicon Macs\n\n## Usage\n\nDocumentation can be found here: \u003chttps://karabiner-elements.pqrs.org/docs/\u003e\n\n## Donations\n\nIf you would like to contribute financially to the development of Karabiner-Elements, donations can be made via \u003chttps://karabiner-elements.pqrs.org/docs/pricing/\u003e\n\n---\n\n## For developers\n\n### How to build\n\nSystem requirements to build Karabiner-Elements:\n\n- macOS 15+\n- Xcode 26+\n- Command Line Tools for Xcode (`xcode-select --install`)\n- xz (`brew install xz`)\n- [XcodeGen](https://github.com/yonaskolb/XcodeGen) (`brew install xcodegen`)\n- CMake (`brew install cmake`)\n\n#### Steps\n\n1.  Get source code by executing the following command in Terminal.app.\n\n    ```shell\n    git clone --depth 1 https://github.com/pqrs-org/Karabiner-Elements.git\n    cd Karabiner-Elements\n    git submodule update --init --recursive --depth 1\n    ```\n\n2.  (Optional) If you have a codesign identity:\n    1.  Find your codesign identity.\n\n        ```shell\n        security find-identity -p codesigning -v | grep 'Developer ID Application'\n        ```\n\n        The result is as follows.\n\n        ```text\n        1) 8D660191481C98F5C56630847A6C39D95C166F22 \"Developer ID Application: Fumihiko Takayama (G43BCU2T37)\"\n        ```\n\n        Your codesign identity is `8D660191481C98F5C56630847A6C39D95C166F22` in the above case.\n\n    2.  Set environment variable to use your codesign identity.\n\n        ```shell\n        export PQRS_ORG_CODE_SIGN_IDENTITY=8D660191481C98F5C56630847A6C39D95C166F22\n        ```\n\n    3.  Find your codesign identity for installer signing.\n\n        ```shell\n        security find-identity -p basic -v | grep 'Developer ID Installer'\n        ```\n\n        The result is as follows.\n\n        ```text\n        1) C86BB5F7830071C7B0B07D168A9A9375CC2D02C5 \"Developer ID Installer: Fumihiko Takayama (G43BCU2T37)\"\n        ```\n\n        Your codesign identity is `C86BB5F7830071C7B0B07D168A9A9375CC2D02C5` in the above case.\n\n    4.  Set environment variable to use your codesign identity for installer signing.\n\n        ```shell\n        export PQRS_ORG_INSTALLER_CODE_SIGN_IDENTITY=C86BB5F7830071C7B0B07D168A9A9375CC2D02C5\n        ```\n\n3.  Build a package by executing the following command in Terminal.app.\n\n    ```shell\n    make package\n    ```\n\n    The `make` script will create a redistributable **Karabiner-Elements-VERSION.dmg** in the current directory.\n\n#### Note about pre-built binaries in the source tree\n\nKarabiner-Elements uses some pre-built binaries in the source tree.\n\n- `vendor/Karabiner-DriverKit-VirtualHIDDevice/dist/Karabiner-DriverKit-VirtualHIDDevice-*.pkg` (the latest one)\n- `Sparkle.framework` in `src/apps/SettingsWindow/`\n\nThe above `make package` command does not rebuild these binaries.\u003cbr/\u003e\n(These binaries will be copied in the distributed package.)\n\nIf you want to rebuild these binaries, you have to build them manually.\u003cbr/\u003e\nPlease follow the instruction of these projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpqrs-org%2Fkarabiner-elements","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpqrs-org%2Fkarabiner-elements","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpqrs-org%2Fkarabiner-elements/lists"}