'\" t
.\"     Title: listenbrainz-mpd
.\"    Author: listenbrainz-mpd contributors
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-01-16
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "LISTENBRAINZ\-MPD" "1" "2026-01-16" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
listenbrainz-mpd \- ListenBrainz submission client for MPD
.SH "SYNOPSIS"
.sp
\fBlistenbrainz\-mpd\fP [\fIOPTION\fP].\|.\|.
.SH "DESCRIPTION"
.sp
MPD client program that automatically submits your listened songs to \c
.URL "https://listenbrainz.org" "" ""
or another API\-compatible destination.
.SH "OPTIONS"
.sp
\fB\-c, \-\-config\fP \fICONFIG_FILE\fP
.RS 4
Use \fICONFIG_FILE\fP instead of the default config file.
.RE
.sp
\fB\-\-create\-default\-config\fP
.RS 4
Create a default configuration file in the default location and exit.
.RE
.sp
\fB\-\-send\-feedback love|hate|clear\fP
.RS 4
Send ListenBrainz feedback for the currently playing song, if any.
.sp
\fBlove\fP
.RS 4
Mark the currently playing song as "loved".
.RE
.sp
\fBhate\fP
.RS 4
Mark the currently playing song as "hated".
.RE
.sp
\fBclear\fP
.RS 4
Clear previously submitted feedback for the currently playing song.
.RE
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
Print help and exit.
.RE
.sp
\fB\-V, \-\-version\fP
.RS 4
Print version information and exit.
.RE
.SH "CONFIGURATION"
.sp
Configuration is loaded from \fB$XDG_CONFIG_HOME/listenbrainz\-mpd/config.toml\fP, or \fB$HOME/.config/listenbrainz\-mpd/config.toml\fP if \fBXDG_CONFIG_HOME\fP is unset.
An alternative configuration file may be specified using the \fB\-\-config\fP option.
.sp
See the sample configuration file for details on the supported configuration keys.
.SH "ENVIRONMENT"
.sp
Environment variables will override the equivalent values from the CONFIGURATION.
.sp
\fBLISTENBRAINZ_TOKEN\fP
.RS 4
ListenBrainz user token.
.RE
.sp
\fBMPD_HOST\fP
.RS 4
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 \fIpassword\fP\fB@\fP\fIhost\fP.
.RE
.sp
\fBMPD_PORT\fP
.RS 4
TCP port of the MPD server.
.RE
.SH "RESOURCES"
.sp
Source code and issue tracker
.RS 4
.URL "https://codeberg.org/elomatreb/listenbrainz\-mpd" "" ""
.RE
.SH "COPYING"
.sp
Copyright \(co 2023 listenbrainz\-mpd contributors.
.br
.sp
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.
.sp
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.
.sp
You should have received a copy of the GNU Affero General Public License along with this program. If not, see \c
.URL "https://www.gnu.org/licenses/" "" "."
.SH "AUTHOR"
.sp
listenbrainz-mpd contributors