Skip to main content

A simple scrobbler for MPD.

Project description


A simple scrobbler for MPD.

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

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

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

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


  • httpx
  • mpd-python2
  • pylast


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

First method

git clone
cd mpdscrobble
python install --user
mpdscrobble -h

Second method (with pipenv)

git clone
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.


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 the Usage section).


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 > ~/.config/systemd/user/mpdscrobble.service
systemctl --user daemon-reload
systemctl --user enable --now mpdscrobble
systemctl --user status mpdscrobble


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

A simple 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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mpdscrobble-0.3.2.tar.gz (6.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page