VIA says "No devices found" — what do I do?
+
First, make sure you're using
Chrome or Edge — VIA doesn't work in Firefox or Safari. Then make sure you've loaded the
keyboard.json layout file via the Design tab in VIA. After that, click Authorize Device and select your macropad from the popup. If it still doesn't appear, try a different USB port or cable.
The macropad types fine but VIA doesn't detect it.
+
This usually means the layout JSON hasn't been loaded yet. In VIA, go to
Settings → enable "Show Design tab" → Design → Load and import the
keyboard.json file. Then try Authorize Device again.
Do my key remaps survive unplugging?
+
Yes. All changes are saved directly to the macropad's firmware memory (EEPROM). Your customisations travel with the device — plug it into any computer and everything is exactly as you left it.
How do I swap switches?
+
The PCB is hot-swap — no soldering needed. Use a switch puller (or gently lever with a keycap puller) to remove a switch, then press a new MX-compatible switch straight into the socket. It supports both 3-pin and 5-pin switches. Make sure the pins are straight before pressing in.
Can I use this on macOS?
+
Absolutely. macOS works great. You may see a system prompt asking for Input Monitoring permission when you first connect — just approve it in System Settings → Privacy & Security → Input Monitoring. This is a one-time step.
What's the difference between layers?
+
Layers let you have multiple key layouts on one macropad. For example, Layer 0 could be your video editing shortcuts, Layer 1 your gaming macros, and Layer 2 your music production controls. You assign a key to switch between layers — like a Shift key, but for your whole layout.
Can I reset everything to default?
+
Yes. In VIA, go to the Settings tab and use the reset/clear EEPROM option to wipe all custom mappings and restore the original firmware defaults.