MPRIS-SCROBBLER(1)

💖 MPRIS-SCROBBLER(1) 💖

okay bestie, welcome to the General Commands Manual entry for mpris-scrobbler — yes, that's section 1, we're in the big leagues now 🎀

---

✨ NAME ✨

mpris-scrobbler — the MPRIS scrobbler user daemon 🫶

---

🌸 SYNOPSIS 🌸

mpris-scrobbler [OPTIONS...]

---

🦋 DESCRIPTION 🦋

mpris-scrobbler is a minimalistic user daemon whose whole entire job is submitting the current playing songs to any of the supported scrobbling services. no cap, that's it, that's the gig 💅

and the way it can interact with any media-player that conforms to the MPRIS D-Bus Interface Specification[1]? iconic. truly. it does not care what player you're using as long as it plays nice with the spec 🌈

---

👑 SERVICES 👑

the services that mpris-scrobbler supports are, in this exact order:

• listenbrainz.org — a music service associated with the Music Brainz audio fingerprinting service.
• libre.fm — the open source variant of the original audioscrobbler.com service.
• last.fm — the evolution of the closed audioscrobbler.com service under the CBS umbrella.

---

⭐ OPTIONS ⭐

• -h, --help — prints a short help message plus the version number, then dips out. bye bestie 👋
• -q, --quiet — do not print any debugging messages. silence, but make it fashion 🤫
• -v, -vv, -vvv, --verbose=[1..3] — crank up the print verbosity to level:
  1. Info messages.
  2. Debug messages.
  3. Tracing messages.

the default is to display only error and warning messages. so if you're like "why is nothing showing up", that's why, she's just being chill 🍓

---

💜 SIGNALS 💜

• SIGTERM — upon receiving this signal, the mpris-scrobbler daemon will try to cleanly exit. graceful queen behavior ✨
• SIGINT — the mpris-scrobbler daemon treats this signal the same as SIGTERM. same energy, different name 💫
• SIGHUP — reloads the credentials file[3], then reloads the current playing track if possible and submits it to the loaded services. it's giving refresh and re-submit 🔥

---

🧚 ENVIRONMENT 🧚

• $XDG_CONFIG_HOME, $XDG_DATA_HOME, $XDG_CACHE_HOME, $XDG_RUNTIME_DIR — the mpris-scrobbler daemon uses these variables in accordance to the XDG Base Directory specification[2] to find its configuration and save its PID file.

---

🌟 NOTES 🌟

1. MPRIS D-Bus Interface Specification https://specifications.freedesktop.org/mpris-spec/latest/
2. XDG Base Directory specification http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
3. mpris-scrobbler-credentials(5)

---

💖 SEE ALSO 💖

mpris-scrobbler-signon(1), mpris-scrobbler-credentials(5)

lowkey go read those too, iykyk 💅

---

and that's a wrap, bestie 🎀 this was mpris-scrobbler(1) from the General Commands Manual, source and version dated 2026-09-25 — go scrobble something iconic, mwah 😭💖