by tekezo

tekezo / Karabiner

Karabiner (KeyRemap4MacBook) is a powerful utility for keyboard customization.

3.8K Stars 331 Forks Last release: Not found The Unlicense 10.6K Commits 41 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Build Status License


Karabiner is obsoleted on macOS Sierra (10.12) or later.
Please use Karabiner-Elements.


Karabiner is a powerful utility for keyboard customization.

  • Change the key mappings (For example, "Change Right Option to Enter")
  • Change the key repeat speed.
  • The revival of a lost NumPad key (Fn+jkluio789…)
  • Features for more efficient operations. (Emacs Mode, Vi Mode, Mouse Keys Mode, ...)

Prior to version 9.3.0, Karabiner was called KeyRemap4MacBook.

Please use Karabiner-Elements on macOS Sierra (10.12) or later.

We made Karabiner-Elements from scratch due to kernel architecture changes in macOS Sierra.

Useful links

  • Latest build: https://pqrs.org/osx/karabiner/
  • Mirror: http://tekezo.github.io/pqrs.org/
  • Google Group: https://groups.google.com/forum/#!forum/osx-karabiner
  • List of key names: https://github.com/tekezo/Karabiner/blob/master/src/bridge/generator/keycode/data/KeyCode.data

You can also get the latest stable release package via fixed URL.

$ curl -L -O https://pqrs.org/latest/karabiner-latest.dmg

System requirements

Karabiner works for all Mac products, including the MacBook series, iMac, Mac mini, and Mac Pro, with the requirement that the product runs OS X 10.9 (Mavericks) or higher, up until MacOS 10.12 (Sierra), which is not supported.

  • If you require Karabiner for macOS 10.12, please use Karabiner Elements.
  • If you require Karabiner for OS X 10.6 - 10.8, please use KeyRemap4MacBook 8.4.0.
  • If you require Karabiner for OS X 10.4 - 10.5, please use KeyRemap4MacBook 5.1.0.

How to build

System requirements:

  • OS X 10.11+
  • Xcode 8+
  • Command Line Tools for Xcode
  • Boost 1.56.0+ (header-only) http://www.boost.org/

Please install Boost into

. (eg.

Step 1: Getting source code

Download the source to master.tar.gz in the current directory, this can be re-executed to restart a cancelled download.

curl -OLC - https://github.com/tekezo/Karabiner/archive/master.tar.gz

Extract the master.tar.gz file to "Karabiner-master" and delete the tar.gz file

tar -xvzf master.tar.gz && rm master.tar.gz

Step 2: Building a package

cd Karabiner-master


script will create a redistributable Karabiner-VERSION.dmg in the current directory.

Note: The build may fail if you have changed any environment variables or if you have modified scripts in the

locations. Use a clean environment (new account) if this is the case.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.