How jamesdun2866/music-assistant-display works
Music Assistant Display is a local TV kiosk for artwork, lyrics, ambient photos, and optional line-in features; it does not play or control audio. The main path is Music Assistant queue/player state into the server, then a browser snapshot and synchronized display. Separate branches provide ambient photo management, line-in album recognition and correction, the listening journal, source tools, and optional CEC remote navigation. The README documents several capabilities whose implementation was not sampled; those links are cited as documented behavior rather than inspected call paths.
Main entry points: App.tsx Display app · index.ts HTTP server · line-in-album.ts Line-in album service · usePlayback.ts Playback updates
Components 25
Kiosk display
- Display app
src/web/App.tsx - Playback updates
src/web/usePlayback.ts - Display protocol
src/shared/protocol.ts - Ambient view
src/web/Ambient.tsx - Line-in view
src/web/LineInAlbum.tsx - Journal view
src/web/ListeningJournal.tsx - Tools panel
src/web/ToolsPanel.tsx
Playback services
- HTTP server
src/server/index.ts - HTTP routes
src/server/http.ts - Playback bridge
src/server/bridge.ts - MA connection
src/server/ma-client.ts - MA provider
src/server/ma-provider.ts - Lyrics cache
src/server/cache.ts
Line-in albums
- Line-in album service
src/server/line-in-album.ts - Album catalog
src/server/album-catalog.ts - Edition correction
src/server/album-editions.ts
Local features
- Ambient library
src/server/ambient.ts - Listening journal
src/server/listening-journal.ts - Source tools
src/server/source-tools.ts - CEC navigation
src/server/cec-native.ts
Input source
- Line-in source
source/sendspin_karaoke_source/audio.py - Album recognition
source/sendspin_karaoke_source/recognition.py - Recording library
source/sendspin_karaoke_source/recording_library.py - Source health
source/sendspin_karaoke_source/source_health.py
Other components
- Viewer
Connections 30
- Viewer → Display app: uses
- Display app → Playback updates: subscribes
src/web/App.tsx - Playback updates → HTTP routes: requests state
- HTTP routes → Playback updates: streams snapshots
- HTTP server → HTTP routes: configures
src/server/index.ts - HTTP server → Playback bridge: creates
src/server/index.ts - Playback bridge → MA provider: uses
- MA provider → MA connection: uses
- MA connection → Lyrics cache: requests lyrics
- HTTP routes → Display protocol: serves snapshots
- Playback updates → Display protocol: validates snapshots
src/web/usePlayback.ts - Display app → Ambient view: renders
src/web/App.tsx - HTTP server → Ambient library: initializes
src/server/index.ts - Display app → Ambient library: manages photos
- Line-in source → Album recognition: provides audio
source/sendspin_karaoke_source/recognition.py - Album recognition → Line-in album service: publishes album
- HTTP server → Line-in album service: initializes
src/server/index.ts - Line-in album service → Album catalog: loads tracklist
src/server/line-in-album.ts - HTTP server → Edition correction: initializes
src/server/index.ts - Line-in album service → Edition correction: sets correction service
src/server/index.ts - Display app → Line-in view: renders
src/web/App.tsx - Line-in view → Line-in album service: displays album
- HTTP server → Listening journal: configures
src/server/index.ts - Display app → Journal view: offers history
- HTTP server → Source tools: configures
src/server/index.ts - Source tools → Recording library: uses library
src/server/source-tools.ts - Source tools → Source health: uses diagnostics
src/server/source-tools.ts - Display app → Tools panel: offers tools
- CEC navigation → Display protocol: uses remote types
src/server/cec-native.ts - Display app → CEC navigation: remote navigation