Library clean-up

Version 1.0.3 · plug-in API >=1.15 <2.0

PublishedHow to add it
On this page

Library clean-up: Updates

Library clean-up 1.0.3 is the latest version. It needs Starboard 0.19.0 or later, with plug-in API 1.15.

Versions

Version Needs plug-in API Released
1.0.3 1.15 or later 17 November 2026
1.0.2 1.15 or later 17 November 2026
1.0.1 1.14 or later 16 November 2026
1.0.0 1.15 or later 15 November 2026

The catalogue offers each Starboard the newest version it can run. 1.0.0 is the first version, so a Starboard with plug-in API 1.14 or earlier is not offered Library clean-up until Starboard is updated.

What is new in 1.0.3

Changed:

  • Clearer words: Libraries says Checked for each library the rules check, the card says "Next check in quiet hours", and its hints name the setting they mean.
  • Logo description: where its logo stands on its own, a screen reader says "Library clean-up logo", the plug-in's name, instead of a description of the symbol.

What is new in 1.0.2

Fixed:

  • Jellyfin 12: it sends Jellyfin's key the way Jellyfin 12 asks for it, so Jellyfin no longer refuses its requests where legacy authorisation is off. Older Jellyfin still works.

What is new in 1.0.1

Changed:

  • Lighter at rest: it wakes about once a minute while nothing asks it anything, not twice a second.
  • Starts faster: its image comes with Python's modules already compiled, so a start takes about a quarter of the processor time.

What is new in 1.0.0

Added:

  • Rules: films watched by everyone, last watched more than 90 days ago; series that ended with every episode watched; films and series nobody has watched for 12 months. Each a setting, for the libraries you choose.
  • Always kept: favourites, anything someone is part way through, films in a collection, and anything tagged keep.
  • Preview lists what would move and the space it frees. Nothing moves until you activate Move items each day.
  • Never deletes: it moves each item to media/.holding, keeping its folders, and Put back returns it.
  • Reelix and Jellyfin are told: Reelix stops following what moves, so it is not downloaded again, and follows it again when it is put back.

How an update is kept safe

  • Before the update Starboard asks Library clean-up to get ready: it finishes the item it is moving and starts no new run, so nothing is left half moved. If it is still working, it says "Still working. Try again in a minute" and nothing changes.
  • After the update, or after a Roll back, it says when it checks again, or that Move items each day is deactivated. The next run carries on where it stopped.
  • Starboard waits for the new version to answer. If it does not, Starboard goes back to the version you had by itself, with your settings as they were.
  • Your settings, its folder and what is in the holding folder are kept.

Update it

  1. Go to Settings, then Plug-ins. When a newer version is known, Library clean-up has an Update chip in Manage.
  2. Select Library clean-up to open its tab.
  3. In Versions, select Update to and the new version.
  4. Read What is new since your version and How the update is kept safe, enter your Starboard password, and select Update Library clean-up.
  5. When the dialog says it is updated, select Done.

Roll it back

  1. On Library clean-up's tab, in Versions, select Roll back to and the version you had.
  2. Enter your Starboard password and select Roll back.
  3. When the dialog says it is back on that version, select Done.

Rolling back needs no download, and only one earlier version is kept.

Find out more

This page on GitHub, where the help is written.