Skip to content

Official companion desktop app for Music Assistant

License

Notifications You must be signed in to change notification settings

music-assistant/desktop-app

Repository files navigation

Logo

Music Assistant Desktop Companion App

A native desktop companion app for Music Assistant
Music Assistant »

Download

About Music Assistant

Music Assistant is a free, opensource Media library manager that connects to your streaming services and a wide range of connected speakers. The server is the beating heart, the core of Music Assistant and must run on an always-on device like a Raspberry Pi, a NAS or an Intel NUC or alike. The desktop app discovers running Music Assistant servers running on your network and allows you to connect to one, basically wrapping the frontend into this app and provides a couple of native features, such as a sendspin player and discord rich presence. It will sit in your system tray, ready to control playback or show the interface.

Documentation and support

Documentation https://music-assistant.io

Beta Documentation https://beta.music-assistant.io

For issues, please go to the issue tracker.

For feature requests, please see feature requests.


Downloads

Platform Architecture Download
Windows x64 .msi installer | .exe installer
macOS Apple Silicon (M1/M2/M3) .dmg
macOS Intel .dmg
Linux x64 .deb | .AppImage | .rpm
Linux ARM64 .deb | .AppImage | .rpm

All downloads available on the Releases page

Features

  • Native Audio Playback - High-quality audio output via Sendspin protocol with device selection
  • System Tray Integration - Control playback and see what's playing from the system tray
  • OS Media Controls - Integrates with macOS Control Center, Windows Media Controls, and Linux MPRIS
  • Discord Rich Presence - Show what you're listening to on Discord
  • Server Discovery - Automatic discovery of Music Assistant servers via mDNS

Architecture

The companion app wraps the Music Assistant frontend (hosted on your MA server) in a native webview, while providing some additional native features:

  • Native Sendspin client for bit-perfect audio playback
  • System-level media controls and Now Playing integration
  • Background operation with tray icon
  • Auto-start on system boot

Installation

Windows

Download and run the .msi or .exe installer from the downloads table above.

macOS

Download the .dmg file for your architecture (Apple Silicon for M1/M2/M3 Macs, Intel for older Macs).

Linux

Debian/Ubuntu: Download and install the .deb package:

sudo dpkg -i Music.Assistant_*_amd64.deb

Fedora/RHEL: Download and install the .rpm package:

sudo rpm -i Music.Assistant-*-1.x86_64.rpm

Other distributions: Download the .AppImage, make it executable, and run:

chmod +x Music.Assistant_*.AppImage
./Music.Assistant_*.AppImage

Development & Contributing

Check the CONTRIBUTING.md file.

License

Apache-2.0


A project from the Open Home Foundation

About

Official companion desktop app for Music Assistant

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •