elomatreb
/
listenbrainz-mpd
3
9
Fork 2
Code Issues Pull Requests Projects Releases 7 Wiki Activity
listenbrainz-mpd/README.md

1.7 KiB
Raw Permalink Blame History

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

    cargo install listenbrainz-mpd

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