TMDb

If you only want ID matching and cover arts then you want Metadata → TMDb, not TMDb (Sync).

Connect TMDb (Sync)

Create a TMDb API key (v3)

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

Connect in CW

Open Settings → TMDb (Sync).
Paste your TMDb API Key (v3).
Click Connect.
A TMDb tab opens. Approve the request.
Return to CW. Wait for “Connected”.

If it stays pending, click Verify once.

Disconnect

Open Settings → TMDb (Sync).
Click Disconnect.

Troubleshooting

Auth tab didn’t open: disable popup blockers for CW.
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 CW config on disk.

Config keys used

TMDb (Sync) stores values under:

tmdb_sync.api_key
tmdb_sync.session_id

Metadata stores a separate key under:

tmdb.api_key

API endpoints (manual flow)

Start / Verify / Finish / Disconnect

CW exposes a small API used by the UI.

These are useful for debugging or headless setup.

Start (opens the approval URL)

POST /api/tmdb_sync/connect/start

curl -X POST http://localhost:PORT/api/tmdb_sync/connect/start \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY"}'

Open the returned auth_url and approve.

Verify (auto-finish after approval)

GET /api/tmdb_sync/verify

curl http://localhost:PORT/api/tmdb_sync/verify

Finish (optional explicit completion)

POST /api/tmdb_sync/connect/finish

curl -X POST http://localhost:PORT/api/tmdb_sync/connect/finish \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","request_token":"REQUEST_TOKEN"}'

Disconnect

POST /api/tmdb_sync/disconnect

curl -X POST http://localhost:PORT/api/tmdb_sync/disconnect

PreviousTrakt NextOthers

Last updated 5 days ago

Was this helpful?