Skip to the content
2 layers85.5 × 49 mmMusicbox, the printed circuit board in 3D

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.md

ESP32 MusicBox

PlatformIO CI

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

box

The KiCad 9.0 project is located in the kicad folder.

Here is the wiring schematic drawing:

schematics

pcb

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
QtyValueFootprintReferences
4~Connector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalBT1Con1, BT2Con1, BT3Con1, PWRCon1
1Conn_01x06_SocketConnector_JST:JST_PH_B6B-PH-K_1x06_P2.00mm_VerticalRFIDCon1
1IOCustomFootprints:Pads_2x10IO1
1~Connector_JST:JST_PH_B3B-PH-K_1x03_P2.00mm_VerticalNeoPixelCon1
1~CustomFootprints:SDCardReaderRD1
1~CustomFootprints:MAX98357AAMP1
1~CustomFootprints:ESP32DevKitESP32

More from mirkosertic/ESP32MusicBox

1
  • 2 layers97.3 × 40.7 mmMusicbox, the printed circuit board in 3D

    Musicbox

    mirkosertic/ESP32MusicBox

    An ESP32 based music box / smart speaker

    7 parts7MIT

Similar boards

  • 2 layers57 × 55.2 mmLogicAnalyzer, the printed circuit board in 3D

    LogicAnalyzer

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    10 parts5.1kGPL-3.0
  • 2 layers32.2 × 15.4 mmProtector, the printed circuit board in 3D

    Protector

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    10 parts4.3kMIT
  • 2 layers26 × 18 mmConn, the printed circuit board in 3D

    Conn

    yaqwsx/KiKit

    Automation tools for KiCAD

    10 parts2.1kMIT
  • 2 layers44.3 × 30.5 mmLime2-SATA RevA, the printed circuit board in 3D

    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 layers17.8 × 43.2 mmNano Adapter, the printed circuit board in 3D

    Nano Adapter

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    10 parts1.1kGPL-3.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    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).