2 layers47.6 × 27.3 mm
2 layers70 × 70 mm
Macropad breakout
BergerAPI/macropadMacropad Build files as presented in an associated video
- Size
- 70 × 70 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 27
- Nets
- 10
- Pads
- 59
- Tracks, vias
- 61, 4
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 8 Nov 2025
- Updated
- 8 Nov 2025
Overview
Macropad breakout is an open-source printed circuit board by BergerAPI, from the BergerAPI/macropad repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 70 × 70 mm with 27 parts on 10 nets, routed with 61 tracks and 4 vias.
It belongs with the keyboards and input and interfaces and adapters boards of this library.
README
README.mdMacropad
This project demonstrates how to build a simple macropad powered by a microcontroller using the same chip as the Raspberry Pi Pico (RP2040). You can use the files here to 3D print, assemble, and program your own version!
The video of the project was recorded using a custom microcontroller, which is not yet publicly available. However, you can safely use a Raspberry Pi Pico instead — it uses the same RP2040 chip, so all firmware and pinouts should work with minimal or no changes.
3D Model Notice
The included 3D model files are provided as-is. Before printing, you must adjust them to include proper tolerances (fit clearance) for your printer and switches — otherwise, parts may fit too tightly or loosely.
Requirements
- Microcontroller: Raspberry Pi Pico (or basically any microcontroller)
- Firmware: Included in this repository
- Switches & Keycaps: Any standard mechanical key switches
- 3D Printer: To print the enclosure and plate (or just order the parts like I did)
Optional:
- EEPROM chip — required for advanced features like changing macros on the fly like with QMK
⚠️ Note: The Raspberry Pi Pico does not have built-in EEPROM, so this functionality will be unavailable unless you add one externally.
Getting Started 🚀
- Print the enclosure and plate (remember to add tolerances). Assemble the hardware.
- Flash the firmware to your Pico (instructions in /firmware).
- Connect to your computer and enjoy your new macropad!
Open Licence
Feel free to play with the provided files and change them to your liking - I even encourage it.
Parts
27| Qty | Value | Footprint | References |
|---|---|---|---|
| 10 | Conn_01x01_Pin | TestPoint:TestPoint_Pad_4.0x4.0mm | J1, J2, J3, J4, J5, J6, J7, J8, J9, J10 |
| 9 | MX_SW_solder | PCM_marbastlib-mx:SW_MX_1u | MX1, MX2, MX3, MX4, MX5, MX6, MX7, MX8, MX9 |
| 4 | MountingHole | MountingHole:MountingHole_3mm | H1, H2, H3, H4 |
| 1 | LOGO | Graphics:test | G*** |
The 24 most common of 27 parts.
Questions
How big is the Macropad breakout PCB?
It measures 70 × 70 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Macropad breakout use?
27 parts. 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 breakout KiCad files?
From the BergerAPI/macropad repository on GitHub, at the commit this page was made from: the board is macropad_breakout.kicad_pcb and its schematic macropad_breakout.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Macropad breakout design in my own project?
Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).
Similar boards
- 2 layers77.4 × 77.4 mm
CORAZON LEDS CON FADE
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
27 parts915 - 2 layers44.2 × 29.3 mm
- 2 layers40 × 40 mm
- 2 layers22 × 42 mm
Nvme bm to e
CRImier/MyKiCad
My KiCad boards. Can't be bothered uploading individually anymore, so here you go.
27 parts253GPL-3.0 - 2 layers80 × 61 mm
PicoProducer
pjgpetecodes/pico-streamdeck
This project is an OBS Controller using a Raspberry Pi Pico and CircuitPython.
27 parts230MIT - 2 layers186 × 45 mm
AddOnD
freeDSP/freeDSP-aurora
freeDSP ADAU1452 with 8 analog input, 8 analog outputs, S/P-DIF I/O, ADAT I/O, USB Audio Class2, WiFi, Bluetooth
27 parts226CC-BY-SA-4.0 - 2 layers29.6 × 40.6 mm
Dbwifi revB
ugcs/ddc
Drone Show Software is software designed for drone shows, allowing flight path planning as well as control of dozens of drones simultaneously in a synchronized manner.
27 parts223