Skip to content

Run Modes and Automation

Posterizarr is designed to be operated from the Web UI. You do not need a terminal or PowerShell for the normal artwork workflow. Open Run Modes from the left sidebar to run, test, back up, restore, sync, or create one asset.

Run Modes page with quick actions and the manual asset form

Choose Run Modes in the left sidebar. Quick Run cards start common jobs; the manual form below creates or replaces one asset.

Quick Run modes

Quick Run cards are at the top of Run Modes. If a confirmation dialog opens, review it before starting. You can choose Don't show this again in supported dialogs; use Reset Prompts at the top of Quick Run to show them again. Only one script run can be active at a time. While one is running, its status and a Stop button appear on the page.

Normal Mode

Choose Normal Mode to process the libraries and artwork types selected in your configuration. Review the confirmation dialog, especially the target server, enabled libraries, upload behavior, and asset cleanup settings, then start the run. Use Testing Mode first if you have changed styling or blueprints and want sample output before a library run.

Testing Mode

  1. In Run Modes > Quick Run, choose Testing Mode.
  2. Confirm that the dialog says no artwork will be uploaded to Plex, Jellyfin, or Emby. The generated examples use your current asset styling and settings.
  3. Choose Start Test Run, or Start & Go to Gallery to open the results automatically when generation finishes.
  4. Review the samples in Test Gallery in the sidebar. The confirmation dialog also lets you set automatic redirection for future test runs.

Testing Mode is for checking generated artwork. It is separate from Dynamic Overlays > Dry Run, which tests overlay rules and renders their changes without uploading them.

The examples below are current Testing Mode outputs from the supplied test set. They show how short, medium, long, and uppercase text affect each artwork type. Open the full Artwork Showcase for additional formats and real media-server examples.

Backup Mode

Choose Backup Mode to copy existing media-server artwork into the configured backup location. Confirm the destination and start the backup. This preserves a local copy for recovery; it does not generate new artwork.

Restore Mode

Choose Restore Mode to upload artwork from the local backup folder back to your media server. In the dialog, choose Restore All Libraries or Restore Specific Items. The specific-item filters can narrow by library, folder/item name, and asset type. Restoring all libraries can affect a large part of your server, so select a narrow target when you only need one item. Restored images are uploaded as saved; this step does not run them through the current overlay or artwork styling configuration.

Sync Jellyfin, Emby, or Silo

Use the Jellyfin or Emby sync card to copy artwork from Plex to the selected server. Review the confirmation details first. Library names must match exactly between the source and target servers. Silo has its own Sync Silo action and limitations; see the Silo notes.

Logo Updater

Choose Logo Updater to fetch or manage logos for one library or all suitable libraries. The dialog offers Browse for a single library, Process All Libraries, Only Replace Non-Posterizarr Logos (EXIF Check), Force Replace, and Revert. Force Replace may overwrite existing logos; Revert removes logos previously added by Posterizarr. Review those switches before starting.

Reset Posters

Choose Reset Posters to open the library selection modal (filtered to supported movie and TV libraries, with a refresh button to reload the cached server list). Select the target library and choose Reset; Posterizarr asks for confirmation before replacing selected posters with the media server's available default artwork. This changes live server artwork and cannot be undone by Posterizarr; make a backup first if you may want to restore the current images.

Create one asset manually

Use the Manual form below the Quick Run cards when you want to make or replace one item without processing a full library:

  1. Choose the output type: poster, season poster, titlecard, background, or collection poster. For standard posters and backgrounds, also choose movie or TV show.
  2. Search by title and year in the built-in provider search, then select an image. Or upload your own image or provide an image URL/path.
  3. Choose the library and item. Use Select Library and Select Folder to browse what the connected server exposes.
  4. Fill in the type-specific details. Season posters need a season name; titlecards need a season, episode title, and episode number.
  5. Select a blueprint or keep the global configuration. Review text/textless and title/logo options, then choose Run or Add to Queue.

The Auto-Queue Changes checkbox remembers the queue choice for future manual submissions. It is separate from the queue switch for the current asset.

