1mpdscribble(1) User Manuals mpdscribble(1)
2
6 mpdscribble - A Music Player Daemon (MPD) client which submits informa‐
7 tion about tracks being played to a scrobbler (e.g. last.fm).
8
10 mpdscribble [options]
11
13 mpdscribble is a client for MPD, the Music Player Daemon. mpdscribble
14 connects to an MPD running on the local network and works in parallel
15 with other MPD clients on the network.
16 By default it will get the hostname and port for mpd from the MPD_HOST
18 and MPD_PORT environment variables. mpdscribble will use localhost:6600
19 if those are not set. The hostname and port can also be specified in
20 the configuration file or on the command line.
21 $ mpdscribble --host myhost --port=12345
23 Values specified on the command line override values from the configu‐
25 ration file or environment variables.
26 If you want to use mpdscribble with a password-protected MPD, set the
28 environment variable MPD_HOST to password@host, or specify the host in
29 the configuration file similarly.
30
33 --help Display help and exit.
34 --version
36 Display version information and exit.
37 --no-daemon
39 Don't daemonize mpdscribble, run it in foreground.
40 --pidfile FILE
42 Write the process id to this file.
43 --daemon-user USERNAME
45 Change to this system user after daemonization.
46 --log FILE
48 Specify log file. The special value "syslog" makes mpdscribble
49 use the local syslog daemon (which is the default). "-" means
50 log to stderr.
51 --conf FILE
53 Read configuration options from file. /etc/mpdscribble.conf is
54 used by default (if --sysconfdir=/etc).
55 --host [PASSWORD@]HOSTNAME
57 Specify host protected by password. To connect via Unix Domain
58 Socket, specify an absolute path here.
59 --port PORT
61 Specify which port the MPD listens on.
62 --proxy URL
64 HTTP proxy URL.
65 --verbose LEVEL
67 Specify how verbosely mpdscribble should log. Possible values
68 are 0 to 3, defaulting to 1.
69
71 mpdscribble looks for its configuration file first at ~/.mpdscrib‐
72 ble/mpdscribble.conf and then at /etc/mpdscribble.conf (if
73 --sysconfdir=/etc) but this can be overridden by specifying an alter‐
74 nate configuration file using the command line option --conf.
75 Supported configuration options:
77 pidfile = FILE
79 Write the process id to this file.
80 log = FILE
82 The file to which mpdscribble should output debugging informa‐
83 tion. The special value "syslog" makes mpdscribble use the
84 local syslog daemon (which is the default). "-" means log to
85 stderr.
86 host = [PASSWORD@]HOSTNAME
88 The host running MPD, possibly protected by a password. To con‐
89 nect via Unix Domain Socket, specify an absolute path here.
90 port = PORT
92 The port that the MPD listens on and mpdscribble should try to
93 connect to.
94 proxy = URL
96 HTTP proxy URL.
97 verbose = 0, 1, 2, 3
99 How verbose mpdscribble's logging should be. Default is 1. "0"
100 means log only critical errors (e.g. "out of memory"); "1" also
101 logs non-critical errors (e.g. "server unreachable"); "2" logs
102 informational messages (e.g. "new song"); "3" prints a lot of
103 debugging messages.
104
106 These options are followed by at least one scrobbler section (choose a
107 unique section name like "libre.fm" which only appears in the log file;
108 the name "mpdscribble" is reserved).
109 url = URL
111 The handshake URL of the scrobbler. Example:
112 "http://post.audioscrobbler.com/", "http://turtle.libre.fm/"
113 username = USERNAME
115 Your audioscrobbler username.
116 password = MD5SUM
118 Your Last.fm password, either cleartext or its MD5 sum.
119 journal = FILE
121 The file where mpdscribble should store its journal in case you
122 do not have a connection to the scrobbler. This option used to
123 be called "cache". It is optional.
124
126 /etc/mpdscribble.conf
127 The system wide configuration file.
128 ~/.mpdscribble/mpdscribble.conf
130 Per user configuration file.
131 /var/cache/mpdscribble/mpdscribble.cache
133 The system wide Last.fm cache file.
134 ~/.mpdscribble/mpdscribble.cache
136 Per user Last.fm cache file.
137 /var/log/mpdscribble/mpdscribble.log
139 The system wide log file.
140 ~/.mpdscribble/mpdscribble.log
142 Per user log file.
143
145 File permissions on cache/log file may be insecure by default.
146 Please report new bugs to the MPD bug tracker:
148 http://www.musicpd.org/mantis
149
152 Current maintainer: Max Kellermann <max@duempel.org>
153 http://max.kellermann.name/
154 Original author: Kuno Woudt <kuno@frob.nl>
156 http://www.audioscrobbler.com/user/warp/
157 Various patches: Nikki
159 http://www.audioscrobbler.com/user/cikkolata/
160 The name mpdscribble coined by: honey in #audioscrobbler
162 http://www.audioscrobbler.com/user/honeypea/
163 Manpage written by: Trevor Caira <trevor.caira@gmail.com>
165 http://www.audioscrobbler.com/user/TrevorCaira/
166
169 mpd(1), mpc(1)
170Linux JANUARY 2009 mpdscribble(1)