Skip to content

SIMKL

SIMKL supports Plan to Watch, Watching, On Hold, Dropped, and Completed for shows and anime, watched episode history, and ratings. Movies use Plan to Watch, Dropped, and Completed because SIMKL does not expose durable Watching/On Hold movie states in the same form.

Rewatch and notes are not managed by Brokerr.

Hosted mode uses the gateway. Custom mode requires client ID, client secret, and /api/auth/simkl/callback. Every API request includes the configured app name and version; leave defaults unless your custom SIMKL application requires different values.

Brokerr writes watched episode identities such as season/episode pairs. SIMKL’s minute-level playback resume position belongs to short-lived scrobble sessions; it is not reconstructed from periodic Plex library scans.

SIMKL IDs can be resolved from direct identifiers and anime mappings. Search supports movies, shows, and anime. Write tests require confirmation.

Brokerr honors SIMKL throttling. Do not reduce request intervals merely to speed up a first full sync.