Skip to content

Posterizarr Plugin for Emby

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

Port & Credits

This plugin is an Emby port of the original Posterizarr Jellyfin Plugin by fscorrupt. All credit for the original idea, architecture, and implementation goes to him.

This port was vibecoded using Claude (Anthropic).

Overview

The Posterizarr Plugin acts as a local asset proxy for Emby. 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.
  • Scheduled Sync Task: Registers a background task to keep library images in sync with your local assets automatically on a customized schedule.

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. Download the latest version of Posterizarr.Plugin.Emby.dll from the GitHub Releases.
  2. Copy Posterizarr.Plugin.Emby.dll into your Emby Server's plugin directory:
    • Docker: /config/plugins/
    • Windows: %appdata%\Emby-Server\programdata\plugins
  3. Restart your Emby Server.

Configuration

  1. After restarting, go to Dashboard → Plugins → Installed Plugins and click Posterizarr Emby.
  2. Click on Settings.
  3. Configure your Root Asset Folder Path (the directory where your curated images are stored, e.g., /assets).
  4. Click Save.
  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.

Scheduled Tasks & Automation

The plugin registers a scheduled background task (default: daily at 02:00 AM) that automatically syncs and refreshes your libraries against local assets.

Configuring the Sync Schedule

  1. Open your Emby Dashboard.
  2. In the left sidebar under the Server section, navigate to Scheduled Tasks.
  3. Locate the Posterizarr Sync Task in the list.
  4. Click on the task to customize its triggers:
    • You can configure the task to run on an interval, at a specific time of day (e.g., daily at 3:00 AM), on system startup, or on a weekly schedule.
  5. You can also trigger the task manually at any time by clicking the Play (Run) button next to it.

Building from Source

If you prefer to compile the plugin yourself from source code, run:

dotnet publish modules/Posterizarr.Plugin.Emby/Posterizarr.Plugin.Emby.csproj -c Release -o publish

The compiled Posterizarr.Plugin.Emby.dll will be located inside the publish/ directory.