Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
mpdscribble(1)			 User Manuals			mpdscribble(1)

NAME
       mpdscribble - A Music Player Daemon (MPD) client	which submits informa-
       tion 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 configu-
       ration 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 ~/.mpdscrib-
       ble/mpdscribble.conf   and   then    at	  /etc/mpdscribble.conf	   (if
       --sysconfdir=/etc)  but	this can be overridden by specifying an	alter-
       nate 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  informa-
	      tion.   The special value	"syslog" makes mpdscribble use the lo-
	      cal syslog daemon	(which is the  default).   "-"	means  log  to
	      stderr.

       host = [PASSWORD@]HOSTNAME
	      The host running MPD, possibly protected by a password.  To con-
	      nect 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  AudioScrob-
	      bler server.

       url = URL
	      The  handshake  URL of the scrobbler.  Example: "http://post.au-
	      dioscrobbler.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.mu-
       sicpd.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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mpdscribble&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help