README.md

• Installation
• Open Karabiner-Elements
• Quit Karabiner-Elements
• Uninstall Karabiner-Elements
• Change Key

Installation

Download Karabiner-Elements package from https://pqrs.org/latest/karabiner-elements-latest.dmg

Open dmg file and then open the installer.

Karabiner-Elements and Karabiner-EventViewer will be installed into Launchpad.

Open Karabiner-Elements

Open Karabiner-Elements from Launchpad.

The preferences window will be opened.

Quit Karabiner-Elements

You can quit Karabiner-Elements by the Quit Karabiner-Elements button.

Uninstall Karabiner-Elements

You can uninstall Karabiner-Elements from Misc tab.

Change Key

At the moment, you have to edit the configuration file by hand.

The configuration file is located in ~/.karabiner.d/configuration/karabiner.json

An example of karabiner.json

{
    "profiles": [
        {
            "name": "Default profile",
            "selected": true,
            "simple_modifications": {
                "caps_lock": "delete"
            }
        }
    ]
}

Typical configuration files

• Change caps lock to delete
• Change caps lock to escape
• Swap caps lock and delete
• Swap caps lock and escape

If you want change caps lock to delete key, execute the following commands in Terminal.

mkdir -p ~/.karabiner.d/configuration/
cd ~/.karabiner.d/configuration/
curl -L -o karabiner.json https://raw.githubusercontent.com/tekezo/Karabiner-Elements/master/examples/change_caps_lock_to_delete.json

change caps lock to escape

mkdir -p ~/.karabiner.d/configuration/
cd ~/.karabiner.d/configuration/
curl -L -o karabiner.json https://raw.githubusercontent.com/tekezo/Karabiner-Elements/master/examples/change_caps_lock_to_escape.json

swap caps lock and delete

mkdir -p ~/.karabiner.d/configuration/
cd ~/.karabiner.d/configuration/
curl -L -o karabiner.json https://raw.githubusercontent.com/tekezo/Karabiner-Elements/master/examples/swap_caps_lock_and_delete.json

swap caps lock and escape

mkdir -p ~/.karabiner.d/configuration/
cd ~/.karabiner.d/configuration/
curl -L -o karabiner.json https://raw.githubusercontent.com/tekezo/Karabiner-Elements/master/examples/swap_caps_lock_and_escape.json

The key definition

The keys (eg. "caps_lock") are defined in types.hpp.

https://github.com/tekezo/Karabiner-Elements/blob/master/src/share/types.hpp#L156-L348