

Musicbox
An ESP32 based music box / smart speaker
- Size
- 85.5 × 49 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 10
- Nets
- 40
- Pads
- 88
- Tracks, vias
- 227, 18
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 17 Sep 2024
- Updated
- 9 Aug 2026
Overview
Musicbox is an open-source printed circuit board by mirkosertic, from the mirkosertic/ESP32MusicBox repository on GitHub, published under the MIT licence. It is a 2-layer board of 85.5 × 49 mm with 10 parts on 40 nets, routed with 227 tracks and 18 vias.
It belongs with the home automation and IoT and radio and wireless boards and the ESP32 boards of this library.
README
README.mdESP32 MusicBox
This project provides an ESP32 based music box with the following features:
- Simple 3-button control
- MP3 playback
- Integration with I2C RFID tag scanner
- Support for WiFi Grids with auto-reconnect to nearest access point
- MQTT status reporting / remote control
- Home Assistant integration with device autodiscovery
- Web-based user interface
- Integrated into your local network with SSDP / mDNS protocol
- WebDAV support for file / content management
- Optional Bluetooth A2DP output / Bluetooth Headphone output
- Special mode to start in Bluetooth Speaker mode, so it works as a Boombox.
- 3-band equalizer
Supported hardware
- ESP32 (tested with Lolin D32 Pro with a lot of PSRAM recommended (8 MB), 4MB flash RAM is required)
- PN532 RFID Reader (i2c-Mode)
- SDCard Reader (SPI-Mode), is already mounted on a Lolin D32 Pro board
- NeoPixel / WS2812 based LEDs for status visualization
Final product

The KiCad 9.0 project is located in the kicad folder.
Here is the wiring schematic drawing:

Manual
Status visualization with LEDs:
- Boot-Sequence - LEDs enabled step by step to visualize boot progress
- Leds cycling in brightness - orange in case WiFi is not connected but enabled, green in case if playback paused or no playback yet
- Leds green from 0% to 100% filling the circle - Playback progress while playing something
- Leds blinking red - Unknown RFID card detected
- Leds blinking green - RFID card programmed / Known card detected
- Leds green to red - While changing volume
- Keep button 1 pressed during startup. Leds will turn blue to indicate Bluetooth Speaker mode.
- Yellow flashing LEDs indicate a Bluetooth pairing request while in Speaker mode. Press button 1 again to confirm the pairing. LEDs will flash in blue to confirm pairing
- Keep button 1 and button 2 pressed during playback to start from beginning
Parts
10| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | ~ | Connector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_Vertical | BT1Con1, BT2Con1, BT3Con1, PWRCon1 |
| 1 | Conn_01x06_Socket | Connector_JST:JST_PH_B6B-PH-K_1x06_P2.00mm_Vertical | RFIDCon1 |
| 1 | IO | CustomFootprints:Pads_2x10 | IO1 |
| 1 | ~ | Connector_JST:JST_PH_B3B-PH-K_1x03_P2.00mm_Vertical | NeoPixelCon1 |
| 1 | ~ | CustomFootprints:SDCardReader | RD1 |
| 1 | ~ | CustomFootprints:MAX98357A | AMP1 |
| 1 | ~ | CustomFootprints:ESP32DevKit | ESP32 |
More from mirkosertic/ESP32MusicBox
1- 2 layers97.3 × 40.7 mm

Similar boards
- 2 layers57 × 55.2 mm

LogicAnalyzer
gusmanb/logicanalyzer
24 channel, 100Msps logic analyzer hardware and software
10 parts5.1kGPL-3.0 - 2 layers32.2 × 15.4 mm

Protector
byrantech/laptop
anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.
10 parts4.3kMIT - 2 layers14.4 × 10.1 mm

Q3Q SWAB A1-00 Temperature + Test Points + OPT3001
joeycastillo/Sensor-Watch
A board replacement for the classic Casio F-91W wristwatch
10 parts2.1k - 2 layers26 × 18 mm

- 2 layers44.3 × 30.5 mm

Lime2-SATA RevA
OLIMEX/OLINUXINO
OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C
10 parts1.5k - 2 layers150 × 50 mm

Breakout 55pin 963063-15-Connector
rusefi/rusefi
rusefi - GPL internal combustion engine control unit
10 parts1.2k - 2 layers17.8 × 43.2 mm

Nano Adapter
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
10 parts1.1kGPL-3.0 - 2 layers53.9 × 23.2 mm

Buffer
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
10 parts1kGPL-3.0
Questions
How big is the Musicbox PCB?
It measures 85.5 × 49 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Musicbox use?
10 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 Musicbox KiCad files?
From the mirkosertic/ESP32MusicBox repository on GitHub, at the commit this page was made from: the board is kicad/esp32_devkit/musicbox.kicad_pcb and its schematic kicad/esp32_devkit/musicbox.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Musicbox design in my own project?
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).