A 6-key macropad with a rotary encoder and OLED display, built for Hackclub Blueprint.
A compact macropad with 3 programmable layers (Media, Gaming, Work), a rotary encoder for volume control, and an OLED display showing the current layer.
The case is 3D printed in 2 parts (Top + Bottom) and fits the PCB snugly with cutouts for all switches, the encoder, the OLED, and the USB-C port.
| Key | Function |
|---|---|
| K1 | Play / Pause |
| K2 | Previous track |
| K3 | Next track |
| K4 | Mute |
| K5 | Screenshot |
| K6 | Change Layer → Game |
Encoder: Volume Up / Down
| Key | Function |
|---|---|
| K1 | Mute mic |
| K2 | Push-to-talk |
| K3 | Clip gameplay |
| K4 | Open Discord |
| K5 | Open Steam |
| K6 | Change Layer → Work |
| Key | Function |
|---|---|
| K1 | Ctrl+C |
| K2 | Ctrl+V |
| K3 | Ctrl+Z |
| K4 | Alt+Tab |
| K5 | Open Run |
| K6 | Change Layer → Media |
Encoder: Scroll Up / Down
| Part | Quantity | Description |
|---|---|---|
| Seeed Studio XIAO RP2040 | 1 | Main microcontroller |
| MX-compatible switches | 6 | Mechanical key switches |
| EC11 Rotary Encoder | 1 | Volume / scroll knob |
| OLED Display 0.91" (I2C) | 1 | SSD1306, 128x32 |
| Keycaps (MX) | 6 | Any MX-compatible keycaps |
| PCB | 1 | Custom 2-layer PCB (67.5x57mm) |
| 3D Printed Case | 1 | Top + Bottom parts |
Built with KMK running on CircuitPython.
To flash:
- Install CircuitPython on the XIAO RP2040
- Copy the
kmkfolder to theCIRCUITPYdrive - Copy
firmware/main.pyto theCIRCUITPYdrive
Dineatriz — Hackclub Blueprint 2026