Open-source mechanical macropad — rev. V5, 2026
Starboard
A compact six-key macropad with a rotary encoder, OLED and addressable RGB — designed entirely around kit parts and a Seeed XIAO RP2040.
XIAO RP2040 / QMK / KiCad / 3D-printed enclosure
drag to rotate · scroll to zoomHardware
01- 01
Switches
Six MX-style switches on a 3×2 matrix with 1N4148 through-hole diodes.
- 02
Encoder
EC11 rotary with push-switch — volume by default, lighting on the FN layer.
- 03
Display
0.91-inch 128×32 SSD1306 OLED over I²C, showing layer and device name.
- 04
Lighting
Six SK6812 MINI-E addressable LEDs, edge-mounted for diffused underglow.
- 05
Controller
Seeed XIAO RP2040, dual-core with native USB-C and no extra support parts.
- 06
Firmware
QMK with layers and encoder maps; a prebuilt UF2 is ready to flash.
Specifications
02- Board
- 63.0 × 63.0 mm
- Layers
- 2
- Enclosure
- 83.8 × 83.8 × 18.5 mm
- Controller
- Seeed XIAO RP2040
- Inputs
- 6 keys + encoder
- Lighting
- 6 × SK6812 MINI-E
- Display
- 0.91-in 128×32 OLED
- Fasteners
- 4 × M3×16 / heatset
Default keymap
03⏯
vol −/+Esc
↑
Mute
←
↓
→
filled key = FN (hold)
- Encoder turn
- Volume down / up
- Encoder press
- Play / pause
- FN layer
- RGB toggle, mode, hue / sat / val, and QK_BOOT
- OLED
- Shows the active layer and device name
Design files
04Click any figure to enlarge
Bill of materials
05| Component | Qty |
|---|---|
| Seeed XIAO RP2040 | 1 |
| MX-style mechanical switch | 6 |
| Blank DSA keycap | 6 |
| EC11 rotary encoder, 20 mm D-shaft | 1 |
| 0.91-inch 128×32 OLED display | 1 |
| SK6812 MINI-E RGB LED | 6 |
| 1N4148 through-hole diode | 6 |
| M3×16 mm screw | 4 |
| M3×5×4 mm heatset insert | 4 |