On this page

How-to

Install Picture shrinker

Install Picture shrinker from Jellyfin's own catalogue, restart Jellyfin, then choose a backup option. Picture shrinker makes the posters, backdrops, logos, photos of people and other pictures Jellyfin keeps smaller, so they take less space. This takes 13 steps and about 5 minutes, with a restart.

After you install or update it, choose a backup option, or nothing is shrunk. There is no default. Until you choose, the Dashboard's 'Activity' list reminds you, and 'Shrink pictures' shows as failed in 'Scheduled Tasks'. Steps 11 to 13 make the choice.

Before you begin

  • The repository is in Jellyfin. Read Add the repository to Jellyfin.
  • An administrator account in Jellyfin 10.11 or Jellyfin 12. Jellyfin installs the build for its own version.
  • Restarting Jellyfin stops anyone watching for about a minute: choose a quiet time.

Steps

  1. Go to Dashboard, then Plugins.
  2. Select Available.
  3. In Search, enter Picture.
  4. Select the Picture shrinker card.

The Plugins page with Available (step 2), Search with Picture entered (step 3) and the Picture shrinker card (step 4) outlined

  1. Select Install. Picture shrinker's page says what it does, and lists each version under Revision History.

Picture shrinker's page in the catalogue, with its Revision History, Status Not installed and Install (step 5) outlined

  1. In Confirm Plugin Installation, select Install.

The Confirm Plugin Installation dialog, with its warning about plug-ins from other authors and Install (step 6) outlined

  1. Go to Dashboard and select Restart.

Jellyfin's Dashboard, with Restart (step 7) outlined, with example data

  1. In the Restart dialog, select Restart. Jellyfin starts again in about a minute. If you run Jellyfin in Docker, you can restart its container instead.

The Restart dialog asking 'Are you sure you wish to restart Jellyfin?', with Restart (step 8) outlined

  1. When Jellyfin is back, go to Dashboard, then Plugins, and select Installed.
  2. Select the Picture shrinker card. Its version and Active are under its name.

    The Plugins page with Installed (step 9) and the Picture shrinker card, version 1.2.5.0 Active (step 10), outlined

  3. Select Settings. Picture shrinker's settings page opens, with a notice that nothing is shrunk until you choose.

    Picture shrinker's page under Installed, with Enable plugin active and Settings (step 11) outlined

  4. Under What to shrink, then Original pictures, choose one:

    • Keep a backup copy of each original: each original is copied before its first shrink, so you can put it back. The first run needs about as much free space as the pictures take now.
    • Shrink without a backup: no extra space is used, and pictures shrunk from then on cannot be put back.

    Picture shrinker's settings with the notice that nothing is shrunk until you choose, and Original pictures (step 12) outlined, neither choice made

    The settings page is the same on Jellyfin 10.11, with the 10.11 build's version number.

    Picture shrinker 1.2.4.0's settings on Jellyfin 10.11.11, with Original pictures (step 12) outlined, the same page as on Jellyfin 12

  5. Select Save, at the end of the settings. The page says when it saved, such as "Saved at 16:31".

    The end of Picture shrinker's settings form, with Save (step 13) outlined

Picture shrinker now runs every Sunday at 03:30. To shrink straight away, select Shrink now under Space on the same page.

Things to note

  • Every picture type is shrunk by default, to the sizes in Choose which pictures to shrink, and their sizes.
  • Its two tasks are in Dashboard, Scheduled Tasks, under Picture shrinker: Shrink pictures and Restore original pictures.
  • Jellyfin 10.11.11 has the same pages and names. On a Plugins page with tabs, Installed is the My Plugins tab and Available is the Catalogue tab.
  • If you use Starboard, it can do these steps for you: read Use the plug-ins with Starboard.

Remove it

  1. To put the original pictures back first, follow Keep a backup, and put the original pictures back.
  2. To free the backup's space, select Delete backup on the settings page.
  3. Go to Dashboard, Plugins, Installed, select Picture shrinker, then Uninstall, and restart Jellyfin.

The pictures stay as they are. If you kept the backup, its folder stays in Jellyfin's data folder (picture-shrinker/originals), with two small files of the plug-in's own: its settings, plugins/configurations/Jellyfin.Plugin.PictureShrinker.xml, and its figures, plugins/Jellyfin.Plugin.PictureShrinker. You can delete them yourself.

If it does not work

Find out more

This page on GitHub, where the help is written.