70 lines
1.7 KiB
ReStructuredText
70 lines
1.7 KiB
ReStructuredText
================
|
|
mopidy-funkwhale
|
|
================
|
|
|
|
A small `Mopidy`_ backend extension to stream music from a Funkwhale server.
|
|
|
|
|
|
Status
|
|
------
|
|
|
|
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.
|
|
|
|
Features
|
|
--------
|
|
|
|
* Searching for tracks, albums and artists available in your Funkwhale instance
|
|
* Browse all artists and albums
|
|
* Browse your favorites
|
|
* Simple configuration
|
|
|
|
Installation
|
|
------------
|
|
|
|
We assume you have a Mopidy server available.
|
|
|
|
We don't have any package for this extension yet, so you may install
|
|
from the repository:
|
|
|
|
.. code-block:: shell
|
|
|
|
pip install git+https://code.eliotberriot.com/funkwhale/mopidy.git
|
|
|
|
.. note::
|
|
|
|
Depending on your setup, you may want to run this comand with ``sudo`` or ``--user``
|
|
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To enable the extension, add the following to your ``mopidy.conf`` file::
|
|
|
|
[funkwhale]
|
|
enabled = true
|
|
# URL of your funkwhale instance
|
|
url = https://demo.funkwhale.audio
|
|
# Username to use when authenticating (leave empty fo anonymous access)
|
|
username = demo
|
|
# Password to use when authenticating (leave empty fo anonymous access)
|
|
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!
|
|
|
|
Todo
|
|
----
|
|
|
|
- Browse use library and playlists
|
|
|
|
|
|
.. _Mopidy: https://www.mopidy.com/
|
|
.. _ncmpcpp: https://wiki.archlinux.org/index.php/ncmpcpp
|
|
.. _iris: https://github.com/jaedb/iris
|