Remappr Docs

Appearance

RemapprOne universal keyboard manager.

Connect, remap, light up and build keyboards across firmwares — ZMK, QMK, VIA, Vial and Keychron today, more to come. One visual builder, one JSON config, every target.

Get started
Config reference
Open the app ↗
Remappr

The Builder

Lay out a board from a preset, KLE import, ortho grid or key-by-key. Wire the matrix, set the controller, pick firmware targets — all on one canvas.

Builder walkthrough

One JSON config

A single source-of-truth keymap.json. Write keys as bare strings or full action objects; the same file drives the live editor and every firmware export.

Keymap format

Multi-firmware export

Export & build emits a ready-to-push project per target — config + GitHub Actions workflow + README. Push it, download the .uf2/.hex, flash.

Export, build & flash

What lives here ​

Remappr has two newest, most powerful subsystems, both documented here:

  • The Builder — a full-screen visual tool for designing a keyboard from scratch: physical layout, matrix wiring, controller, lighting, layers and bindings.
  • The JSON keymap config — the generalized, firmware-agnostic document that is the single source of truth. One config file → per-firmware compilers → flashable projects.

If you want to change a keymap on a connected board, start with Getting Started. If you want to understand or hand-write the config, jump to the Config Reference. If you want to add a firmware target or hack on the compilers, see the Developer docs.

Apache-2.0. Originally forked from ZMK Studio; application layer fully rewritten.

Remappr