mpdscrobble 0.2.4

A simple Last.fm/Libre.fm scrobbler for MPD.

mpdscrobble

A simple Last.fm scrobbler for MPD.

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 a mpdscribble journal file, you can use the mpdscribble_history.py script.

Requirements

• mpd-python2
• pylast

Installation

Classic installation :

pip install mpdscrobble
mpdscrobble -h

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

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

Run from source

First method

git clone https://github.com/dbeley/mpdscrobble
cd mpdscrobble
python setup.py install --user
mpdscrobble -h

Second method (with pipenv)

git clone https://github.com/dbeley/mpdscrobble
cd mpdscrobble
pipenv install '-e .'
pipenv run mpdscrobble -h

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 search a config file at ~/.config/mpdscrobble/mpdscrobble.conf, but you can override the default location with the -c/--config flag (see Usage section).

Scheduling

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 mpdscribble

If you installed mpdscrobble from source you can also use:

cp systemd-service/* ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now mpdscrobble
systemctl --user status mpdscribble

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.