LISTENBRAINZ-MPD(1)   LISTENBRAINZ-MPD(1)

listenbrainz-mpd - ListenBrainz submission client for MPD

listenbrainz-mpd [OPTION]...

MPD client program that automatically submits your listened songs to https://listenbrainz.org or another API-compatible destination.

-c, --config CONFIG_FILE

Use CONFIG_FILE instead of the default config file.

--create-default-config

Create a default configuration file in the default location and exit.

--send-feedback love|hate|clear

Send ListenBrainz feedback for the currently playing song, if any.

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.

-h, --help

Print help and exit.

-V, --version

Print version information and exit.

Configuration is loaded from $XDG_CONFIG_HOME/listenbrainz-mpd/config.toml, or $HOME/.config/listenbrainz-mpd/config.toml if XDG_CONFIG_HOME is unset. An alternative configuration file may be specified using the --config option.

See the sample configuration file for details on the supported configuration keys.

Environment variables will override the equivalent values from the CONFIGURATION.

LISTENBRAINZ_TOKEN

ListenBrainz user token.

MPD_HOST

Host of the MPD server. May be a hostname, a bare IP address, or an absolute path to a Unix socket. To use a server password, specify a value like password@host.

MPD_PORT

TCP port of the MPD server.

Source code and issue tracker

https://codeberg.org/elomatreb/listenbrainz-mpd

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.

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.

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

listenbrainz-mpd contributors

2026-01-16