Picture shrinker

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

PublishedHow to add it
On this page

Picture shrinker: Settings

Picture shrinker's settings are on its own tab: go to Settings, then Plug-ins, then Picture shrinker. Starboard draws them and keeps them; secrets are never shown again once saved.

Settings

Setting What it does Default
Space saved A page of its own: how much space it has saved, how many pictures it has shrunk and when it runs next, then a table of each run with what started it, how many pictures were shrunk, left as they were or could not be read, and how it ended. Pictures it could not read are listed under Could not read, with the reason. You can read it, but not change it. None
Saved by type A page of its own: the space each type of picture has saved, such as posters, backdrops and photos of cast and crew, with how many were shrunk, their size before and their size now, then all types together. The figures are kept after each run, so the page opens at once. Pictures shrunk before version 1.2.2 were not counted by type and share one row. Before anything is shrunk, it says what to do first. You can read it, but not change it. None
When to shrink Every day, week or month, at a time. It works at the lowest priority, so a time when the server is quiet is best. In a month without the date you chose, such as the 31st in April, it runs on the last day. Every week on Sunday at 03:30
Posters no taller than A poster taller than this is shrunk to this height. 900 pixels is sharp on a television. A number from 300 to 3,000 pixels. 900 pixels
Photos of people no wider than A photo of a cast or crew member wider than this is shrunk to this width. A number from 100 to 2,000 pixels. 400 pixels
Original pictures Keep a backup copy of each original, or Shrink without a backup. Nothing is shrunk until you choose. With a backup, each original is copied once to the plug-in's own folder before its first shrink, so Restore original pictures can put it back. With no backup, Start again has Jellyfin download the pictures again instead. None: you choose, after you add it and after the update to 1.2.0
Shrink all picture types In What to shrink. Shrinks every type of picture in one setting. Deactivate it to choose types one by one with the ticks under it. Activated
Posters, Photos of cast and crew, Backdrops, Thumbnails, Logos, Banners, Disc art, Clear art In What to shrink. Each type, used when Shrink all picture types is deactivated. All activated
Backdrops, Thumbnails, Logos, Banners, Disc art and Clear art no wider than In Sizes and quality. A picture of that type wider than this is shrunk to this width. 1920 pixels for backdrops is sharp on a 1080p television or display and a little softer full-page on a 4K one. 1920, 1280, 800, 1000, 500 and 800 pixels
Shrink new pictures in quiet hours Each hour of quiet hours, shrinks the posters and photos Jellyfin saved since the last pass, so they never build up. Activated or deactivated. Deactivated

Buttons

These are on Picture shrinker's tab.

  • Shrink now starts a run straight away, at the lowest priority. If a run is already going, it says "Already shrinking". The card and the Space saved page say how far it has gone. Run now in System, then Jobs, does the same.
  • Stop shrinking stops the run after the picture it is on. The next run carries on where it stopped.
  • Restore original pictures puts every original from the backup back in Jellyfin. The backup is kept.
  • Delete backup removes the backup for good, after asking you.
  • Start again: the pictures it shrinks deletes the backup and the records, moves each picture of every type it shrinks aside and has Jellyfin download it again at full size. A picture Jellyfin cannot download again within a day is put back.
  • Start again: every picture deletes the backup and the records and has Jellyfin replace every picture, backdrops and logos included. It downloads much more and can take many hours.

Things to note

  • A change to the sizes is used from the next run; you do not need to deactivate it first. A smaller number saves more space. A picture already shrunk is not made larger again if you choose a larger number.
  • A run stops itself after 115 minutes, and the next one carries on. Pictures already shrunk are only opened, never written again.
  • It shrinks every type of picture Jellyfin saves, unless you leave a type out in What to shrink.
  • System, then Jobs, shows when it runs next.
  • The pictures it shrank stay shrunk when you remove it. Choose Restore original pictures or Start again first to have them full size again.
  • Settings are kept when you update or deactivate it, and when you remove it they stay in its folder.

Find out more

This page on GitHub, where the help is written.