TMDb Metadata

Configure TMDb metadata to improve matching and stabilize IDs across providers.

End users

CrossWatch uses TMDb for many features.

TMDb is strongly recommended if you want posters, backdrops, richer metadata, and more reliable matching.

Setup

1

Create a TMDb API key

1. Create a TMDb account.
2. Request an API key here: https://www.themoviedb.org/settings/api

2

Add the key to CrossWatch

1. Open Settings → Connections.
2. Paste your API key.
3. Click Save.

This key is used for matching only.

If you want TMDb watchlist/ratings syncing, connect TMDb Sync instead: TMDb.

Settings

Language / Locale

Controls the language used for titles, overviews, and other localized fields.

PublicMetaDB TMDb enrichment uses this setting too.

Pick a locale code from the list below.

Cache TTL (hours)

Controls how long CrossWatch caches posters and other TMDb payloads.

PublicMetaDB TMDb enrichment uses this cache too.

Default is 720 hours.

Higher TTL = fewer API calls. Lower TTL = fresher metadata.

Supported locales

These locale codes control the language/region used for TMDb lookups.

Power users