17 stable releases

new 2.3.7 Jun 5, 2024
2.3.5 Apr 20, 2024
2.3.3 Feb 7, 2024
2.3.2 Dec 17, 2023
0.1.0 Feb 20, 2022

#81 in Command line utilities

Download history 9/week @ 2024-02-18 37/week @ 2024-02-25 2/week @ 2024-03-03 9/week @ 2024-03-10 2/week @ 2024-03-17 10/week @ 2024-03-31 123/week @ 2024-04-07 151/week @ 2024-04-14 52/week @ 2024-04-21 11/week @ 2024-04-28 185/week @ 2024-05-19 6/week @ 2024-05-26

193 downloads per month

AGPL-3.0-only

66KB
1.5K SLoC

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.

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

Dependencies

~34–50MB
~806K SLoC