~/firmware

Keyboard Firmware

Every Parix keyboard ships with open-source firmware, pre-flashed and ready to type. Wired boards run QMK. Wireless boards run ZMK. Both are fully customisable.

Wired keyboards — QMK + Vial

All Parix wired keyboards run QMK with Vial enabled. Plug in, open the Vial app, and remap keys in real time. No flashing, no code.

Wireless keyboards — ZMK

All Parix wireless keyboards run ZMK with Bluetooth, mouse keys, and ZMK Studio enabled out of the box.

Totem

github.com/dieselsaurav/zmk-config-totem-studio

ZMK 4 (Zephyr 4.1). Miryoku-inspired 38-key layout with home row mods, vim-style navigation, 6 thumb-activated layers, full mouse emulation, 14 combos, and ZMK Studio support. Based on urob's tuning for home row mods and combos.

Corne Wireless

github.com/dieselsaurav/zmk-for-keyboards

ZMK config for the Corne wireless split keyboard with nice!nano v2. Supports nice!view and nice!OLED displays. ZMK Studio enabled on left half.

See each repo's README for the full keymap layout, layer maps, combo tables, and build configuration.

Customising your keymap

ZMK Studio (no flashing)

Plug the left half in via USB, open zmk.studio in Chrome, and connect. Remap keys, adjust layers, configure hold-taps — changes apply instantly and persist across reboots. Works over Bluetooth too.

Keymap Editor (visual, via GitHub)

Fork your keyboard's repo, then open Keymap Editor. It connects to your fork, gives you a visual drag-and-drop interface, and commits changes directly to GitHub. The build.yml Action compiles the firmware automatically.

Flashing a custom build

  1. Fork the repo on GitHub.
  2. Edit the .keymap file in config/.
  3. Push. GitHub Actions builds the firmware. No local toolchain needed.
  4. Download the .uf2 files from the Actions tab.
  5. Flash. Double-press reset on the controller. It mounts as a USB drive. Drag the .uf2 onto it.
  6. Flash both halves — left and right have separate .uf2 files.

Resources

  • ZMK Documentation — keymaps, behaviors, combos, macros
  • ZMK Studio — real-time keymap editor for wireless keyboards
  • Keymap Editor — visual ZMK keymap editor via GitHub
  • Vial — real-time keymap editor for wired keyboards

Need help? Email diesel.saurav@gmail.com.