mpdscribble(1)							   User Manuals 						    mpdscribble(1)

NAME

       mpdscribble - A Music Player Daemon (MPD) client which submits information about tracks being played to a scrobbler (e.g. last.fm).

SYNOPSIS

       mpdscribble [options]

DESCRIPTION

       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  local-
       host: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.

OPTIONS

       --help Display help and exit.

       --version
	      Display version information and exit.

       --no-daemon
	      Don't daemonize mpdscribble, run it in foreground.

       --pidfile FILE
	      Write the process id to this file.

       --daemon-user USERNAME
	      Change to this system user after daemonization.

       --log FILE
	      Specify log file.  The special value "syslog" makes mpdscribble use the local syslog daemon (which is the default).  "-"	means  log
	      to stderr.

       --conf FILE
	      Read configuration options from file. /etc/mpdscribble.conf is used by default (if --sysconfdir=/etc).

       --host [PASSWORD@]HOSTNAME
	      Specify host protected by password.  To connect via Unix Domain Socket, specify an absolute path here.

       --port PORT
	      Specify which port the MPD listens on.

       --proxy URL
	      HTTP proxy URL.

       --verbose LEVEL
	      Specify how verbosely mpdscribble should log.  Possible values are 0 to 3, defaulting to 1.

CONFIGURATION

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

       Supported configuration options:

       pidfile = FILE
	      Write the process id to this file.

       log = FILE
	      The file to which mpdscribble should output debugging information.  The special value "syslog" makes mpdscribble use the local  sys-
	      log daemon (which is the default).  "-" means log to stderr.

       host = [PASSWORD@]HOSTNAME
	      The host running MPD, possibly protected by a password.  To connect via Unix Domain Socket, specify an absolute path here.

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

       proxy = URL
	      HTTP proxy URL.

       verbose = 0, 1, 2, 3
	      How  verbose  mpdscribble's  logging  should be.	Default is 1.  "0" means log only critical errors (e.g. "out of memory"); "1" also
	      logs non-critical errors (e.g. "server unreachable"); "2" logs informational messages (e.g. "new song"); "3" prints a lot of  debug-
	      ging messages.

SCROBBLERS

       These  options  are  followed by at least one scrobbler section (choose a unique section name like "libre.fm" which only appears in the log
       file; the name "mpdscribble" is reserved).

       file = PATH
	      Log to a file instead of submitting the songs to an AudioScrobbler server.

       url = URL
	      The handshake URL of the scrobbler.  Example: "http://post.audioscrobbler.com/", "http://turtle.libre.fm/"

       username = USERNAME
	      Your audioscrobbler username.

       password = MD5SUM
	      Your Last.fm password, either cleartext or its MD5 sum.

       journal = FILE
	      The file where mpdscribble should store its journal in case you do not have a connection to the scrobbler.  This option used  to	be
	      called "cache".  It is optional.

FILES

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

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

       /var/cache/mpdscribble/mpdscribble.cache
	      The system wide Last.fm cache file.

       ~/.mpdscribble/mpdscribble.cache
	      Per user Last.fm cache file.

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

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

BUGS

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

       Please report new bugs to the MPD bug tracker: http://www.musicpd.org/mantis

CREDITS

       Current maintainer: Max Kellermann <max@duempel.org>
	      http://max.kellermann.name/

       Original 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/

SEE ALSO

       mpd(1), mpc(1)

Linux								   JANUARY 2009 						    mpdscribble(1)