mpdscribble(1)

📦
version 0.26 · 3 versions
, in arch rolling

💅 mpdscribble(1) — the MPD scrobbler bestie manual 💅

okay so welcome to the User Manuals glow-up of mpdscribble(1). This is the page for the little client that scrobbles your tracks, and yes, it ate. 💖

✨ NAME ✨

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

🦋 SYNOPSIS 🦋

mpdscribble [options]

💖 DESCRIPTION 💖

mpdscribble is a client for MPD, the Music Player Daemon. It connects to an MPD running on the local network and works in parallel with other MPD clients on the network. It's giving main character energy but make it a network client.

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

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. no cap, that's the whole vibe.

On submission failure, mpdscribble waits for some time then retries. Sending a USR1 signal to a running mpdscribble process makes it submit immediately. slay.

🎀 OPTIONS 🎀

  • --help — Pops up the help text and exits.
  • --version — Prints version info and exits.
  • --no-daemon — Keeps mpdscribble in the foreground instead of daemonizing it.
  • --pidfile FILE — Drops the process id into this file.
  • --daemon-user USERNAME — Switches to this system user after daemonization.
  • --log FILE — Sets the log file. The special value "syslog" makes mpdscribble use the local syslog daemon (which is the default). "-" means log to stderr.
  • --conf FILE — Reads configuration options from this file. /etc/mpdscribble.conf is used by default (if --sysconfdir=/etc).
  • --host [PASSWORD@]HOSTNAME — Specifies the host, protected by a password if you need one. To connect via Unix Domain Socket, specify an absolute path here.
  • --port PORT — Says which port the MPD listens on.
  • --proxy URL — Sets the HTTP proxy URL.
  • --verbose LEVEL — Sets how verbosely mpdscribble should log. Possible values are 0 to 3, defaulting to 1.

🌸 CONFIGURATION 🌸

mpdscribble looks for its configuration file in the following order:

  • $XDG_CONFIG_HOME/mpdscribble/mpdscribble.conf
  • ~/.config/mpdscribble/mpdscribble.conf
  • ~/.mpdscribble/mpdscribble.conf
  • /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 where 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). important bestie!

  • file = PATH — Log to a file instead of submitting the songs to an AudioScrobbler server.
  • url = URL — The handshake URL of the scrobbler. Example: "https://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.
  • ignore = FILE — Include an ignore file for this scrobbler to exclude tracks from scrobbling.

🫶 IGNORE FILE FORMAT 🫶

Tracks can be ignored by listing them in an ignore file. Each line in the file specifies a pattern to match tracks you wish to exclude from scrobbling. The format is simple and flexible, allowing you to match by artist, album, title, track number or a combination of these fields. so useful.

📝 File Format 📝

A tag match is specified as tagname="value", where tagname is replaced with one of the supported tags (artist, album, title, track). Values must be quoted and spaces are not allowed surrounding the equal sign.

Each line consists of one or more tag matches separated by spaces:

tag1="value1" tag2="value2" ...

Tags can appear in any order and blank lines are ignored.

A backslash (\) is interpreted as escape character and may be used to escape literal double quotes within a value. To write a literal backslash, use a double backslash (\\).

Each line is limited to 4096 characters including the newline character. Superfluous characters are silently ignored.

🌈 Examples 🌈

If a tag is omitted, any value for that field is matched:

  • title="Bohemian Rhapsody" — Matches any track titled Bohemian Rhapsody.
  • artist="Queen" — Matches any track by Queen, regardless of album or title.
  • artist="Queen" album="A Night at the Opera" — Matches any track by Queen from A Night at the Opera, regardless of title.
  • artist="Queen" album="A Night at the Opera" title="Bohemian Rhapsody" — Matches a specific track by Queen, from A Night at the Opera, titled Bohemian Rhapsody.
  • artist="Queen" album="A Night at the Opera" track="01" — Matches the first track on the album A Night at the Opera by Queen. Note that track tags are interpreted as text and not numbers, meaning "01" is not the same as "1".
  • artist="Clark \"Plazmataz\" Powell" — Matches tracks by Clark "Plazmataz" Powell.

🍓 FILES 🍓

  • /etc/mpdscribble.conf — The system wide configuration file.
  • ~/.config/mpdscribble/mpdscribble.conf — Per user configuration file.
  • /var/cache/mpdscribble/mpdscribble.cache — The system wide Last.fm cache file.
  • ~/.cache/mpdscribble/mpdscribble.cache — Per user Last.fm cache file.
  • /var/log/mpdscribble/mpdscribble.log — The system wide log file.

💀 BUGS 💀

File permissions on cache/log file may be insecure by default. bestie, be careful with those perms!

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

👑 SEE ALSO 👑

mpd(1), mpc(1) — go read those too, bestie.

okay bye bestie — this page is from Linux, dated JANUARY 2009, and it's literally the mpdscribble(1) manual. slay and scrobble responsibly 💅

📦 where this page comes from