README.rst 1.82 KB
Newer Older
Agate's avatar
Agate committed
1
2
3
4
================
mopidy-funkwhale
================

Agate's avatar
Agate committed
5
A small `Mopidy`_ backend extension to stream music from a Funkwhale server.
Agate's avatar
Agate committed
6
7


Agate's avatar
Agate committed
8
9
Features
--------
Agate's avatar
Agate committed
10

Agate's avatar
Agate committed
11
* Searching for tracks, albums and artists available in your Funkwhale instance
12
* Browse all libraries, artists and albums
Agate's avatar
Agate committed
13
* Browse your favorites
Agate's avatar
Agate committed
14
* Simple configuration
Agate's avatar
Agate committed
15

Agate's avatar
Agate committed
16
17
Installation
------------
Agate's avatar
Agate committed
18

Georg Krause's avatar
Georg Krause committed
19
We assume you have a Mopidy server available (version 3 or greater required).
Agate's avatar
Agate committed
20

Agate's avatar
Agate committed
21
.. code-block:: shell
Agate's avatar
Agate committed
22

23
    apt-get install libcairo2-dev libgirepository1.0-dev python3-dev
Antipiot's avatar
Antipiot committed
24
    sudo python3 -m pip install mopidy-funkwhale
Antipiot's avatar
Antipiot committed
25

Agate's avatar
Agate committed
26

Agate's avatar
Agate committed
27
28
29
30
31
32
33
34
35
36
37
38
39
40
.. 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
Agate's avatar
Agate committed
41
42
43
44
45
46
47
48
49
50
    # 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

Agate's avatar
Agate committed
51
52
53
    # duration of cache entries before they are removed, in seconds
    # 0 to cache forever, empty to disable cache
    cache_duration = 600
Agate's avatar
Agate committed
54
55
56

Of course, replace the demo values with your actual info (but you can
try using the demo server).
Agate's avatar
Agate committed
57

Agate's avatar
Agate committed
58
After that, reload your mopidy daemon, and you should be good!
Agate's avatar
Agate committed
59

Agate's avatar
Agate committed
60
61
62
63
64
65
66
Authorization
-------------

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

Run ``mopidy funkwhale login`` to perform authorization.

Agate's avatar
Agate committed
67
68
69
.. _Mopidy: https://www.mopidy.com/
.. _ncmpcpp: https://wiki.archlinux.org/index.php/ncmpcpp
.. _iris: https://github.com/jaedb/iris