{
  "slug": "karabiner-elements",
  "name": "Karabiner-Elements",
  "aliases": ["Karabiner"],
  "vendor": { "name": "pqrs.org (Takayama Fumihiko)", "slug": "pqrs-org", "website": "https://pqrs.org/" },
  "homepage_url": "https://karabiner-elements.pqrs.org/",
  "docs_url": "https://karabiner-elements.pqrs.org/docs/",
  "repo_url": "https://github.com/pqrs-org/Karabiner-Elements",
  "license_url": "https://github.com/pqrs-org/Karabiner-Elements/blob/main/LICENSE.md",
  "product_type": "application",
  "product_status": "active",
  "summary": "Free, public-domain keyboard customizer for macOS that remaps keys and defines complex modifications through JSON rules at the driver level",
  "description": "Karabiner-Elements is a keyboard customizer for macOS developed by pqrs.org and released into the public domain (Unlicense). Unlike application-level tools it works with a virtual HID driver, so remappings apply system-wide and per physical device before applications see the keystrokes. Simple modifications swap one key for another from a graphical list; complex modifications are JSON rules that can turn Caps Lock into Escape when tapped and Control when held, create layers, add Vi or Emacs bindings, or change behavior per application. Rules can be imported from a community collection.\n\nProfiles let users switch sets of rules, settings can be scoped to specific keyboards, and a companion EventViewer shows raw key events for debugging. The current release supports macOS 13 through the latest version on Intel and Apple Silicon, with older releases for earlier systems.\n\nIt is purely a keyboard tool: there is no window management, mouse scripting or general automation, and installing its driver extension requires approving a system extension and granting input-monitoring permission.",
  "capabilities": ["System-wide key remapping via a virtual HID driver", "Complex JSON rules with tap/hold, layers and per-app conditions", "Device-specific settings and switchable profiles", "Importable community rule collections", "EventViewer for inspecting key events"],
  "workflows": ["Make Caps Lock act as Escape and Control", "Give an external PC keyboard Mac modifier layout", "Add a navigation layer on the home row"],
  "advantages": ["Free and public domain", "Works below the application layer, so remaps are universal", "Long-maintained with current macOS support"],
  "limitations": ["Keyboard only; no mouse or window automation", "Requires system-extension and input-monitoring approval", "JSON rule syntax has a learning curve"],
  "prerequisites": ["macOS 13 or later for the current release"],
  "audiences": ["Keyboard-focused users and developers", "People using non-Apple keyboards on Macs"],
  "alternatives": ["hammerspoon", "keyboard-maestro"],
  "categories": [{ "slug": "macos-utilities", "primary": true }, { "slug": "macos-automation" }],
  "tags": ["macos", "keyboard", "remapping", "open-source", "apple-silicon"],
  "use_cases": ["automate-desktop-tasks"],
  "operating_systems": ["macos"],
  "execution_modes": ["local"],
  "interfaces": ["desktop", "cli"],
  "deployment_models": ["desktop"],
  "integrations": ["Homebrew cask"],
  "data_formats": ["karabiner.json configuration"],
  "languages": ["C++", "Swift"],
  "source_model": "open-source",
  "license_spdx": "Unlicense",
  "pricing_model": ["open-source", "free"],
  "self_hostable": true,
  "sources": [
    { "url": "https://karabiner-elements.pqrs.org/", "type": "official_site", "title": "Karabiner-Elements", "supports": ["name", "summary", "capabilities", "prerequisites"], "checked_at": "2026-11-02" },
    { "url": "https://karabiner-elements.pqrs.org/docs/", "type": "official_docs", "title": "Karabiner-Elements documentation", "supports": ["capabilities"], "checked_at": "2026-11-02" },
    { "url": "https://github.com/pqrs-org/Karabiner-Elements/blob/main/LICENSE.md", "type": "license_page", "supports": ["license_spdx", "source_model"], "checked_at": "2026-11-02", "note": "Public-domain dedication (Unlicense text)" }
  ],
  "confidence": "high",
  "discovery_method": "editorial-research",
  "depth": "standard",
  "editorial_status": "reviewed",
  "visibility": "public",
  "featured": false,
  "author": "batch-C"
}