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: Plex, Emby, or Jellyfin.

• A supported target: Trakt, SIMKL, or MDBList.

• Good ID matching (set up Metadata).

Prefer the Watcher over Webhooks. Watcher handles Skip Credits, autoplay, and other edge cases better.

1) Connect providers

Open Settings → Authentication.

Connect:

• one media server (source)

• one or more trackers (targets)

Related: Authentication

2) Add metadata (recommended)

Open Settings → Metadata.

Add TMDb.

Related: Metadata

3) Pick a scrobble mode

Use Watcher unless you have a hard reason not to.

• Recommended: Watcher

• Legacy/deprecated: Webhooks (legacy)

4) Enable Watcher (recommended)

Open Settings → Scrobble → Watcher.

1. Add one or more routes (provider → sink mappings).

2. Pick provider and sink profiles if needed.

3. Enable Watcher.

4. Click the red Save button.

5) Validate with one title

Play one movie or episode.

Then verify:

• the tracker shows progress or “Now watching”

• completion is marked after the threshold

• the UI footer updates (optional): Playing Card

How it works (high level)

1. Detect playback on the source.

2. Resolve the item to stable IDs.

3. Send progress heartbeats.

4. Mark completed after thresholds are met.

5. Retry 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.

Related topics

• Pick Watcher vs webhooks: Webhook or Watcher

• Improve matching quality: Metadata

• Show live progress in the UI footer: Playing Card

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

• Configure sources and sinks: Watcher

• Learn the deprecated path (not recommended): Webhooks (legacy)