--- a/doc/upmpdcli.txt
+++ b/doc/upmpdcli.txt
@@ -11,8 +11,7 @@
stream.
As of version 1.2.0, the software includes a Media Server gateway to
-streaming music services, with initial support for Google Play Music, Qobuz
-and Tidal.
+cloud streaming music services.
[[upmpdcli.security]]
== Security
@@ -47,7 +46,8 @@
Upmpdcli versions 1.2.0 and later offer support for accessing music on some
streaming services. You will need a valid account on the services you want
-to use. The initial release supports Google Play Music, Qobuz and Tidal.
+to use. The initial release supports Google Play Music, Qobuz and Tidal
+(which does not work any more, see the notes in the Tidal section).
When the function is activated, upmpdcli creates a separate auxiliary Media
Server, with the sole purpose of presenting the streaming server
@@ -58,9 +58,33 @@
Streaming is not limited to the local upmpdcli renderer, and the Media
Server should happily send music to other renderers.
+NOTE: The streaming services passwords are stored in the upmpdcli
+configuration file ('/etc/upmpdcli.conf'). The 1.2.2 installer does not
+make this file r/w by owner only. This will be fixed, but for now, you
+should probably do it after setting the password:
++chmod 600 /etc/upmpdcli.conf+ Actually, it would quite probably
+be a good idea not to use the same account for your mail and music uses.
+
+NOTE: I have no reason to believe that upmpdcli is technically mis-using
+the streaming services in any way, but it is definitely not approved by any
+of them, and you are using it under your own responsibility.
+
=== Notes on the Tidal interface
-This is based on the
+[NOTE]
+===================================
+There seems to be problems when streaming Tidal lossless/FLAC streams,
+with the default MPD configuration. A preliminary and rather superficial
+enquiry seems to indicate that this is caused by too much buffering by
+MPD. Adding the following parameters to the MPD configuration file
+(/etc/mpd.conf) reduces the pre-fetch period from 20 S to 10 S and seems to
+fix the issues for me:
+
+ audio_buffer_size "2048"
+ buffer_before_play "20%"
+====================================
+
+The Tidal module code is is based on the
link:https://github.com/tamland/kodi-tidal[Kodi Tidal add-on] and the
link:https://github.com/tamland/python-tidal[Tidal API], by Thomas
Amland (also using other useful modules by Thomas). I was able to reuse
@@ -73,6 +97,12 @@
The configuration parameters are described
link:#_tidal_streaming_service_parameters[further down].
+
+NOTE: as of 2016-09-17, the Tidal interface does not seem to work any
+more. It appears that the Kodi add-on has problems too, so this probably
+comes from a change on the Tidal side, maybe they invalidated the API key
+which was used by most open-source interfaces.
+
=== Notes on the Qobuz interface