Repository navigation
v2.5.0 — ZMK Studio over USB + Bluetooth (cormoran fork)
Live keymap editing via ZMK Studio over USB and Bluetooth, built on cormoran's ZMK-Studio fork. Hardware-verified on the Eyelash Sofle (nice!nano v2). The Studio web app lives in a separate project (#30); this release is firmware.
Highlights
- USB + BLE keymap editing — connect ZMK Studio over
/dev/ttyACM(CDC-ACM) or Bluetooth (GATT). BLE editing is the headline feature. - Encoder is web-configurable — switched to
runtime-sensor-rotate(volume by default) on all 8 layers; reassign it live in Studio. - Studio locking off (
CONFIG_ZMK_STUDIO_LOCKING=n) — no unlock key needed.
Under the hood
- ZMK →
cormoran/zmk@v0.3-branch+dya(v0.3 base) + 5 cormoran DYA modules;eyelash_soflepinned to dya commit4848e21f. - Board → shield migration: builds are now
-DSHIELD="eyelash_sofle_* nice_view";.uf2names and flash tasks unchanged. - Custom keymap (layers, HRM, gaming) otherwise untouched.
Memory budget (CI build, both transports compiled in)
| Build | Flash | RAM |
|---|---|---|
| Left (Studio + nice_view) | 51.5% | 41.9% |
| Right (nice_view) | 34.2% | 24.3% |
| Settings reset | 5.7% | 4.4% |
Flashing & use
- Flash:
mise run flash-release(download from CI) — or build locally withmise run build-flash. - Studio: connect the left half via USB, or pair over BT, then open the Studio app. On Linux, BLE editing needs Chrome's
chrome://flags/#enable-experimental-web-platform-featuresflag (Web Bluetooth) — not a firmware limitation. - Rollback:
mise run flash-releaseafter reverting, or reflash a prior release.
See PR #31 for full detail and the hardware verification log.