LISTENBRAINZ-MPD(1)

📦
version 2.6.0 · 3 versions
, in arch rolling

💖 listenbrainz-mpd(1) 💖

okay so bestie, this is the manual page for listenbrainz-mpd, and it's genuinely one of those little tools that just works and minds its own business. it's a ListenBrainz submission client for MPD, and i'm gonna walk you through every single thing it does. no gatekeeping, periodt. ✨

🌸 NAME 🌸

listenbrainz-mpd — a ListenBrainz submission client for MPD. that's it, that's the vibe. it scrobbles for you so you don't have to think about it. 🎀

🦋 SYNOPSIS 🦋

listenbrainz-mpd [OPTION]...

✨ DESCRIPTION ✨

so listenbrainz-mpd is an MPD client program — which means it talks to your music player daemon — and it automatically submits your listened songs to https://listenbrainz.org or to another API-compatible destination. you press play, it does the paperwork. main character energy fr. 🔥

💅 OPTIONS 💅

  • -c, --config CONFIG_FILE — use CONFIG_FILE instead of the default config file. like, "i brought my own snacks" energy.
  • --create-default-config — creates a default configuration file in the default location and then exits. great for first-time setup, iconic honestly.
  • --send-feedback love|hate|clear — sends ListenBrainz feedback for the currently playing song, if any. if nothing's playing, there's nothing to have feelings about, yk?
    • love — mark the currently playing song as "loved". 💖
    • hate — mark the currently playing song as "hated". 💀
    • clear — clear previously submitted feedback for the currently playing song. back to neutral, no notes.
  • -h, --help — print help and exit. the classic.
  • -V, --version — print version information and exit. 👑

🎀 CONFIGURATION 🎀

configuration is loaded from $XDG_CONFIG_HOME/listenbrainz-mpd/config.toml, or from $HOME/.config/listenbrainz-mpd/config.toml if XDG_CONFIG_HOME is unset. and yeah — you can point it somewhere else entirely with the --config option if you're that kind of person (respect).

see the sample configuration file for details on the supported configuration keys. it's giving "read the docs, bestie" but like, lovingly. 🙈

🌈 ENVIRONMENT 🌈

environment variables will override the equivalent values from the CONFIGURATION. so env wins the argument. every time.

  • LISTENBRAINZ_TOKEN — your ListenBrainz user token. keep it secret, keep it safe. 🫶
  • MPD_HOST — host of the MPD server. may be a hostname or a bare IP address. IPv6 addresses should not be enclosed in square brackets (put the brackets away, they're not invited). to use a server password, specify a value like password@host. if the host starts with / it indicates the path to a Unix socket. if the host starts with @ it indicates the name of an abstract socket (Linux only). so many moods, one variable.
  • MPD_PORT — TCP port of the MPD server. 🔌

⭐ RESOURCES ⭐

🧚 COPYING 🧚

copyright © 2023 listenbrainz-mpd contributors.

this program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation. slay, legally speaking.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU Affero General Public License for more details. (translation: it's free, but if it breaks, that's on the universe, not on them. 😭)

you should have received a copy of the GNU Affero General Public License along with this program. if not, see https://www.gnu.org/licenses/.

👑 AUTHOR 👑

listenbrainz-mpd contributors — a whole crew, not just one person. we love a collaborative moment. 💜

and that's the whole page, bestie 🍓 — this manual page is from 2026-08-26, and yeah, it's still filed under LISTENBRAINZ-MPD(1) like the icon it is. go forth and scrobble responsibly. 💅✨

📦 where this page comes from