Trouble: Allow button on System Preferences > Security & Privacy does not work.

The allow button on System Preferences > Security & Privacy should be hidden after you click it.
If the button does not hide after click, you did not succeed to click it.

It's because macOS blocks the click if you are using an app which intercepts mouse events.
You have to quit them before pressing the allow button.

Apps which prevent the click:
  • MagicPrefs
  • SteerMouse
  • Witch
  • If you are using macOS from remote via Screen Sharing, you cannot click the allow button.
  • etc.

Trouble: Touch bar does not change to f1-f12 when I press the fn key.

It's an issue of macOS, and unfortunately, Karabiner-Elements cannot avoid this issue.
Instead, please change fn+number keys to function keys in Karabiner-Elements configuration.

  1. Import Map fn + number keys to function keys
  2. Enable Map fn + number keys to their corresponding function keys.
  3. You can use f1-f12 keys by fn+number keys.

Trouble: Control-eject shortcut does not work when Karabiner-Elements is running.

It's an issue of macOS, and unfortunately, Karabiner-Elements cannot avoid this issue.
Instead, please change fn+escape to eject and use control+fn+escape (== control+eject) shortcut.

  1. Import Change escape key
  2. Enable Change fn+escape to eject.
  3. You can use control+fn+escape as control+eject.

Trouble: karabiner.json is not owned by a valid user error message in log

If the following error message is appeared in log, your home directory owner ship is not valid.

[warning] [grabber] /Users/.../karabiner.json is not owned by a valid user.

The cause is that you are using an external storage and locating your home directory into the volume.
You have to enable ownership on the external volume by the following command in Terminal.app.

sudo diskutil enableOwnership disk99999s99999

(See diskutil manual for detail.)

Installed files

Karabiner-Elements installs files into the following locations.

System files
  • /Applications/Karabiner-Elements.app
  • /Applications/Karabiner-EventViewer.app
  • /Library/Application Support/org.pqrs/Karabiner-Elements
  • /Library/Application Support/org.pqrs/Karabiner-VirtualHIDDevice
  • /Library/Application Support/org.pqrs/config
  • /Library/Application Support/org.pqrs/tmp
  • /Library/LaunchDaemons/org.pqrs.karabiner.karabiner_grabber.plist
  • /Library/LaunchAgents/org.pqrs.karabiner.karabiner_console_user_server.plist
  • /var/log/karabiner
User files
  • ~/.config/karabiner
  • ~/.local/share/karabiner