Skip to the content
2 layers145 × 82 mmMacrpad2.0, the printed circuit board in 3D

A custom-built macropad featuring 9 programmable keys and 2 rotary encoders, designed for productivity, streaming, editing, and general automation.

Size
145 × 82 mm
Copper layers
2
Thickness
1.6 mm
Parts
17
Nets
29
Pads
89
Tracks, vias
268, 18
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
3 Jun 2026
Updated
25 Jun 2026

Overview

Macrpad2.0 is an open-source printed circuit board by minageorge183n, from the minageorge183n/esp32-macropad repository on GitHub. It is a 2-layer board of 145 × 82 mm with 17 parts on 29 nets, routed with 268 tracks and 18 vias.

Its parts include 11 switches, 2 resistors, 1 IC and 1 connector. It belongs with the radio and wireless boards and the ESP32 boards of this library.

README

README.md

🔘 ESP32 Bluetooth + WiFi Macropad

A custom-built macropad featuring 9 programmable keys and 2 rotary encoders, designed for productivity, streaming, editing, and general automation. It connects via Bluetooth for real-time input and WiFi for easy configuration through a web-based UI.


✨ Features

  • 🎹 9 Mechanical Keys Fully programmable keys that can send:

    • Keyboard shortcuts
    • Media controls
    • Text strings
  • 🔄 2 Rotary Encoders Each encoder supports:

    • Clockwise / Counterclockwise rotation
    • Push button click
  • 📡 Dual Connectivity

    • Bluetooth (BLE) → Acts as a wireless keyboard
    • WiFi → Hosts a configuration web interface
  • 🌐 Web UI Configuration

    • Access via browser (phone or PC)
    • Remap keys and encoders
    • No need to reflash firmware for changes

⚙️ How It Works

Bluetooth Mode

  • The macropad connects to your device as a BLE keyboard
  • Pressing keys sends predefined actions instantly

WiFi Mode

  • The device creates or connects to a WiFi network

  • You access a local web page hosted on the ESP32

  • From there, you can:

    • Change key mappings
    • Assign new actions
    • Save configurations

🚀 Getting Started

1. Power On

  • Connect the macropad via USB or battery
  • It will automatically start Bluetooth and WiFi services

2. Connect via Bluetooth

  • Pair it like a normal keyboard
  • Start using default key mappings

3. Access Web Interface

  • Connect to the same WiFi network (or device hotspot mode)

  • Open browser and go to:

    text
    http://<device-ip>
  • Configure keys and encoders from the UI


🧠 Key Mapping Capabilities

Each key can be configured to:

  • 🔹 Send a single key (e.g., A, Enter)
  • 🔹 Use modifiers (Ctrl, Alt, Shift)
  • 🔹 Trigger media actions (volume, play/pause)
  • 🔹 Type full strings (macros)

🎛️ Rotary Encoder Functions

Each encoder supports:

  • ↻ Rotate Left → Action 1
  • ↺ Rotate Right → Action 2
  • ⏺ Press → Action 3

Example uses:

  • Volume control
  • Timeline scrubbing
  • Zoom in/out

🛠️ Hardware Overview

  • ESP32 microcontroller
  • 9 mechanical switches
  • 2 rotary encoders with push buttons
  • Optional battery module

📌 Use Cases

  • 🎥 Streaming (OBS, shortcuts)
  • 🎨 Design (Photoshop, Illustrator)
  • 🎬 Video editing (Premiere, DaVinci)
  • 💻 General productivity
  • 🎮 Gaming macros

🔮 Future Improvements

  • Profiles switching
  • OLED display support
  • Cloud sync for configs
  • Mobile app companion

📄 Notes

  • Make sure Bluetooth is enabled on your device
  • Web UI works best on modern browsers
  • Keep firmware updated for new features

🤝 Contributing

This is a personal project, but ideas and improvements are always welcome.


📜 License


Parts

17
QtyValueFootprintReferences
9~mx1:SW_MX1A-11NNS1, S2, S3, S4, S5, S6, S7, S8, S9
2ResistorResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1, R2
2RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW1, SW2
1Conn_01x08_PinConnector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_VerticalJ1
1DEVKIT_V1_ESP32-WROOM-32snapmagic:MODULE_DEVKIT_V1_ESP32-WROOM-32U1

The 15 most common of 17 parts.

Similar boards

  • 2 layers50 × 35 mmServo power, the printed circuit board in 3D

    Servo power

    earthtojake/text-to-cad

    Design physical products with AI

    17 parts26kMIT
  • 2 layers139.7 × 62.2 mmBreakout 60pin EEC IV, the printed circuit board in 3D

    Breakout 60pin EEC IV

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    17 parts1.2k
  • 2 layers29.2 × 55.9 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

    17 parts1kGPL-3.0
  • 2 layers24.5 × 36.5 mmCluster, the printed circuit board in 3D

    Cluster

    JesusFreke/lalboard

    A 3D-printed keyboard inspired by the DataHand

    17 parts993
  • 2 layers56.3 × 55.7 mmStarNecklace, the printed circuit board in 3D

    StarNecklace

    hackclub/OnBoard

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

    17 parts915
  • 2 layers25 × 25 mmSmallEncoder, the printed circuit board in 3D

    SmallEncoder

    DDeGonge/OS-ARM

    This arm is not industrial and it will not be fast, but that is not my goal. But it will hopefully be a very nice looking arm fully capable of 6dof motion, cheap enough to keep it accessable but capable enough to…

    17 parts498MIT
  • 2 layers38.9 × 16.1 mmAmoeba spc, the printed circuit board in 3D

    Amoeba spc

    mtl/keyboard-pcbs

    Keyboard PCBs

    17 parts485
  • 2 layers36 × 51 mmABSIS ALE, the printed circuit board in 3D

    ABSIS ALE

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    17 parts431

Questions

How big is the Macrpad2.0 PCB?

It measures 145 × 82 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macrpad2.0 use?

17 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 Macrpad2.0 KiCad files?

From the minageorge183n/esp32-macropad repository on GitHub, at the commit this page was made from: the board is PCB/macrpad2.0.kicad_pcb and its schematic PCB/macrpad2.0.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macrpad2.0 design in my own project?

Its repository states no licence, so its author keeps all rights: ask minageorge183n before reusing the design.