Music Assistant

Music Assistant is a self-hosted, open-source music library manager for Home Assistant.

  • Home Automation
  • Media Applications
  • Media Servers
  • Tools & Utilities
Music Assistant is a self-hosted, open-source music library manager for Home Assistant. It combines streaming services and local music files into one library and streams to supported speakers, smart displays, and audio players. It is for homelab users who want a unified music backend with multi-brand player support. Use it when you need local network discovery, flexible player pairing, and a single library for mixed music sources.

Platform availability

Available on 6 of 10 platforms

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

82/100 Excellent

Maintained
100last commit 17 days ago
Popular
703,279 GitHub stars
Easy to install
856 install platforms, install notes, Docker image
Light to run
502 GB minimum RAM

Availability: platform listings confirmed today, links checked 9 days ago

GitHub stars
3,279
Open issues
92
Last commit
2026-11-04
Latest release
2.10.9
License
Apache-2.0
Activity
steady

Checked 17 days ago - source: GitHub (music-assistant/server)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add your Music AI API key Before sending any music to Music AI, add your Music AI API key where the app or command expects it, such as in the Authorization header. An API key is a secret code that proves you are allowed to use the service, so without it Music AI will reject your requests and nothing will be processed. source
  • Use a reachable audio link for jobs When creating a Music AI job, the input URL must be a complete web address the service can actually reach, not just a local file path. If Music AI cannot download the file, the job can fail because it has no audio to process. source
  • Check jobs using the job ID After submitting a job, keep the job ID and use it to check the status and later get the finished audio links. The job ID is Music AI's unique reference number for that job, so checking it helps you know when processing is done or why it failed. source

Fetched 54 days ago - each note links to its source

Alternatives (4)

  • Emby - Emby is a self-hosted media server that organizes personal video, music, photo, and live TV libraries and streams them to smart TVs, stream…
  • Jellyfin - Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
  • Mediora - Transform your Apple TV into a powerful media hub with Mediora.
  • Plex - Plex is a LinuxServer.io Docker container that runs Plex Media Server so home users can organize and stream personal video, music, and phot…

Checked 51 days ago - source: AlternativeTo

Common questions

Where should I post bug reports and ask for support?

Check the troubleshooting page first, then create bug reports and discuss ideas in the project's separate support repository.

Can I play local music to Alexa devices with Music Assistant?

Yes, a Reddit thread describes using the Music Assistant Home Assistant plugin to play local music to Alexa devices, including grouped speakers.

Are non-standard setups supported?

Some core options help non-standard setups, but they are supplied on a non-support basis. Search Discord because users have often identified a fault in their own setup.

Does each music service need its own account?

Yes, each service still needs its own account, even though Music Assistant combines sources into one library.

Does Music Assistant collect or share playback data?

No, Music Assistant never collects or shares what you play, although online music services still handle their own streams.

Answers sourced from music-assistant.io, www.music-assistant.io, www.music-assistant.io, www.reddit.com

Community

Collected 54 days ago - public community threads