{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-tools-keyboard-customization",
  "slug": "tools-keyboard-customization",
  "title": "Keyboard customization (Karabiner-Elements)",
  "summary": "Tool roles, alternatives, selection tradeoffs, and compatibility caveats.",
  "category": "Tools",
  "tags": [
    "tools",
    "keyboard-customization"
  ],
  "sources": [
    {
      "label": "Tool comparison reference",
      "url": "https://dewy-sleet-n5zs.here.now/#keyboard-customization"
    }
  ],
  "sourceUnits": [
    "resources/index.html#keyboard-customization"
  ],
  "collection": "factory",
  "categoryId": "tools",
  "wordCount": 295,
  "url": "/topics/factory-tools-keyboard-customization/",
  "markdownUrl": "/markdown/factory-tools-keyboard-customization.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-tools-keyboard-customization.json",
  "headings": [
    {
      "id": "keyboard-customization-karabiner-elements",
      "text": "Keyboard customization (Karabiner-Elements)",
      "level": 2
    },
    {
      "id": "pick-this-if",
      "text": "Pick this if…",
      "level": 3
    }
  ],
  "markdown": "# Keyboard customization (Karabiner-Elements)\n\nTool roles, alternatives, selection tradeoffs, and compatibility caveats.\n\n## Keyboard customization (Karabiner-Elements)\n\n**John uses:** [Karabiner-Elements](https://github.com/pqrs-org/Karabiner-Elements) (22.5k, Unlicense) with his config written as `karabiner.edn` compiled by [Goku](https://github.com/yqrashawn/GokuRakuJoudo) (1.4k, GPL-3.0, last push the example workflow). Section 06's trick: an app-scoped Esc-hold layer in Ghostty fires internal Ctrl+Alt chords that Herdr's `[[keys.command]]` bindings catch — Karabiner knows the keyboard, Herdr knows the focused pane.\n\n| Alternative | What it is | How it differs | License |\n|----|----|----|----|\n| [kanata](https://github.com/jtroo/kanata) | Cross-platform advanced keyboard remapper (layers, tap-hold) in Rust | Works on Linux/Windows/mac; kmonad-style config; no macOS app-scoping as rich as Karabiner's | LGPL-3.0 |\n| [kmonad](https://github.com/kmonad/kmonad) | Advanced keyboard manager (Haskell), layers and macros, cross-platform | The original layer-centric remapper; config is Lisp-flavored like Goku's edn | MIT |\n| [Hammerspoon](https://github.com/Hammerspoon/hammerspoon) | macOS desktop automation scripted in Lua (hotkeys, window management, app events) | Hotkeys plus arbitrary automation logic — can replace the 'chord fires a script' half of John's setup | MIT |\n| [skhd](https://github.com/asmvik/skhd) | Simple hotkey daemon for macOS | Just hotkey→command bindings in a flat config; minimal but no remapping layers; check current repository activity | MIT |\n| [Keyboard Maestro](https://www.keyboardmaestro.com/) | Commercial macOS macro platform (hotkeys, palettes, app-scoped macros) | GUI macro builder, one-time license; closed source | commercial |\n\n### Pick this if…\n\n- **kanata** — you want Karabiner-style layers on Linux or Windows too.\n- **kmonad** — same, with the original Lisp-flavored config (kin to Goku's edn).\n- **Hammerspoon** — your chords should run *logic*, not just keystrokes — it can replace the chord→script half of John's setup.\n- **skhd** — you only need \"hotkey runs command\" with no remapping.\n- **Keyboard Maestro** — you want a GUI and a one-time license instead of config files."
}
