

Macrpad2.0
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| Qty | Value | Footprint | References |
|---|---|---|---|
| 9 | ~ | mx1:SW_MX1A-11NN | S1, S2, S3, S4, S5, S6, S7, S8, S9 |
| 2 | Resistor | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R1, R2 |
| 2 | RotaryEncoder_Switch | Rotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW1, SW2 |
| 1 | Conn_01x08_Pin | Connector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_Vertical | J1 |
| 1 | DEVKIT_V1_ESP32-WROOM-32 | snapmagic:MODULE_DEVKIT_V1_ESP32-WROOM-32 | U1 |
The 15 most common of 17 parts.
Similar boards
- 2 layers50 × 35 mm

- 2 layers139.7 × 62.2 mm

- 2 layers29.2 × 55.9 mm

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 mm

- 2 layers56.3 × 55.7 mm

StarNecklace
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
17 parts915 - 2 layers25 × 25 mm

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 mm

- 2 layers36 × 51 mm

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.