Schedule and automate

  • Use Scheduler in the sidebar to create, edit, enable, or run scheduled jobs. Choose the mode, libraries, asset types where available, and schedule.
  • Use Auto Triggers to connect supported Tautulli or Sonarr/Radarr events. The native webhook setup does not require a terminal or a custom script.
  • Use Logs to review a run. Return to Run Modes to stop an active run.

Native webhook setup

Tautulli: In Tautulli, open Settings > Notification Agents, add a Webhook, and enter http://YOUR_POSTERIZARR_HOST:8000/api/webhook/tautulli?api_key=YOUR_API_KEY. Set the method to POST, enable Recently Added, and provide the JSON data for rating key and media type. Create the API key in Posterizarr's Web UI configuration.

Sonarr or Radarr: Open Settings > Connect, add a Webhook, and enter http://YOUR_POSTERIZARR_HOST:8000/api/webhook/arr?api_key=YOUR_API_KEY. Enable On Import and On Upgrade, set the method to POST, then save. No script file or shared container volume is needed for the native webhook.

See the Tautulli and Sonarr/Radarr setup notes for the external-app steps.

CLI and legacy instructions (optional)

The commands below are not required when using the Web UI. Expand this section only if you intentionally run Posterizarr from PowerShell, Docker exec, or an older script-based trigger integration.

Optional PowerShell, Docker, and legacy trigger commands

Automatic Mode

Run the script without any parameters:

.\Posterizarr.ps1

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1

This will generate posters for your entire Plex library based on the configured settings.

The posters are all placed in AssetPath\.... This can then be mounted in Kometa to use as the assets folder.

Testing Mode

Run the script with the -Testing flag. In this mode, the script will create pink posters/backgrounds with short, medium, and long texts (also in CAPS), using the values specified in the config.json file.

These test images are placed in the script root under the ./test folder.

Tip

This is handy for testing your configuration before applying it en masse to the actual posters. You can see how and where the text would be applied, as well as the size of the textbox.

.\Posterizarr.ps1 -Testing

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Testing

Manual Mode (Interactive)

Warning

Source picture gets edited by script and is then moved to desired asset location.

Run the script with the -Manual switch and add the desired extra switch for which poster you want to create -MoviePosterCard or -ShowPosterCard or-SeasonPoster or -CollectionCard or -BackgroundCard or -TitleCard

.\Posterizarr.ps1 -Manual -MoviePosterCard

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -MoviePosterCard

Follow the prompts to enter the source picture path (Container needs Access to it), media folder name, and movie/show title to manually create a custom poster.

Posterizarr Input Prompts

Enter local path or URL to source picture:

  • Paste the image URL or provide the full local path to the image file you want to use as the poster source. This is the image that Posterizarr will base the new poster on.

Enter Media Folder Name (as seen by Plex):

  • The name of the local movie or show folder where the .mkv (or other media) file is stored. This should match the folder structure Plex recognizes.

Enter Movie/Show/Collection Title:

  • The title that will be displayed on the generated poster.

Create Season Poster? (y/n):

  • Type y if you're generating a season poster, otherwise n.

Create TitleCard? (y/n):

  • Type y if you also want to create a title card, otherwise n.

Create Collection Poster? (y/n):

  • Type y if you're generating a collection poster, otherwise n.

Enter Plex Library Name:

  • Enter the name of the Plex (or Jellyfin) library, e.g., "Movies" or "TV Shows".

Enter Title Text:

  • Enter the Title of the asset e.g., "Avatar".

Enter Season Name:

  • Enter the Title of the asset e.g., "Season 1".
  • If you want to add Custom Text to Season poster please enter it via prefix Title | Season 1

Manual Mode (Semi Automated)

Warning

The source picture is moved (if local) or downloaded (if a URL - and moved), then edited and placed in the desired asset location. The -PicturePath parameter can accept either a local file path or a direct URL to an image.

Example on Windows:
  -PicturePath "C:\path\to\movie_bg.jpg"

Example on Docker:
  -PicturePath "/path/to/movie_bg.jpg"

