mpd scribble - A Music Player Daemon (MPD) client which submits information about tracks being played to Audioscrobbler.

mpdscribble [options]

mpdscribble is a client for MPD, the Music Player Daemon. mpdscribble connects to an MPD running on the local network and works in parallel with other MPD clients on the network.

By default it will get the hostname and port for mpd from the MPD_HOST and MPD_PORT environment variables. mpdscribble will use localhost:6600 if those are not set. The hostname and port can also be specified in the configuration file or on the command line.

$ mpdscribble --host myhost --port=12345

Values specified on the command line override values from the configuration file or environment variables.

If you want to use mpdscribble with a password-protected MPD, set the environment variable MPD_HOST to password@host, or specify the host in the configuration file similarly.

--help

Display help and exit.

--version

Display version information and exit.

--log FILE

Specify log file. /var/log/mpdscribble.log is used by default.

--cache FILE

Specify Audioscrobbler cache file. /var/cache/mpdscribble.cache is used by default.

--conf FILE

Read configuration options from file. /etc/mpdscribble/mpdscribble.conf is used by default.

--host [PASSWORD@]HOSTNAME

Specify host protected by password.

--port PORT

Specify which port the MPD listens on.

--sleep INTERVAL

Specify how often mpdscribble should query MPD (in seconds, default is 5).

--cache-interval INTERVAL

Specify how often mpdscribble should write its cache file (in seconds, default is 600).

--verbose LEVEL

Specify how verbosely mpdscribble should log. Possible values are 0, 1, 2.

mpdscribble looks for its configuration file first at ~/.mpdscribble/mpdscribble.conf and then at /etc/mpdscribble/mpdscribble.conf but this can be overridden by specifying an alternate configuration file using the command line option --conf.

Supported configuration options:

username = USERNAME

Your audioscrobbler username.

password = MD5SUM

The md5sum of your Audioscrobbler password.

log = FILE

The file to which mpdscribble should output debugging information.

cache = FILE

The file where mpdscribble should store its Audioscrobbler cache in case you do not have a connection to the Audioscrobbler server.

host = [PASSWORD@]HOSTNAME

The host running MPD, possibly protected by a password.

port = PORT

The port that the MPD listens on and mpdscribble should try to connect to.

verbose = 0, 1, 2

How verbose mpdscribble's logging should be.

sleep = INTERVAL

How long mpdscribble should wait between MPD status queries.

/etc/mpdscribble/mpdscribble.conf The system wide configuration file.

~/.mpdscribble/.mpdscribble.conf Per user configuration file.

/var/cache/mpdscribble.cache The system wide Audioscrobbler cache file.

~/.mpdscribble/mpdscribble.cache Per user Audioscrobbler cache file.

/var/log/mpdscribble.log The system wide log file.

~/.mpdscribble/.mpdscribble.log Per user log file.

mpdscribble does not currently work when crossfading is enabled. (this will be fixed when MPD provides a listener API, this is scheduled for mpd 0.13).

mpdscribble does not obtain musicbrainz tags from MPD (this is a limitation in the way MPD handles metadata, and will hopefully be fixed in the distant future).

File permissions on cache/log file may be insecure by default.

Currently there is no proxy support (neither for connecting to AS nor MPD).

Please report new bugs to Kuno Woudt <kuno@frob.nl>.

Author: Kuno Woudt <kuno@frob.nl> http://www.audioscrobbler.com/user/warp/

Various patches: Nikki http://www.audioscrobbler.com/user/cikkolata/

The name mpdscribble coined by: honey in #audioscrobbler http://www.audioscrobbler.com/user/honeypea/

Manpage written by: Trevor Caira <trevor.caira@gmail.com> http://www.audioscrobbler.com/user/TrevorCaira/

mpd(1), mpc(1)