Metadata and artwork providers

- TMDB supplies posters, backdrops, cast, summaries, search, trailers, reviews, and recommendations. Add a TMDB API key first for the richest details.
- TheTVDB supplies show identity, season/episode numbering, air dates, and fallback art. It also lists the alternate episode orders (DVD, absolute, and others) a show offers in its Episode order dialog, under TheTVDB’s own names.
- Fanart.tv supplies community-curated poster, backdrop, and logo fallbacks.
- OMDb is optional and can provide IMDb rating badges.
- YouTube is optional and can supply trailer metadata.
Plekt caches metadata and artwork locally. A cached poster whose file has gone missing is downloaded again the next time it is needed, so the artwork is restored without a manual reset.
When TMDB or TheTVDB answers that Plekt is sending too many requests, Plekt retries a bounded number of times and then pauses requests to that provider for a short cool-down instead of retrying without limit.
A provider outage can affect new enrichment without erasing the local watch archive.
Use Settings → Metadata to refresh after correcting a key.
Verify a connection without guessing
After any integration change, create one known test:
- Use a title that is already present in the local library.
- Make one watched, unwatched, or resume change from the source.
- Wait for the webhook or polling interval.
- Open Sync Activity.
- Read each destination result and follow the matching troubleshooting link if it is skipped or failed.
