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 file = PATH
111 Log to a file instead of submitting the songs to an AudioScrob‐
112 bler server.
113 url = URL
115 The handshake URL of the scrobbler. Example:
116 "http://post.audioscrobbler.com/", "http://turtle.libre.fm/"
117 username = USERNAME
119 Your audioscrobbler username.
120 password = MD5SUM
122 Your Last.fm password, either cleartext or its MD5 sum.
123 journal = FILE
125 The file where mpdscribble should store its journal in case you
126 do not have a connection to the scrobbler. This option used to
127 be called "cache". It is optional.
128
130 /etc/mpdscribble.conf
131 The system wide configuration file.
132 ~/.mpdscribble/mpdscribble.conf
134 Per user configuration file.
135 /var/cache/mpdscribble/mpdscribble.cache
137 The system wide Last.fm cache file.
138 ~/.mpdscribble/mpdscribble.cache
140 Per user Last.fm cache file.
141 /var/log/mpdscribble/mpdscribble.log
143 The system wide log file.
144 ~/.mpdscribble/mpdscribble.log
146 Per user log file.
147
149 File permissions on cache/log file may be insecure by default.
150 Please report new bugs to the MPD bug tracker:
152 http://www.musicpd.org/mantis
153
156 Current maintainer: Max Kellermann <max@duempel.org>
157 http://max.kellermann.name/
158 Original author: Kuno Woudt <kuno@frob.nl>
160 http://www.audioscrobbler.com/user/warp/
161 Various patches: Nikki
163 http://www.audioscrobbler.com/user/cikkolata/
164 The name mpdscribble coined by: honey in #audioscrobbler
166 http://www.audioscrobbler.com/user/honeypea/
167 Manpage written by: Trevor Caira <trevor.caira@gmail.com>
169 http://www.audioscrobbler.com/user/TrevorCaira/
170
173 mpd(1), mpc(1)
174Linux JANUARY 2009 mpdscribble(1)