Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/RudeySH/lastfm-bulk-edit

Bulk edit your scrobbles for any artist, album or track on Last.fm at once.
https://github.com/RudeySH/lastfm-bulk-edit

Last synced: 3 months ago
JSON representation

Bulk edit your scrobbles for any artist, album or track on Last.fm at once.

Awesome Lists containing this project

README

        

# Last.fm Bulk Edit

Bulk edit your scrobbles for any artist, album or track on [Last.fm](https://www.last.fm/) at once.

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QPVH74PGFEFTL&source=url)

## Features

- Bulk edit your scrobbles for any artist, album or track at once.
- Easier management of all your automatic edits.

## Instructions

1. Upgrade to [Last.fm Pro](https://www.last.fm/pro).
2. Install a userscript manager:
- [Violentmonkey](https://violentmonkey.github.io/) (open source, recommended).
- [Tampermonkey](https://tampermonkey.net/) (closed source, supports more browsers).
- Greasemonkey is currently not supported, see FAQ.
- See next paragraph for Android devices (iOS not supported).
3. Install this userscript: [Last.fm Bulk Edit](https://raw.githubusercontent.com/RudeySH/lastfm-bulk-edit/main/dist/lastfm-bulk-edit.user.js).
- If you're using Violentmonkey, press the "Confirm installation" button on the left.
- If you're using Tampermonkey, press the "Install" button on the top-left.
4. Go to your [Last.fm library](https://www.last.fm/user/_/library/artists).
5. Use the new "Edit scrobbles" menu item like in the examples below.

To update the installed userscript to the latest version, simply do step 3 again.

## Installing a userscript manager on Android devices

Because Google Chrome and Samsung Internet do not support add-ons, the following instructions are for Firefox only.

1. Create a collection on the [Firefox Browser Add-ons website](https://addons.mozilla.org/en-US/firefox/collections/). You have to enter the collection name in the Firefox app later, so use a simple name such as "android". The description is required, and the custom URL can't contain upper-case letters.
2. Edit the collection and use the search bar to find and add add-ons. Search for "Violentmonkey" (recommended) or "Tampermonkey".
3. Take note of your Firefox user ID number, which is shown on the top-right. You have to enter it in the Firefox app later.
4. Install the following app: [Firefox Browser (Nightly for Developers)](https://play.google.com/store/apps/details?id=org.mozilla.fenix). You can't use the regular Firefox app.
5. In the app, go to **⋮** → **⚙ Settings** → **About Firefox Nightly**, and tap the Firefox logo five times to enable debug options.
6. Go to **⋮** → **⚙ Settings** → **Custom Add-on collection**, and enter your User ID and collection name (both can be found on the website from step 1).
7. Restart Firefox Nightly, and go to **⋮** → **Add-ons**, Violentmonkey or Tampermonkey should show up. Tap the plus (+) icon to install it.
8. Continue with step 3 of the instructions in the previous paragraph.

## Examples

### Merging albums, fixing album names, and removing albums

Go to any artist in your library. Click on the dropdown button next to any album, and select "Edit scrobbles". Wait for the dialog to load. Edit the track, artist, album or album artist to your desire, then click "Save edit".

![](img/fix-albums.gif)

### Select which albums you want to edit when editing compilations

Last.fm Bulk Edit will automatically detect when an album you're editing contains tracks that have been scrobbled on different albums as well. Depending on the track, that may or may not be correct, so you'll be able to select which albums get edited and which don't.

![](img/compilations.gif)

### Replacing an incorrect artist name with Last.fm's auto-corrected name

In this example, auto-corrections are still turned on, but the steps are roughly the same for when auto-corrections are turned off.

This GIF also demonstrates that the album artist name is kept in sync when changing the artist name.

![](img/album-artist-sync.gif)

## Automatic edits

Last.fm Bulk Edit works perfectly in combination with automatic edits. Automatic edits is a Last.fm Pro feature that allows you to save track edits, and have them be applied automatically to new scrobbles.

On top of this, Last.fm Bulk Edit improves the [automatic edits page](https://www.last.fm/settings/subscription/automatic-edits) by adding the following features:

- Navigate track edits by selecting the artist name from a drop-down list.
- Load all track edits into a single page (optional).
- Click on a column header to sort rows alphabetically by track/artist/album name.
- Show original track name, original artist name, original album name, and original album artist name.
- Emphasize the fields that have been edited with **bold text**.
- Widen the table if the track / artist / album / album artist name is very long, instead of truncating the text with "…".

## Adds album names and links to scrobble overview

Last.fm Bulk Edit also improves the scrobble overview, by adding album names and links. This makes it easier to keep an eye on whether you are scrobbling with the correct album name.

![](img/scrobble-overview.png)

## Frequently asked questions

### Why did my edit not save properly?

There could be many reasons for this. Sometimes Last.fm servers are too busy, try again later. Keep in mind that it is not possible to change just the upper or lower casing of names, [due to how these are stored in Last.fm's database](https://getsatisfaction.com/lastfm/topics/website-update-12-march-editing-scrobbles-subscriber-feature).

### How do I get in contact with you?

If you have found a bug, or want to propose a feature or improvement, feel free to open a [GitHub issue](https://github.com/RudeySH/lastfm-bulk-edit/issues). For general support or discussion, use [GitHub discussions](https://github.com/RudeySH/lastfm-bulk-edit/discussions) or contact me on Discord, you'll find me in the [Last.fm Discord](https://discord.gg/6aTeg3u) (I'm @rudeysh).

### Why do I need a Last.fm Pro subscription?

[Last.fm Pro](https://www.last.fm/pro) enables subscribers to edit scrobbles, one track at a time[1](#f1). Last.fm Bulk Edit uses this feature behind the scenes to perform bulk editing.

1: Last.fm only lets you bulk edit an exact artist, track, album and album artist combination. See the next paragraph for more information.

### How is this different from Last.fm's bulk edit checkbox?

When you edit a scrobble on Last.fm, you'll see this checkbox:

![A screenshot of Last.fm's bulk edit checkbox](img/bulk-edit.png)

This checkbox lets you to bulk edit an exact artist, track, album and album artist combination. This often means you can't edit all scrobbles of a given track at once, because it is likely some scrobbles have a different album or album artist.

Last.fm Bulk Edit lets you edit all scrobbles of a given track at once, regardless of differences between scrobbles in artist, album or album artist. Better yet, Last.fm Bulk Edit also lets you edit all scrobbles of an artist or album at once.

### How is this different from the other batch edit userscript?

The other userscript, [lastfm-batch-edit](https://github.com/danielrw7/lastfm-batch-edit), was created before Last.fm added the bulk edit checkbox. That userscript has similar limitations. It can't edit all scrobbles of an artist or album at once.

### What are userscripts?

Userscripts are programs that augment your browsing experience.
For example, they can add features or enhancements to existing websites.
Userscripts are not browser extensions. Instead, they can be enabled by a userscript manager.
Userscript managers are browser extensions that install and run userscripts for you.

[Violentmonkey](https://violentmonkey.github.io/) and [Tampermonkey](https://tampermonkey.net/) are the most popular userscript managers. Last.fm Bulk Edit currently only supports Violentmonkey and Tampermonkey.

### Why is Greasemonkey not supported?

Last.fm Bulk Edit uses the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) to post form data to edit scrobbles. Greasemonkey has some issues with the Fetch API:
- https://github.com/greasemonkey/greasemonkey/issues/2647
- https://github.com/greasemonkey/greasemonkey/issues/3071
- https://github.com/greasemonkey/greasemonkey/issues/3072

### Why did you make this?

Because it is easy to scrobble with bad metadata, but hard to fix it. Editing scrobbles one by one is a pain. Music streaming services like Spotify do not allow you to clean up tags, so there is no way to prevent it from happening in the first place.

Redditors of [r/lastfm](https://www.reddit.com/r/lastfm) have expressed similar frustrations.

[u/willguitar100 posted](https://www.reddit.com/r/lastfm/comments/azks0z/the_most_painful_thing_ive_noticed_in_my_lastfm/):

> The most painful thing I've noticed in my last.fm yet. Apparently I used the wrong apostrophe.

![](img/reddit/z9wuk5fq1dl21.png)

[u/Cyreniac posted](https://www.reddit.com/r/lastfm/comments/ahbr4w/are_memes_allowed_here/):

![](img/reddit/j2Vr-boauwYbLfmDJlVRoL74WiHeaiYjzWESXQMh3yk.jpg)

[u/Bluegorilla101 posted](https://www.reddit.com/r/lastfm/comments/8ver9b/the_struggles_of_using_spotify_to_scrobble/):

> The struggles of using Spotify to scrobble.

![](img/reddit/n2rcyyfssf711.png)

[u/tjdeignan posted](https://www.reddit.com/r/lastfm/comments/dagrtb/why/):

![](img/reddit/ztpdkkp2jcp31.jpg)

### Who are you?

I'm Rudey. Check out [my Last.fm profile](https://www.last.fm/user/RudeySH).

### How do I support Last.fm Bulk Edit?

Star this repository on GitHub and spread the word! Here's a PayPal donate link:

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QPVH74PGFEFTL&source=url)