Auth: TMDb

TMDb can be used in CrossWatch in two different ways.

• Metadata (recommended): improves matching across providers. Setup guide: Meta: TMDb.

• TMDb (Sync): connects your TMDb account so CrossWatch can read/write TMDb data.

This page covers TMDb (Sync).

End users

What it supports

• Watchlist

• Ratings

If you only want better matching, you want Metadata → TMDb, not TMDb (Sync).

Connect TMDb (Sync)

1

Create a TMDb API key (v3)

1. Create a TMDb account.

2. Request an API key: https://www.themoviedb.org/settings/api

2

Connect in CrossWatch

1. Open Settings → TMDb (Sync).

2. Paste your TMDb API Key (v3).

3. Click Connect.

4. A TMDb tab opens. Approve the request.

5. Return to CrossWatch. Wait for “Connected”.

If it stays pending, click Verify once.

Disconnect

1. Open Settings → TMDb (Sync).

2. Click Disconnect.

Troubleshooting

• Auth tab didn’t open: disable popup blockers for CrossWatch.

• Stuck on “Pending approval”: approve in the TMDb tab, then click Verify.

• “TMDb did not return a session id”: restart the flow with Connect and approve again.

• Verify keeps failing: the server must reach https://api.themoviedb.org/3.

• Key issues: the key must be a valid TMDb v3 API key.

Security notes

Treat your TMDb API key and session as secrets.

They are stored in CrossWatch config on disk.

Power users