Music Assistant
Music Assistant is a self-hosted, open-source music library manager for Home Assistant.
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
Variants
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
- Local music to Alexa : r/selfhosted - Reddit (reddit)
- Music Assistant's next big hit - Home Assistant Community (other)
- Music Assistant Rookie questions - Home Assistant Community (other)
- SURPRISE - Music Assistant 2.0: Your Music, Your Players (reddit)
- Music assistant start page : r/homeassistant - Reddit (reddit)
Collected 54 days ago - public community threads