# Karabiner-Elements

Free macOS keyboard customizer for simple remaps, conditional complex rules, device-specific mappings and input-event inspection.

> This is the Markdown version of the Karabiner-Elements page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/karabiner-elements>

- **Latest version**: `16.3.0`
- **Developer**: Fumihiko Takayama (pqrs.org) and contributors
- **Homepage**: <https://karabiner-elements.pqrs.org/>
- **Categories**: [Utilities](https://opennavo.com/categories/utilities)
- **Install**: `brew install --cask karabiner-elements`
- **30-day installs**: 4,849
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/pqrs-org/Karabiner-Elements/releases/download/v16.3.0/Karabiner-Elements-16.3.0.dmg>
- **SHA-256**: `19cce7bed3d48a722242ca683bd1bae406b6a87fed520728d1c91dee175b75e4`
- **Commands**: karabiner_cli
- **Installer packages**: Karabiner-Elements.pkg

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "delete": "/Library/Application Support/org.pqrs",
          "early_script": {
            "executable": "/Library/Application Support/org.pqrs/Karabiner-DriverKit-VirtualHIDDevice/scripts/uninstall/remove_files.sh",
            "sudo": true
          },
          "launchctl": [
            "org.pqrs.karabiner.agent.karabiner_grabber",
            "org.pqrs.karabiner.agent.karabiner_observer",
            "org.pqrs.karabiner.karabiner_console_user_server",
            "org.pqrs.karabiner.karabiner_grabber",
            "org.pqrs.karabiner.karabiner_observer",
            "org.pqrs.karabiner.karabiner_session_monitor",
            "org.pqrs.karabiner.NotificationWindow"
          ],
          "pkgutil": [
            "org.pqrs.Karabiner-DriverKit-VirtualHIDDevice",
            "org.pqrs.Karabiner-Elements"
          ],
          "script": {
            "executable": "/Library/Application Support/org.pqrs/Karabiner-Elements/uninstall_core.sh",
            "sudo": true
          },
          "signal": [
            [
              "TERM",
              "org.pqrs.Karabiner-Menu"
            ],
            [
              "TERM",
              "org.pqrs.Karabiner-NotificationWindow"
            ]
          ]
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "Karabiner-Elements.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "Karabiner-Elements.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "binary": [
        "/Library/Application Support/org.pqrs/Karabiner-Elements/bin/karabiner_cli"
      ],
      "target": "$HOMEBREW_PREFIX/bin/karabiner_cli"
    },
    "phase": "install",
    "sources": [
      "/Library/Application Support/org.pqrs/Karabiner-Elements/bin/karabiner_cli"
    ],
    "target": "$HOMEBREW_PREFIX/bin/karabiner_cli",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.config/karabiner",
            "~/.local/share/karabiner",
            "~/Library/Application Scripts/org.pqrs.Karabiner-VirtualHIDDevice-Manager",
            "~/Library/Application Support/Karabiner-Elements",
            "~/Library/Caches/org.pqrs.Karabiner-Elements.Updater",
            "~/Library/Containers/org.pqrs.Karabiner-VirtualHIDDevice-Manager",
            "~/Library/HTTPStorages/org.pqrs.Karabiner-Elements.Settings",
            "~/Library/Preferences/org.pqrs.Karabiner-Elements.Updater.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Karabiner-Elements is a free, open-source keyboard customizer for macOS, maintained by Fumihiko Takayama (tekezo/pqrs.org) and contributors. It is useful for developers, keyboard enthusiasts and people who need device-specific or application-specific input behavior.

### Features
- Create simple key-to-key mappings in the graphical Settings app.
- Import community complex modifications or write your own JSON/JavaScript rules.
- Customize function keys, modifiers, simultaneous keys and conditional actions.
- Choose which keyboards or pointing devices to modify and use separate profiles.
- Inspect input events and device identifiers with Karabiner-EventViewer.
- Use supported mouse-key and MultitouchExtension features and CLI controls.

### Install and enable
Install with `brew install --cask karabiner-elements`, or open the official DMG and run the included PKG installer. This installs background services and a virtual keyboard/mouse driver; administrator authorization is required for the installer and privileged service approval. Open Karabiner-Elements Settings and follow its setup prompts in macOS System Settings: allow privileged/non-privileged background services, grant Accessibility/Input Monitoring permissions as required, and allow the Driver Extension. The current guide notes Accessibility approval normally also covers Input Monitoring. Choose the virtual keyboard layout matching your physical keyboard, then add a simple mapping and test it.

### Requirements and platforms
The current16.3.0 release supports macOS13 Ventura through27 Golden Gate. Intel and Apple Silicon Macs are supported on macOS13–26; the repository lists macOS27 for Apple Silicon. Older systems need the vendor’s older releases, such as14.13.0 for macOS11–12; do not install the current package solely because an older version once supported your Mac. This is a macOS utility; no official Windows, Linux, iOS or Android edition is established. Minimum RAM and installed storage were not published in the cited guide. The official16.3.0 DMG is42,388,528bytes, distinct from installed footprint.

