Split-keyboard ergonomics on a stock MacBook, in one Karabiner-Elements config. The right hand moves a column over, the home row becomes modifiers and four hold layers, and 30 keys you should stop reaching for are switched off.
The same keymap ships in two forms, and they are kept identical:
| Where it runs | What it is | |
|---|---|---|
karabiner/ |
the MacBook's built-in keyboard | one karabiner.json, no firmware |
qmk/ |
a ZSA Voyager | QMK firmware, so the layout travels with the board |
Learn it once on the laptop, plug in the split, same fingers do the same things.
|
This project is sponsored by PCBWay, a one-stop shop for PCB prototyping, assembly, CNC machining and 3D printing. For the project background, ordering walkthrough and planned hardware coverage, see Sponsor below for what they offer. |
Each layer is drawn twice: the MacBook deck first, then the Voyager. The small grey legend in the corner of each cap is what is printed on the laptop key it stands for; the big legend is what the key actually does.
There is also an interactive version of the laptop diagrams — open it and press keys on your own keyboard to light up the matching cap, or hold Space and a layer key to preview a layer live.
Inspired by @getreuer's QMK keymap, which is the reference for what a well-documented personal keymap looks like.
A laptop keyboard has no thumb cluster and no layer keys, so the usual QMK tricks do not port over directly. This config works around that with three moves:
- Everything worth reaching for moves onto the home row. Numbers, symbols and arrows live on hold layers, not on the number row.
- Space and Right Command become gates. Hold either one and that hand's home row turns into modifiers and layer keys. Let go and it is plain letters again — so there are no accidental mod-taps while typing at speed.
- The keys you should stop using are disabled. The number row,
esc,tab,delete,caps lock,return, Left Control, Left Option, the arrow cluster and the four alpha keys between the hands do not do their job any more.
The Voyager has real thumb keys, so it does not need any of the workarounds — but it runs them anyway, so both boards feel identical.
PCBWay sponsors this project. They offer PCB prototyping and assembly alongside CNC machining, sheet metal fabrication, injection moulding and 3D printing. For keyboard builders, those services provide options for custom electronics, plates, enclosures and mounts.
Splitmac currently provides software for a MacBook and the commercial ZSA Voyager. This repository does not yet document a PCBWay-manufactured part.
The PCBWay project write-up covers the project background, an ordering walkthrough, the planned unboxing and measurement coverage, the final application, and the benefits of PCBWay's services. Actual order screenshots, part photographs and inspection results are pending; the write-up identifies what is still needed.
If you use them, say hello from splitmac.