NAME

scrbbl-edit — edit scrobbles

SYNOPSIS

DESCRIPTION

scrbbl-edit edits scrobbles based on specified filters and actions. By default, it edits all scrobbles and changes nothing, filters restricting which scrobbles to edit, and actions describing how to edit each scrobble.

This is a scrbbl(1) command.

This command requires login. See scrbbl-login(1) for how to login.

You probably DO NOT want to run this without specifying, at the very least, --from with at most 2 weeks in the past. Last.fm does not accept scrobbles from before 2 weeks ago, so this would happily delete your scrobbles without actually adding them back.

This can potentially cause lost scrobbles if something happens during the process - internet connection issues, power loss, Last.fm outage etc. Verify that you have not lost scrobbles after running the command. If scrobbles are lost, they can be readded with scrbbl-new(1).

The options are as follows:

--set-title title

Set the title of each matched scrobble to title.

If --title-regex is specified, title is a replacement string for the matched regex. To reference a matched group $n can be used, where n is the group number.

--set-artist artist

Set the artist of each matched scrobble to artist.

If --artist-regex is specified, artist is a replacement string for the matched regex. To reference a matched group $n can be used, where n is the group number.

--set-album album

Set the album of each matched scrobble to album.

If --album-regex is specified, album is a replacement string for the matched regex. To reference a matched group $n can be used, where n is the group number.

Exclusive with --set-no-album.

--set-no-album

Remove the album of each matched scrobble.

Exclusive with --set-album.

--set-album-artist artist

Set the album artist of each matched scrobble to artist.

Exclusive with --set-no-album-artist.

--set-no-album-artist

Remove the album artist of each matched scrobble, making it the same as the artist.

Exclusive with --set-album-artist.

--swap-title

Swaps the track title and artist fields.

If --set-title or --set-artist are also specified, they alter the already swapped fields.

--from time

Filter by scrobbled time, restricting the lower bound.

The time format is 'YYYY-mm-dd HH:MM:SS'. Timezone is the local timezone.

--to time

Filter by scrobbled time, restricting the upper bound.

The time format is 'YYYY-mm-dd HH:MM:SS'. Timezone is the local timezone.

--title title

Filter by track title. If specified multiple times, matches any of the titles. Case insensitive.

--artist artist

Filter by artist. If specified multiple times, matches any of the artists. Case insensitive.

--album album

Filter by album. If specified multiple times, matches any of the albums. Case insensitive.

--no-album

Filter by tracks with no album. If specified together with --album, matches any of the albums and tracks with no album.

--title-regex regex

Filter by track title matching the regex. The regex is similar to PCRE and case insensitive. If specified together with --title, matches any of the titles and titles matching the regex.

--artist-regex regex

Filter by artist matching the regex. The regex is similar to PCRE and case insensitive. If specified together with --artist, matches any of the artists and artists matching the regex.

--album-regex regex

Filter by album matching the regex. The regex is similar to PCRE and case insensitive. If specified together with --album, matches any of the albums and albums matching the regex.

EXAMPLES

Fix a track title to the correct one

Swap around the track title and artist for an artist whose name got scrobbled as the track title

Append '(feat. ...)' to all tracks in an album