Repository files navigation

Mopidy is an extensible music server written in Python.

Mopidy plays music from local disk, Spotify, SoundCloud, Google Play Music, andmore. You edit the playlist from any phone, tablet, or computer using a varietyof MPD and web clients.

Stream music from the cloud

Vanilla Mopidy only plays music from files and radio streams. Throughextensions, Mopidy can play music from cloud services like Spotify,SoundCloud, and Google Play Music.With Mopidy's extension support, backends for new music sources can be easilyadded.

Mopidy is just a server

Mopidy is a Python application that runs in a terminal or in the background onLinux computers or Macs that have network connectivity and audio output.Out of the box, Mopidy is an HTTP server. If you install theMopidy-MPDextension, it becomes an MPD server too. Many additional frontends forcontrolling Mopidy are available as extensions.

Pick your favorite client

You and the people around you can all connect their favorite MPD or web clientto the Mopidy server to search for music and manage the playlist together.With a browser or MPD client, which is available for all popular operatingsystems, you can control the music from any phone, tablet, or computer.

Mopidy on Raspberry Pi

TheRaspberry Pi is a popular device to run Mopidy on, either usingRaspbian, Ubuntu, or Arch Linux.Pimoroni recommends Mopidy for use with theirPirate Audio audio gear forRaspberry Pi.Mopidy is also a significant building block in thePi Musicbox integratedaudio jukebox system for Raspberry Pi.

Mopidy is hackable

Mopidy's extension support and Python, JSON-RPC, and JavaScript APIs makeMopidy a perfect base for your projects.In one hack, a Raspberry Pi was embedded in an old cassette player. The buttonsand volume control are wired up with GPIO on the Raspberry Pi, and are used tocontrol playback through a custom Mopidy extension. The cassettes have NFC tagsused to select playlists from Spotify.

Getting started

To get started with Mopidy, begin by reading theinstallation docs.

Contributing

Begin by reading thecontributingsection of our documentation.If you are a developer, please also readDevelopment environmentand/orExtension development.We welcome all kinds of help with bug fixing, testing, documentation, and supporting other users.

Project resources

• Documentation
• Discourse forum
• Zulip chat
• Source code
• Issue tracker