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 Karabiner-Elements.pkg.
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 Apps or Finder.

Grant permissions to Karabiner-Elements in System Settings

When you open Karabiner-Elements Settings, instructions such as allowing Background Services will be displayed. Follow those instructions and grant the required permissions in System Settings.

Specifically, the following permissions are required:

• Allow privileged and non-privileged background services to run
• Grant Accessibility permission
• Grant Input Monitoring permission
• Allow Driver Extension for the virtual keyboard and mouse

(Normally, Accessibility permission also covers Input Monitoring permission, so it will be granted automatically when you allow Accessibility.)

Choose your keyboard layout

When setup is complete, you will be asked which virtual keyboard layout to use. Choose the same type as the keyboard you are using. (You can change this setting later from the Virtual Keyboard tab.)

Configure Karabiner-Elements

Enjoy keyboard configuration!

• Configuration manual