Sync your library
Sync your movie and show libraries and resolve each title to a TMDB id so artwork providers can be queried accurately.
PosterPilot
Browse your library, find better artwork, and apply it — directly to your media server or as Kometa-ready YAML.
PosterPilot is a self-hosted web app that browses a media library (Plex, Jellyfin, or Emby — one active at a time), finds artwork covers across multiple providers, and applies a chosen cover to your media server — directly via its API and/or by exporting Kometa/PMM-compatible YAML. It runs as a single Docker container on a Mac or on an Unraid server.
A guided first-install wizard walks you from picking a language through connecting your server, TMDB key, and providers, choosing libraries, and a first sync — and for Plex it includes a PIN login and connection discovery so you never have to hunt down a token or URL.
What it does
Section titled “What it does”Find covers
Fan out across enabled providers — MediUX, Fanart.tv, TMDB, and ThePosterDB — and compare poster and background candidates grouped by provider and set. Use a whole set, mix pieces across providers, or assemble a custom set from a pasted URL or an uploaded file.
Apply covers
Apply a chosen cover via the media-server API (uploads and locks the field, instantly) and/or via a Kometa YAML export that your Kometa instance consumes on its next run.
Stay localized
The UI ships in English, Spanish, Simplified Chinese, Japanese, and Brazilian Portuguese, with per-key English fallback — managed through Weblate.
Library-wide work runs as background jobs with live progress over Server-Sent Events, shown right on the Dashboard. A granular Activity log (Settings → Activity) and a rotating file log record every operational event, and an update checker with a “What’s New” modal surfaces new releases.
Where to go next
Section titled “Where to go next” Installation Run PosterPilot with Docker Compose on a Mac or Unraid using the official GHCR image.
Configuration Connect a media server, set your TMDB key, enable artwork providers, and learn the full env-var reference.
Usage Sync a library, find covers, apply them, build custom sets, and filter the library wall.
Contributing Set up the project locally and run the quality gates before submitting a change.
- SvelteKit (TypeScript) on Bun, built with
adapter-node - SQLite + Drizzle ORM (libsql) for the library cache, candidates, history, jobs, and settings
- Tailwind CSS v4, a dark, image-forward UI
- An in-process job queue with Server-Sent Events for live progress
PosterPilot is released under the MIT License.
PosterPilot is an independent project, not affiliated with or endorsed by Plex, Jellyfin, Emby, MediUX, Fanart.tv, TMDB, ThePosterDB, or Kometa. Trademarks belong to their respective owners. This product uses the TMDB API but is not endorsed or certified by TMDB.