
Macro devboard ESP32
YingK8/ESP32-BLE-Macro-Pad
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.
Macro devboard quarq is an open-source printed circuit board by YingK8, from the YingK8/ESP32-BLE-Macro-Pad repository on GitHub. It is a 2-layer board of 59.4 × 71.6 mm with 58 parts on 114 nets, routed with 132 tracks and 39 vias.
It is built around the USBLC6-2SC6, 1N4148WT and 12402012E212A, with the 2450AT14A0100001T, ECS-320-8-37B-CKY-TR and PEC12R-4225F-S0024 among its other parts. Its parts include 19 capacitors, 10 diodes, 8 switches, 7 resistors and 3 inductors. It belongs with the microcontroller boards boards and the nRF52 and nRF5x boards of this library.
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.
| Component | Quantity |
|---|---|
| ESP32 Dev Board | 1 |
| Mechanical Keyswitches | 6 |
| Rotary Encoder | 1 |
| 1N4148 Diodes | 6 |
| Function | ESP32 Pin |
|---|---|
| Row 1 | GPIO 5 |
| Row 2 | GPIO 6 |
| Col 1 | GPIO 4 |
| Col 2 | GPIO 7 |
| Col 3 | GPIO 8 |
| Encoder A | GPIO 9 |
| Encoder B | GPIO 10 |
Edit the keymap in the source code:
const uint8_t keys[ROWS][COLS] = {
{MEDIA_PLAY, MEDIA_VOL_UP, MEDIA_VOL_DOWN},
{KEY_F13, KEY_F14, KEY_F15}
};
## Pomodoro UI + Task Sync (macro-pad/)
- Display: ST7789 240x280 SPI. Set pins in `macro-pad/include/Config.h`.
- Controls: top-left key toggles pause/resume; encoder rotation moves selection; top-right key (encoder click in matrix) checks/unchecks a task.
- Task payload: newline-delimited titles terminated by `--END--`.
CLI helper (requires `pip install bleak`):
```bash
python3 macro-pad/tools/push_tasks.py "Write report" "Review PRs"| Qty | Value | Footprint | References |
|---|---|---|---|
| 7 | 100nF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C17, C19, C20, C21, C22, C30, C32 |
| 7 | 1N4148WT | Diode_SMD:D_SOD-323F | D2, D3, D4, D5, D6, D7, D8 |
| 6 | MX_SW_HS | keyswitches:Kailh_socket_MX | SW1, SW2, SW6, SW7, SW8, SW9 |
| 3 | 100 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R6, R7, R11 |
| 3 | DNF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C25, C26, C31 |
| 3 | LED | LED_SMD:LED_0603_1608Metric_Pad1.05x0.95mm_HandSolder | D9, D10, D12 |
| 2 | 1uF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C16, C27 |
| 2 | 22 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R4, R5 |
| 2 | 5.1k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R1, R2 |
| 2 | 8pF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C33, C34 |
| 2 | SolderJumper_2_Open | Jumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mm | JP10, JP11 |
| 1 | 0.5pF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C24 |
| 1 | 0.6pF | Capacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolder | Z3 |
| 1 | 0.8pF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C23 |
| 1 | 10uH | Inductor_SMD:L_0603_1608Metric_Pad1.05x0.95mm_HandSolder | L2 |
| 1 | 12402012E212A | 12402012E212A:AMPHENOL_12402012E212A | J1 |
| 1 | 15nH | Inductor_SMD:L_0402_1005Metric_Pad0.77x0.64mm_HandSolder | L1 |
| 1 | 2450AT14A0100001T | AMCA31_2R450G_S1F_T3:XDCR_AMCA31-2R450G-S1F-T3 | E1 |
| 1 | 4.7nH | Inductor_SMD:L_0201_0603Metric_Pad0.64x0.40mm_HandSolder | L3 |
| 1 | 4.7uF | Capacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolder | C18 |
| 1 | 47nF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C28 |
| 1 | 7.5nH | Inductor_SMD:L_0402_1005Metric_Pad0.77x0.64mm_HandSolder | Z1 |
| 1 | 820pF | Capacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolder | C29 |
| 1 | Conn_02x13_Counter_Clockwise | Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_Vertical | J3 |
| 1 | DNF | Capacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolder | Z2 |
| 1 | ECS-320-8-37B-CKY-TR | ECS_320_8_37B_CKY_TR:XTAL_ECS-160-9-37-CKM-TR | Y3 |
| 1 | PEC12R-4225F-S0024 | PEC12R_4225F_S0024:XDCR_PEC12R-4225F-S0024 | S1 |
| 1 | RST | Button_Switch_SMD:SW_Tactile_SPST_NO_Straight_CK_PTS636Sx25SMTRLFS | SW4 |
| 1 | USBLC6-2SC6 | Package_TO_SOT_SMD:SOT-23-6_Handsoldering | U3 |
| 1 | nRF52840 | Package_DFN_QFN:Nordic_AQFN-73-1EP_7x7mm_P0.5mm | U1 |

YingK8/ESP32-BLE-Macro-Pad
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

YingK8/ESP32-BLE-Macro-Pad
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

YingK8/ESP32-BLE-Macro-Pad
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

YingK8/ESP32-BLE-Macro-Pad
A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.




da-penguin-guy/Proteus
The Proteus is a modular collection of PCBs that will be used to develop the Virgil sound Protocol

jsmnbom/esp-butt
A physical controller for intimate devices. No phone. No app. Just knobs, sliders, and hundreds of compatible toys.


ahkneipp/LightDriver
Control system for a strip of WS2811 LEDs; Quick and dirty

It measures 59.4 × 71.6 mm and has 2 copper layers, 1.6 mm thick.
58 parts, built around the USBLC6-2SC6, 1N4148WT, 12402012E212A and 2450AT14A0100001T. 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.
From the YingK8/ESP32-BLE-Macro-Pad repository on GitHub, at the commit this page was made from: the board is PCB/macro devboard quarq.kicad_pcb and its schematic PCB/Untitled.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask YingK8 before reusing the design.