The Movie Database

TMDb

TMDb metadata improves matching across providers. It turns “title + year” into stable IDs, so sync plans don’t guess.

What it does

TMDb metadata helps CrossWatch:

  • resolve items by TMDb ID (and other IDs when TMDb provides them)

  • normalize title and year

  • reduce “missing peer” and “wrong match” issues

circle-info

CrossWatch currently supports TMDb only for metadata.

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 → Metadata → TMDb.

  2. Paste your API key.

  3. Click Save.

Settings

chevron-rightLanguage / Localehashtag

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

Pick a locale code from the list below.

chevron-rightCache TTL (hours)hashtag

Controls how long CrossWatch caches posters and other TMDb payloads.

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

Supported locales

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

chevron-rightLocale listhashtag
Locale
Language
Country/Region

af-ZA

Afrikaans

South Africa

ar-AE

Arabic

United Arab Emirates

ar-SA

Arabic

Saudi Arabia

be-BY

Belarusian

Belarus

bg-BG

Bulgarian

Bulgaria

bn-BD

Bengali

Bangladesh

ca-ES

Catalan

Spain

ch-GU

Chamorro

Guam

cn-CN

Chinese

China

cs-CZ

Czech

Czech Republic

cy-GB

Welsh

United Kingdom

da-DK

Danish

Denmark

de-AT

German

Austria

de-CH

German

Switzerland

de-DE

German

Germany

el-GR

Greek

Greece

en-AU

English

Australia

en-CA

English

Canada

en-GB

English

United Kingdom

en-IE

English

Ireland

en-NZ

English

New Zealand

en-US

English

United States

eo-EO

Esperanto

es-ES

Spanish

Spain

es-MX

Spanish

Mexico

et-EE

Estonian

Estonia

eu-ES

Basque

Spain

fa-IR

Persian

Iran

fi-FI

Finnish

Finland

fr-CA

French

Canada

fr-FR

French

France

ga-IE

Irish

Ireland

gd-GB

Scottish Gaelic

United Kingdom

gl-ES

Galician

Spain

he-IL

Hebrew

Israel

hi-IN

Hindi

India

hr-HR

Croatian

Croatia

hu-HU

Hungarian

Hungary

id-ID

Indonesian

Indonesia

it-IT

Italian

Italy

ja-JP

Japanese

Japan

ka-GE

Georgian

Georgia

kk-KZ

Kazakh

Kazakhstan

kn-IN

Kannada

India

ko-KR

Korean

South Korea

ky-KG

Kyrgyz

Kyrgyzstan

lt-LT

Lithuanian

Lithuania

lv-LV

Latvian

Latvia

ml-IN

Malayalam

India

mr-IN

Marathi

India

ms-MY

Malay

Malaysia

ms-SG

Malay

Singapore

nb-NO

Norwegian Bokmål

Norway

nl-BE

Dutch

Belgium

nl-NL

Dutch

Netherlands

no-NO

Norwegian

Norway

pa-IN

Punjabi

India

pl-PL

Polish

Poland

pt-BR

Portuguese

Brazil

pt-PT

Portuguese

Portugal

ro-RO

Romanian

Romania

ru-RU

Russian

Russia

si-LK

Sinhala

Sri Lanka

sk-SK

Slovak

Slovakia

sl-SI

Slovenian

Slovenia

sq-AL

Albanian

Albania

sr-RS

Serbian

Serbia

sv-SE

Swedish

Sweden

ta-IN

Tamil

India

te-IN

Telugu

India

th-TH

Thai

Thailand

tl-PH

Filipino (Tagalog)

Philippines

tr-TR

Turkish

Turkey

uk-UA

Ukrainian

Ukraine

vi-VN

Vietnamese

Vietnam

zh-CN

Chinese

China

zh-HK

Chinese

Hong Kong

zh-SG

Chinese

Singapore

zh-TW

Chinese

Taiwan

zu-ZA

Zulu

South Africa

Troubleshooting

  • Wrong match: prefer items with stable IDs (TMDb/IMDb). Fix the item in the Editor, then re-run.

  • Lots of missing matches: add TMDb metadata and re-run. Missing metadata causes weak matching.

  • Rate limits: increase cache TTL and avoid rapid re-runs.

Last updated