Getting Started

Setup in
5 minutes.

Your macropad arrives ready to use as a standard keyboard. To customise it with VIA — remapping keys, building macros, and setting up layers — just follow the steps below. No coding, no soldering, no firmware flashing needed.

VIA Setup Guide

Step-by-step

01

Plug in your macropad

Connect it to your computer via USB-C. It will work immediately as an input device — all default keys are pre-programmed and ready to use straight away.

02

Open VIA in Chrome or Edge

Go to usevia.app in Google Chrome or Microsoft Edge. VIA uses the WebHID API which is only supported in those two browsers — it won't work in Firefox or Safari.

💡 On macOS, you may be asked to grant Input Monitoring permission. This is normal — approve it in System Settings → Privacy & Security → Input Monitoring.
03

Authorize your macropad

Click the Authorize Device button and select your Desk Tech macropad from the popup list. VIA will connect to it and show your layout matching the number of keys your macropad has.

04

Start customising

Click any key on the layout and select a new function from the keycode panel. Changes save to the macropad instantly — your settings are stored in the firmware, not on the computer, so they follow the device everywhere.

💡 Use the Layers section to set up different profiles — for example, one layer for editing and another for gaming — and switch between them with a dedicated key.
Troubleshooting

Layout not recognised?

Sometimes VIA connects to your macropad but doesn't know what layout to display — this is normal and easy to fix. Follow the steps below to load the layout manually.

01

Download the VIA layout file

Download the JSON layout file for your macropad. This tells VIA what your keyboard looks like and how it's wired.

02

Load the layout file into VIA

In VIA, click the Settings tab (cog icon), then enable "Show Design tab". Go to the Design tab and click "Load" to import the keyboard.json file you downloaded.

💡 You only need to do this once — VIA remembers the layout for next time.
Compatibility

OS Support

🍎

macOS

Works great. May need Input Monitoring permission once.

Smooth
🐧

Linux

Works out of the box with no extra steps.

Smooth
🪟

Windows

Use Chrome or Edge with the JSON file. Works well.

Smooth