Skip to the content
PCBKitNew board
2 layers80.1 × 76.5 mmHacker Macropad, the printed circuit board in 3D

A small and compact 3×4 programmable Macropad built around the Seeed XIAO RP2040, running on QMK firmware. Designed for programmers, terminal users, and automation — with layers for navigation, symbols, and macros.

Size
80.1 × 76.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
27
Nets
26
Pads
109
Tracks, vias
164, 2
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
22 Feb 2026
Updated
3 Mar 2026

Overview

Hacker Macropad is an open-source printed circuit board by Nitin-2468-dev, from the Nitin-2468-dev/Hacker-Macropad repository on GitHub. It is a 2-layer board of 80.1 × 76.5 mm with 27 parts on 26 nets, routed with 164 tracks and 2 vias.

It is built around the 1N4148WT. Its parts include 13 switches, 12 diodes, 1 IC and 1 connector. It belongs with the keyboards and input boards of this library.

Main components

1

README

README.md

Hacker Macropad

A small and compact 3×4 programmable Macropad built around the Seeed XIAO RP2040, running on QMK firmware. Designed for programmers, terminal users, and automation — with layers for navigation, symbols, and macros.


Overall Hackpad

Hackpad Overview


Schematic

Schematic

  • 3×4 key matrix (12 keys)
  • 1 diode per key (1N4148)
  • ROW2COL diode direction
  • Connected to XIAO RP2040 GPIO matrix

PCB Layout

PCB

  • Custom matrix routing
  • Through-hole tactile switches
  • XIAO RP2040 footprint
  • OLED header with a rotary encoder footprint
  • Compact square layout

Case & Assembly

Case

  • Two-piece enclosure
  • Top plate with switch cutouts
  • Bottom shell holds PCB & XIAO and other componets.
  • Corner screw mounting
  • Internal clearance for OLED + encoder

Features

  • 12 programmable keys (QMK)
  • RP2040 native USB
  • Multi-layer support
  • Coding symbol layer
  • Dev / terminal macro layer
  • NKRO enabled
  • Mouse key support (optional)
  • Reset-to-bootloader key
  • OLED + Encoder ready (optional)

Bill of Materials (BOM)

ItemQtyNotes
Seeed XIAO RP20401Main controller
Tactile / Mechanical Switch12Key switches
1N4148 Diodes12Matrix isolation
Custom PCB1design PCB
OLED Display (0.91"/0.96")1animation
Rotary Encoder1volume knob
M2 / M2.5 Screws4Case mounting
Standoffs4PCB mounting
Case (3D Printed)1Top + Bottom
image

Default Keymap (Programmer Layout)

Mode 1 — Navigation

  • Arrow keys
  • ESC / TAB / HOME / END
  • Modifier keys

Mode 2 — Coding Symbols

{ } [ ] ( ) | \ < >

Mode 3 — Dev Shortcuts

  • Ctrl+C / Ctrl+V / Ctrl+Z
  • Ctrl+S / Ctrl+F / Ctrl+R
  • Alt+Tab
  • Reset to bootloader

Firmware

Built using QMK Firmware

Compile

bash
qmk clean
qmk compile -kb hacker_macropad -km default

Flash (RP2040)

  1. Double-tap RESET on XIAO RP2040
  2. USB drive appears
  3. Copy .uf2 firmware file
  4. Done 🎉

About

Parts

27
QtyValueFootprintReferences
121N4148WTDiode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12
12SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12
1DisplayKiCad-SSD1306-0.91-OLED-4pin-128x32:SSD1306-0.91-OLED-4pin-128x32J1
1MOUDLE-SEEEDUINO-XIAOfootprints:XIAO-Generic-Hybrid-14P-2.54-21X17.8MMU1
1RotaryEncoderRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW13

Questions

How big is the Hacker Macropad PCB?

It measures 80.1 × 76.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Hacker Macropad use?

27 parts, built around the 1N4148WT. 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 Hacker Macropad KiCad files?

From the Nitin-2468-dev/Hacker-Macropad repository on GitHub, at the commit this page was made from: the board is pcb/Project.kicad_pcb and its schematic pcb/Project.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Hacker Macropad design in my own project?

Its repository states no licence, so its author keeps all rights: ask Nitin-2468-dev before reusing the design.

Similar boards

  • 2 layers181 × 97 mmOpenDeck r3.1.2, the printed circuit board in 3D

    OpenDeck r3.1.2

    shanteacontrols/OpenDeck

    A platform for building interactive control and sensing devices using MIDI and OSC built with Zephyr RTOS.

    262 parts960Apache-2.0
  • 2 layers255.9 × 99.3 mmZerosprey42, the printed circuit board in 3D

    Zerosprey42

    beekeeb/zerosprey42

    Zerosprey42 Keyboard is a wired, beginner friendly, choc hotswap, MonoBlockSplit (Unibody), column-staggered, DIY mechanical keyboard.

    96 parts140
  • 4 layers65 × 56.5 mmSH RPi, the printed circuit board in 3D

    SH RPi

    hatlabs/SH-RPi-hardware

    Sailor Hat for Raspberry Pi hardware design files

    168 parts56
  • 2 layers59.6 × 42 mmMacropad synthplug mk2, the printed circuit board in 3D

    Macropad synthplug mk2

    todbot/macropadsynthplug

    Turn StemmaQT port by into Audio Out + MIDI In

    43 parts53CC0-1.0
  • 4 layers47 × 39.5 mmStealthburner Toolhead PCB, the printed circuit board in 3D

    Stealthburner Toolhead PCB

    acha666/RP2040_ToolheadPCB_SB

    A Toolhead PCB for VORON StealthBurner based on RP2040

    145 parts43GPL-3.0
  • 2 layers271.8 × 103.9 mmHotswap ble, the printed circuit board in 3D

    Hotswap ble

    ebastler/cornholius

    ZMK-based replacement PCB for Cornelius keyboard

    146 parts37
  • 2 layers275.5 × 92 mmOlice, the printed circuit board in 3D

    Olice

    floookay/olice

    The olice is 40% alice-like ortho keyboard. It features two board extension modules that can be magnetically attached on the sides.

    115 parts33
  • 4 layers35.5 × 14.5 mmComplete v1.0, the printed circuit board in 3D

    Complete v1.0

    drpykachu/Sonar-Watch

    A self-designed, home-made watch intended to tell time in a funky and unique way!

    225 parts23