Skip to content

Karabiner-Elements

Fumihiko Takayama (pqrs.org) and contributors · Free macOS keyboard customizer for simple remaps, conditional complex rules, device-specific mappings and input-event inspection.

CaskUtilitiesAuto-updates 23.1K
Install command
brew install --cask karabiner-elements
30-day installs
4,849
#80 in App
1-year installs
59.3K
Last 365 days
Latest version
16.3.0
Download size
42MB
dmg
Release cadence
Irregular
0 releases in 30 days

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, Installation, Repository, Release notes, License.

At a glance

Chip
Apple silicon · Intel
Auto-updates
Yes
Repository
Open source · Unlicense · Updated 1 day ago★23.1K
Developer
Fumihiko Takayama (pqrs.org) and contributors
Homebrew
Available; the app updates itself
Also known as
Karabiner Elements, karabiner-elements
Homepage
karabiner-elements.pqrs.org
Token
karabiner-elements

Checked

What’s new in 16.3.0

New · OpenNavo editorial

  • ChangesFix stuck modifiers with simultaneous left/right Command or Shift.

How to install Karabiner-Elements on Mac

Homebrew runs the Karabiner-Elements.pkg installer, which asks for an administrator password.

Install without Homebrew

Download the same file Homebrew uses: Install Details

Uninstall Karabiner-Elements and optional data cleanup

Uninstall command
brew uninstall --cask karabiner-elements

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

Deep clean (optional)
Uninstall command
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.

Questions about Karabiner-Elements

Is Karabiner-Elements safe?

Karabiner-Elements is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 4,849 times through Homebrew in the last 30 days.

Is Karabiner-Elements open source?

Karabiner-Elements’s source code is public on GitHub (pqrs-org/Karabiner-Elements) under the Unlicense license.

How do I completely uninstall Karabiner-Elements on a Mac?

Run brew uninstall --cask karabiner-elements. It stops 7 background services and forgets 2 installer receipts. To delete its settings and caches as well, run 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. That also deletes 8 files and folders, including ~/.config/karabiner.

Does Karabiner-Elements run on Apple silicon (M1 and later) Macs?

Homebrew installs it on both Apple silicon and Intel Macs, from the same download.

Where does Karabiner-Elements store its settings and data?

Its settings are in ~/Library/Preferences/org.pqrs.Karabiner-Elements.Updater.plist. Its data is in ~/.config/karabiner, ~/Library/Application Support/Karabiner-Elements, and ~/Library/Containers/org.pqrs.Karabiner-VirtualHIDDevice-Manager. These locations come from Homebrew’s clean-up list.

What is the latest version of Karabiner-Elements?

The latest version is 16.3.0, added to Homebrew on Sep 6, 2026. Karabiner-Elements updates itself; to update it with Homebrew, run brew upgrade --cask --greedy karabiner-elements.

What else does installing Karabiner-Elements add?

It also adds 1 command-line tool: karabiner_cli. It installs through a .pkg installer, which asks for an administrator password.

Similar Apps

  • LinearMouseFree Mac mouse and trackpad utility for scrolling, pointer acceleration/speed, button actions and per-device or app profiles.
  • AltTabMac window switcher with individual-window previews and configurable shortcuts; free core features with optional Pro tools.
  • AppCleanerMac uninstall utility that finds associated app files and lets you review what to remove.
  • VorssaintFree, modular Mac menu bar toolkit with per-app audio, system monitoring, window controls, capture tools, clipboard utilities, and an optional Dynamic Island.
Browse all apps