September 1, 2025
Description
A custom-built, handwired keypad powered by the RP2040 Pro Micro, running QMK + Vial firmware.
This project is designed for anyone who wants a compact, fully-programmable macropad for productivity, creative work, or gaming. With 12 mechanical switches, dual rotary encoders, and an OLED screen for layer display, it’s a versatile tool you can customize to your workflow.
Bill of Materials (BOM)
| Item | Quantity | Notes |
|---|---|---|
| RP2040 Pro Micro | 1 | Controller board |
| Mechanical switches (MX style) | 12 | Any preferred switch type |
| Keycaps | 12 | MX-compatible |
| Rotary encoders (EC11 or similar) | 2 | With push button |
| Rotary encoder knobs | 2 | Any style |
| OLED display (0.91", SSD1306, I2C) | 1 | Recommended size: 128×32 (0.91") |
| Diodes (1N4148 or SMD) | 12 | For matrix wiring |
| Wires (thin, flexible) | As needed | For handwiring |
| Soldering materials | – | Solder, iron, flux |
Default Keymap
Resources & Tutorials
QMK documentation – Firmware setup, compiling, and flashing
Vial Documentation – Live key remapping and layer management
Handwiring Guide by Bogus (RLH - Handwired customizeable macropad) – Wiring and assembly reference
License:
BY-NC-SA
justBlank
