Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

"A backend extension for mopidy to stream music from a Funkwhale server"

Project description

A small Mopidy backend extension to stream music from a Funkwhale server.


This project is still pretty young and is not feature complete. It has been tested with the latest version of Mopidy and the Iris and ncmpcpp clients.


  • Searching for tracks, albums and artists available in your Funkwhale instance
  • Browse all artists and albums
  • Browse your favorites
  • Simple configuration


We assume you have a Mopidy server available (version 3 or greater required).

We don’t have any package for this extension yet, so you may install from the repository:

apt-get install libcairo2-dev libgirepository1.0-dev python-dev
sudo python3 -m pip install mopidy-funkwhale


Depending on your setup, you may want to run this comand with sudo or --user


To enable the extension, add the following to your mopidy.conf file:

enabled = true
# URL of your funkwhale instance
url =
# Application credentials (leave empty fo anonymous access)
# If you don't now what to put here, just run `mopidy funkwhale login` for
# the instructions
client_id =
client_secret =
# If for some reason, you want to use the legacy password-based auth,
# uncomment the variables below
# username = demo
# password = demo

# duration of cache entries before they are removed, in seconds
# 0 to cache forever, empty to disable cache
cache_duration = 600

Of course, replace the demo values with your actual info (but you can try using the demo server).

After that, reload your mopidy daemon, and you should be good!


This plugin support the OAuth authorization workflow that is included in Funkwhale 0.19.

Run mopidy funkwhale login to perform authorization.


  • Browse use library and playlists

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mopidy-funkwhale, version 0.1.0.dev22
Filename, size File type Python version Upload date Hashes
Filename, size mopidy_funkwhale-0.1.0.dev22-py2.py3-none-any.whl (12.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size mopidy_funkwhale-0.1.0.dev22.tar.gz (14.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page