Switch to unified view

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.