How to Add Posters and Metadata to Your IPTV Library with TMDB

If your Movies and Series library feels like a spreadsheet — placeholder thumbnails, missing synopses, thousands of titles with no way to browse — TMDB enrichment can fix that. GridStreamr looks up each title in The Movie Database and pulls posters, backdrops, cast, ratings, release year, and plot summaries, so your library starts to feel like a real streaming catalog.

What TMDB is

The Movie Database (TMDB) is a community-maintained catalog of movies, series, and people, with an open API. It backs Plex, Jellyfin, Trakt, and most of the self-hosted media ecosystem. A free account gets you a generous API quota — more than enough for a home IPTV library.

How GridStreamr uses TMDB

Once you enable it, GridStreamr matches each Movie and Series in your library to a TMDB entry by title and year, falls back to fuzzy matching when source metadata is messy, and caches enriched metadata locally so the UI stays fast. You get movie grids with proper posters, series pages with season and episode lists, and a richer detail page per title.

Step 1: Create a free TMDB account

1. Open themoviedb.org and sign up for a free account.
2. Verify your email.
3. Under Settings → API, request an API key (v3 auth). Pick 'Personal' and describe the use as 'Enriching a personal IPTV library'.
4. Copy the resulting API key (32 characters).

Step 2: Paste it into GridStreamr

Open GridStreamr → Settings → General → TMDB → paste your API key and press Save. The app validates the key against TMDB, and if it's valid, it queues every Movie and Series for enrichment. You'll see posters pop in over the next few minutes while the background job runs.

What gets enriched

• Poster and backdrop images.
• Plot synopsis, runtime, and release year.
• Cast and crew lists with character names.
• User ratings and content genres.
• Season and episode structure for series, with per-episode stills.

Privacy and quota

Your TMDB key stays on your device. TMDB sees metadata requests such as title and year so it can return matches — GridStreamr does not provide TMDB keys for you. Typical personal libraries stay well within TMDB's free quota.

What to try next

With TMDB flowing, try AI Live Channels Enrichment (Premium, hosted AI with in-app credit packs) to standardize channel names in Smart Collections, detect language and stream quality, classify content type, and discover missing logos. Together, TMDB and AI enrichment turn a raw playlist into a polished, searchable library across your devices. See the AI enrichment article on this blog for how credits work.