You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Georg Krause b018bb1e5b Merge branch 'cleanup-fix-jwt-token' into 'main' 2 days ago
.changelog Add missing changelog snippets 3 months ago
mopidy_funkwhale fix: APIClient jwt_token error on anonymous connection 1 month ago
tests Fix config tests 3 months ago
.editorconfig IInitial commit 4 years ago
.gitignore IInitial commit 4 years ago
.gitlab-ci.yml Install job dependencies 3 months ago Add changelog management with towncrier 3 months ago
HISTORY.rst IInitial commit 4 years ago
LICENSE IInitial commit 4 years ago Better documentation 4 years ago
README.rst Document installation of python3-dev in README 1 year ago
pyproject.toml Configure right directory for changelog snippets 3 months ago
setup.cfg Lint codebase and add CI job 3 months ago Lint codebase and add CI job 3 months ago



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


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


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

.. code-block:: shell

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

.. note::

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.

.. _Mopidy:
.. _ncmpcpp:
.. _iris: