{"id":17859152,"url":"https://github.com/mirkosertic/esp32musicbox","last_synced_at":"2025-07-28T19:33:33.481Z","repository":{"id":259700513,"uuid":"858934709","full_name":"mirkosertic/ESP32MusicBox","owner":"mirkosertic","description":"An ESP32 based music box / smart speaker","archived":false,"fork":false,"pushed_at":"2025-06-05T19:10:38.000Z","size":684,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-05T20:21:20.525Z","etag":null,"topics":["arduino","esp32","esp32-arduino","home-assistant","maker","mqtt","music-player","platformio","rfid","smarthome","voice-control"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mirkosertic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-17T19:34:09.000Z","updated_at":"2025-06-05T19:10:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"d81a6d73-2e81-463f-9700-d0e84c84311e","html_url":"https://github.com/mirkosertic/ESP32MusicBox","commit_stats":null,"previous_names":["mirkosertic/esp32musicbox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirkosertic%2FESP32MusicBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirkosertic%2FESP32MusicBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirkosertic%2FESP32MusicBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirkosertic%2FESP32MusicBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mirkosertic","download_url":"https://codeload.github.com/mirkosertic/ESP32MusicBox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirkosertic%2FESP32MusicBox/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259085300,"owners_count":22803176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","esp32","esp32-arduino","home-assistant","maker","mqtt","music-player","platformio","rfid","smarthome","voice-control"],"created_at":"2024-10-28T06:03:18.281Z","updated_at":"2025-07-28T19:33:33.474Z","avatar_url":"https://github.com/mirkosertic.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESP32 MusicBox\n\n[![PlatformIO CI](https://github.com/mirkosertic/ESP32MusicBox/actions/workflows/build.yml/badge.svg)](https://github.com/mirkosertic/ESP32MusicBox/actions/workflows/build.yml)\n\nThis project provides an ESP32 based music box with the following features:\n\n* Simple 3-button control\n* MP3 playback\n* Integration with I2C RFID tag scanner\n* Support for WiFi Grids with auto-reconnect to nearest access point\n* MQTT status reporting / remote control\n* Home Assistant integration with device autodiscovery\n* Web-based user interface\n* Integrated into your local network with SSDP / mDNS protocol\n* WebDAV support for file / content management\n* Optional Bluetooth A2DP output / Bluetooth Headphone output\n* Special mode to start in Bluetooth Speaker mode, so it works as a Boombox.\n* 3-band equalizer\n\n## Supported hardware\n\n* ESP32 (tested with Lolin D32 Pro with a lot of PSRAM recommended (8 MB), 4MB flash RAM is required)\n* PN532 RFID Reader (i2c-Mode)\n* SDCard Reader (SPI-Mode), is already mounted on a Lolin D32 Pro board\n* NeoPixel / WS2812 based LEDs for status visualization\n\n## Final product\n\n![box](doc/box.png)\n\nThe KiCad 9.0 project is located in the kicad folder.\n\nHere is the wiring schematic drawing:\n\n![schematics](doc/schematics.svg)\n\n![pcb](doc/pcb.png)\n\n## Manual\n\nStatus visualization with LEDs:\n\n- Boot-Sequence - LEDs enabled step by step to visualize boot progress\n- Leds cycling in brightness - orange in case WiFi is not connected but enabled, green in case if playback paused or no playback yet\n- Leds green from 0% to 100% filling the circle - Playback progress while playing something\n- Leds blinking red - Unknown RFID card detected\n- Leds blinking green - RFID card programmed / Known card detected\n- Leds green to red - While changing volume\n- Keep button 1 pressed during startup. Leds will turn blue to indicate Bluetooth Speaker mode.\n- 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\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirkosertic%2Fesp32musicbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirkosertic%2Fesp32musicbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirkosertic%2Fesp32musicbox/lists"}