Example with URL:
  -PicturePath "https://posterurl.here/movie_bg.jpg"

Movie or Show Poster

To create a standard poster for a movie or a TV show's main entry:

.\Posterizarr.ps1 -Manual -PicturePath "C:\path\to\movie_bg.jpg" -Titletext "The Martian" -FolderName "The Martian (2015)" -LibraryName "Movies"

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -PicturePath "/path/to/movie_bg.jpg" -Titletext "The Martian" -FolderName "The Martian (2015)" -LibraryName "Movies"

Season Poster

Note

Any season name ending in 0 or 00 (e.g., "Season 0", "Staffel 00") or matching a keyword like "Specials" will be handled as a Specials season. If you want to add Custom Text to Season poster please enter it via prefix Title | Season 01 in -SeasonPosterName

To create a poster for a specific season of a TV show, use the -SeasonPoster switch and provide the season name:

.\Posterizarr.ps1 -Manual -SeasonPoster -PicturePath "C:\path\to\show_bg.jpg" -Titletext "The Mandalorian" -FolderName "The Mandalorian (2019)" -LibraryName "TV Shows" -SeasonPosterName "Season 1"

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -SeasonPoster -PicturePath "/path/to/show_bg.jpg" -Titletext "The Mandalorian" -FolderName "The Mandalorian (2019)" -LibraryName "TV Shows" -SeasonPosterName "Season 1"

Collection Poster

To create a poster for a media collection, use the -CollectionCard switch. The script will use the -Titletext for both the poster text and the folder name.

.\Posterizarr.ps1 -Manual -CollectionCard -PicturePath "C:\path\to\collection_bg.jpg" -Titletext "James Bond" -LibraryName "Movies"

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -CollectionCard -PicturePath "/path/to/collection_bg.jpg" -Titletext "James Bond" -LibraryName "Movies"

Background Poster

To create a standard background poster for a movie or a TV show's main entry:

.\Posterizarr.ps1 -Manual -BackgroundCard -PicturePath "C:\path\to\movie_bg.jpg" -Titletext "The Martian" -FolderName "The Martian (2015)" -LibraryName "Movies"

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -BackgroundCard -PicturePath "/path/to/movie_bg.jpg" -Titletext "The Martian" -FolderName "The Martian (2015)" -LibraryName "Movies"

Episode Title Card

To create a 16:9 title card for a specific episode, use the -TitleCard switch and provide episode details:

.\Posterizarr.ps1 -Manual -TitleCard -PicturePath "C:\path\to\episode_bg.jpg" -FolderName "Breaking Bad (2008)" -LibraryName "TV Shows" -EPTitleName "Ozymandias" -SeasonPosterName "Season 5" -EpisodeNumber "14"

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Manual -TitleCard -PicturePath "/path/to/episode_bg.jpg" -FolderName "Breaking Bad (2008)" -LibraryName "TV Shows" -EPTitleName "Ozymandias" -SeasonPosterName "Season 5" -EpisodeNumber "14"

Backup Mode

Run the script with the -Backup flag. In this mode, the script will download every artwork you have in your mediaserver, using the values specified in the config.json file.

Tip

This is handy for creating a backup or if you want an second assetfolder with kometa/tcm EXIF data for jellyfin/emby.

.\Posterizarr.ps1 -Backup

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Backup

Restore Mode

Run the script with the -Restore flag. In this mode, the script will push all artwork from your local backup folder to your media server (Plex, Jellyfin, or Emby).

Tip

This is handy for quickly recreating your library posters after a crash, or if you prefer to edit assets in bulk locally and then push them.

Warning

Running this command directly without any additional flags will automatically attempt to restore ALL assets for ALL items across ALL your included libraries. To prevent this, use the targeted restore flags below.

.\Posterizarr.ps1 -Restore

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Restore

Targeted Restore You can filter what gets restored using additional flags. These flags can be used independently or combined together. For example, you don't need to specify the library or type if you only want to restore one specific item.

  • -RestoreType (options: poster, background, season, episode, titlecard)
  • -RestoreLibrary (e.g. "Movies")
  • -RestoreItem (Accepts the exact Media Title, the Original Title, OR the exact Root Folder name!)

