Webhook or Watcher

Scrobbling mode (real-time)

As of v0.6.3, the legacy (“traditional”) webhooks are deprecated and no longer maintained or supported. Use the Watcher instead.

The Watcher fully replaces webhooks and is the recommended path going forward: it’s more reliable, more capable, and easier to operate than the old webhook setup.

If you’re still on legacy webhooks, expect no fixes and no support for webhook-related issues, migrate to the Watcher now!

1) Configure authentication providers

You need:

• Trakt and or SIMKL for Watcher scrobbling

• Trakt for Webhook scrobbling

• Plex / Jellyfin / Emby

2) Choose your mode

Server	Best choice	Why
Jellyfin	Watcher	Best practice
Plex	Watcher	Best practice and no Plex Pass needed
Emby	Watcher	Best practice and no Emby Premiere needed

[!NOTE] CrossWatch blocks enabling Watcher and Webhook at the same time. Pick one scrobble mode. Prefer the Watcher when available. That means Plex and Emby and Jellyfin use the watcher, the traditional webhooks will be obsolute in the future.

3) Enable the mode in CrossWatch

Go to Settings - Scrobbler:

• Enable Watcher or Webhook

• Optional:

  • Filtering. Use this if multiple users share your media server.

  • Auto remove from Watchlist when a movie is finished

  • Autostart. Watcher only.

  • Ratings enable ratings to be sent to Trakt and/or SIMKL and/or MDBList (only for Plex) when using watcher you need to add a webhook helper for ratings!

4a) If you picked Webhook

CrossWatch exposes endpoints like:

• Plex: http://YOUR_HOST:8787/webhook/plextrakt

• Jellyfin: http://YOUR_HOST:8787/webhook/jellyfintrakt

• Emby: http://YOUR_HOST:8787/webhook/embytrakt

For Plex you are done. For Jellyfin/Emby read the Webhook wiki since it requires specific configuration: https://github.com/cenodude/CrossWatch/wiki/Webhook

4b) If you picked Watcher

You are done. if you enable ratings for Plex then also include the webhook helper in your Plex instance http://YOUR_HOST:8787/webhook/plexwatcher