Scrobble

Internal blueprint for the scrobble pipeline (event parsing, filtering, and sink dispatch).

This section documents the scrobble pipeline under providers/scrobble/.

It also covers the legacy webhook bridge under providers/webhooks/.

End users

If you want setup steps, use the UI docs: Scrobble and Watcher.

What scrobbling does

Scrobbling pushes playback progress to trackers in real time.

It uses three pieces:

• providers (Plex/Jellyfin/Emby) that produce events

• a dispatcher that filters and dedupes

• sinks (Trakt/SIMKL/MDBList) that send events outbound

Pages in this section

• Event producers: Providers

• Outbound senders: Sink

• State files: Services

• Deprecated: Webhooks

Typical flow

flowchart TD
  P[Playback event] --> PARSE[Parse -> ScrobbleEvent]
  PARSE --> F[Filter + dedupe]
  F --> S[Send to sinks]
  F --> CW[Update currently_watching]
  F -->|if completed| WL[Auto-remove from watchlist]

Power users