Examples:

Restore only the posters for a specific movie using its exact folder name:

.\Posterizarr.ps1 -Restore -RestoreItem "Alien (1979) [imdb-tt0078748]" -RestoreType "poster"

Restore all artwork types for a specific show using its title:

.\Posterizarr.ps1 -Restore -RestoreItem "Breaking Bad"

Restore only backgrounds for an entire library:

.\Posterizarr.ps1 -Restore -RestoreLibrary "Movies" -RestoreType "background"

Poster reset Mode

Run the script with the -PosterReset -LibraryToReset "Test Lib" flag. In this mode, posterizarr will reset every artwork from a specifc plex lib.

.\Posterizarr.ps1 -PosterReset -LibraryToReset "Test Lib"

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -PosterReset -LibraryToReset "Test Lib"

Tip

Note: This operation does not delete any artwork. It simply sets each item's poster to the first available poster from Plex’s metadata. This action cannot be undone, so proceed with caution.

Sync Modes

Exact Match

The script requires that library names in Plex and Emby/Jellyfin match exactly for the sync to work. It calculates the hash of the artwork from both servers to determine if there are differences, and only syncs the artwork if the hashes do not match.

Jellyfin

Run the script with the -SyncJelly flag. In this mode, the script will sync every artwork you have in plex to jellyfin.

.\Posterizarr.ps1 -SyncJelly

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -SyncJelly

Emby

Run the script with the -SyncEmby flag. In this mode, the script will sync every artwork you have in plex to emby.

.\Posterizarr.ps1 -SyncEmby

On docker this way:

  docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -SyncEmby

Tip

This is handy if you want to run the sync after a kometa run, then you have kometa ovlerayed images in jelly/emby

Tautulli Mode Docker

Warning

Tautulli and Posterizarr must run as a container in Docker

Note

If Discord is configured it will send a Notification on each trigger.

Direct Upload Enforced in Trigger Modes

Tautulli Mode always forces direct upload to Plex (Upload2Plex = true), regardless of whether PlexUpload is set to false in your config.json. The purpose of real-time triggers is to immediately style newly added media in Plex the moment it is imported, without waiting for your next scheduled run. If you use Kometa and want zero uploads from Posterizarr before Kometa applies overlays, do not configure Tautulli triggers; schedule regular Posterizarr batch runs before your Kometa schedule instead.

This mode lets Tautulli trigger Posterizarr for a specific Plex item, such as a newly added show, movie, or episode.

For the legacy script-based setup, configure a script in Tautulli as follows.

  1. Make sure that you mount the Posterizarr directory to tautulli, cause the script needs the Path /posterizarr
    volumes:
      - "/opt/appdata/posterizarr:/posterizarr:rw"
      # Optional: Add additional mounts if running multiple instances
      # - "/opt/appdata/posterizarr2:/posterizarr2:rw"
    
    ⚠️ Note: The default mount path is case-sensitive and must match exactly /posterizarr. If you use custom paths for multiple instances, ensure they are also mounted here.
  2. Download the trigger.py from the GH and place it in the Tautulli Script dir - Tautulli-Wiki
  3. You may have to set chmod +x to the file.
  4. Open Tautulli and go to Settings - NOTIFICATION AGENTS
  5. Click on Add a new notification agent and select Script
  6. Specify the script folder where you placed the script and select the script file.
  7. Add an optional Description to identify the script.

    backgroundtesting

  8. Go to Triggers, scroll down and select Recently Added.

    backgroundtesting

  9. Go to Conditions, you can now specify when the script should get called.

  10. Set Media Type to the types you want to process, for example episode, movie, show and season.
  11. Exclude libraries without tmdb, tvdb, or Fanart IDs, or include only libraries where Posterizarr should create artwork.

    backgroundtesting

  12. Next go to Arguments - Unfold Recently Added Menu and paste the following Argument, after that you can save it.

  13. Please do not change the Argument otherwise the script could fail.

