Controller Works Documentation





The easiest way to customize your keyboard is to use the pre-loaded firmware and apply a custom keymap using the Via app.

Another option is to load custom firmware.

Pre-Loaded Firmware

The mini42 comes with an official build of QMK Via firmware pre-installed. Follow these steps to view and edit your keymap using the Via application.

  1. Plug your keyboard into your computer or other host system.
  2. Navigate to using a web browser such as Chrome or a browser based on Chrome with HID support (this allows the web app to communicate directly with your keyboard).
  3. Press Authorize Device +. A dialog should appear with Controller Works mini42 listed. Select that device and press Connect. The mini42 keymap should appear.
  4. Select the layer in the upper right quadrant of the app. Layers are sets of keyboard functions that are accessible through shifting the keyboard to that layer, similar to standard shift keys. The different key categories are listed in the lower left quadrant. There are many ways to access different layers. A good starting point is Fn1(Fn3) and Fn2(Fn3). These will select layer 1 and layer 2 if held down individually, and layer 3 if held down together. Make sure the same keys in the upper layers are set to KC_TRNS or the downward facing triangle .


Enter the bootloader in 3 ways:

Pre-Built Firmware

Get into bootloader mode (see above). The keyboard will appear as a USB drive on your host machine. Drag one of the .UF2 files below onto the USB drive. Plug the USB into the other half of the keyboard and repeat the process.

mini42 default firmware Via uf2 file Use this if in doubt Works with Via app

mini42 default firmware Vial uf2 file Works with Vial app

Build Your Own Firmware (Advanced)

The mini42 is officially supported in QMK. Please follow these instructions to build and customize your own firmware for the mini42.

The mini42 is also supported in the Vial fork of QMK. Please follow these instructions for using and customizing Vial.