TMDb

End users

Connect TMDb (Sync) to synchronize supported TMDb account activity.

If you only want ID matching and cover arts then 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 CW

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 CW. 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 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.

Power users

Power users

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