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 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.

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  syslog  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 debugging 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)