简体中文
EnglishHow do I download Karabiner-Elements for my macOS version?
Updated
Go to karabiner-elements.pqrs.org and use the Download dropdown on the page. The current release listed there is v16.3.0, and the dropdown groups each download by the macOS version it supports, so you pick the entry that matches your Mac's system version. Both Intel-based Macs and Apple Silicon Macs are supported.
Steps to download the right build
- Open karabiner-elements.pqrs.org in your browser.
- Click the Download dropdown (labeled with the current version, e.g. "Download v16.3.0").
- Find the macOS version your Mac is running and click that download link.
- Install the downloaded package, then open Karabiner-Elements to configure your key mappings.
To check your macOS version first: open the Apple menu → About This Mac and read the version number (for example, macOS 15 Sequoia or macOS 14 Sonoma).
Which download matches your macOS version
The dropdown lists downloads by macOS release. Based on the current page, the mapping is:
| macOS version | Download listed |
|---|---|
| macOS 27 Golden Gate | v16.3.0 |
| macOS 26 Tahoe | v16.3.0 |
| macOS 15 Sequoia | v16.3.0 |
| macOS 14 Sonoma | v16.3.0 |
| macOS 13 Ventura | v16.3.0 |
| macOS 12 Monterey | v14.13.0 |
| macOS 11 Big Sur | v14.13.0 |
| macOS 10.15 Catalina (10.15.6 or later) | v13.7.0 |
| macOS 10.15 Catalina | v12.10.0 |
| macOS 10.14 Mojave | v12.10.0 |
| macOS 10.13 High Sierra | v12.10.0 |
| macOS 10.12 Sierra | v12.10.0 |
| macOS 10.11 El Capitan | v11.6.0 |
| macOS 10.11 El Capitan | v10.22.0 |
| macOS 10.10 Yosemite | v10.22.0 |
| macOS 10.9 Mavericks | v10.22.0 |
Note that some older macOS versions appear more than once (for example, Catalina and El Capitan). Pick the entry whose label matches your exact system version rather than assuming the newest number is correct for an older OS.
What you get after installing
Karabiner-Elements is a keyboard customizer for macOS. Once installed, you can:
- Configure simple key mappings from the GUI.
- Import predefined rules from the community, such as Diamond cursor, Emacs key bindings anywhere, Vi key bindings, and "prevent unintended command-q."
- Write your own rules to modify existing ones or build new ones from scratch.
Common points to watch
- Match the version, not just the newest number. Newer releases target newer macOS versions; an older Mac needs the older build listed next to its system version.
- Intel and Apple Silicon are both supported according to the site, so you don't need a separate download based on chip type.
- Check the release notes if you want to know what changed between versions before installing.
- The site links to a pricing page and a Sponsor option; the download itself is presented as a direct download from the page.