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. dmg
  2. Open the .pkg file. pkg
  3. The installer will be opened. Install Karabiner-Elements.
    installer@2x.png

Keep Login Items enabled

Since macOS 13 Ventura, background item notifications will be shown after the installation.

login-items0@2x.png

The following Login Items in System Settings are required, and have to keep enabled.

  • Karabiner-DriverKit-VirtualHIDDeviceClient.app
  • Karabiner-Elements.app
login-items1@2x.png

Open Karabiner-Elements Settings

  1. Open Karabiner-Elements from Launchpad.
    karabiner-elements-icon@2x.png

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.
    system-extension-blocked@2x.png
    system-extension-allow@2x.png

Grant Input Monitoring to Karabiner-Elements processes

  1. Two Keystroke Receiving alerts will be shown on macOS Catalina or later after you allow the system software.
  2. Press the Open System Settings button on both alerts.
    karabiner-grabber@2x.png
    karabiner-observer@2x.png
  3. System Settings will be opened after you press the Open System Settings button.
    Choose Privacy & Security > Input Monitoring, and then enable karabiner_grabber and karabiner_observer.
    input-monitoring@2x.png

Setup your keyboard layout

  1. Keyboard Setup Assistant will be opened.
    Choose your keyboard layout. (ANSI, ISO or JIS)
    keyboard-setup-assistant@2x.png

Configure Karabiner-Elements

Enjoy keyboard configuration!