Scrobbling

Real-time Watcher and webhook support, routes, and playback rules.

This section covers real-time scrobbling support.

It shows route compatibility, Watcher and webhook behavior, and the progress thresholds that affect scrobble events.

Use Watcher when possible. It supports Plex, Jellyfin, and Emby to Trakt, SIMKL, and MDBList.

Quick links

Title

Choose between Watcher and webhooks

Open

Webhook or Watcher

Title

Set up Watcher routes

Open

Watcher

Title

Set up webhook mappings

Open

Webhooks

Title

Filter by user, server, or library

Open

Route support

Watcher routes

Playback source	Trakt	SIMKL	MDBList
Plex
Jellyfin
Emby

Webhook routes

Playback source	Trakt	SIMKL	MDBList
Plex
Jellyfin
Emby

Scrobbling capabilities

Core behavior

Capability	Watcher	Webhook	Notes
Independent enablement			Watcher and webhook can be enabled independently
Automatic start on app boot		N/A	Available for the watcher source
Route-based configuration			Routes connect a media source profile to a tracker sink profile
Start, pause, and stop progress handling			Sink thresholds control pause versus completed stop
Pause debounce			Suppresses very short pause events
Near-completion start suppression			Suppresses credit or near-end start flapping
Automatic watchlist removal after watching			Configurable for movie, show, and episode types

Filtering and routing

Capability	Watcher	Webhook	Notes
Username allowlist			Plex account or user filtering
Server UUID allowlist			Empty means unrestricted unless blocked
Server UUID blocklist			Always ignored when matched
Media library allowlist			Available per Plex, Jellyfin, and Emby profile

Plex-specific behavior

Capability	Watcher	Webhook	Notes
Autoplay suppression			Webhook-only protection for short autoplay transitions
Live session progress probing			Webhook-only session probing to improve progress accuracy
Plex rating forwarding to Trakt			Optional
Plex rating forwarding to SIMKL			Optional watcher behavior
Plex rating forwarding to MDBList			Optional watcher behavior
Plex Pass requirement for webhooks			Required by Plex to send webhook events

Emby-specific behavior

Capability	Watcher	Webhook	Notes
Emby Premiere requirement for webhooks			Required by Emby to send webhook events

Scrobble progress rules

The default thresholds reduce noisy updates and prevent early stops from marking items watched.

Rule	Default	Purpose
Progress reporting step (Watcher only)	25 percent	Reduces unnecessary sink updates from watcher polling
Stop becomes pause below	80 percent	Prevents an early stop from marking content watched
Forced completed stop at	95 percent	Treats near completion as watched
Allowed progress regression	5 percent	Tolerates small backward progress changes
Pause debounce	5 seconds	Ignores micro-pauses
Near-end start suppression	99 percent	Suppresses credit-related start flapping