Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.


A 3x3 handwired macropad


The VOID9 is a 3d printed, handwired, 4x4 macropad running QMK Firmware on a Pro Micro controller.

I suggest printing the case using a 0.4 mm nozzle, supports are not needed for any of the parts.

You might want/need to use small dabs of hot glue to secure the switches in the plate depending on how well calibrated your printer is(if you're generous with it, it will add to the weight of the keyboard and it might change the feel of it).

Dont overtighten the screws as the threads might get stripped.


The pins mentioned in the VOID9 handwiring guide are incorrect; they've been recently swapped: use the column pinout mentioned below instead (pins D1, D4, D0), or if you have an older build of the macropad (which was using pins D1, D0, D4) edit the info.json file in the qmk fork in order to reflect your wiring!

Bill Of Materials

  • 3d printed case parts
  • 9 x Cherry MX style mechanical switches
  • 9 x diodes (
  • 9 x keycaps of choice
  • 1 x Pro Micro (Aliexpress)
  • 0.5 mm wire
  • hotglue
  • 4 x M3x10 Allen head bolts ( / 13mm overall length, 5,5mm diameter head)
  • 4 x 8mm bumpons

Handwiring guide

I've also put together a pretty visual handwiring guide for the VOID9, that you can browse over here.

Pin assignment

ROW0    ROW1    ROW2
F4      F5      F6

COL0    COL1    COL2
D1      D4      D0

Encoder Pad A           Encoder Pad B
B1                      F7
B2                      B3

QMK Vial Fork

A QMK Vial fork can be found here.

Most features are disabled in order for the firmware to fit on the atmega32u4 present on the Pro Micro controllers, but if you want to tinker around with different features or if you're using a different MCU you can enable/disable them to suit your own needs by editing the file in the vial keymap folder.

The web version of Vial is available at; it runs in supported browsers (Chrome, Edge and Opera) without requiring an installation.

VOID9 Vial

QMK Fork

A fork containing the QMK config files can be found here. Edit them to suit your own needs and build the firmware following the QMK docs.

If you plan on using the VIA configurator dont forget to download the json definitions file linked in this repository.

License: CC BY-NC-SA 4.0

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.


A 3x3 handwired macropad, running QMK firmware






No releases published


No packages published