Skip to content

Enrichment (TMDB)

Iain Smith edited this page Aug 31, 2026 · 1 revision

Enrichment (TMDB)

Add your own free TMDB API Read Access Token (v4) and tvtimes enriches film programmes with backdrops, title-logos, cast, ratings and synopses, and powers the Top rated this week row on Guide and Tonight.

Connect

  1. Create a token at https://www.themoviedb.org/settings/api (the v4 Read Access Token, a long eyJ… string).
  2. Settings → TMDB → Connect, paste it. The token is validated against TMDB, then stored encrypted at rest.

New guide data fills in over the following minutes as the worker warms the cache; opening a film's panel enriches it on demand.

How matching works

A programme maps to a cached TMDB row by (normalised title, year). The enrichment cache is global — content is public, so whichever tenant has a token populates rows everyone benefits from. Genuine "no match" results are cached (with no wrong artwork shown); transient request failures are not cached.

A film enriched without a year won't match a programme that carries one, and vice versa — the odd film shows the plain panel instead. That's expected.

Channel logos

Separate from TMDB. Logos come from the playlist, else the iptv-org database, else the SiliconDust guide for HDHomeRun — proxied through your origin and shown on a neutral card so both dark and light marks read.

Attribution

This product uses the TMDB API but is not endorsed or certified by TMDB.

Clone this wiki locally