https://github.com/mirkosertic/esp32musicbox

An ESP32 based music box / smart speaker
https://github.com/mirkosertic/esp32musicbox

arduino esp32 esp32-arduino home-assistant maker mqtt music-player platformio rfid smarthome voice-control

Last synced: 26 days ago
JSON representation

An ESP32 based music box / smart speaker

• Host: GitHub
• URL: https://github.com/mirkosertic/esp32musicbox
• Owner: mirkosertic
• License: mit
• Created: 2024-09-17T19:34:09.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-06-05T19:10:38.000Z (about 1 month ago)
• Last Synced: 2025-06-05T20:21:20.525Z (about 1 month ago)
• Topics: arduino, esp32, esp32-arduino, home-assistant, maker, mqtt, music-player, platformio, rfid, smarthome, voice-control
• Language: C++
• Homepage:
• Size: 668 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ESP32 MusicBox

[![PlatformIO CI](https://github.com/mirkosertic/ESP32MusicBox/actions/workflows/build.yml/badge.svg)](https://github.com/mirkosertic/ESP32MusicBox/actions/workflows/build.yml)

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

## Supported hardware

* ESP32 (tested with ESP32 DevKit C)

* PN532 RFID Reader (i2c-Mode)

* SDCard Reader (SPI-Mode)

* NeoPixel / WS2812 based LEDs for status visualization

## Schematics

The KiCad 9.0 project is located in the kicad folder.

Here is the wiring schematic drawing:

![schematics](doc/schematics.svg)

## 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