Skip to content

Posterizarr Plugin for Jellyfin

Middleware for asset lookup. Maps local assets to library items as posters, backgrounds, or titlecards.

Overview

The Posterizarr Plugin acts as a local asset proxy for Jellyfin. It is designed to work alongside the Posterizarr automation script, allowing your media server to utilize locally generated or managed assets (posters, backgrounds, title cards) as metadata.

Important

This middleware does not allow you to browse, search, or download assets. Its sole purpose is to replace the default artwork by mapping library items to your local file system.

Features

  • Local Asset Mapping: Maps local files to library items without replacing original metadata permanently in some configurations.
  • Metadata Provider: Registers as a metadata provider for images.
  • Support for Multiple Asset Types: Handles Posters, Backgrounds (Fanart), and Title Cards.

Installation

Warning

Only use this if you are not syncing from Plex, as it will overwrite your synced items with locally created assets from Posterizarr.

  1. Open your Jellyfin Dashboard.
  2. Navigate to Plugins -> Repositories.
  3. Click Add and enter the following information:
    • Repository Name: Posterizarr
    • Repository URL: https://raw.githubusercontent.com/fscorrupt/posterizarr/main/manifest.json
  4. Navigate to the Catalog tab.
  5. Find Posterizarr under the Metadata category.
  6. Click Install and choose the latest version.
  7. Restart your server.

Configuration

  1. After restarting, go to Plugins → Installed Plugins and click Posterizarr.
  2. Click on "Settings"
  3. Configure your Asset Root Path (the directory where your curated images are stored).
  4. Safe it
  5. Go to your Dashboard -> Libraries.
  6. Manage a library (e.g., Movies).
  7. Enable Posterizarr under the Image Fetchers settings.
  8. Ensure it is prioritized according to your preferences.
  9. Refresh metadata (Search for missing metadata → Replace existing images) for your library to pick up local assets.