mopidy-scrobbler

Mopidy extension for scrobbling played tracks to Last.fm or Libre.fm.

This extension requires a free user account at Last.fm or Libre.fm.

Maintainer wanted

Mopidy-Scrobbler is currently kept on life support by the Mopidy core developers. It is in need of a more dedicated maintainer.

If you want to be the maintainer of Mopidy-Scrobbler, please:

1. Make 2-3 good pull requests improving any part of the project.

2. Read and get familiar with all of the project's open issues.

3. Send a pull request removing this section and adding yourself as the "Current maintainer" in the "Credits" section below. In the pull request description, please refer to the previous pull requests and state that you've familiarized yourself with the open issues.

   As a maintainer, you'll be given push access to the repo and the authority to make releases to PyPI when you see fit.

Installation

Install by running:

python3 -m pip install mopidy-scrobbler

See https://mopidy.com/ext/scrobbler/ for alternative installation methods.

Configuration

The extension is enabled by default when it is installed. You just need to add your Last.fm username and password to your Mopidy configuration file:

[scrobbler]
username = my-last.fm-username
password = my-last.fm-password

To use Libre.fm instead, you must specify the network too:

[scrobbler]
network = librefm
username = my-libre.fm-username
password = my-libre.fm-password

The following configuration values are available:

• scrobbler/enabled: If the scrobbler extension should be enabled or not. Defaults to enabled.
• scrobbler/network: The scrobbling network to use. Can be either lastfm or librefm. Defaults to lastfm.
• scrobbler/username: Your Last.fm or Libre.fm username.
• scrobbler/password: Your Last.fm or Libre.fm password.

Project resources

• Source code
• Issues
• Releases

Development

Set up development environment

Clone the repo using, e.g. using gh:

gh repo clone mopidy/mopidy-scrobbler

Enter the directory, and install dependencies using uv:

cd mopidy-scrobbler/
uv sync

Running tests

To run all tests and linters in isolated environments, use tox:

tox

To only run tests, use pytest:

pytest

To format the code, use ruff:

ruff format .

To check for lints with ruff, run:

ruff check .

To check for type errors, use pyright:

pyright .

Making a release

To make a release to PyPI, go to the project's GitHub releases page and click the "Draft a new release" button.

In the "choose a tag" dropdown, select the tag you want to release or create a new tag, e.g. v0.1.0. Add a title, e.g. v0.1.0, and a description of the changes.

Decide if the release is a pre-release (alpha, beta, or release candidate) or should be marked as the latest release, and click "Publish release".

Once the release is created, the release.yml GitHub Action will automatically build and publish the release to PyPI.

Credits

• Original author: Stein Magnus Jodal
• Current maintainer: None. Maintainer wanted, see section above.
• Contributors