Scrobble
Real-time playback progress syncing (now playing, pause/stop, and completion).
Scrobbling pushes playback progress while you watch.
It keeps “Up Next” and history in sync across devices.
What scrobbling sends
Depending on the provider pair, CrossWatch can send:
Now playing updates (progress)
Paused / Stopped
Completed when enough is watched
Prerequisites
A supported source (example: Plex watcher).
A supported target (example: Trakt).
Good ID matching (set up Metadata if needed).
Prefer the Watcher over Webhooks. Watcher handles Skip Credits, autoplay, and other edge cases better.
How it works
Detect playback on the source.
Resolve the item to stable IDs.
Send periodic progress heartbeats.
Mark completed once thresholds are met.
Retry and queue when the network is flaky.
What counts as “watched”
Completion threshold: time and/or percent (example: ~80%).
Credits handling: optional grace so skipping credits still completes.
Minimum duration: ignore very short clips unless enabled.
Settings
Scrobble settings typically include:
completion threshold
heartbeat interval
offline queue and flush
per-provider enable/disable
Troubleshooting quick checks
Never completes: lower the threshold or ensure duration is available.
Duplicates: increase heartbeat interval and verify ID mapping.
Progress stuck: the player may not report positions. Prefer Watcher mode.
Offline periods: enable queue/flush and retry.
Summary
Scrobbling pushes progress and completion in real time.
It’s best for new plays as they happen, not bulk backfills.
Matching quality (IDs) matters as much as playback events.
Next steps
Pick a scrobble mode (Watcher recommended): Webhook or Watcher
Configure Watcher sources and sinks: Watcher
Improve IDs before blaming scrobbling: Metadata
Show live progress in the UI footer: Playing Card
Last updated