1mpdscribble(1)                   User Manuals                   mpdscribble(1)
2
3
4

NAME

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

SYNOPSIS

10       mpdscribble [options]
11

DESCRIPTION

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
17       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
22       $ mpdscribble --host myhost --port=12345
23
24       Values  specified on the command line override values from the configu‐
25       ration file or environment variables.
26
27       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
31

OPTIONS

33       --help Display help and exit.
34
35       --version
36              Display version information and exit.
37
38       --no-daemon
39              Don't daemonize mpdscribble, run it in foreground.
40
41       --pidfile FILE
42              Write the process id to this file.
43
44       --daemon-user USERNAME
45              Change to this system user after daemonization.
46
47       --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
52       --conf FILE
53              Read configuration options from file.  /etc/mpdscribble.conf  is
54              used by default (if --sysconfdir=/etc).
55
56       --host [PASSWORD@]HOSTNAME
57              Specify  host protected by password.  To connect via Unix Domain
58              Socket, specify an absolute path here.
59
60       --port PORT
61              Specify which port the MPD listens on.
62
63       --proxy URL
64              HTTP proxy URL.
65
66       --verbose LEVEL
67              Specify how verbosely mpdscribble should log.   Possible  values
68              are 0 to 3, defaulting to 1.
69

CONFIGURATION

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
76       Supported configuration options:
77
78       pidfile = FILE
79              Write the process id to this file.
80
81       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
87       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
91       port = PORT
92              The port that the MPD listens on and mpdscribble should  try  to
93              connect to.
94
95       proxy = URL
96              HTTP proxy URL.
97
98       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

SCROBBLERS

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
110       file = PATH
111              Log  to a file instead of submitting the songs to an AudioScrob‐
112              bler server.
113
114       url = URL
115              The    handshake    URL    of    the    scrobbler.      Example:
116              "http://post.audioscrobbler.com/", "http://turtle.libre.fm/"
117
118       username = USERNAME
119              Your audioscrobbler username.
120
121       password = MD5SUM
122              Your Last.fm password, either cleartext or its MD5 sum.
123
124       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

FILES

130       /etc/mpdscribble.conf
131              The system wide configuration file.
132
133       ~/.mpdscribble/mpdscribble.conf
134              Per user configuration file.
135
136       /var/cache/mpdscribble/mpdscribble.cache
137              The system wide Last.fm cache file.
138
139       ~/.mpdscribble/mpdscribble.cache
140              Per user Last.fm cache file.
141
142       /var/log/mpdscribble/mpdscribble.log
143              The system wide log file.
144
145       ~/.mpdscribble/mpdscribble.log
146              Per user log file.
147

BUGS

149       File permissions on cache/log file may be insecure by default.
150
151       Please     report    new    bugs    to    the    MPD    bug    tracker:
152       http://www.musicpd.org/mantis
153
154

CREDITS

156       Current maintainer: Max Kellermann <max@duempel.org>
157              http://max.kellermann.name/
158
159       Original author: Kuno Woudt <kuno@frob.nl>
160              http://www.audioscrobbler.com/user/warp/
161
162       Various patches: Nikki
163              http://www.audioscrobbler.com/user/cikkolata/
164
165       The name mpdscribble coined by: honey in #audioscrobbler
166              http://www.audioscrobbler.com/user/honeypea/
167
168       Manpage written by: Trevor Caira <trevor.caira@gmail.com>
169              http://www.audioscrobbler.com/user/TrevorCaira/
170
171

SEE ALSO

173       mpd(1), mpc(1)
174
175
176
177
178Linux                            JANUARY 2009                   mpdscribble(1)
Impressum