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

Open Karabiner-Elements from Launchpad.

Setup your keyboard layout

Choose your keyboard layout. (ANSI, ISO or JIS).

This setting changes the behavior of some keys (symbol keys) on the keyboard. If the printed characters on your keyboard do not match what is input, please change this later in the Virtual Keyboard settings.

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

Grant Input Monitoring to Karabiner-Elements processes

1. The Keystroke Receiving alert will be shown.
2. Press the Open System Settings button and enable karabiner_grabber.

   

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 enable .Karabiner-VirtualHIDDevice-Manager.

   

   

Configure Karabiner-Elements

Enjoy keyboard configuration!

• Configuration manual