Metadata and artwork providers

Plekt Metadata Providers settings showing provider cards and connection status
Metadata Providers contains the keys and connection status used for enrichment and artwork.
  • 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:

  1. Use a title that is already present in the local library.
  2. Make one watched, unwatched, or resume change from the source.
  3. Wait for the webhook or polling interval.
  4. Open Sync Activity.
  5. Read each destination result and follow the matching troubleshooting link if it is skipped or failed.

Continue with the sync model or open Settings.