MPRIS-SCROB...-CREDENTIALS(5)

💖 MPRIS-SCROB...-CREDENTIALS 💖

okay bestie, welcome to the MPRIS scrobbler credentials file — it lives in section 5 of the File Formats Manual, and it's the little secret-keeping file that holds all your scrobbling logins. let's get into it 🫶

---

✨ SYNOPSIS ✨

$XDG_DATA_HOME/mpris-scrobbler/credentials

---

🌸 DESCRIPTION 🌸

so this is the config file for the mpris-scrobbler daemon, and its whole job is storing the authentication credentials for whichever services you've turned on. heads up though: the credentials are stored in plain text, so it is genuinely important that the file is not world readable. no cap. lock it down. 🔒

the format supports multiple sections, and each section = one scrobbling service, and each one can hold as many value assignments as you want. it's giving organized. it's giving structured. we love her. ✨

a section gets introduced by a line that has the service name wrapped in square brackets, so like

[librefm]

would introduce a service called librefm. iconic.

a value assignment is just one single line: the name of the value, an equals sign, and a setting for the value. so

enabled = true

would set the value named enabled in the current service section to true. and listen — any spaces before or after the name and the value are ignored, so you can space it out however you want, she does not care 💅

also: any line starting with ; is ignored, and so is any blank line. comments and vibes only.

---

🎀 SERVICES 🎀

the recognized service labels are:

• listenbrainz — used to store configuration settings related to the open listenbrainz.org platform 🌈
• librefm — used to store configuration settings related to the open libre.fm platform 🦋
• lastfm — used to store configuration settings related to the proprietary last.fm platform 👑

---

💅 OPTIONS 💅

• enabled= — boolean value showing whether the current service is active or not. value can be 0|1 or enabled|disabled
• username= — string value containing the user name of the authenticated session
• token= — string value containing the application token that the current session is authenticated with
• session= — string value containing the application session key that the current user is authenticated with
• url= — string value containing the custom URL for the current service's end-point. the only services that support this option are libre.fm and listenbrainz.org

---

⭐ EXAMPLE ⭐

[librefm]
enabled = true
username = <username>
token = <oauth-token-value>
session = <oauth-session-value>

[listenbrainz]
enabled = true
token = <listenbrainz-auth-token>

---

🦋 FILES 🦋

$XDG_DATA_HOME/mpris-scrobbler/credentials

---

👀 SEE ALSO 👀

mpris-scrobbler(1) mpris-scrobbler-signon(1)

---

and that's the whole page, bestie — go forth and scrobble responsibly 💖✨

this lil masterpiece is from the File Formats Manual, dated 2026-09-25 — MPRIS-SCROB...-CREDENTIALS(5), periodt. 🎀