mopidy-funkwhale/README.rst

71 lines
1.8 KiB
ReStructuredText
Raw Normal View History

2018-10-03 18:34:45 +02:00
================
mopidy-funkwhale
================
2018-10-03 22:40:14 +02:00
A small `Mopidy`_ backend extension to stream music from a Funkwhale server.
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
Status
------
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
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.
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
Features
--------
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
* Searching for tracks, albums and artists available in your Funkwhale instance
2018-10-05 00:06:09 +02:00
* Browse all artists and albums
* Browse your favorites
2018-10-03 22:40:14 +02:00
* Simple configuration
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
Installation
------------
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
We assume you have a Mopidy server available.
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
We don't have any package for this extension yet, so you may install
from the repository:
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
.. code-block:: shell
2018-10-03 18:34:45 +02:00
2019-01-27 10:18:25 +01:00
apt-get install libcairo2-dev libgirepository1.0-dev python-dev
2018-12-10 20:59:11 +01:00
pip install git+https://dev.funkwhale.audio/funkwhale/mopidy.git
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
.. 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
2018-10-05 00:06:09 +02:00
# duration of cache entries before they are removed, in seconds
# 0 to cache forever, empty to disable cache
cache_duration = 600
2018-10-03 22:40:14 +02:00
Of course, replace the demo values with your actual info (but you can
try using the demo server).
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
After that, reload your mopidy daemon, and you should be good!
2018-10-05 00:06:09 +02:00
2018-10-03 22:40:14 +02:00
Todo
----
2018-10-03 18:34:45 +02:00
2018-10-05 00:06:09 +02:00
- Browse use library and playlists
2018-10-03 18:34:45 +02:00
2018-10-03 22:40:14 +02:00
.. _Mopidy: https://www.mopidy.com/
.. _ncmpcpp: https://wiki.archlinux.org/index.php/ncmpcpp
.. _iris: https://github.com/jaedb/iris