Default Setup (Single Instance):

If you are using the default /posterizarr mount, paste this:

<movie>RatingKey "{rating_key}" mediatype "{media_type}"</movie><show>RatingKey "{rating_key}" mediatype "{media_type}"</show><season>parentratingkey "{parent_rating_key}" mediatype "{media_type}"</season><episode>RatingKey "{rating_key}" parentratingkey "{parent_rating_key}" grandparentratingkey "{grandparent_rating_key}" mediatype "{media_type}"</episode>

Custom Path Setup (Multiple Instances):

If you are triggering a second Posterizarr instance (e.g., mounted as /posterizarr2), you must use the -p parameter right after each opening tag to define the target watcher directory:

<movie>-p "/posterizarr2/watcher" RatingKey "{rating_key}" mediatype "{media_type}"</movie><show>-p "/posterizarr2/watcher" RatingKey "{rating_key}" mediatype "{media_type}"</show><season>-p "/posterizarr2/watcher" parentratingkey "{parent_rating_key}" mediatype "{media_type}"</season><episode>-p "/posterizarr2/watcher" RatingKey "{rating_key}" parentratingkey "{parent_rating_key}" grandparentratingkey "{grandparent_rating_key}" mediatype "{media_type}"</episode>

![backgroundtesting](images/Tautulli_Step4.png)

Tautulli Mode Windows

Note

If Discord is configured it will send a Notification on each trigger.

This mode lets Tautulli trigger Posterizarr for a specific Plex item, such as a newly added show, movie, or episode.

  1. Open Tautulli and go to Settings - NOTIFICATION AGENTS
  2. Click on Add a new notification agent and select Script
  3. Specify the script folder of Posterizarr and select the script file.
  4. Set the script timeout to 0, which is unlimited. (The default is 30, which would kill the script before it finishes.)
  5. Add an optional Description to identify the script.

    backgroundtesting

  6. Go to Triggers, scroll down and select Recently Added.

    backgroundtesting

  7. Go to Conditions, you can now specify when the script should get called.

  8. Set Media Type to the types you want to process, for example episode, movie, show and season.
  9. Exclude libraries without tmdb, tvdb, or Fanart IDs, or include only libraries where Posterizarr should create artwork.

    backgroundtesting

  10. Next go to Arguments - Unfold Recently Added Menu and paste the following Argument, after that you can save it.

  11. Please do not change the Argument otherwise the script could fail.
<movie>RatingKey "{rating_key}" mediatype "{media_type}"</movie><show>RatingKey "{rating_key}" mediatype "{media_type}"</show><season>parentratingkey "{parent_rating_key}" mediatype "{media_type}"</season><episode>RatingKey "{rating_key}" parentratingkey "{parent_rating_key}" grandparentratingkey "{grandparent_rating_key}" mediatype "{media_type}"</episode>

backgroundtesting

Tautulli Mode (Native Webhook)

Recommended

This is the easiest way to set up Tautulli. It requires no custom scripts or volume mounts.

  1. Open Tautulli and go to Settings -> Notification Agents.
  2. Click Add a new notification agent and select Webhook.
  3. Configuration Tab:
    • Webhook URL: http://YOUR_POSTERIZARR_IP:8000/api/webhook/tautulli?api_key=YOUR_API_KEY
    • (Generate an API Key in Posterizarr settings under WebUI)
    • Webhook Method: POST
  4. Triggers Tab:
    • Check Recently Added.
  5. Data Tab:
    • Scroll down to Recently Added.
    • Paste the following into JSON Data:
      {
          "RatingKey": "{rating_key}",
          "mediatype": "{media_type}",
          "parentratingkey": "{parent_rating_key}",
          "grandparentratingkey": "{grandparent_rating_key}"
      }
      
  6. Click Save.

Sonarr/Radarr Mode Docker

Warning

Arrs and Posterizarr must run as a container in Docker

Note

If Discord is configured it will send a Notification on each trigger.

Direct Upload Enforced in Trigger Modes

Arr trigger runs always force direct upload to your media server (Upload2Plex = true / Jellyfin / Emby), regardless of whether PlexUpload is set to false in your config.json.

