Auth: SIMKL

Movies, Shows, Seasons, Episodes and Anime

SIMKL is a tracker for movies, shows, and anime. CrossWatch connects via OAuth (client ID/secret + access token).

End users

What it supports

• Watchlist

• Ratings (movies/shows/anime)

• History

SIMKL is also used for scrobbling (Watcher/Webhooks) when configured.

Connect SIMKL

1. Create a SIMKL developer app:

   1. Open https://simkl.com/settings/developer/

   2. Click Add → Add a new App

   3. Set Name: CrossWatch

   4. Set Description: CrossWatch

   5. Set Redirect URI: the callback URL shown by CrossWatch, for example: http://<your-server-ip>:8787/callback

   6. Click Save Changes

2. Copy the Client ID and Client Secret into CrossWatch.

3. Click Connect SIMKL. A new tab opens.

4. Click YES to approve.

5. Wait until you see:

   

SIMKL authorized. You can close this tab and return to the app.

If you later switch CrossWatch from HTTP ↔ HTTPS (or change host/port), update the SIMKL Redirect URI to match.

Guide: HTTPS/TLS.

Limitations

• Watchlist: stable up to ~2,500 items total (max 10,000)

• History (plays): stable up to ~10,000 play events total.

• Ratings: stable up to ~10,000 ratings total.

Prefer incremental windows for big backfills.

Troubleshooting

• If the auth tab doesn’t open, disable popup blockers for CrossWatch.

• If authorization fails, verify the redirect URI matches exactly.

• If you run sync very often, SIMKL may throttle you. Daily is usually enough.

• If you see 429 Too Many Requests, tune provider throttling. Guide: Provider rate limiting.

Power users