what is keyboard fr?

hfo4/keyboard — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2019-04-05

★ 1LuaAudience · developerComplexity · 3/5DormantSetup · moderate

vibe map

mindmap
  root((repo))
    What it does
      Remaps Mac keyboard
      Adds custom key modes
      Keeps hands on home row
    Tech stack
      Lua
      Karabiner-Elements
      Hammerspoon
      macOS
    Use cases
      Snap windows with keys
      Navigate cursor without mouse
      Format text in Markdown mode
      Launch favorite apps fast
    Audience
      Developers
      Writers
    Setup
      Install Karabiner-Elements
      Grant accessibility permissions
      Config files, no app

mindmap root((repo)) What it does Remaps Mac keyboard Adds custom key modes Keeps hands on home row Tech stack Lua Karabiner-Elements Hammerspoon macOS Use cases Snap windows with keys Navigate cursor without mouse Format text in Markdown mode Launch favorite apps fast Audience Developers Writers Setup Install Karabiner-Elements Grant accessibility permissions Config files, no app

what do people make with this?

VIBE 1

Snap application windows to half the screen using a keyboard shortcut instead of the mouse.

VIBE 2

Navigate the cursor with H, J, K, L style keys without leaving the home row.

VIBE 3

Wrap selected text in Markdown formatting like asterisks or backticks with a quick key combo.

VIBE 4

Customize the config to launch your own frequently used apps from a keyboard mode.

what's the stack?

LuaKarabiner-ElementsHammerspoonmacOS

how it stacks up fr

	hfo4/keyboard	drakeee/altv-lua-examples	alerque/silex.sile
Stars	1	1	—
Language	Lua	Lua	Lua
Last pushed	2019-04-05	2020-08-20	2025-04-17
Maintenance	Dormant	Dormant	Stale
Setup difficulty	moderate	moderate	moderate
Complexity	3/5	2/5	3/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

macOS-only, requires installing Karabiner-Elements and granting accessibility permissions.

prompts (copy fr)

prompt 1

Help me set up Karabiner-Elements and Hammerspoon to use this keyboard mode config on my Mac.

prompt 2

Show me how to add a new custom mode to this Hammerspoon Lua configuration.

prompt 3

Explain how Super Duper Mode remaps H, J, K, L to arrow keys in this setup.

prompt 4

Help me customize this config to launch my own favorite apps with a key combo.

prompt 5

Walk me through granting the accessibility permissions this project needs on macOS.

Frequently asked questions