Skip to content

farbe-software/hackboard

Repository files navigation

Hackboard

macOS 13+ Karabiner-Elements

Note

Beta testing is paused while we evaluate feedback. Thanks to everyone who participated — we'll be back.

Hackboard is a macOS app enabling layered keymaps (based on the hold-tap paradigm) to trigger actions more efficiently and ergonomically with your keyboard. Hold a sequence, tap a key, map an action - that's a keymap.

Examples:

Sequence Action
Hold ⌘Hold ATap T Open Terminal
Hold ⌘Hold AHold STap M Open Maps in Safari
Hold FTap J, K, L, ; Arrow Keys
Hold FTap Space Enter
Hold ⌘Hold TTap E Type your_email@example.com

Hackboard bundles Hb-Karabiner-Elements, a fork of Karabiner-Elements by Fumihiko Takayama — without his years of work, this wouldn't exist. Support his work. Inspired by Max Stoiber's sublayer concept. Fully compatible with your existing Karabiner config, currently pinned to version 15.0.0.

Get Started

  1. Hb-Karabiner-Elements starts automatically after install — grant the macOS permissions it requests (Input Monitoring, virtual HID driver).
  2. Start Hackboard — it asks for access to the folder containing karabiner.json via a system folder picker.
  3. Hackboard loads an example configuration - try it, change it and hack away!

Important

Switching from Karabiner-Elements? Uninstall it first and ensure your karabiner.json is compatible with Karabiner-Elements 15.0.0.

  • If there are problems with permissions, try deactivating and reactivating them.
  • Your existing karabiner.json rules remain unaffected and will continue to work. If any of them conflict with your Hackboard keymaps, the Hackboard keymaps take priority.

Uninstall

A full uninstall can be triggered from the Hackboard settings page or through the Hb-Karabiner-Elements UI. Either option removes both applications. A restart is required to complete the uninstallation.

Feedback & Issues

Found a bug or have a suggestion? Open an issue on this repository.

Legal

By downloading and using Hackboard, you agree to the Terms of Service and acknowledge the Privacy Policy.