This mode lets Sonarr or Radarr trigger Posterizarr for a specific Plex or Jellyfin item, such as a newly added show, movie, or episode.

For the legacy script-based setup, configure a script in Sonarr or Radarr as follows.

  1. Ensure you mount the Posterizarr directory to your Sonarr/Radarr container, as the script requires access to /posterizarr:
    volumes:
      - "/opt/appdata/posterizarr:/posterizarr:rw"
    
    ⚠️ Note: This mount path is case-sensitive and must match exactly /posterizarr.
  2. Download ArrTrigger.sh from GitHub and place it in your Sonarr/Radarr script directory.
  3. For example, create a scripts folder in /opt/appdata/sonarr, resulting in the path: /opt/appdata/sonarr/scripts/ArrTrigger.sh
  4. Make sure to set executable permissions: chmod +x ArrTrigger.sh
  5. In Sonarr/Radarr, go to Settings → Connect.
  6. Click the + button and select Custom Script.
  7. Enter a name for the script.
  8. For Notification Triggers, select only On File Import.
  9. Under Path, browse to and select your ArrTrigger.sh script.
  10. Example: /config/scripts/ArrTrigger.sh
  11. With this setup, the Arr suite will create a file in /posterizarr/watcher whenever a file is imported.
  12. The file will be named like: recently_added_20250925114601966_1da214d7.posterizarr
  13. Posterizarr monitors this directory for files ending in .posterizarr.
  14. When such a file is detected, it waits up to 5 minutes(based on fileage), then reads the file and triggers a Posterizarr run for the corresponding item.

Sonarr/Radarr Mode (Native Webhook)

Recommended

This method replaces the need for ArrTrigger.sh and works without complex volume mapping.

  1. Open Sonarr or Radarr.
  2. Go to Settings -> Connect.
  3. Click the + button and select Webhook.
  4. Name: Posterizarr
  5. On Import: Yes
  6. On Upgrade: Yes
  7. URL: http://YOUR_POSTERIZARR_IP:8000/api/webhook/arr?api_key=YOUR_API_KEY
    • (Generate an API Key in Posterizarr settings under WebUI)
  8. Method: POST
  9. Click Save.

Gather Logs Mode

Run the script with the -GatherLogs flag. In this mode, the script collects logs, rotated logs, and database files into a single archive for troubleshooting.

Crucially, the script sanitizes these files before zipping them automatically masking API keys, tokens, PINs, and sensitive hostnames. The result is saved in the script root as posterizarr_support_<timestamp>.zip

!!! tip Use this when reporting bugs or requesting support. It allows you to share comprehensive debugging information with the developer without manually scrubbing your credentials or private links from the files.

.\Posterizarr.ps1 -GatherLogs

On docker this way:

docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -GatherLogs

Logo Updater Mode

The Logo Updater Mode automatically scans your Plex libraries for missing ClearLogos (text-based title images), fetches them from online sources (TMDB, TVDB, Fanart.tv), and uploads them directly to your Plex server metadata.

Standard Update

.\Posterizarr.ps1 -LogoUpdater -LibraryName "Movies"

Revert Mode (Delete Posterizarr-added logos)

.\Posterizarr.ps1 -LogoRevert -LibraryName "Movies"

Parameters:

  • -LogoUpdater: Enable the logo search and upload process.
  • -LogoRevert: Search for logos previously added by Posterizarr (verified via fingerprinting) and unlinks them from Plex.
  • -ForceReplace: Overwrite existing logos even if they already exist in Plex.
  • -LogoExifCheck: Only replace existing logos if they lack Posterizarr EXIF metadata (e.g. default logos auto-selected by Plex). Existing logos created or uploaded by Posterizarr are skipped.
  • -LibraryName: Specify a single library name or use "all" to process all suitable Movie and TV libraries.

Tip

Fingerprinting & EXIF Checks: When running with -LogoExifCheck or in Revert mode, Posterizarr inspects the current logo for a metadata comment (created with posterizarr). Using -LogoExifCheck allows you to replace unwanted or wrong-language logos chosen by Plex's default agents while skipping logos Posterizarr already customized in prior runs.

