Skip to main content

Mopidy extension for comprehensive management of Last.fm scrobbles

Project description

Mopidy extension for comprehensive management of Last.fm scrobbles.

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

About

This extension aims to provide advanced scrobbling functionality above and beyond what the existing Mopidy Scrobbler extension provides:

  • Caching scrobbles in case no internet connection is available

  • Delete scrobbles before they’re submitted

  • Automatic cleaning of song metadata (provided by music-metadata-filter package)

  • Manually edit song metadata

  • Completely ignore tracks played by specific extensions

Important: Out of the box, this extension won’t automatically scrobble the songs you’re listening to. Instead, it will record them so that you can scrobble them yourself later. Please refer to the Usage section later on in the readme.

I might add automatic scrobbling at a later date. If you’re considering a PR to add this functionality, please open an issue first to discuss the implementation.

Installation

Install by running:

sudo python3 -m pip install Mopidy-Advanced-Scrobbler

Configuration

The extension is enabled by default when it is installed. However, to actually make use of the ability to scrobble, you’ll need to provide several details. In addition to providing your Last.fm username and password, you’ll also need to create an API account:

https://www.last.fm/api/account/create

Then fill out your credentials in the Mopidy configuration file:

[advanced_scrobbler]
api_key = bf572286a9ea25a28b9c896b03b7176e
api_secret = f89e3f3cf54ee6f248d55dac328d4bc0
username = djmattyg007
password = secret

The following configuration values are available:

  • advanced_scrobbler/enabled: If the Advanced Scrobbler extension should be enabled or not. Defaults to enabled.

  • advanced_scrobbler/api_key: The API account’s API key.

  • advanced_scrobbler/api_secret: The API account’s API secret.

  • advanced_scrobbler/username: Your Last.fm username.

  • advanced_scrobbler/password: Your Last.fm password.

  • advanced_scrobbler/db_timeout: Database connection timeout in seconds.

  • advanced_scrobbler/scrobble_time_threshold: The amount of a song that must have been listened, as a percentage. Valid values are between 50 and 100. Defaults to 50.

  • advanced_scrobbler/ignored_uri_schemes: A list of track URI schemes that should be completely ignored. No record will ever be submitted or recorded for tracks coming from these extensions. Defaults to an empty list.

Usage

Enter the address of the Mopidy server that you are connecting to in your browser (e.g. http://localhost:6680/advanced_scrobbler).

There are two main pages: “Plays” and “Corrections”. The “Plays” page contains a list of every track you’ve listened to, and when it was listened to. It also notes if track metadata has been altered from what was originally provided, and if so, what it was before it was altered.

From this page you can also edit track metadata, delete plays individually or in bulk, and scrobble tracks individually or in bulk. Selecting “Scrobble to here” will ensure all plays recorded up to and including the selected play are scrobbled, leaving any plays recorded after the selected play.

While editing track metadata, you can decide to save the edit permanently as a manual correction. If the same track is played in future, this manual correction will be automatically applied when recording the play. You can also decide to automatically update any other plays of the same track that have not yet been submitted. If a track’s metadata was corrected automatically, you will also have the option of “approving” the automatic correction. This will convert it into a manual correction for you.

The “Corrections” page simply lists all existing manual corrections. On this page, corrections can be edited or deleted.

Project resources

Credits

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

Mopidy-Advanced-Scrobbler-2.1.0.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

File details

Details for the file Mopidy-Advanced-Scrobbler-2.1.0.tar.gz.

File metadata

  • Download URL: Mopidy-Advanced-Scrobbler-2.1.0.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.9.6

File hashes

Hashes for Mopidy-Advanced-Scrobbler-2.1.0.tar.gz
Algorithm Hash digest
SHA256 e4ea5cb51082fe51c6d67a5018e18ce8251e68803a7e65eda794f2222a3ece45
MD5 ddf4dc0a496868f263f3926e56324724
BLAKE2b-256 50fbf8040b8467e09d6ba725383e191b8a2e5c88530809bd312c2fd5825deec9

See more details on using hashes here.

File details

Details for the file Mopidy_Advanced_Scrobbler-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: Mopidy_Advanced_Scrobbler-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.9.6

File hashes

Hashes for Mopidy_Advanced_Scrobbler-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d49bbd0c338ca2b3b812136030df87e2863c310d6cdded39a386206b467b3212
MD5 0351184f02d8db56b31966ef4236f574
BLAKE2b-256 2f1b6b8df5d1599319a88cd97395d18b99d22cae20f6783697035bd4a2eb032e

See more details on using hashes here.

Supported by

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