|
a/doc/upmpdcli.txt |
|
b/doc/upmpdcli.txt |
|
... |
|
... |
53 |
|UPnP network interface|-i iface|$UPMPD_UPNPIFACE|upnpiface
|
53 |
|UPnP network interface|-i iface|$UPMPD_UPNPIFACE|upnpiface
|
54 |
|UPnP port|-p port|$UPMPD_UPNPPORT|upnpport
|
54 |
|UPnP port|-p port|$UPMPD_UPNPPORT|upnpport
|
55 |
|===========================
|
55 |
|===========================
|
56 |
|
56 |
|
57 |
|
57 |
|
|
|
58 |
In addition to the above basic parameters, many configuration variables can
|
|
|
59 |
be set in the configuration file.
|
|
|
60 |
|
58 |
[[upmpdcli.configfile]]
|
61 |
[[upmpdcli.configfile]]
|
59 |
== Configuration file
|
62 |
include::upmpdcli-config.txt[]
|
60 |
|
|
|
61 |
In addition of the above, the following variables can be set in the
|
|
|
62 |
configuration file:
|
|
|
63 |
|
|
|
64 |
mpdpassword:: Password for connecting to *MPD* (only necessary if
|
|
|
65 |
password access is enabled in the *MPD* configuration file).
|
|
|
66 |
|
|
|
67 |
ownqueue:: If this is set (on by default), we own the *MPD* queue and will
|
|
|
68 |
fearlessly clear it.
|
|
|
69 |
|
|
|
70 |
upnpip:: UPnP IP address to use (if `upnpiface` is not used to select an
|
|
|
71 |
interface).
|
|
|
72 |
|
|
|
73 |
upnpav:: Activate UPnP AV services. This is set by default, but it may be
|
|
|
74 |
useful to switch it off with some too easily confused OpenHome Control
|
|
|
75 |
Points.
|
|
|
76 |
|
|
|
77 |
openhome:: Activate OpenHome services. This is set by default and there is
|
|
|
78 |
little reason to turn this off.
|
|
|
79 |
|
|
|
80 |
ohmetapersist:: OpenHome playlist disk persistence (default 1), no reason
|
|
|
81 |
to turn it off.
|
|
|
82 |
|
|
|
83 |
cachedir:: Directory for cached data (`/var/cache/upmpdcli` if started as
|
|
|
84 |
root or else `~/.cache/upmpdcli`).
|
|
|
85 |
|
|
|
86 |
pkgdatadir:: Directory where the distributed configuration data (XML files
|
|
|
87 |
etc.) is stored. Default: `$prefix/share/upmpcli` (e.g.:
|
|
|
88 |
`/usr/share/upmpdcli`).
|
|
|
89 |
|
|
|
90 |
iconpath:: Path to an icon to be displayed by Control Points which support
|
|
|
91 |
it. The UPnP protocol has provisions for a renderer to send the URL to a
|
|
|
92 |
descriptive icon as part of the device description. The icon to use can be
|
|
|
93 |
set using the *iconpath* configuration file parameter. Due to current (and
|
|
|
94 |
probably permanent) *upmpdcli* limitations, the image file *must* be a
|
|
|
95 |
64x64 32 bits-per-pixel png file. Default: `$pkgdatadir/icon.png`.
|
|
|
96 |
|
|
|
97 |
presentationhtml:: Path to an HTML file to be used as presentation page. The
|
|
|
98 |
file referenced by the path will only be read once when *upmpdcli* starts,
|
|
|
99 |
it can't presently be used for status updates (but I guess that you could
|
|
|
100 |
put a redirect in there, to something more dynamic served by a real HTTP
|
|
|
101 |
server). Default: `$pkgdatadir/presentation.html`.
|
|
|
102 |
|
|
|
103 |
onplay:: Command to run when MPD playback is about to begin. Note that
|
|
|
104 |
`onplay` is also called if MPD is controlled from another tool, e.g. by
|
|
|
105 |
`mpc`.
|
|
|
106 |
|
|
|
107 |
onstart:: Command to run when a play action is performed. The difference to
|
|
|
108 |
`onplay` is that `onstart` is called *before* playback is about to begin.
|
|
|
109 |
|
|
|
110 |
onstop:: Command to run when MPD playback is about to end. Note that
|
|
|
111 |
`onstop` is also called if MPD is controlled from another tool, e.g. by
|
|
|
112 |
`mpc`.
|
|
|
113 |
|
|
|
114 |
onvolumechange:: Command to run when sound volume is changed.
|
|
|
115 |
|
|
|
116 |
|
63 |
|
117 |
=== Radio station definitions
|
64 |
=== Radio station definitions
|
118 |
|
65 |
|
119 |
Recent Upmpdcli versions (after 0.13) implement an OpenHome Radio service
|
66 |
Recent Upmpdcli versions (after 0.13) implement an OpenHome Radio service
|
120 |
which allows selecting and listening to internet radio stations.
|
67 |
which allows selecting and listening to internet radio stations.
|