

A hardware macro-pad designed from scratch to provide physical control over Spotify and computer audio. This project features mechanical keyswitches, a rotary encoder for volume tracking, and an integrated display for…
- Size
- 99.8 × 94.5 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 21
- Nets
- 77
- Pads
- 129
- Tracks, vias
- 205, 23
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 26 Jun 2026
- Updated
- 24 Aug 2026
Overview
Pulse is an open-source printed circuit board by thatSilentGamer, from the thatSilentGamer/pulse repository on GitHub. It is a 2-layer board of 99.8 × 94.5 mm with 21 parts on 77 nets, routed with 205 tracks and 23 vias.
It is built around the ESP32-WROOM-32 and SK6812MINI-E. Its parts include 5 resistors, 4 capacitors, 3 switches, 2 diodes and 2 connectors. It belongs with the ESP32 boards of this library.
Main components
2ESP32-WROOM-32
SMD,18x25.5mm-40℃~+85℃ -98dBm 2.4GHz 2.7V~3.6V 20dBm Bluetooth4.2 ESP32-DOWDQ6 UART、SDIO、SPI、I2C、GPIO、PWM、ADC、DAC SMD,25.5x18mm WiFi Modules ROHSEspressif SystemsWiFi ModulesSK6812MINI-E
SMD-40℃~+85℃ 0.6mA 1.78mm 120mcd~240mcd 120° 160mcd~320mcd 1kHz 2.8mm 2000V 3.2mm 3.7V~5.5V 460nm~470nm 515nm~525nm 620nm~625nm 800Kbit/s 815mcd~1275mcd Semi-transparent lens SMD RGB LEDs(Built-in IC) ROHSOPSCO OptoelectronicsRGB LEDs(Built-In IC)
README
README.mdCustom ESP32-S3 Spotify Controller Macro-Pad
A hardware macro-pad designed from scratch to provide physical control over Spotify and computer audio. This project features mechanical keyswitches, a rotary encoder for volume tracking, and an integrated display for media status.
Project Overview
What It Is
This is a compact hardware macro-pad designed as a Spotify Controller. It features two Cherry MX2A Speed Silver switches for skipping tracks or pausing music, an EC11 rotary encoder for volume scrolling, and a TENSTAR ROBOT 1x9 Pin SPI Display tilted at an angle to show track info.
Why I Made It
I engineered this controller to bridge digital media apps with hardware. The goal was to build a dedicated desktop tool that lets me control music instantly without switching windows.
How It Works
- Media Switches: The Cherry MX2A Speed Silvers are soldered directly to a custom PCB, passing through a top case layer for stability.
- Volume Encoder: Provides a rotating dial interface to control system volume or track scrolling, and it has an integrated click-switch.
- Display Output: The sequential 1x9 pin header channels hardware SPI communication straight from the ESP32-S3 Mini, enabling graphics for media feedback.
- Power & Control: Fully powered and controlled via a USB-C connection driven by the ESP32-S3 Mini processor.
Project Gallery
Mechanical & CAD Design
Click here to view the Onshape 3D CAD Assembly & Source Files
The case is a two-part shell (top piece and bottom base) that is secured together using M2/M3 mechanical screws through internal mounting standoffs that align with the PCB's mounting holes (H1–H4). This ensures a rigid, durable enclosure that holds the electronics firmly in place without relying on friction, tape, or glue.
- Material Clearances: The switch holes are slightly larger than they need to be so that they don't get stuck if the 3D print shrinks or over-extrudes a bit.
- Flush Screen Housing: The angled part for the screen meets the flat top completely flush so there isn't a weird lip sticking out.
- Vertical Component Stack: The case is deep enough so the pins on the bottom of the PCB don't hit the bottom of the shell.
Build Guide & Instructions
1. Bill of Materials (BOM)
| Item Name | Size / Specs | Quantity | Cost (Each) | Total Cost | Purchase Link |
|---|---|---|---|---|---|
| ESP32 | 38pin type c | 1 | $8.80 | $8.80 | AliExpress Link |
| Cherry MX2A Speed Silver 45g Linear Switch | PCB RGB LED | 2 | $0.40 | $0.80 | Mechanical Keyboards Link |
| EC11 w/ Push Button (rotary encoder) | 20mm Plum handle | 1 | $0.96 | $0.96 | AliExpress Link |
| Encoder Knob | O 20x13mm | 1 | $0.99 | $0.99 | AliExpress Link |
| TFT Display | 3.5 inch | 1 | $0.99 | $0.99 | AliExpress Link |
| WS2812 LED Light strip | 1m | 1 | $0.99 | $0.99 | AliExpress Link |
| Shine-through keycaps | Black-97 | 1 | $8.35 | $8.35 | AliExpress Link |
| USB-C Cable | 100W Black | 1 | $5.28 | $5.28 | AliExpress Link |
| 22AWG Electric Wire | 25m | 1 | $0.99 | $0.99 | AliExpress Link |
| Resistor Set | 300pcs in box | 1 | $3.37 | $3.37 | AliExpress Link |
| Capacitor Set | n/a | 1 | $2.05 | $2.05 | AliExpress Link |
| Electrolytic Capacitor | 10V1000UF 20PCS | 1 | $0.99 | $0.99 | AliExpress Link |
| Brass Heatset inserts | M2, M2.5, M3 (500PCS) | 1 | $1.59 | $1.59 | AliExpress Link |
| M2 Screws | 482pcs M2 | 1 | $0.99 | $0.99 | AliExpress Link |
| M3 Screws | 392pcs M3 | 1 | $0.99 | $0.99 | AliExpress Link |
| 3D Printing | n/a | 1 | $10.00 | $10.00 | n/a |
| SK6812 MINI-E RGB lights | 100PCS | 1 | $0.99 | $0.99 | AliExpress Link |
| Total Cost: | $48.72 |
2. PCB & Wiring Layout
- The project utilizes a custom printed circuit board designed in KiCad (source files located in
/Electronics). - Switches: Solder the Cherry MX2A Speed Silver switches into the footprint designated on the top side of the board.
- Encoder: Mount and solder the EC11 rotary encoder into position
SW1. - Display: Connect the 1x9 Pin SPI Display header directly to
J1, which routes hardware SPI pins from the ESP32-S3 WROOM module. - Mounting: Use M2/M3 mechanical screws through standoffs
H1–H4to secure the soldered PCB firmly inside the 3D-printed bottom shell.
3. Firmware & Flashing Instructions
- Download and install the Arduino IDE along with the ESP32 board definitions and required libraries (
TFT_eSPI,BleKeyboard,ESP32Encoder, andFastLED). - Open
/Firmware/pulse.inoin your IDE. - Connect the ESP32-S3 to your computer via USB-C.
- Select ESP32S3 Dev Module as your target board and select the correct COM port.
- Click Upload to compile and flash the firmware onto the microcontroller.
4. Usage Guide
Once flashed and powered via USB-C, Pulse will boot up and display "Pulse is online." on the screen while lighting up the green underglow.
- Pairing: Open your computer or phone's Bluetooth settings and pair with the device named "Pulse Controller".
- Volume Control: Turn the rotary encoder knob clockwise to increase system volume, and counter-clockwise to decrease volume.
- Play/Pause: Press down on the rotary encoder knob (integrated click switch) to toggle media play/pause.
- Track Navigation: Press the left Cherry MX switch (
BTN_SKIP_BCK) to jump to the previous track, or the right switch (BTN_SKIP_FWD) to skip to the next track on Spotify!
Parts
21| Qty | Value | Footprint | References |
|---|---|---|---|
| 5 | 10k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal | R1, R2, R3, R4, R5 |
| 4 | MountingHole_Pad | MountingHole:MountingHole_2.2mm_M2_Pad_Via | H1, H2, H3, H4 |
| 3 | 100nF | Capacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mm | C1, C2, C4 |
| 2 | SK6812MINI | LED Lib:MX_SK6812MINI-E_REV | D1, D2 |
| 2 | SW_Push | switches:SW_Cherry_MX1A_1.00u_PCB | SW2, SW3 |
| 1 | 1000uF | Capacitor_THT:C_Radial_D8.0mm_H11.5mm_P3.50mm | C3 |
| 1 | Conn_01x03_Pin | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J2 |
| 1 | Conn_01x09_Pin | Connector_PinHeader_2.54mm:PinHeader_1x09_P2.54mm_Vertical | J1 |
| 1 | ESP32-WROOM-32 | ESP32 Lib:ESP32-DevKitC | U1 |
| 1 | RotaryEncoder_Switch | Rotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm_CircularMountingHoles | SW1 |
Similar boards
- 4 layers45.2 × 59.9 mm

