Skip to content

Main Capabilities of Posterizarr

Feature Description
Kometa Integration - Posterizarr organizes assets using the Kometa-compatible folder structure required for seamless integration.
- For instructions on configuring Posterizarr with Kometa, please refer to the dedicated Kometa Integration Guide.
- Tip: See Kometa-Configs repo for additional sample configuration to streamline asset management.
Direct Upload to Media Servers - Posterizarr can directly upload artwork to media servers:
  - Plex: Uploads artwork if Kometa isn’t used.
  - Jellyfin: Directly uploads artwork.
  - Emby: Similarly, uploads artwork directly.
Upload Existing Assets - Configure whether to upload pre-existing assets to Plex, Jellyfin, or Emby, saving time by skipping redundant uploads for libraries with complete artwork.
Backup Functionality - Facilitates artwork backup by downloading all assets from Plex to a specified backup share.
- Supports the Kometa folder structure for organized storage.
Manual Asset Path (Local Assets) - Local Asset Preference: Prioritizes assets from a manual asset path if present. Skips download if local assets are available.
- Path Configuration: Specify the folder structure in the configuration, saving time and bandwidth by using pre-existing images.
Resizing - Automatically resizes all poster images to 2000x3000 for optimized media server use.
Preferred Language Selection - Configure language preferences for media metadata, supporting multi-language ordering.
  - Season-specific language preferences allow finer control over metadata for localized season information.
Poster and Background Minimum Size - Set minimum dimensions for posters (2000x3000) and backgrounds/title cards (3840x2160), ensuring only high-quality images are used.
Overlay Effects - Applies optional overlays to downloaded images:
  - Borders: Adds polished framing.
  - Text: Customizable title text.
  - Gradient Overlay: Stylish gradient effect (custom options via gradient pack).
Automatic Library Search - Autonomously scans Plex, Jellyfin, or Emby server for libraries, simplifying setup.
Handling Multiple Versions - Manages multiple versions of movies/shows (e.g., theatrical cuts, director’s cuts), ensuring complete coverage for all available versions.
CSV Export - Generates a CSV file with queried movie/show data:
  - Plex: $ScriptRoot\logs\PlexLibexport.csv
  - Other Media Servers (Jellyfin/Emby): $ScriptRoot\logs\OtherMediaServerLibExport.csv
Logging Capabilities - Creates logs for troubleshooting and analysis:
  - General script log: $ScriptRoot\logs\Scriptlog.log
  - ImageMagick commands log: $ScriptRoot\logs\ImageMagickCommands.log
  - Choices log: ImageChoices.csv
Uptime-Kuma - Sends notifications to Uptime Kuma to monitor script activity for success and failure.
Notifications - Sends notifications about script activity using Apprise or Discord.
- Example Images: View sample images here.
Cross-Platform Compatibility - Runs on Linux, Docker, and Windows (Plex, Jellyfin, and Emby compatible), ensuring versatile usage in various environments.
Poster/Background/TitleCard Creation - Searches for high-quality artwork from Fanart, TMDb, TVDb, Plex (fallback: IMDb).
- Resizes to:
  - 3840x2160 for backgrounds and title cards.
  - 2000x3000 for posters.
Library Exclusions - Specify libraries to exclude from processing on Plex, Jellyfin, and Emby servers, helping to avoid unnecessary processing for selected content categories (e.g., YouTube, Audiobooks).
Clearlogo Management - Browse libraries and search for clearlogos by title or ID (TMDB/TVDB) directly from the WebUI.
- Fetch clearlogos from Fanart, TMDB, or TVDB and seamlessly push them directly into the connected media server.
Skip Items in Libraries - Exclude items from processing by adding the "skip_posterizarr" label/tag to any item, preventing downloads and uploads for those items.
Manual Asset Template - Place SeasonTemplate.ext or EpisodeTemplate.ext in your ManualAssets/Show directory, and the script will use this template file for all season and episode images during a posterizarr run.
Auto-Update Options - Supports auto-update settings for both Posterizarr and ImageMagick, keeping tools up to date with minimal manual intervention. (Not on Docker)
Asset Cleanup - Automatic asset cleanup removes Posterizarr-created assets when corresponding media is deleted from the media server, ensuring storage efficiency.
RTL (Right-to-Left) Font Support - Supports right-to-left (RTL) fonts for media titles, making it more accessible for non-Latin-based languages such as Arabic or Hebrew.
New Line on Specific Symbols - Automatically adds a new line on specific symbols (e.g., hyphen or colon) within text to enhance visual aesthetics on overlays.
Fallback Options for Title Cards - Uses background images as title cards if title-specific artwork is unavailable.
Overlay Reset - Reset all posters in a library of your choice to the Plex default.