In the WebUI, you can access this mode via the "Run Modes" tab. It provides a user-friendly interface to select libraries and toggle "Force Replace", "Only Replace Non-Posterizarr Logos (EXIF Check)", or "Revert" settings.

In the WebUI's Manual Mode, you can use the "Browse Logos" button to search for ClearLogos/ClearArt directly from online providers.

  1. Open Manual Mode in the WebUI.
  2. Click "Browse Logos".
  3. Search for a movie or show.
  4. Select a logo to automatically use its URL as the title source.
  5. When you run the manual mode with a URL in the "Title Text" field, Posterizarr will download and use that image as a logo overlay on your poster.

Plex Sync Mode (WebUI & Scheduler)

The Plex Sync Mode is a dedicated, lightweight synchronization mechanism built directly into Posterizarr's WebUI backend. It allows you to selectively push generated artwork directly to your Plex server without running full PowerShell image generation cycles or triggering external scrapers.

Why Use Plex Sync Mode?

  • Lightweight & Fast: Pure Python execution utilizing PMS REST endpoints (/library/metadata/{rating_key}/posters and /arts). No ImageMagick overhead.
  • Change Tracking (Zero Redundant Uploads): Maintains an internal SQLite cache (database/plex_push_cache.db) recording file sizes, modification timestamps, and upload history. Assets that have not changed locally are skipped immediately.
  • Granular Control (Respects Kometa & Custom Workflows): You can select exactly which libraries (e.g. "Movies", "TV Shows", or "all") and which asset types to sync:
    • Collections: Collection posters (Assets/Collections/)
    • Posters: Movie and Show main posters (Assets/<Library>/<Item>/poster.*)
    • Seasons: TV Season posters (Assets/<Library>/<Item>/SeasonXX.*)
    • Title Cards: Episode title cards (Assets/<Library>/<Item>/<Item> - SxxExx.*)
    • Backgrounds: Fanart / Backdrops (Assets/<Library>/<Item>/background.*) If you manage movie posters with Kometa or PMM, you can enable Plex Sync exclusively for Collections without touching other media artwork.

Interactive Collection Explorer Diff & Push

Under Collection Builder (/media-server-collections): 1. Select your Plex server and library. 2. The UI automatically compares every local collection poster against the Plex server and labels it with real-time diff tags: - In Sync: Local poster matches Plex and was previously uploaded. - Update Ready: Local poster has been updated or edited locally and is ready to push. - Missing on Plex: Local collection poster exists on disk, but has not yet been pushed to Plex. - No Local Asset: Collection exists on Plex, but no local poster file was found in Assets/Collections/. 3. Use the LOCAL / SERVER toggle on each card to visually inspect the differences between your local asset and what is currently live on your Plex server. 4. Click Push to Plex on an individual collection card for instant 1-click upload, or click Push All Out-of-Sync in the toolbar to batch upload all pending collections concurrently.

Automated Scheduling

In Scheduler (/scheduler): 1. Select Plex Sync (Lightweight) as the execution mode. 2. Select target library (All Libraries or a specific library). 3. Toggle which asset types to include using the interactive checkboxes. 4. Set your desired interval or cron schedule. 5. All sync activity is logged to UILogs/PlexSync.log and viewable in real-time in the WebUI Log Viewer.

Do not use Plex Sync schedule in combination with Kometa (Plex Meta Manager)!

If you run Kometa to manage posters, titlecards, or overlays, do not schedule a Plex Sync job for those same libraries or asset types.

Because Kometa applies its own overlays and metadata modifications directly to Plex, Posterizarr's Plex Sync will continuously detect that the live Plex artwork differs from your clean local assets and will repeatedly attempt to re-upload them. This triggers an endless overwrite cycle between Kometa and Posterizarr.

If you use Kometa, ensure that Plex Sync is only scheduled for asset types that Kometa does not touch (e.g. custom Collections only), or manage all uploads exclusively through Kometa.