Installation

Some operations are required to grant properly permission from macOS to Karabiner-Elements. Follow this instruction to set up Karabiner-Elements.

Install Karabiner-Elements

  1. Open the downloaded file. dmg
  2. Open a pkg file. pkg
  3. The installer will be opened. Install Karabiner-Elements.
    installer@2x.png

Open Karabiner-Elements Preferences

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

Allow using kext which provides virtual devices for Karabiner-Elements

  1. An alert about kext policy will be shown since macOS High Sierra when you open Karabiner-Elements Preferences.
  2. Click Open System Preferences > Security & Privacy button, then press Allow button.
    high-sierra-kext-policy@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 kernel extension.
  2. Press Open System Preferences button on both alerts.
    catalina-karabiner-grabber@2x.png
    catalina-karabiner-observer@2x.png
  3. System Preferences will be open after you press the Open System Preferences button.
    Choose Privacy > Input Monitoring, and then enable karabiner_grabber and karabiner_observer.
    (You have to unlock configuration by the left bottom icon.)
    catalina-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!