Skip to the content
PCBKitNew board
2 layers63.6 × 42.5 mmMacroboard v2, the printed circuit board in 3D

4-Key Macroboard V2 with Rotary Encoder | Customizable via QMK | Includes PCB, BOM, 3D Model & Gerber Files

Size
63.6 × 42.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
15
Nets
21
Pads
82
Tracks, vias
161, 15
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
21 May 2025
Updated
2 Jun 2025

Overview

Macroboard v2 is an open-source printed circuit board by MoeezAnwar, from the MoeezAnwar/Macroboard-v2 repository on GitHub, published under the MIT licence. It is a 2-layer board of 63.6 × 42.5 mm with 15 parts on 21 nets, routed with 161 tracks and 15 vias.

Its parts include 5 switches, 4 resistors, 4 diodes, 1 IC and 1 transistor. It belongs with the RP2040 boards of this library.

README

README.md

🧠 Macroboard v2 — Compact 4-Key Mechanical Macro Pad with Rotary Encoder

Macroboard Render

Macroboard v2 is a compact, hot-swappable 4-key mechanical macro pad featuring a high-quality rotary encoder, designed by Moeez Anwar. It’s perfect for streamlining workflows, creative shortcuts, and gaming macros. This open-source project includes full PCB design, schematics, 3D models, and all necessary files to build your own Macroboard.


📦 Repository Structure

Folder/FileDescription
Macroboard-v2.kicad_schElectrical schematic designed in KiCad.
Macroboard-v2.kicad_pcbPCB layout file.
Macroboard-v2.step3D STEP model of the assembled macro pad with components.
Macroboard-v2.csvBill of Materials (BOM) including part prices and sources.
Gerber/Complete Gerber files ready for PCB fabrication.
3d Model/STL and STEP files for 3D-printable case/enclosure.
AutoDesk Project File/Fusion 360 project files for case customization.
images/Photos, renders, and other visual references.
JOURNAL.mdDevelopment and design notes.
.gitignoreGit ignore file.
README.mdThis document.

🧰 Features

  • ✅ 4 Mechanical Keys — Minimalist layout for essential macros.
  • ✅ Rotary Encoder — Smooth, precise control for volume, scrolling, or custom functions.
  • ✅ Kailh Hot-Swap Sockets — Easily swap switches without soldering.
  • ✅ MX-Style Switch Compatible — Supports all Cherry MX-style switches.
  • ✅ USB-C Connector — Modern, reversible connection interface.
  • ✅ QMK / VIA Firmware Compatible — Full programmability and customization.
  • ✅ Open Source Hardware & Software — Full transparency and freedom to customize.

🛠️ Bill of Materials (BOM)

The full BOM is detailed in Macroboard-v2.csv, including:

  • Kailh hot-swap sockets
  • Recommended switches (e.g., Kailh Speed Pro Heavy / Super Speed)
  • Rotary encoder (e.g., DCR_PEC12R-4015F-S0024)
  • LEDs (SMD 1206 package)
  • NPN transistors (SOT-23 package) for LED control
  • SMD resistors (0603 package)
  • Microcontroller and USB-C connector (not included in the repo)

Prices and supplier info included.


🖨️ 3D Printed Case

Included are 3D-printable case files located in the 3d Model/ and AutoDesk Project File/ folders. The case is designed to protect the PCB and provide a sleek, ergonomic enclosure.


📤 Manufacturing Instructions

  1. Upload the Gerber files in the Gerber/ folder to your PCB manufacturer of choice (e.g., JLCPCB, PCBWay).
  2. Select 1.6mm FR4, 2-layer PCB, HASL finish.
  3. Order and wait for delivery.
  4. Assemble components following the schematic and BOM.

🧪 Getting Started

  1. Clone the repository:
    bash
    git clone https://github.com/MoeezAnwar/Macroboard-v2.git
    cd Macroboard-v2

Open and edit the project in KiCad 7+.

Program the microcontroller with QMK or compatible firmware to customize key mappings and encoder behavior.


✍️ Author

Moeez Anwar
Founder, Flurryhost
LinkedIn


🛡️ License

Open source under the MIT License. Feel free to use, modify, and share with credit.


🙏 Acknowledgments

Thanks to the KiCad community and open hardware advocates for enabling projects like this.


Share your builds and improvements! Contributions and issues are welcome.

Parts

15
QtyValueFootprintReferences
468RResistor_SMD:R_0603_1608MetricR1, R2, R3, R4
4LEDLED_SMD:LED_1206_3216MetricD1, D2, D3, D4
4SW_DIP_x01MX Switch Hot Swapable:Kailh_socket_MXSW5, SW6, SW7, SW8
1PEC12R-4015F-S0024PEC12R-4015F-S0024 Rotary Encoder:XDCR_PEC12R-4015F-S0024S2
1Q_NPN_BECTransistor:SOT-23Q2
1XIAO-RP2040-DIPOPKL:XIAO-RP2040-DIPU1

Questions

How big is the Macroboard v2 PCB?

It measures 63.6 × 42.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macroboard v2 use?

15 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 Macroboard v2 KiCad files?

From the MoeezAnwar/Macroboard-v2 repository on GitHub, at the commit this page was made from: the board is Macroboard-v2.kicad_pcb and its schematic Macroboard-v2.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macroboard v2 design in my own project?

Its repository publishes it under the MIT 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 layers19 × 76 mmSub, the printed circuit board in 3D

    Sub

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    15 parts3kApache-2.0
  • 2 layers26.7 × 62.2 mmDeniseadapter, the printed circuit board in 3D

    Deniseadapter

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    15 parts1kGPL-3.0
  • 2 layers100 × 44 mmVideoslot, the printed circuit board in 3D

    Videoslot

    mntmn/amiga2000-gfxcard

    MNT VA2000, an Open Source Amiga 2/3/4000 Graphics Card (Zorro II/III), written in Verilog

    15 parts1k
  • 2 layers91 × 51 mmBusinessCard, the printed circuit board in 3D

    BusinessCard

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    15 parts915
  • 2 layers24.3 × 57.9 mmFlosspods pro flex, the printed circuit board in 3D

    Flosspods pro flex

    kenp-io/not-for-airpods-repairs

    The content of this repository is licensed under the WTFPL License. Please have a close look at the terms before using this material.

    15 parts609WTFPL
  • 2 layers20.3 × 15.2 mmL0 Load, the printed circuit board in 3D

    L0 Load

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    15 parts546MIT
  • 2 layers68 × 50 mmEleLab v2 PowerFeed, the printed circuit board in 3D

    EleLab v2 PowerFeed

    Chrismettal/EleLab_v2

    Cheap DIY lab system for hobbyists and the tinkering folk

    15 parts531GPL-3.0
  • 2 layers50.8 × 35.6 mmInterface, the printed circuit board in 3D

    Interface

    harbaum/I2C-Tiny-USB

    Cheap and simple I²C to USB interface

    15 parts454