How termuxbash/musicify works
Musicify is a Flask music streamer that lets users browse local audio or find YouTube tracks, queue playback, and send the resulting Icecast stream to a Bose SoundTouch speaker. The main path runs from a source route through playback ownership and the queue player, then through FFmpeg to Icecast; speaker controls separately direct the Bose device to the stream. Other capabilities include queue/status controls, playlists and history, lyrics display, autoplay/recommendations, and local/YouTube search. The map follows the shown calls and README-described features; unsampled implementation links are omitted or marked unverified.
Main entry points: app.py Flask App · stream_manager.py Queue Player · playback_controller.py Playback Ownership · routes.py Local Library
Components 22
Music Sources
- Local Library
apps/local/routes.py - YouTube Routes
apps/yt/routes.py - YouTube Service
services/yt_service.py - Music Files
- YouTube API
Playback Core
- Flask App
app.py - Playback Ownership
core/playback_controller.py - Queue Player
core/stream_manager.py
Speaker and Stream
- FFmpeg Streaming
services/ffmpeg_service.py - Icecast Stream
- Speaker Controls
core/bose_routes.py - Bose Device Client
core/bose_worker.py - Bose Speaker
Player Features
- Status and History
core/stats.py - Lyrics Service
services/lyrics_service.py - Lyrics Display
core/display.py - Runtime Settings
core/settings.py - Last.fm
- LRCLIB
Web Interface
- Web Pages and Assets
templates - Browser Interactions
static/common.js
Other components
- Listener
Connections 31
- Listener → Web Pages and Assets: uses
README.md - Flask App → Local Library: registers routes
app.py - Flask App → YouTube Routes: registers routes
app.py - Flask App → Speaker Controls: registers routes
app.py - Flask App → Status and History: registers routes
app.py - Flask App → Queue Player: starts player
app.py - Flask App → Playback Ownership: creates controller
app.py - Flask App → FFmpeg Streaming: configures player
app.py - Flask App → Bose Device Client: configures player
app.py - Local Library → Music Files: browses files
apps/local/routes.py - Local Library → Playback Ownership: acquires and enqueues
apps/local/routes.py - YouTube Routes → YouTube Service: searches and resolves
apps/yt/routes.py - YouTube Routes → Playback Ownership: acquires playback
apps/yt/routes.py - YouTube Service → YouTube API: searches
services/yt_service.py - YouTube Service → Playback Ownership: enqueues tracks
services/yt_service.py - Playback Ownership → Queue Player: delegates playback
core/playback_controller.py - Queue Player → FFmpeg Streaming: starts streams
- FFmpeg Streaming → Icecast Stream: publishes audio
services/ffmpeg_service.py - Speaker Controls → Bose Device Client: dispatches commands
core/bose_routes.py - Bose Device Client → Bose Speaker: controls and queries
core/bose_worker.py - Speaker Controls → Icecast Stream: selects stream URL
core/bose_routes.py - Status and History → Queue Player: reads player status
core/stats.py - Status and History → YouTube Service: requests track lookup
core/stats.py - Queue Player → Last.fm: gets recommendations
core/stream_manager.py - Lyrics Service → LRCLIB: fetches synced lyrics
services/lyrics_service.py - Lyrics Service → Lyrics Display: sends lyric lines
services/lyrics_service.py - Flask App → Lyrics Service: creates service
app.py - Local Library → Runtime Settings: reads library root
apps/local/routes.py - YouTube Routes → Runtime Settings: reads configuration
apps/yt/routes.py - Speaker Controls → Runtime Settings: reads speaker config
core/bose_routes.py - Browser Interactions → Web Pages and Assets: supports interactions