Skip to content

v2.5.0 — ZMK Studio over USB + Bluetooth (cormoran fork)

Choose a tag to compare

@rdlu rdlu released this 25 Jun 12:33
· 105 commits to main since this release

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_sofle pinned to dya commit 4848e21f.
  • Board → shield migration: builds are now -DSHIELD="eyelash_sofle_* nice_view"; .uf2 names 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 with mise 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-features flag (Web Bluetooth) — not a firmware limitation.
  • Rollback: mise run flash-release after reverting, or reflash a prior release.

See PR #31 for full detail and the hardware verification log.