The recorded cask installs a PKG and declares no extra formula dependencies or explicit cask conflicts. Its virtual HID driver and background services are required for actual remapping. Other tools that alter keyboard input can require compatibility configuration; see the vendor’s Logitech Logi Options+ Fn-key guidance rather than assuming every input tool works together. Build-tool dependencies in the source repository are for compilation, not prerequisites for the signed downloadable package.

When upgrading from15.9.0 or earlier, automatic service startup is disabled; open Karabiner-Elements.app after upgrading to re-enable it. Use the documented uninstaller because components live outside the application bundle.

### Cost, account and license
No service account or subscription is required for local keyboard remapping. The project is free and accepts optional sponsorship/donations. Its main project license is public domain/Unlicense; bundled third-party components retain their respective licenses. Imported rules can run actions, so review the rules you choose to enable.

Sources: [Official website](https://karabiner-elements.pqrs.org/), [Installation](https://karabiner-elements.pqrs.org/docs/getting-started/installation/), [Repository](https://github.com/pqrs-org/Karabiner-Elements), [Release notes](https://karabiner-elements.pqrs.org/docs/releasenotes/), [License](https://github.com/pqrs-org/Karabiner-Elements/blob/main/LICENSE.md).

## System requirements

- Build for macOS 27, 26, 15, 14, 13 · Version: 16.3.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · Checked 2026-11-21
  - <https://github.com/pqrs-org/Karabiner-Elements/releases/download/v16.3.0/Karabiner-Elements-16.3.0.dmg>
  - SHA-256: `19cce7bed3d48a722242ca683bd1bae406b6a87fed520728d1c91dee175b75e4`
- Build for macOS 27, 26, 15, 14, 13 · Version: 16.3.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · Checked 2026-11-21
  - <https://github.com/pqrs-org/Karabiner-Elements/releases/download/v16.3.0/Karabiner-Elements-16.3.0.dmg>
  - SHA-256: `19cce7bed3d48a722242ca683bd1bae406b6a87fed520728d1c91dee175b75e4`
- Build for macOS 12, 11 · Version: 14.13.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · Checked 2026-11-21
  - <https://github.com/pqrs-org/Karabiner-Elements/releases/download/v14.13.0/Karabiner-Elements-14.13.0.dmg>
  - SHA-256: `826270a21b7f4df9b9a8c79c9aad4de8f48021f58eaacbee1d4f150c963c6cbc`
- Build for macOS 12, 11 · Version: 14.13.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · Checked 2026-11-21
  - <https://github.com/pqrs-org/Karabiner-Elements/releases/download/v14.13.0/Karabiner-Elements-14.13.0.dmg>
  - SHA-256: `826270a21b7f4df9b9a8c79c9aad4de8f48021f58eaacbee1d4f150c963c6cbc`

## Karabiner-Elements security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/pqrs-org/Karabiner-Elements> · Open source: Yes — <https://github.com/pqrs-org/Karabiner-Elements> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask karabiner-elements`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Background services (launchctl): `org.pqrs.karabiner.agent.karabiner_grabber` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.agent.karabiner_observer` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.karabiner_console_user_server` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.karabiner_grabber` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.karabiner_observer` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.karabiner_session_monitor` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Background services (launchctl): `org.pqrs.karabiner.NotificationWindow` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Installer receipts (pkgutil): `org.pqrs.Karabiner-DriverKit-VirtualHIDDevice` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Installer receipts (pkgutil): `org.pqrs.Karabiner-Elements` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `/Library/Application Support/org.pqrs` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask karabiner-elements`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.config/karabiner` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/.local/share/karabiner` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Scripts/org.pqrs.Karabiner-VirtualHIDDevice-Manager` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Karabiner-Elements` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/org.pqrs.Karabiner-Elements.Updater` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Containers/org.pqrs.Karabiner-VirtualHIDDevice-Manager` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/org.pqrs.Karabiner-Elements.Settings` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/org.pqrs.Karabiner-Elements.Updater.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

## Latest release notes

### 16.3.0 (2026-10-07)

Fixes stuck modifiers and sleep/wake issues, and adds ELECOM HUGE buttons6–8 support.

**Changes**

- Fix stuck modifiers with simultaneous left/right Command or Shift.
- Avoid checking updates on every wake and remapping delays after sleep.
- Support ELECOM HUGE trackball buttons6–8.

## Facts and sources

- <https://opennavo.com/apps/karabiner-elements>
- <https://opennavo.com/apps/karabiner-elements/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/k/karabiner-elements.rb> · Checked 2026-11-21
- <https://formulae.brew.sh/cask/karabiner-elements>
- <https://github.com/pqrs-org/Karabiner-Elements> · Checked 2026-11-13
