listenbrainz-mpd

A ListenBrainz submission client for MPD.

Features

• Submission of listen entries, including "Now Playing" entries
• Full metadata support, including transmission of MusicBrainz IDs
• Ability to submit feedback (Love/Hate) for individual recordings

Usage

1. Install.

   AUR (Arch Linux)

   Install the listenbrainz-mpd AUR package.

   Cargo

   Run cargo install listenbrainz-mpd. Note: If you want to use the provided systemd service file, you need to enable the systemd cargo feature (-F systemd).

   Other Options

   Note: These are maintained by third parties.

   • Nix: listenbrainz-mpd
   • Docker: GioF71/listenbrainz-mpd-docker

2. Configure your ListenBrainz user token through the configuration file or the LISTENBRAINZ_TOKEN environment variable.

   Place the sample configuration file in the appropriate location and fill in your ListenBrainz user token and potentially other relevant configuration.

   Platform	Default config file location
   Linux	$XDG_CONFIG_HOME/listenbrainz-mpd/config.toml
   macOS	$HOME/Library/Application Support/listenbrainz-mpd/config.toml
   Windows	{FOLDERID_LocalAppData}\listenbrainz-mpd\config.toml

   You can use the --create-default-config option to have this file automatically created for you.

3. Run the binary, or install and enable the provided systemd service file.

   systemctl --user enable --now listenbrainz-mpd.service

License

Licensed under the terms of the GNU Affero General Public License v3.0 (see LICENSE.txt for details).