NAME

scrbbl-list — list scrobbles

SYNOPSIS

DESCRIPTION

scrbbl-list lists scrobbles of the logged in user based on specified filters. By default, it lists all scrobbles, with filters restricting which scrobbles to list.

This is a scrbbl(1) command.

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

It's recommended to specify at least the --from option to avoid requesting all scrobbles for the account, which might be a lot.

The options are as follows:

--from time

Filter by scrobbled time, restricting the lower bound.

The time format is ISO, for example '2026-01-01T00:00:00', but more specific parts can be ommited, for example all of '2026', '2026-01', '2026-01-01' and '2026-01-01 00:00' are valid and the same as the previous example. Time spans such as '1month5days12hours' are also supported, they can also be shortened like '1M5d12h'. Defaults to local timezone.

--to time

Filter by scrobbled time, restricting the upper bound.

The time format is ISO, for example '2026-01-01T00:00:00', but more specific parts can be ommited, for example all of '2026', '2026-01', '2026-01-01' and '2026-01-01 00:00' are valid and the same as the previous example. Time spans such as '1month5days12hours' are also supported, they can also be shortened like '1M5d12h'. Defaults to 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

List all scrobbles from an artist from the last month

List all scrobbles for a track from the last month