mpdas(1)

💖 mpdas — the Music Player Daemon AudioScrobbler 💖

okay bestie, sit down, hydrate, and let me tell you about mpdas(1) from the General Commands Manual. it's giving "your MPD listening history but make it online". ✨

🌸 NAME 🌸

mpdas — Music Player Daemon AudioScrobbler

like. that's the whole name. short, iconic, does exactly what it says on the tin. 👑

🦋 SYNOPSIS 🦋

mpdas [options]

yeah that's it. no fancy subcommands, no weird positional args, just vibes and options. periodt. 💅

✨ DESCRIPTION ✨

so mpdas is a MPD AudioScrobbler client. what does that mean fr fr? it uses libmpd to go grab the song data from MPD (your Music Player Daemon), and then it uses libcurl to post all of that to Last.fm. so every track you play gets lovingly yeeted onto your scrobble history. no cap, that's the whole job. 🎀

💜 OPTIONS 💜

• -c CONFIGFILE — read the configuration from file instead of doing the usual default hunt. yes you can point it wherever you want. main character energy.
• -d — run detached from the controlling terminal. it just. leaves. goes off on its own. 🦋
• -h — display help. your girl needs directions sometimes.
• -v — display version. gotta know which era of mpdas you're living in. ⭐

🌈 CONFIGURATION 🌈

okay so when mpdas starts up, it goes looking for its config in a very specific order, and you need to know this:

1. first it tries the system config file at $SYSCONFIGDIR/mpdasrc
2. then it tries your user config file at ~/.config/mpdasrc (and this one is taken from $XDG_CONFIG_HOME if that's set) — or, alternatively, ~/.mpdasrc

also, an example configuration file called mpdasrc.example is usually provided along with mpdas, so you're not out here guessing. use it, bestie. 🫶

now here's every single thing you can put in there:

• username = LASTFM USERNAME — set your Last.fm username. obviously.
• password = LASTFM PASSWORD — set your Last.fm password. keep it secret, keep it safe. 🙈
• host = HOSTNAME — set the hostname that MPD is using.
• mpdpassword = MPD PASSWORD — set the password that MPD wants.
• port = MPD PORT — set the port that MPD is listening on.
• runas = USERNAME — changes which user mpdas runs as.
• debug = (0|1) — print out debug information. turn it on when things are acting up, it's giving detective mode 🔥
• service = SERVICE NAME — will scrobble to Libre.fm if you set this to "librefm". otherwise, Last.fm is used, and that's the default.

ngl the service one is lowkey the cutest option because it's just a little string that decides your whole scrobbling destiny. "librefm" = Libre.fm, anything else = Last.fm. iykyk. 💖

🎀 AUTHORS 🎀

mpdas was written by Henrik Friedrichsen <henrik@affekt.org>. absolute legend behavior.

the manpage was written by Sebastian Mair <tuqs@core.ws>. thank you for your service. 🫡

and that's the whole thing!! this lil page lives in the General Commands Manual as mpdas(1), and if you ever forget everything i just said, just come back here and reread it. mwah. 💅💖✨