What is Remappr?
Remappr is a universal keyboard manager — one app to connect, remap, light up and build keyboards across firmwares. It supports ZMK, QMK, VIA, Vial and Keychron today, and is built to add more firmwares over time. The same React UI ships as a desktop app (Electron) and runs in the browser at remappr.com.
It does two things:
- Edit a keymap on a connected keyboard — connect over USB/serial, BLE or raw HID and remap keys, switch layers, manage Bluetooth profiles, and (on supported boards) paint per-key RGB — live, with no reflash.
- Build a keyboard from scratch — design the physical layout, wire the matrix, choose a controller and firmware targets, then export a ready-to-build firmware project.
Both flows share one JSON keymap config — a generalized, firmware-agnostic document that the live editor reads from, your edits write back into, and the exporter compiles per firmware.
Two ways to start
When you open Remappr you land on the Start Page, which offers two paths.
Connect a device
If you have a ZMK Studio-enabled, VIA/Vial or Keychron board, plug it in (or pair over Bluetooth) and pick it from the connection list. Remappr detects the firmware family and only shows the features that firmware actually supports (capability-gated UI). From there you are in the keymap editor.
- ZMK — USB/serial (CDC-ACM) or BLE. The board must have ZMK Studio enabled.
- QMK / VIA / Vial — raw HID via the VIA protocol.
- Keychron — VIA/QMK + a BLE radio, with the per-key RGB and wireless panels.
Create a keyboard
Click Create a keyboard to open the Builder — the full-screen design tool. You do not need any hardware connected; you can design a board, write its keymap, and export a buildable firmware project entirely offline.
Demo mode
No keyboard? Choose Try Demo Mode on the Start Page to explore the editor against a simulated 36-key Corne. It is the same config-driven flow as a real device — a good way to learn the editor before you connect hardware.
Where to go next
| You want to… | Read |
|---|---|
| Design a board from scratch | Builder overview |
| Lay out keys / wire the matrix | Building the layout |
| Set up layers and key bindings | Layers & bindings |
| Turn a design into firmware | Export, build & flash |
| Understand or hand-write the config | Config reference |
| See what's built vs planned | Roadmap |
| Extend the compilers | Developer docs |