a/doc/upmpdcli.txt b/doc/upmpdcli.txt
1
i= Upmpdcli: MPD UPnP Renderer Front-End
1
= Upmpdcli: MPD UPnP Renderer Front-End
2
2
3
3
4
*upmpdcli* is an UPnP Media Renderer front-end to *MPD*, the Music Player
4
*upmpdcli* is an UPnP Media Renderer front-end to *MPD*, the Music Player
5
Daemon. It supports both pure UPnP and the OpenHome ohMedia services.
5
Daemon. It supports both pure UPnP and the OpenHome ohMedia services.
6
6
...
...
197
197
198
This facility uses Python 2.x, which must be available on the system for
198
This facility uses Python 2.x, which must be available on the system for
199
the radio links to work.
199
the radio links to work.
200
200
201
Radio stations can be defined in the configuration (at the end because of
201
Radio stations can be defined in the configuration (at the end because of
202
the use of section indicators). Example:
202
the use of section indicators), or in in a separate file by setting the
203
'radiolist' parameter in the main configuration.
204
Example entry:
203
205
204
----
206
----
205
[radio Radio Teddy]
207
[radio Radio Teddy]
206
url = http://opml.radiotime.com/Tune.ashx?id=s80044
208
url = http://opml.radiotime.com/Tune.ashx?id=s80044
207
artUrl = http://cdn-radiotime-logos.tunein.com/s80044q.png
209
artUrl = http://cdn-radiotime-logos.tunein.com/s80044q.png
210
artScript = /path/to/some/script
208
----
211
----
209
212
210
The section name must begin with `radio`, the rest will be displayed as the
213
The section name must begin with `radio`, the rest will be displayed as the
211
station name. `url` and `artUrl` designate the playlist or stream, and an
214
station name. `url` and `artUrl` designate the playlist or stream, and an
212
icon. `artUrl` is optional.
215
icon. `artUrl` is optional.
213
216
214
Radio channels can be accessed by selecting the `Radio` Source from an
217
Radio channels can be accessed by selecting the `Radio` Source from an
215
OpenHome Control Point.
218
OpenHome Control Point.
216
219
217
You can also define the radio stations in a separate file by setting the
220
218
'radiolist' parameter in the main configuration.
221
Some radios (e.g. radioparadise) publish the album art for the currently
222
playing title. The details vary. `artScript`, if set, should point to an
223
executable script which prints this dynamic art Uri to stdout. The
224
image will supercede the radio logo, to be displayed by control
225
points. Beware that the path to the script must be accessible by the
226
`upmpdcli` user, which may not be the case for your home. `/usr/local/bin` is
227
your friend. As a very rough example here follows a command which would
228
retrieve the radioparadise uri (as long as they don't change their format,
229
a proper approach would use an xml parser of course):
230
231
    curl -s http://radioparadise.com/xml/now.xml | \
232
         grep '<coverart>' | sed -e 's/<coverart>//' -e 's!</coverart>!!'
219
233
220
[[upmpdcli.songcast]]
234
[[upmpdcli.songcast]]
221
== Songcast integration
235
== Songcast integration
222
236
223
upmpdcli recent versions support Songcast, only when the sc2mpd extension
237
upmpdcli recent versions support Songcast, only when the sc2mpd extension