4 layers234 × 84 mm
Main panel
google/mozc-devices
Circuit diagrams and firmware source code for Gboard DIY keyboards
234 parts3kApache-2.0
2 layers98.5 × 98.2 mm
Macropad
krypt0s231/MacropadFor the hackpad project (https://blueprint.hackclub.com/home) (https://hackpad.hackclub.com/)
- Size
- 98.5 × 98.2 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 50
- Nets
- 47
- Pads
- 208
- Tracks, vias
- 887, 149
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 26 Dec 2025
- Updated
- 30 Dec 2025
Overview
Macropad is an open-source printed circuit board by krypt0s231, from the krypt0s231/Macropad repository on GitHub. It is a 2-layer board of 98.5 × 98.2 mm with 50 parts on 47 nets, routed with 887 tracks and 149 vias.
It is built around the SK6812MINI-E. Its parts include 32 diodes, 16 switches, 1 IC and 1 connector. It belongs with the keyboards and input boards and the RP2040 boards of this library.
Main components
1README
README.mdKRYPT's Hackpad – Custom 4×4 KMK Macropad with OLED & RGB
A custom-designed 4×4 mechanical macropad built around the Seeed XIAO RP2040, featuring:
Matrix-scanned mechanical switches with diodes
SK6812 Mini RGB LEDs
0.91" OLED display
KMK firmware (CircuitPython)
PC-side system monitoring (CPU / RAM / GPU / Disk)
This project was designed as a DIY / competition-grade hackpad, from schematic → PCB → firmware → case.
Project Images
Schematic
PCB Layout
Case & Assembly
Hardware Overview
MCU: Seeed Studio XIAO RP2040
Switches: MX-style mechanical switches
Matrix: 4 Rows × 4 Columns with 1N4148 diodes
RGB: SK6812 Mini (NeoPixel compatible)
Display: 0.91" OLED (SSD1306, 128×32)
Power: USB-C
Pin Mapping
Matrix
Columns
COL0 → GPIO0
COL1 → GPIO27
COL2 → GPIO28
COL3 → GPIO29
Rows
ROW0 → GPIO3
ROW1 → GPIO4
ROW2 → GPIO2
ROW3 → GPIO1
Peripherals
RGB Data: GPIO26
OLED: I²C (default XIAO pins)
Firmware
Keyboard firmware: KMK (CircuitPython)
Features:
Matrix scanning
RGB underglow
OLED display
USB HID data input from PC
#The OLED displays:
CPU usage
RAM usage
GPU usage
Disk (C:) usage
System statistics are sent from a PC-side Python script over USB HID.
PC-side Software
A Python helper script runs on the host computer to:
Read system stats (via psutil, GPUtil)
Send data to the keyboard using HID
This architecture is similar to Stream Decks and professional macro pads.
Author
Designed and built by kryptos
License
Open-sourse
Parts
50| Qty | Value | Footprint | References |
|---|---|---|---|
| 16 | 1N4148 | Diode_THT:D_DO-35_SOD27_P7.62mm_Horizontal | D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, D16 |
| 16 | SK6812MINI | LED:MX_SK6812MINI-E_REV | D17, D18, D19, D20, D21, D22, D23, D24, D25, D26, D27, D28, D29, D30, D31, D32 |
| 16 | SW_Push | Button_Switch_Keyboard:SW_Cherry_MX_1.00u_PCB | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12, SW13, SW14, SW15, SW16 |
| 1 | Conn_01x04 | KiCad-SSD1306-0.91-OLED-4pin-128x32.pretty-master:SSD1306-0.91-OLED-4pin-128x32 | J1 |
| 1 | XIAO-RP2040-DIP | Seeed Studio XIAO Series Library:XIAO-RP2040-DIP | U1 |
Questions
How big is the Macropad PCB?
It measures 98.5 × 98.2 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Macropad use?
50 parts, built around the SK6812MINI-E. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Macropad KiCad files?
From the krypt0s231/Macropad repository on GitHub, at the commit this page was made from: the board is PCB/main.kicad_pcb and its schematic PCB/main.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Macropad design in my own project?
Its repository states no licence, so its author keeps all rights: ask krypt0s231 before reusing the design.
Similar boards
- 4 layers180.8 × 300.3 mm
Dilemma
Bastardkb/Dilemma
The Dilemma is a vertical stagger low-profile keyboard with mods.
383 parts590 - 4 layers48 × 32 mm
FlatSat
Pwnsat/FlatSat
Flatsat v1.0 is a hardware based platform for aerospace cybersecurity research
106 parts575GPL-2.0 - 2 layers
Demo
adamws/kicad-kbplacer
KiCad plugin for automatic keyboard's key placement and routing
48 parts547GPL-3.0 - 2 layers97 × 78.5 mm
Dumbpad
imchipwood/dumbpad
Simple 4x4 numpad with rotary encoder. Powered by QMK via ATmega32u4 Pro Micro
62 parts517GPL-2.0 - 4 layers82.5 × 39.4 mm
V4head
makerforgetech/modular-biped
An open source framework for creating a bipedal modular companion robot.
26 parts493GPL-3.0 - 2 layers115.7 × 95.7 mm
- 4 layers70 × 54 mm
