feat: cold report, playlist pruning, and .m3u8 playlists

Conversation 0 Commits 2 Files Changed 3

+455 -43

2 Commits

Author	SHA1	Message	Date
Emma Thorpe	35d5e98642	fix: write playlists as .m3u8 so Rockbox reads them as UTF-8 Build and publish container / build (pull_request) Successful in 2m42s Details Rockbox's is_m3u8_name() treats every playlist extension as UTF-8 except an explicit ".m3u", which it instead decodes through the user's configured codepage: /* Default to M3U8 unless explicitly told otherwise. */ return (!dot \|\| strcasecmp(dot, ".m3u") != 0); The one extension being used was therefore the only one that mangles accented filenames, and this library holds Motley Crue, Beyonce and Sigur Ros. Renaming the output is the whole fix. No byte order mark is written. One would promote a .m3u file to UTF-8 as well, but it is unnecessary at this extension and upsets players that do not expect to find one. Kept with the pruning change rather than raised separately, because the rename depends on it: without pruning, seventeen dead .m3u files would sit on the device for ever, and every one of them full of paths that still resolve.	2026-08-25 10:43:43 +01:00
Emma Thorpe	9fdd61b648	feat: report which albums have never been played Build and publish container / build (pull_request) Successful in 6m37s Details Stage four, read-only. An album is cold when it has files, not one of its tracks has ever been scrobbled across the whole nine-year history, and its newest file landed over a year ago. The age floor is measured from the file rather than the release date: what matters is how long a record has been available to play, not how old it is. Album-level rather than track-level. A record with two played tracks is a record that gets played, and picking the other ten off it leaves gaps in an album rather than reclaiming anything worth having. Track file sizes are now indexed so the report can rank by the disk actually recoverable, which is the point of the exercise. That needed a column on a table that already exists, so the store gained an in-place column migration; a full rebuild would mean re-downloading sixty thousand scrobbles. The report refuses to produce anything when the backfill is unfinished, when any artist failed to index, when any artist has no albums, or when there is no history to judge against. Each of those makes played music look unplayed, which is the one failure that costs a library, and they are checked rather than trusted because the report they gate is the one that ends in deletion. Nothing is written to Lidarr. Every call there remains a GET, and unmonitoring waits until the list this produces has been looked at -- no flag protects against a list that is wrong. Also prunes playlists no longer produced, which #12 made necessary by renaming moods: high-energy-rock would otherwise have stayed on the device for ever. It is driven by a record of what was written last time rather than by deleting every M3U that is not currently ours, so a playlist put in that directory by hand is left alone.	2026-08-24 19:21:57 +01:00

Author

SHA1

Message

Date

Emma Thorpe

35d5e98642

fix: write playlists as .m3u8 so Rockbox reads them as UTF-8

Build and publish container / build (pull_request) Successful in 2m42s

Details

Rockbox's is_m3u8_name() treats every playlist extension as UTF-8 except an
explicit ".m3u", which it instead decodes through the user's configured
codepage:

    /* Default to M3U8 unless explicitly told otherwise. */
    return (!dot || strcasecmp(dot, ".m3u") != 0);

The one extension being used was therefore the only one that mangles accented
filenames, and this library holds Motley Crue, Beyonce and Sigur Ros. Renaming
the output is the whole fix.

No byte order mark is written. One would promote a .m3u file to UTF-8 as well,
but it is unnecessary at this extension and upsets players that do not expect
to find one.

Kept with the pruning change rather than raised separately, because the rename
depends on it: without pruning, seventeen dead .m3u files would sit on the
device for ever, and every one of them full of paths that still resolve.

2026-08-25 10:43:43 +01:00

Emma Thorpe

9fdd61b648

feat: report which albums have never been played

Build and publish container / build (pull_request) Successful in 6m37s

Details

Stage four, read-only. An album is cold when it has files, not one of its tracks
has ever been scrobbled across the whole nine-year history, and its newest file
landed over a year ago. The age floor is measured from the file rather than the
release date: what matters is how long a record has been available to play, not
how old it is.

Album-level rather than track-level. A record with two played tracks is a record
that gets played, and picking the other ten off it leaves gaps in an album
rather than reclaiming anything worth having.

Track file sizes are now indexed so the report can rank by the disk actually
recoverable, which is the point of the exercise. That needed a column on a table
that already exists, so the store gained an in-place column migration; a full
rebuild would mean re-downloading sixty thousand scrobbles.

The report refuses to produce anything when the backfill is unfinished, when any
artist failed to index, when any artist has no albums, or when there is no
history to judge against. Each of those makes played music look unplayed, which
is the one failure that costs a library, and they are checked rather than
trusted because the report they gate is the one that ends in deletion.

Nothing is written to Lidarr. Every call there remains a GET, and unmonitoring
waits until the list this produces has been looked at -- no flag protects
against a list that is wrong.

Also prunes playlists no longer produced, which #12 made necessary by renaming
moods: high-energy-rock would otherwise have stayed on the device for ever. It
is driven by a record of what was written last time rather than by deleting
every M3U that is not currently ours, so a playlist put in that directory by
hand is left alone.

2026-08-24 19:21:57 +01:00

feat: cold report, playlist pruning, and .m3u8 playlists #13