music-assistant/server
Server
This project is a multi-room music server and library aggregator that centralizes local audio files and various streaming services into a single unified database. It functions as a media controller for DLNA and UPnP devices, enabling the management of music, podcasts, and audiobooks across networked speakers.
The system is distinguished by its ability to synchronize audio playback across multiple speakers and brands simultaneously. It features a digital signal processor for loudness normalization and frequency correction, alongside an acoustic fingerprinting engine used for metadata enrichment and similarity-based music discovery.
The server covers a broad range of capabilities, including multi-source library merging, automated metadata acquisition for lyrics and artwork, and integration with home automation platforms for voice control and audio announcements. It supports various streaming providers and self-hosted media servers, offering global search and personalized recommendations.
The server utilizes mDNS for automatic service discovery on local networks to simplify the connection process.
Features
- Music Streaming Aggregators - Combines metadata and streams from multiple external music services into a single unified library aggregator.
- Music Library Managers - Provides a centralized system for organizing and accessing local and remote music collections.
- Unified Media Libraries - Combines audio tracks from various streaming providers and local files into a single unified library.
- Audio Playback Synchronization - Synchronizes audio playback across multiple networked speakers to ensure consistent timing and prevent echo.
- Digital Signal Processing - Uses digital signal processing to filter audio streams and modify sound output based on hardware capabilities.
- DSP Configuration Control - Provides control over frequency balance and equalizer presets to optimize sound for specific hardware.
- Music Library Integrations - Imports artists, albums, and playlists from Deezer accounts into the unified local media library.
- DLNA Media Servers - Functions as a DLNA/UPnP media controller to manage audio streams across networked speakers.
- Library Organization - Manages favorites, creates playlists from queues, and retrieves detailed metadata for albums and tracks.
- Acoustic Fingerprinting Systems - Analyzes acoustic fingerprints to match files with recordings and retrieve missing metadata.
- Data Integration & Synchronization - Synchronizes media library data from external music providers into a local database.
- Media Library Synchronization - Synchronizes artists, albums, and playlists from external sources into the centralized local database.
- Audio Digital Signal Processing - Implements a DSP chain for loudness normalization and frequency correction on audio streams.
- Audio Hardware Routing - Routes audio streams from integrated music sources to networked smart speakers and audio devices.
- Gapless Playbacks - Implements gapless playback using server-side stitching or native player enqueueing to eliminate silence between tracks.
- Multi-Room Audio Casting - Coordinates synchronized audio playback across multiple speakers and brands for consistent multi-room streaming.
- Audio Fingerprinting - Extracts acoustic fingerprints to determine mood, energy, and track similarity.
- Audio Stream DSP - Includes a digital signal processor for loudness normalization and frequency correction of audio streams.
- Music Source Integrations - Connects a subscription account to stream artists, albums, and playlists from the Apple Music catalogue.
- Music Servers - Acts as a centralized music server hosting local files and streaming services for network playback.
- Cross-Track Loudness Leveling - Measures perceived volume using industry standards to ensure consistent levels across different audio sources.
- Multi-Player Management - Coordinates audio streams across diverse hardware targets to enable synchronized playback and grouping.
- Music Metadata Enrichment - Automatically fetches artist biographies, lyrics, and high-resolution artwork to enrich the media library.
- Home Automation Integrations - Integrates with home automation controllers to manage shared media player access and trigger events.
- Multi-Brand - Links playback devices from different manufacturers into a single group for simultaneous synchronized playback.
- Personalized Recommendation Retrieval - Provides personalized music recommendations by linking user data to streaming providers.
- Media Player Bridges - Exposes media players to smart home platforms to enable automated playback and voice control.
- Podcast Clients - Manages podcast subscriptions and synchronizes episode playlogs with the media library.
- Podcast Feed Management - Imports show publishers and episode descriptions directly from RSS feeds and podcast indices.
- Audiobook Server Integrations - Syncs audiobooks and podcasts from a self-hosted Audiobookshelf server into a unified media library.
- Manual Media Imports - Allows manual addition of tracks, radio stations, and playlists via URLs or local files.
- Streaming Integrations - Connects an account to stream audiobooks with chapter navigation and playback resumption.
- Queue Handover - Enables moving the active playback list from one connected speaker to another.
- Playlist Managers - Provides tools for creating and managing custom music playlists via the interface or file imports.
- Reading Progress Tracking - Retrieves recently played items and identifies in-progress audiobooks or podcast episodes.
- Music Collection Importing - Syncs owned albums and personal library items from Bandcamp using an account identity token.
- Media Artwork Acquisition - Collects images for artists, albums, and tracks from metadata sources and online databases.
- Media Content Deduplication - Matches identical music from different sources to prevent duplicate entries within the library.
- Unified Media Search - Aggregates search results from multiple connected music providers into a single unified global search.
- Library Search Interfaces - Provides a search interface to locate artists, albums, or playlists within the library.
- Lyric Retrieval - Retrieves synchronized or plain text lyrics from embedded tags, local files, or external APIs.
- Sonic Attribute Playlist Generation - Creates playlists based on sonic attributes to group music by specific feels.
- Acoustic Frequency Correction - Applies precise corrections to frequency ranges to compensate for room acoustics or hardware.
- Playback Experience Optimizations - Applies loudness normalization and crossfades across all connected devices for a smooth listening experience.
- High-Fidelity Audio Streaming - Supports playback of music in lossless high-fidelity quality from subscription accounts.
- Playback Experience Optimization - Coordinates gapless playback, loudness normalization, and crossfades for a consistent listening experience.
- Playback Stream Transfers - Allows moving active audio streams between speakers seamlessly to maintain playback flow.
- Headless Streaming Clients - Detects and streams audio to headless Squeezelite clients and compatible hardware firmware.
- Artist Recommendation Engines - Identifies similar artists and tracks to provide recommendations and automated radio playback.
- Artwork Retrieval - Queries imagery services and local folders to retrieve high-resolution album covers and artist banners.
- Frequency Response Adjustments - Modifies bass and treble frequency regions to customize the audio output for specific players.
- Media Art Grids - Displays media libraries as a responsive grid of cover art for intuitive browsing and playback.
- Equalizer Preset Management - Loads external frequency correction files from standardized formats to automate headphone and speaker tuning.
- Audio Feature Extraction - Extracts audio characteristics like energy and mood to power music discovery and metadata enrichment.
- Music Content Search - Implements search functionality to locate songs, albums, and lyrics within the Deezer catalogue.
- Music Discovery - Matches tracks based on audio fingerprints to provide similarity-based music discovery and suggestions.
- Music Streaming Integrations - Streams radio and podcasts from ARD Audiothek using a password-based login.
- Playback Queue Interfaces - Ships a dedicated interface for organizing the sequence of media tracks in the playback queue.
- Lyric Synchronization - Sources time-synced lyrics from local files or online providers to display during playback.
- Playlist Management - Enables the creation and modification of playlists directly on the Deezer platform.
- Beat-Matched Transitions - Analyzes beats and energy curves to perform synchronized transitions between songs.
- Remote Media Library Streaming - Provides the ability to query and search across remote streaming service catalogues for music discovery.
- Server-Side Audio Stitching - Manages transitions between audio tracks on the server to ensure gapless playback and crossfading.
- Home Automation Announcements - Enables sending text-to-speech or audio alerts from home automation systems to all connected media players.
- Voice Control Integrations - Connects voice assistants to the media server for spoken playback management commands.
- Voice Command Playback Controls - Enables track skipping, pausing, and volume adjustments through local voice intents and request recognition.
- Streaming Clients - Streams audio to Snapcast-compatible web players and mobile applications.
- Bluetooth Connectivity - Routes audio streams to Bluetooth devices via software bridging or external transmitters.
- Bluetooth Speaker Bridging - Connects Bluetooth speakers to the server to enable multi-room synchronization and real-time monitoring.
- Internet Radio Streams - Streams live radio, podcasts, and on-demand audio from the BBC Sounds service.
- Metadata Synchronization - Updates library details and artist information in real time via background workers and API triggers.
- Playback Automation - Provides mechanisms to start specific tracks or playlists via automation service calls.
- Player Control Interfaces - Offers an external interface to execute playback actions, send announcements, and transfer queues.
- Third-Party Media Player Integrations - Integrates with smart home systems to expose external media players as playback targets.
