Skip to content

mpdscrobble: a simple Last.fm scrobbler for MPD. Also compatible with ListenBrainz and Maloja.

License

Notifications You must be signed in to change notification settings

dbeley/mpdscrobble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a01e5ac · Jul 4, 2024

History

44 Commits
Nov 20, 2023
Jul 4, 2024
Feb 27, 2021
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Nov 20, 2023
Feb 24, 2021
Nov 20, 2023
Nov 20, 2023
Apr 24, 2022
Nov 20, 2023
Apr 23, 2022
Nov 20, 2023
Apr 23, 2022
Nov 20, 2023

Repository files navigation

mpdscrobble

A simple Last.fm scrobbler for MPD.

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

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
  • mpd-python2
  • 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

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

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.