How ralihachev/musicstation works
MusicStation is an ESP32-S3 music player with an e-paper interface. The documented V1 workflow shows iPhone playback metadata arriving over Bluetooth, online artwork and lyrics fetched over Wi-Fi, and a compact display rendered on e-paper. V2 shifts the workflow toward a microSD library, local playlists and sidecars, queue-based playback, and physical controls; its audio backend is currently simulated. V2 relationships below use sampled excerpts and the SOURCE INDEX where possible. The V1 branch reflects README documentation; unsampled V2 orchestration links are omitted or marked unverified.
Main entry points: player.cpp Queue and playback · ui.cpp Navigation and UI · library.cpp Music library index · MusicStation.ino V1 firmware
Components 17
V1 companion
- V1 firmware
MusicStation.ino - E-paper display
V2 interaction
- Button input
V2/MusicStationV2/input.cpp - Navigation and UI
V2/MusicStationV2/ui.cpp - E-paper panel
V2/MusicStationV2/panel.cpp
V2 media
- SD storage
V2/MusicStationV2/storage.cpp - Music library index
V2/MusicStationV2/library.cpp - MP3 metadata
V2/MusicStationV2/mp3meta.cpp - Playlist handling
V2/MusicStationV2/playlist.cpp - Local artwork
V2/MusicStationV2/cover.cpp - Synchronized lyrics
V2/MusicStationV2/lyrics.cpp
V2 playback
- Queue and playback
V2/MusicStationV2/player.cpp - Audio backend
V2/MusicStationV2/audio.cpp - Persistent state
V2/MusicStationV2/settings.cpp
V2 device
- Power management
V2/MusicStationV2/power.cpp
Other components
- iPhone
- Online services
Connections 20
- iPhone → V1 firmware: sends playback state
README.md - Online services → V1 firmware: provides artwork and lyrics
README.md - V1 firmware → E-paper display: renders player screen
README.md - Button input → Navigation and UI: dispatches input
- Navigation and UI → Queue and playback: controls playback
V2/MusicStationV2/ui.cpp - Navigation and UI → Music library index: reads browse records
V2/MusicStationV2/ui.cpp - Navigation and UI → Persistent state: updates settings
V2/MusicStationV2/ui.cpp - Navigation and UI → Playlist handling: refreshes playlists
V2/MusicStationV2/ui.cpp - Navigation and UI → E-paper panel: draws screens
- Music library index → MP3 metadata: probes track metadata
V2/MusicStationV2/library.cpp - Music library index → SD storage: reads and writes index
- Playlist handling → SD storage: reads playlist files
- Queue and playback → Music library index: builds track queues
V2/MusicStationV2/player.cpp - Queue and playback → Playlist handling: loads playlist queue
V2/MusicStationV2/player.cpp - Queue and playback → Synchronized lyrics: loads track lyrics
V2/MusicStationV2/player.cpp - Queue and playback → Local artwork: loads track artwork
V2/MusicStationV2/player.cpp - Queue and playback → Audio backend: starts and controls audio
V2/MusicStationV2/player.cpp - Queue and playback → Persistent state: persists playback state
V2/MusicStationV2/player.cpp - Audio backend → SD storage: reads track audio
V2/MusicStationV2/audio.cpp - Power management → Audio backend: mutes audio
V2/MusicStationV2/power.cpp