mpdscrobble

A simple Last.fm scrobbler for MPD.

On top of Last.fm, mpdscrobble is also compatible with those services:

• ListenBrainz
• Maloja

If you are searching for a mpd-compatible Last.fm scrobbler, check out first mpdscribble, as mpdscrobble has less features than mpdscribble:

• no journal of failed scrobbles
• it needs a pair of Last.fm API key/secret instead of just username/password

If you need to scrobble tracks from an existing mpdscribble journal file, you can use the mpdscribble_history.py script.

Requirements

• httpx
• python-mpd2
• pylast

Installation

Classic installation :

pip install mpdscrobble
mpdscrobble -h

You will then need to create a config file (see the Configuration section).

If you want the systemd-service, you will have to install it manually (see the Scheduling section).

Run from source

git clone https://github.com/dbeley/mpdscrobble
cd mpdscrobble
pip install -e .
mpdscrobble -h

If you want to scrobble an existing mpdscribble journal file, use the mpdscribble_history.py script:

python mpdscribble_history.py /path/to/mpdscribble/journal -c ~/.config/mpdscrobble/mpdscrobble.conf

On Archlinux

If you are an Archlinux user, you can install the AUR package mpdscrobble-git.

yay -S mpdscrobble-git

The systemd service file will be automatically installed.

Configuration

See mpdscrobble.example.conf for an example.

By default, mpdscrobble searches for a config file at ~/.config/mpdscrobble/mpdscrobble.conf, but you can override the default location with the -c/--config_file flag (see the Usage section).

The mpdscrobble section lets you override the MPD connection settings and the scrobble behavior:

[mpdscrobble]
host = localhost
port = 6600
use_album_artist = false

• host and port: MPD connection settings, optional, default to localhost:6600.
• use_album_artist: when enabled, scrobble with the album artist instead of the track artist when the track has one, optional, default is false.

Each scrobbler service gets its own section: [last.fm], [listenbrainz], [maloja], and you can configure several instances of the same service by appending a number to the section name ([maloja2], [maloja3], ...).

Scheduling

If you installed the AUR package on Archlinux, the systemd service is automatically installed.

systemctl --user enable --now mpdscrobble
systemctl --user status mpdscrobble

Otherwise you will need to manually install the systemd service.

curl https://raw.githubusercontent.com/dbeley/mpdscrobble/main/systemd-service/mpdscrobble.service > ~/.config/systemd/user/mpdscrobble.service
systemctl --user daemon-reload
systemctl --user enable --now mpdscrobble
systemctl --user status mpdscrobble

Usage

usage: mpdscrobble [-h] [--debug] [-c CONFIG_FILE] [--dry-run]

A simple Last.fm scrobbler for MPD.

optional arguments:
  -h, --help            Show this help message and exit.
  --debug               Display debugging information.
  -c CONFIG_FILE, --config_file CONFIG_FILE
                        Config file (default: ~/.config/mpdscrobble/mpdscrobble.conf).
  --dry-run             Disable scrobbling.