Couch Potato Pal
the pal who remembers what's going on
Explainer 8 min read

Where all the show information actually comes from

IMDb, TMDB, TheTVDB โ€” the databases behind every poster, synopsis, and episode title on your screen. What each one is, why there's more than one, and why your server probably ignores the famous one.

Here's something that isn't obvious until someone says it out loud: your video files contain almost none of the information you see on screen.

The poster, the episode title, the little synopsis, the cast list with photographs, the air date, the season artwork โ€” none of that is inside the file. A video file is video, audio, and maybe subtitles. Everything else your media server shows you was downloaded from an online database, matched to your file by name, and cached locally.

That's why a badly-named file shows up blank and mysterious, and why a correctly-named one arrives fully dressed within seconds. The server isn't reading your file. It's looking your show up.

The three names you'll keep seeing

What it isBest atWho uses it
TMDB
The Movie Database
Community-built, founded 2008, free and open to developers Movies, artwork, broad language coverage Plex's default, Jellyfin, lots of apps
TheTVDB Community-built, founded 2006, TV-first Deep episode-level detail, specials, air dates The *arr library tools, Kodi, Emby
IMDb The famous one. Founded 1990, owned by Amazon since 1998 Credits, ratings, sheer completeness Humans. Rarely software โ€” see below

Why your server ignores the famous one

This is the question everyone eventually asks. IMDb is the biggest, best-known film and television database on earth. So why does essentially no media server pull its data from it?

The answer is licensing, not quality.

So IMDb remains the place you go to settle an argument about an actor, while your server quietly uses somebody else's data. IMDb still shows up in your library, though โ€” just as an identifier rather than a source. More on that shortly.

A note on TheTVDB

TheTVDB's current API isn't free either โ€” it runs on either a commercial licence or an inexpensive user-supported subscription of about $12 a year. Most people never notice, because the tools they use handle it. It's worth knowing that these databases are real organisations with hosting bills, not infinite free utilities.

Why two of them, though?

It looks like pointless duplication until you notice they were built by different people to solve different problems.

TheTVDB grew up around television, in an era of people meticulously cataloguing episode guides. Its strength is granularity: every episode, every special, every alternate ordering, every air date. If you need to know exactly how a season was broken up, it's the better record.

TMDB grew up around film, with an emphasis on artwork and international coverage. Its posters and backdrops tend to be better curated, it handles many languages gracefully, and its television data โ€” while good โ€” models a season the way a network schedule does rather than the way an episode guide does.

Neither is the "correct" one. They're two reasonable answers built by two communities with different instincts, and both are maintained by volunteers.

Where they disagree, and why it lands in your lap

Mostly they agree. Where they don't, the disagreement can quietly scramble a show in your library.

The practical consequence: your library tools follow TheTVDB, your media server probably defaults to TMDB, and when those two disagree, you are the one who notices.

The ID numbers that hold it together

Every database gives each title a permanent identifier. You've seen the IMDb one even if you never registered it โ€” it's the tt0386676 in an IMDb address.

These IDs are how the whole ecosystem stays glued together. TMDB records a title's IMDb ID. TheTVDB records both. Your tools pass them around so that "this show" means the same thing across five programs, regardless of spelling, translation, or a stray subtitle.

This is also the reliable fix when a show matches to the wrong thing. Rather than fighting the filename, find the correct entry, grab its ID, and tell your software to use that specific record. Most tools accept an ID directly, and a match made that way stays made.

You're allowed to fix them

This is the part most people never realise, and it's genuinely satisfying.

TMDB and TheTVDB are community-maintained. Not "community" in a decorative sense โ€” ordinary people create accounts and enter the data. If an episode title is wrong, a poster is missing, or a special is filed under the wrong season, you can sign up and correct it. Changes go through review and then propagate to everyone.

So when a show in your library has bad data, there are two fixes. The local one patches your copy. The upstream one fixes it for every person who ever looks that show up again. The second takes about the same amount of effort, and a surprising amount of what's good about these databases exists because somebody bothered.

Others you'll bump into

NameWhat it's for
TVmazeTV data with a genuinely free API. Popular for schedules and episode listings.
AniDBAnime, which has its own numbering conventions that general databases handle poorly.
MusicBrainzThe equivalent idea for music. Same community-built model.
TraktTracks what you've watched across devices. A history service, not a metadata source.
WikidataStructured facts about everything. Increasingly used to link the others together.

The short version

Written for people running a personal media server for content they're entitled to have: their own disc rips, home video, over-the-air DVR recordings, and public-domain material. Nothing here is about obtaining media, and we don't cover that.