---
schema_version: 1
revision: "22ce5d34dbcb5a78"
id: "factory-tools-keyboard-customization"
title: "Keyboard customization (Karabiner-Elements)"
---

# Keyboard customization (Karabiner-Elements)

Tool roles, alternatives, selection tradeoffs, and compatibility caveats.

## Keyboard customization (Karabiner-Elements)

**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.

| Alternative | What it is | How it differs | License |
|----|----|----|----|
| [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 |
| [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 |
| [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 |
| [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 |
| [Keyboard Maestro](https://www.keyboardmaestro.com/) | Commercial macOS macro platform (hotkeys, palettes, app-scoped macros) | GUI macro builder, one-time license; closed source | commercial |

### Pick this if…

- **kanata** — you want Karabiner-style layers on Linux or Windows too.
- **kmonad** — same, with the original Lisp-flavored config (kin to Goku's edn).
- **Hammerspoon** — your chords should run *logic*, not just keystrokes — it can replace the chord→script half of John's setup.
- **skhd** — you only need "hotkey runs command" with no remapping.
- **Keyboard Maestro** — you want a GUI and a one-time license instead of config files.

## Original references

- [Tool comparison reference](https://dewy-sleet-n5zs.here.now/#keyboard-customization)
