Skip to content

Advanced features โ€‹

On a connected device, Remappr exposes the firmware's advanced behaviors and hardware settings โ€” each capability-gated, so a panel only appears when the board actually supports it.

๐Ÿ“ท Screenshot slot โ€” docs/public/images/editor/advanced-sheet.png

The Advanced sheet with its tabs (Tap Dance ยท Combo ยท Key Override ยท Alt Repeat ยท Macros).

The Advanced sheet โ€‹

Opened from the header (Dynamic Entries โ‡„ or Macros โœฆ). Tabs appear only when the device advertises that capability:

TabShown whenEdits
Tap Dancetap-dance count > 0Multi-tap behaviors (tap / hold actions, tapping term).
Combocombo count > 0Key chords โ†’ output.
Key Overridekey-override count > 0Remap rules with activation options.
Alt RepeatsupportedAlternate-repeat-key.
Macrosmacro count > 0Tap / down / up / delay / text sequences.

These map to the same concepts as the config's tapDances, macros and combos โ€” here you edit them live on the device (mostly VIA/Vial/Keychron).

Wireless settings โ€‹

The Wireless button (๐Ÿ“ถ) opens "Wireless Settings โ€” Power, NKRO & connection":

  • Status โ€” transport (usb/ble), BT slot, battery level / charging, wireless module.
  • Low-power mode โ€” Enable LPM, Timeout (ms), Save LPM.
  • N-Key Rollover โ€” Enable NKRO.
  • Danger zone โ€” Factory reset ("Reset all settings to factory defaults? This cannot be undone.").

Advanced Mode โ€‹

The Advanced Mode button (โ“˜) opens "Advanced Mode โ€” Debounce, report rate & key behaviour":

  • Debounce โ€” Response time slider (0โ€“80 ms) + raw Mode, Save debounce.
  • Report rate โ€” raw Value, Save report rate.
  • Snap-click โ€” Enable snap-click (rapid trigger).
  • N-Key Rollover โ€” Enable NKRO.
  • Quick Start โ€” note that auto-sleep / auto-backlight-off live in the Wireless panel.

Device controls โ€‹

  • Bluetooth profiles โ€” manage BT connection slots (ZMK / Keychron).
  • Lock / unlock โ€” see Connecting a device.
  • Restore Stock Settings โ€” from the device menu, resets to the stock keymap.

See also โ€‹

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