How music-assistant/server works
Music Assistant is a server-side media library manager that connects streaming services with networked speakers. The principal workflow is selecting catalog media for a player, resolving it into a queue, streaming audio, and delivering it to a speaker. The graph also preserves major supporting capabilities such as metadata, recommendations, discovery, storage, and authenticated API access. Relationships beyond those stated in the README are limited: sampled files and the SOURCE INDEX show some module references, but not enough runtime wiring to verify a complete call chain.
Main entry points: mass.py Server runtime · music/controller.py Music library · players/controller.py Player control · player_queues/controller.py Player queues
Components 22
Server Core
- Server runtime
music_assistant/mass.py - Core controllers
music_assistant/models/core_controller.py - Background tasks
music_assistant/controllers/tasks/context.py
Music Catalog
- Music library
music_assistant/controllers/music/controller.py - Media item model
music_assistant/controllers/music/media/base.py - Metadata enrichment
music_assistant/controllers/metadata/controller.py - Recommendations
music_assistant/controllers/music/recommendations/controller.py
Playback
- Player queues
music_assistant/controllers/player_queues/controller.py - Audio streaming
music_assistant/controllers/streams/controller.py - Player control
music_assistant/controllers/players/controller.py - Player state model
music_assistant/models/player.py
Provider Integrations
- Music provider contract
music_assistant/models/music_provider.py - Player provider contract
music_assistant/models/player_provider.py - Service integrations
music_assistant/providers
Access and Platform
- Web API
music_assistant/controllers/webserver/controller.py - Request authentication
music_assistant/controllers/webserver/helpers/auth_middleware.py - Device discovery
music_assistant/controllers/discovery/controller.py - Storage management
music_assistant/controllers/storage/controller.py - Configuration
music_assistant/controllers/config/controller.py
Other components
- Music user
- Connected speakers
- Streaming services
Connections 20
- Music user → Server runtime: uses
- Server runtime → Streaming services: connects services
- Server runtime → Connected speakers: connects speakers
- Server runtime → Core controllers: hosts controllers
music_assistant/mass.py - Web API → Request authentication: authenticates requests
music_assistant/controllers/webserver/controller.py - Music library → Media item model: manages media
music_assistant/controllers/music/controller.py - Music library → Metadata enrichment: uses enrichment
music_assistant/controllers/metadata/controller.py - Music library → Recommendations: offers recommendations
music_assistant/controllers/music/controller.py - Player queues → Music library: lists media
music_assistant/controllers/player_queues/controller.py - Player control → Player state model: manages player state
music_assistant/controllers/players/controller.py - Player control → Player provider contract: uses provider contract
music_assistant/controllers/players/controller.py - Music provider contract → Music library: supplies catalog items
music_assistant/controllers/music/controller.py - Service integrations → Music provider contract: implements contract
music_assistant/providers/nicovideo/services/manager.py - Service integrations → Player provider contract: implements contract
music_assistant/providers/sendspin/bridge_manager.py - Player queues → Audio streaming: resolves audio
- Audio streaming → Player control: delivers audio
- Server runtime → Background tasks: schedules work
- Server runtime → Device discovery: provides discovery
- Server runtime → Storage management: provides storage
music_assistant/controllers/storage/controller.py - Server runtime → Configuration: provides configuration