# Mopidy

Mopidy is an extensible, Python-based music server for homelabs and home networks. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1397/mopidy

## Description

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, Any server.

## Health score

80/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 79 (8,609 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- Docker Hub: https://hub.docker.com/r/knex666/mopidy
- Unraid: https://ca.unraid.net/apps/mopidy-08umi1b0k8idm3?q=Mopidy
- GitHub: https://github.com/mopidy/mopidy
- Official website: https://www.mopidy.com
- Documentation: https://docs.mopidy.com/

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/1397/mopidy), the self-hosted and open-source app directory.