- 2 layers33 × 51.5 mm

- 2 layers49 × 106 mm

Tadpole FPV PCB
SharKingStudios/Tadpole-FPV
A small FPV drone that has a custom transmitter PCB.
48 parts - 4 layers100 × 95 mm

Sk612-delay
mirdej/synkie
The Synkie is a modular open source analog video processor, developed by Michael Egger, Max Egger and Flo Kaufmann
166 parts47 - 2 layers24.1 × 36.2 mm

Esp32miniBT
asterics/esp32_mouse_keyboard
ESP32 implementation for HID over GATT Keyboard and Mouse (Bluetooth Low Energy). Including serial API for external modules (similar to Adafruit EZKey HID)
28 parts911GPL-3.0 - 4 layers99.6 × 76.2 mm

- 4 layers46.8 × 34.8 mm

SmartWatch V4
Bellafaire/ESP32-Smart-Watch
An open source smartwatch based on the ESP32 compatible with the Arduino IDE.
74 parts258MIT - 2 layers90 × 76.5 mm

Questions
How big is the Pulse PCB?
It measures 99.8 × 94.5 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Pulse use?
21 parts, built around the ESP32-WROOM-32 and SK6812MINI-E. 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 Pulse KiCad files?
From the thatSilentGamer/pulse repository on GitHub, at the commit this page was made from: the board is Electronics/Pulse.kicad_pcb and its schematic Electronics/Pulse.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Pulse design in my own project?
Its repository states no licence, so its author keeps all rights: ask thatSilentGamer before reusing the design.