sofleii

ZMK firmware for the Eyelash Sofle split keyboard, plus a planned Rust/ratatui CLI/TUI.

Docs · Keymap (PDF) · Releases · Roadmap (#44)

Warning

Personal configuration — use at your own risk. Releases are experimental and built for one specific keyboard. Key layout, timing, and layer assignments are tuned to personal preference and may change without notice. If you have the same hardware, feel free to use this as a starting point, but do not expect a stable or general-purpose firmware.

Original hardware by 380465425@qq.com · vendor repo a741725193/zmk-sofle (original README, 3D case model); see Hardware.

Every layer, with its own page and key grid: sofleii.dlu.one/keymap.

Highlights

• v3.0.0 on ZMK main / Zephyr 4.1 (cormoran's main+dya fork), nice!nano v2 + nice!view on both halves.
• 9 layers: BASE, NAV, CODE, MEDIA, SYS|NUM, the GAME? picker and three game layers (MINECRFT, GAME, NOMANSKY).
• Home-row mods with an opposite-hand rule and a faster index-finger Shift; AltGr on a right-thumb mod-tap.
• Gaming layers with no hold-taps at all: pick one from SYS|NUM, leave with the two top corners.
• Per-layer underglow from the in-repo zmk-rgb-layer module: BASE moods, master brightness, remembered across reboots.
• Studio live keymap editing on the left half, over USB and Bluetooth.
• Soft off: hold Q+S+Z for 2 seconds.

Quick start

Flash a release (needs mise and an authenticated gh; double-tap reset on each half when asked):

mise run flash-release

On a major upgrade, flash the settings reset first (mise run flash-release-reset), see Upgrading to v3. Flashing without mise: Flashing.

Build locally (Arch Linux; full guide in Building):

mise run setup                              # once: west workspace + Python deps
mise run doctor                             # workspace matches config/west.yml?
mise run build-left && mise run build-right

Docs site (Hugo, from site/):

mise run docs                               # http://127.0.0.1:1313/

sofleii CLI/TUI

Planned, not released: a Rust/ratatui CLI and terminal UI for split and connection status, BLE profiles, battery, firmware update checks and the flash and build routines, over the Studio RPC protocol. Tracked in #44; see sofleii.

More

• Memory budget per half: Firmware reference.
• Window-manager keybinds (niri, GNOME, COSMIC) for the NAV layer: WM_KEYBINDS.md.

License

MIT, see LICENSE. Third-party parts keep their own licenses: the vendored Hextra theme, FlexSearch and fonts under site/, files with their own SPDX headers, the ZMK-derived physical layout (MIT), and keymap_drawer.config.yaml; LICENSE lists them all.