Library clean-up

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

PublishedHow to add it
On this page

Library clean-up: Problems

Find what is wrong with Library clean-up, then follow the numbered answer.

Find your answer
Flow chart: Library clean-up is not working as it should. The same chart is written out in words after it.Failed or Not answeringNot supportedActive, but somethingis wrongNothing movesPreview lists nothing,or the wrong thingsThe card says Last runfailedPut back did not workThe disk is as full asbeforeLibrary clean-up isnot working as itshouldWhat does its tabsay?What is wrong?Start it again1Update it or updateStarboard2Check Move items eachday3Check the rules4Read what the cardsays5Check the Holdingfolder page6Free the space forgood7
The chart in words

Start: Library clean-up is not working as it should

1 Start it again

  1. On Library clean-up's tab, read the message under its state: it says why it stopped.
  2. Select Try again.
  3. If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
  4. Still failing: go to System, then Logs, and find its name.

It stops answering when it cannot read and change the media folder, or cannot write its own folder. Check that Jellyfin is added in Settings, then Apps, then deactivate and activate Library clean-up.

2 Update it or update Starboard

Your Starboard's plug-in API is outside what this version of Library clean-up works with, so Starboard stopped it. Library clean-up needs plug-in API 1.15, in Starboard 0.19.0 or later.

  1. Select Check for an update on its tab.
  2. If there is none, update Starboard. Read Update Starboard.

3 Check Move items each day

  • Nothing moves until Move items each day is activated in Rules. When it is deactivated, the card says Deactivated and what Preview would move.
  • It moves once a day, in Starboard's quiet hours. To move straight away, go to System, then Jobs, and select Run now beside Move items to the holding folder.
  • A run moves up to 200 items, within 50 minutes. The next run carries on.
  • A move that would have to copy the files is not made, and something with the same name already in the holding folder is never overwritten.

4 Check the rules

  • Films watched by everyone finds nothing when one person never watches, such as a guest account. Add their Jellyfin user name to People to leave out.
  • Check that the rules you want are activated in Rules, and that the library is not deactivated in Libraries.
  • Something in Always keep stays: favourites, anything someone is part way through, films in a collection and anything with the keep tag.
  • To keep something Preview lists, add the keep tag to it in Jellyfin, or change the rules. Then select Preview again and check the list again.
  • Preview is worked out in the background, which takes a few seconds on a large library. The page updates by itself.

5 Read what the card says

  • No answer from and its name: it did not answer in 3 seconds. Check that it is Active on its tab, then wait a minute.
  • Last run failed in the band: the card says "The last run did not finish" and why. Fix that, then select Run now in System, then Jobs, or wait for the next run.

6 Check the Holding folder page

  1. On Library clean-up's tab, open Holding folder.
  2. Find the item. If something else is in its place now, it stays in the holding folder and the page says so. Move or rename what is in its place, then select Put back again.
  3. Jellyfin is told when an item is put back, so it is back in your library within a minute. Reelix follows it again exactly as before.

If you removed Library clean-up, Put back has gone. Move the folder back from media/.holding/library-cleanup yourself, then choose Follow for it in Starboard's Library.

7 Free the space for good

Library clean-up never deletes, so the space is still used while an item is in the holding folder. When you are sure you do not want something, delete its folder in media/.holding/library-cleanup yourself, with your computer's file manager or a terminal.

Report a problem

If none of these helps, tell its maker, with what its tab and the card say: the plug-ins' issues on GitHub.

Find out more

This page on GitHub, where the help is written.