|
a/doc/upmpdcli.txt |
|
b/doc/upmpdcli.txt |
|
... |
|
... |
| 9 |
It has the ability to interface to Linn Songcast for multiroom synchronized
|
9 |
It has the ability to interface to Linn Songcast for multiroom synchronized
|
| 10 |
playing either of audio captured on Windows or Mac OS X or of its own
|
10 |
playing either of audio captured on Windows or Mac OS X or of its own
|
| 11 |
stream.
|
11 |
stream.
|
| 12 |
|
12 |
|
| 13 |
As of version 1.2.0, the software includes a Media Server gateway to
|
13 |
As of version 1.2.0, the software includes a Media Server gateway to
|
| 14 |
streaming music services, with initial support for Google Play Music, Qobuz
|
14 |
cloud streaming music services.
|
| 15 |
and Tidal.
|
|
|
| 16 |
|
15 |
|
| 17 |
[[upmpdcli.security]]
|
16 |
[[upmpdcli.security]]
|
| 18 |
== Security
|
17 |
== Security
|
| 19 |
|
18 |
|
| 20 |
*upmpdcli* is not audited for security issues, and, as far as I
|
19 |
*upmpdcli* is not audited for security issues, and, as far as I
|
|
... |
|
... |
| 45 |
[[upmpdcli.streaming]]
|
44 |
[[upmpdcli.streaming]]
|
| 46 |
== Streaming services support
|
45 |
== Streaming services support
|
| 47 |
|
46 |
|
| 48 |
Upmpdcli versions 1.2.0 and later offer support for accessing music on some
|
47 |
Upmpdcli versions 1.2.0 and later offer support for accessing music on some
|
| 49 |
streaming services. You will need a valid account on the services you want
|
48 |
streaming services. You will need a valid account on the services you want
|
| 50 |
to use. The initial release supports Google Play Music, Qobuz and Tidal.
|
49 |
to use. The initial release supports Google Play Music, Qobuz and Tidal
|
|
|
50 |
(which does not work any more, see the notes in the Tidal section).
|
| 51 |
|
51 |
|
| 52 |
When the function is activated, upmpdcli creates a separate auxiliary Media
|
52 |
When the function is activated, upmpdcli creates a separate auxiliary Media
|
| 53 |
Server, with the sole purpose of presenting the streaming server
|
53 |
Server, with the sole purpose of presenting the streaming server
|
| 54 |
catalog. You will see it appear on the network if streaming service
|
54 |
catalog. You will see it appear on the network if streaming service
|
| 55 |
parameters are present in the configuration file. The Media Server name is
|
55 |
parameters are present in the configuration file. The Media Server name is
|
| 56 |
the one for the upmpdcli instance, with "-mediaserver" appended.
|
56 |
the one for the upmpdcli instance, with "-mediaserver" appended.
|
| 57 |
|
57 |
|
| 58 |
Streaming is not limited to the local upmpdcli renderer, and the Media
|
58 |
Streaming is not limited to the local upmpdcli renderer, and the Media
|
| 59 |
Server should happily send music to other renderers.
|
59 |
Server should happily send music to other renderers.
|
| 60 |
|
60 |
|
|
|
61 |
NOTE: The streaming services passwords are stored in the upmpdcli
|
|
|
62 |
configuration file ('/etc/upmpdcli.conf'). The 1.2.2 installer does not
|
|
|
63 |
make this file r/w by owner only. This will be fixed, but for now, you
|
|
|
64 |
should probably do it after setting the password:
|
|
|
65 |
chmod 600 /etc/upmpdcli.conf+ Actually, it would quite probably
|
|
|
66 |
be a good idea not to use the same account for your mail and music uses.
|
|
|
67 |
|
|
|
68 |
NOTE: I have no reason to believe that upmpdcli is technically mis-using
|
|
|
69 |
the streaming services in any way, but it is definitely not approved by any
|
|
|
70 |
of them, and you are using it under your own responsibility.
|
|
|
71 |
|
| 61 |
=== Notes on the Tidal interface
|
72 |
=== Notes on the Tidal interface
|
| 62 |
|
73 |
|
| 63 |
This is based on the
|
74 |
[NOTE]
|
|
|
75 |
===================================
|
|
|
76 |
There seems to be problems when streaming Tidal lossless/FLAC streams,
|
|
|
77 |
with the default MPD configuration. A preliminary and rather superficial
|
|
|
78 |
enquiry seems to indicate that this is caused by too much buffering by
|
|
|
79 |
MPD. Adding the following parameters to the MPD configuration file
|
|
|
80 |
(/etc/mpd.conf) reduces the pre-fetch period from 20 S to 10 S and seems to
|
|
|
81 |
fix the issues for me:
|
|
|
82 |
|
|
|
83 |
audio_buffer_size "2048"
|
|
|
84 |
buffer_before_play "20%"
|
|
|
85 |
====================================
|
|
|
86 |
|
|
|
87 |
The Tidal module code is is based on the
|
| 64 |
link:https://github.com/tamland/kodi-tidal[Kodi Tidal add-on] and the
|
88 |
link:https://github.com/tamland/kodi-tidal[Kodi Tidal add-on] and the
|
| 65 |
link:https://github.com/tamland/python-tidal[Tidal API], by Thomas
|
89 |
link:https://github.com/tamland/python-tidal[Tidal API], by Thomas
|
| 66 |
Amland (also using other useful modules by Thomas). I was able to reuse
|
90 |
Amland (also using other useful modules by Thomas). I was able to reuse
|
| 67 |
most of the Kodi code.
|
91 |
most of the Kodi code.
|
| 68 |
|
92 |
|
|
... |
|
... |
| 71 |
|
95 |
|
| 72 |
It only works with a valid Tidal subscription.
|
96 |
It only works with a valid Tidal subscription.
|
| 73 |
|
97 |
|
| 74 |
The configuration parameters are described
|
98 |
The configuration parameters are described
|
| 75 |
link:#_tidal_streaming_service_parameters[further down].
|
99 |
link:#_tidal_streaming_service_parameters[further down].
|
|
|
100 |
|
|
|
101 |
NOTE: as of 2016-09-17, the Tidal interface does not seem to work any
|
|
|
102 |
more. It appears that the Kodi add-on has problems too, so this probably
|
|
|
103 |
comes from a change on the Tidal side, maybe they invalidated the API key
|
|
|
104 |
which was used by most open-source interfaces.
|
|
|
105 |
|
| 76 |
|
106 |
|
| 77 |
=== Notes on the Qobuz interface
|
107 |
=== Notes on the Qobuz interface
|
| 78 |
|
108 |
|
| 79 |
This is based on the service API from the
|
109 |
This is based on the service API from the
|
| 80 |
link:https://github.com/tidalf/plugin.audio.qobuz[Kodi add-on], by Joachim
|
110 |
link:https://github.com/tidalf/plugin.audio.qobuz[Kodi add-on], by Joachim
|