Skip to content

Keyboard layers for macOS

Hold a key.
Get a whole new keyboard.

Arrows on H J K L, Home and End under your fingers, media keys where you want them. On the built-in MacBook keyboard and on every other one.

Free and open source (MIT) · macOS 26 (Tahoe) or later · Setup guide

KeyLayers showing the Mod layer: arrows on H J K L, Home, End and page keys, media keys on the top rowKeyLayers showing the Mod layer: arrows on H J K L, Home, End and page keys, media keys on the top row
Hold fn for the Mod layer. The starter keymap puts the arrows on H J K L, Home, Page Down, Page Up and End on Y U I O, and the Mac's media keys on F1 to F12. Change any key in the app.

Why KeyLayers

Made for the road.

At my desk I type on a UHK, the Ultimate Hacking Keyboard, and I live in its layers: arrows, Home, End and Page Up under the home row, a Mod key away. On the road, with only the MacBook, all of that was gone, and I kept getting lost on a keyboard I've used for years.

So I built KeyLayers: the layers I'm used to, on the keyboard I have with me. It does one thing, layers, and stays out of the way otherwise.

Features

Your keyboard, in layers.

Layers

Hold a key, get a layer

While you hold a layer key, its layer replaces the keys underneath. Keys it doesn't map fall through, so the rest of your keyboard stays as it is.

Change any key

Click a key and pick what it does: a keypress with modifiers, a media key, a layer, another keymap or a macro. Changes apply right away.

Automation

Macros

A list of key taps, typed text and pauses that one key plays. Typed for your keyboard layout.

Settings that stay small

Double-tap timing, a short overlay when you lock a layer, the keymap and layer in the menu bar, and whether the helper starts at login.

Setup

It tells you what's missing

macOS wants three approvals. The status area says which one is next and opens the right place in System Settings. The setup guide shows every step.

Pause any time

One click, or Left Control + Left Option + Left Command + Escape from anywhere, and every key does what it normally does.

And the small things

Details that add up.

  • Emergency stop. Left Control + Left Option + Left Command + Escape pauses remapping from anywhere.

  • Lock a layer. Double-tap a layer key to stay on it. The menu bar and a short overlay show where you are.

  • Every Apple layout. The MacBook keyboard and the Magic Keyboard, in ANSI, ISO and JIS.

  • Several keymaps. One for coding, one for writing. Switch with a key.

  • Import and export. Your keymaps are one file. Take them to your next Mac.

  • Updates itself. Signed, notarized updates. Your setup and permissions stay.

Privacy

Your keystrokes stay on your Mac.

Read, remapped, gone

To remap your keys, KeyLayers reads them, which is why macOS asks for Input Monitoring. Each key is remapped the moment you press it. Nothing is logged, stored or sent anywhere.

No network, except updates

The only connection KeyLayers makes is the update check against its releases on GitHub. No accounts, no analytics, no telemetry. The source is on GitHub, MIT licensed.

Released under the MIT License.