Inspiration: ZMK and the Cornish ZEN keymap
The keymap style comes from the owner's ZMK keyboard firmware work, in particular the configuration for the 42-key Corne-ish Zen (franken-cornish-zen: 31 layers, home-row mods, combos, Unicode, APL and Greek layers), and the header generator follows zmk_unicode_headers, which turns the Unicode database into named C macros the way GenerateHeaders.jsh turns the USB HID Usage Tables into kp_A and cp_MUTE.
| ZMK configuration | Nachtgespenst |
|---|---|
| FUN layer: F7 F8 F9 / F4 F5 F6 / F1 F2 F3, F10 on a thumb | The F1-F10 page has the same rows; F11 to F24 follow the same arrangement |
Plain, Hyper (LH) and Meh (LM) function layers | The same three families as pages (... HYP, ... MEH), written with lhyp() and lmeh() |
| KEYPAD, SYM1/SYM2, NAV, VOLUME/CONSUMER, APPL | Numpad Full, Symbol Pad, Edit/Nav, Media, App Launch |
| Home-row mods, combos, mouse, APL, logic, Greek and punctuation layers (Unicode) | Not carried over: a touch macro pad has no typing layer and HID has no Unicode |
| Fixed keycap colours and printed legends | The macro pad draws keycap colour and legend per tile and per page: colour by kind of key and by modifier, icons, captions and modifier badges |
| No application layers | New: Maven, Office, Teams, Outlook, PowerPoint, browser and debugger pages, and the Locks page |
The full comparison is in the wiki.
Since Claude joined
The project did not start with Claude Code. An earlier version of the firmware was made about a year before, with Gemini in its chat client (the Android app and the browser) and a little help from GitHub Copilot; its keymap style and its header generator come from the owner's ZMK work (see Inspiration). The history of this repository starts on 10 May 2026. On 12 November 2026 the project started working with Claude Code, with a project guide (CLAUDE.md), an overnight plan, and tests that drive the real hardware. The big steps:
- Before Claude Code (commits of 10 to 14 May 2026)Core2 BLE macro pad, layers and grids, LED bar, and the generator that turns the USB HID specification into C++ headers with a ZMK-style keymap; made with Gemini and some GitHub Copilot.
- 12 November: a new interface and a second boardLVGL 9 interface with icons and a Locks page; CoreS3 port; USB HID next to BLE; LED bar feedback; the serial protocol,
SerialTestand the first screenshots. - 13 November: hardeningA review of the HID code led to a non-blocking press queue with release retry, a proper USB-mounted check, BLE security without MITM, atomic LED state and a loop that sleeps instead of spinning.
- 17 November: project hygieneREADME, licence and third-party notices; decision records for the Claude Code sandbox, a project-local PlatformIO and pinned JDKs; the HUT download split into its own script.
- 17 and 18 November: routing, LED bars and camera testsSelectable USB/BLE routing with tests for every mode; the CoreS3 LED bar found and verified with a webcam;
LedCamand the pin finder; documentation and code comments in British English; this page, a changelog, and the classic interface branch.
The complete list is in the changelog.