Mopidy

Mopidy is an extensible, Python-based music server for homelabs and home networks.

  • Media Applications
  • Media Servers
  • Other
  • Tools & Utilities
Mopidy is an extensible, Python-based music server for homelabs and home networks. It streams music from local disk and online sources such as Spotify and SoundCloud, and lets you control playback and build playlists from any phone, tablet, or computer through MPD (Music Player Daemon) and web clients. This Unraid build adds Snapcast and Icecast streaming plus the Iris web interface, giving power users an open, scriptable music server with multiple streaming options.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

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.

80/100 Excellent

Maintained
100last commit 18 days ago
Popular
798,609 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
75no serious findings

Based on 4 of 5 factors.

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

GitHub stars
8,609
Open issues
175
Last commit
2026-11-02
Latest release
v4.0.5
License
Apache-2.0
Activity
steady

Checked 11 days ago - source: GitHub (mopidy/mopidy)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

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

First-install notes

  • Get Mopidy installed first On Debian/Ubuntu, run sudo apt update, then sudo apt install mopidy. This installs the app and core pieces, so Mopidy can start without missing base files. source
  • Install audio playback support If you're doing a manual install, install GStreamer (the audio engine) and its Python bindings. Without it, Mopidy may start but may not be able to play music or some file types. source
  • Tell Mopidy where your music is In Mopidy-File settings, set media_dirs to the folders that hold your music. If you don't, Mopidy won't know where to look and your local files won't show up. source
  • Unraid container setup Set the container to bridge networking (br0) with a static IP. Mount a config volume to /mopidy.conf (see the Mopidy configuration docs for the file format), mount your local media folder, and if you use Snapcast mount a /tmp volume so the snapfifo sockets are shared. source

Fetched 45 days ago - each note links to its source

Alternatives (6)

  • Ampache - Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
  • Amperfy Music
  • Funkwhale - Open-source, self-hosted streaming platform supports Android, iOS, podcasts, uploads, sharing, no ads or tracking, federated across decentr…
  • Subsonic - Subsonic is a free, web-based media streamer, providing ubiquitous access to your music and video.
  • ampd - Ampd is a free, self-hosted web client for Music Player Daemon that lets users browse music libraries and control playback from a modern, r…
  • koel - Free, open-source, self-hosted music streaming server that turns a personal music collection into a fast, browser-based listening experienc…

Checked 51 days ago - source: AlternativeTo

Common questions

How do I tell Mopidy where my local music files are?

In the Mopidy-File extension settings, set media_dirs to the folders that hold your music. If you don't, Mopidy won't know where to look and your local files won't show up.

Why can Mopidy start but fail to play some music?

Install GStreamer and its Python bindings if you do a manual install. Without that audio engine, Mopidy may start but may not be able to play music or some file types.

How can I install Mopidy on Debian or Ubuntu?

Run sudo apt update, then sudo apt install mopidy. This installs Mopidy and the core pieces needed to start without missing base files.

Can I control Mopidy from a phone or tablet?

Yes. You can control it from any MPD or web client on a phone, tablet, or computer.

Where should I go if Mopidy setup stops working?

Use the built-in debugging tools, or ask for help on the Mopidy Discourse forum or the #mopidy-users Zulip stream.

Answers sourced from docs.mopidy.com, docs.mopidy.com, docs.mopidy.com, docs.mopidy.com, selfhost.directory

Community

Collected 53 days ago - public community threads