Auth: MDBList

Movies, Shows, Seasons, Episodes and Limited Anime

MDBList is a service for building and maintaining movie and TV lists. CrossWatch supports Device Code auth and a legacy API key fallback.

End users

What it supports

• Watchlist

• Ratings

• History

Use Device Code for new setups. It is the default and recommended auth mode.

API key auth still works as a fallback.

MDBList does not provide easy rollback/export for user data. Use deletes carefully, and consider using Adapter: CrossWatch as a safety net.

Connect MDBList with Device Code

1. Open Settings → Authentication → MDBList.

2. Set Authentication Method to Device Code.

3. Click Connect MDBList.

4. A browser window opens so you can enter your code.

5. Copy the Link code (PIN) from CrossWatch.

6. Paste the code into MDBList.

7. Wait until CrossWatch shows Connected with Device Code.

Use the legacy API key mode

1. Open https://mdblist.com/preferences/#api

2. Create or copy your MDBList API key.

3. In CrossWatch, set Authentication Method to API key.

4. Paste the API key into CrossWatch.

5. Click Connect MDBList.

Troubleshooting

• If the auth window does not open, disable popup blockers for CrossWatch.

• If the link code fails, click Connect MDBList again to generate a new code.

• If you use API key mode and auth fails, regenerate the key and reconnect.

• If writes fail, verify items have stable IDs (TMDb/IMDb) in the source provider.

• If you see 429 Too Many Requests, lower MDBList rate limits. Guide: Provider rate limiting.

Power users