Library health

Version 1.1.3 · plug-in API >=1.14 <2.0

PublishedHow to add it
On this page

Library health: Dashboard card

Library health adds 2 cards you can put on your dashboard. Each starts with a band: Library health's logo and name and a status in words. A footer says when it last changed.

Library health

Shows how many films and series in Jellyfin have no poster, no description or no year, out of how many titles it checked.

  • How often it updates: Library health checks Jellyfin every 6 hours, or when you select Check now. The card is asked once a minute while the dashboard is open. Nothing is asked while the browser tab is hidden.
  • Example: 4 to fix, of 1,240 titles

To fix in Jellyfin

Shows a short list, up to 10 lines: the films and series to fix, each with what it is missing, such as "No poster" or "No description, no year". With nothing to fix, it says "Nothing to fix" and "Every title has a poster, a description and a year".

  • How often it updates: Library health checks Jellyfin every 6 hours, or when you select Check now. The card is asked once a minute while the dashboard is open. Nothing is asked while the browser tab is hidden.
  • Example:
  • Brazil (1985): No poster

What the status says

Status Means
OK The last check found nothing to fix. The band says "Nothing to fix".
Waiting It started moments ago and has not checked yet. The band says "Checking soon" and the number card says "Not checked yet".
Warning The last check found titles to fix. The band says "To fix", and the number card says how many.
Problem The first check went wrong. The number card says what went wrong under the number, such as "LookupError: Starboard has no Jellyfin key to give yet: add Jellyfin in Settings, Apps". The list card shows its "Nothing to fix" line until a check works, so read the band and the number card.

Once a check has worked, the cards keep showing its result if a later check goes wrong.

Add it to your dashboard

  1. Select Edit dashboard.
  2. In Add a card, choose the card. Its name ends with (Library health), such as Library health (Library health).
  3. Select Save.

Library health must be added and active first. Read Install.

Find out more

This page on GitHub, where the help is written.