Installation

Some operations are required to grant proper permission from macOS to Karabiner-Elements. Follow these instructions to set up Karabiner-Elements.

Install Karabiner-Elements

1. Open the downloaded file.
2. Open the .pkg file.
3. The installer will be opened. Install Karabiner-Elements.

   

After installation, you’ll need to grant the necessary permissions for Karabiner-Elements to function. This is part of macOS’s protection mechanism to prevent applications from accessing information without user consent. There are a few required steps, so please follow the instructions.

Additionally, when you open Karabiner-Elements Settings, the necessary actions will be displayed, so you can follow those prompts as well.

Open Karabiner-Elements Settings

1. Open Karabiner-Elements from Launchpad.

   

Keep Login Items enabled

The background item notifications will be shown after the installation.

The following Login Items in System Settings must be enabled.

• Karabiner-Elements Non-Privileged Agents
• Karabiner-Elements Privileged Daemons

Allow system software which provides virtual devices for Karabiner-Elements

1. The following alert will be shown when you open Karabiner-Elements Settings.
2. Click Open System Settings button, then press the Allow button.

   

   

Grant Input Monitoring to Karabiner-Elements processes

1. The Keystroke Receiving alerts will be shown.
2. Press the Open System Settings button on both alerts.

   

3. System Settings will be opened after you press the Open System Settings button.
   Choose Privacy & Security > Input Monitoring, and then enable karabiner_grabber.
   

   

Setup your keyboard layout

1. Keyboard Setup Assistant will be opened.
   Choose your keyboard layout. (ANSI, ISO or JIS)

   

Configure Karabiner-Elements

Enjoy keyboard configuration!

• Configuration manual