Skip to the content
2 layers99.8 × 94.5 mmPulse, the printed circuit board in 3D

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

2

README

README.md

Custom 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

Screenshot 2026-06-25 223707 Screenshot 2026-07-09 151816 image image image pulse_zine_page

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 NameSize / SpecsQuantityCost (Each)Total CostPurchase Link
ESP3238pin type c1$8.80$8.80AliExpress Link
Cherry MX2A Speed Silver 45g Linear SwitchPCB RGB LED2$0.40$0.80Mechanical Keyboards Link
EC11 w/ Push Button (rotary encoder)20mm Plum handle1$0.96$0.96AliExpress Link
Encoder KnobO 20x13mm1$0.99$0.99AliExpress Link
TFT Display3.5 inch1$0.99$0.99AliExpress Link
WS2812 LED Light strip1m1$0.99$0.99AliExpress Link
Shine-through keycapsBlack-971$8.35$8.35AliExpress Link
USB-C Cable100W Black1$5.28$5.28AliExpress Link
22AWG Electric Wire25m1$0.99$0.99AliExpress Link
Resistor Set300pcs in box1$3.37$3.37AliExpress Link
Capacitor Setn/a1$2.05$2.05AliExpress Link
Electrolytic Capacitor10V1000UF 20PCS1$0.99$0.99AliExpress Link
Brass Heatset insertsM2, M2.5, M3 (500PCS)1$1.59$1.59AliExpress Link
M2 Screws482pcs M21$0.99$0.99AliExpress Link
M3 Screws392pcs M31$0.99$0.99AliExpress Link
3D Printingn/a1$10.00$10.00n/a
SK6812 MINI-E RGB lights100PCS1$0.99$0.99AliExpress 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–H4 to secure the soldered PCB firmly inside the 3D-printed bottom shell.

3. Firmware & Flashing Instructions

  1. Download and install the Arduino IDE along with the ESP32 board definitions and required libraries (TFT_eSPI, BleKeyboard, ESP32Encoder, and FastLED).
  2. Open /Firmware/pulse.ino in your IDE.
  3. Connect the ESP32-S3 to your computer via USB-C.
  4. Select ESP32S3 Dev Module as your target board and select the correct COM port.
  5. 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
QtyValueFootprintReferences
510kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR1, R2, R3, R4, R5
4MountingHole_PadMountingHole:MountingHole_2.2mm_M2_Pad_ViaH1, H2, H3, H4
3100nFCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mmC1, C2, C4
2SK6812MINILED Lib:MX_SK6812MINI-E_REVD1, D2
2SW_Pushswitches:SW_Cherry_MX1A_1.00u_PCBSW2, SW3
11000uFCapacitor_THT:C_Radial_D8.0mm_H11.5mm_P3.50mmC3
1Conn_01x03_PinConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ2
1Conn_01x09_PinConnector_PinHeader_2.54mm:PinHeader_1x09_P2.54mm_VerticalJ1
1ESP32-WROOM-32ESP32 Lib:ESP32-DevKitCU1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm_CircularMountingHolesSW1

Similar boards

  • 4 layers45.2 × 59.9 mmPcb quadrotor, the printed circuit board in 3D

    Pcb quadrotor

    AutopilotPi/V3s_Quadrotor

    A Quadrotor Using AutoPilotPi

    85 parts10GPL-3.0
  • 2 layers33 × 51.5 mmOrph32, the printed circuit board in 3D

    Orph32

    pizzalover125/orpheus32

    An ESP32 devboard made specifically for Hack Club!

    28 parts
  • 2 layers49 × 106 mmTadpole FPV PCB, the printed circuit board in 3D

    Tadpole FPV PCB

    SharKingStudios/Tadpole-FPV

    A small FPV drone that has a custom transmitter PCB.

    48 parts
  • 4 layers100 × 95 mmSk612-delay, the printed circuit board in 3D

    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 mmEsp32miniBT, the printed circuit board in 3D

    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 mmE TKT, the printed circuit board in 3D

    E TKT

    andreisperid/E-TKT

    open source embossed label maker

    110 parts481MIT
  • 4 layers46.8 × 34.8 mmSmartWatch V4, the printed circuit board in 3D

    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 mmLCDZapperPro, the printed circuit board in 3D

    LCDZapperPro

    charcole/LCDZapper

    Device for making light gun games playable on LCD TVs

    126 parts163

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.