GirishPatel / Karabiner-Elements

The next generation Karabiner for macOS Sierra

Home Page:https://pqrs.org/osx/karabiner/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status License

Karabiner-Elements

Karabiner-Elements is the subset of the next generation Karabiner for macOS Sierra.

Project Status

Karabiner-Elements works fine.

You can download the latest Karabiner-Elements from https://pqrs.org/latest/karabiner-elements-latest.dmg

System requirements

  • OS X 10.11.*
  • OS X 10.12.*

Usage

Detailed usage instructions are available here.

Features

  • Simple key modification (change keys to another keys)
  • Support Secure Keyboard Entry (eg. Terminal, Password prompt)
  • Modifier flags sharing with all connected keyboards.

Limitations

  • Karabiner-Elements cannot modify eject key due to the limitation of macOS API.
  • Karabiner-Elements ignores the System Preferences > Keyboard > Modifier Keys... configuration.

How to build

System requirements:

To install the Boost requirement, download the latest Boost release, open the boost folder inside of it, and move all of the files there into /opt/local/include/boost/.

(For example, the version.hpp should be located in /opt/local/include/boost/version.hpp)

Step 1: Getting source code

Clone the source from github.

git clone --depth 1 https://github.com/tekezo/Karabiner-Elements.git

Step 2: Building a package

cd Karabiner-Elements
make

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

Donations

If you would like to contribute financially to the development of Karabiner Elements, donations can be made via https://pqrs.org/osx/karabiner/donation.html.en.

About

The next generation Karabiner for macOS Sierra

https://pqrs.org/osx/karabiner/

License:The Unlicense


Languages

Language:C++ 68.6%Language:Objective-C 23.5%Language:Shell 4.0%Language:Makefile 1.9%Language:C 1.2%Language:Ruby 0.6%Language:AppleScript 0.2%