Webhook or Watcher

Pick a scrobble mode. Watcher is recommended. Legacy webhooks are deprecated.

Scrobbling pushes playback events in real time. It is separate from periodic syncing.

As of v0.6.3, legacy webhooks are deprecated. They are not maintained or supported. Use Watcher instead.

Save changes often. Most settings do nothing until you click the red floating Save button.

Prerequisites

Connect providers in Settings → Authentication.

You need:

• One media server: Plex, Jellyfin, or Emby

• One or more targets: Trakt, SIMKL, and/or MDBList

Related: Authentication

Pick a mode

Default choice: Watcher. Use it for Plex, Jellyfin, and Emby.

Why Watcher works best:

• More reliable than legacy webhooks.

• No Plex Pass required.

• No Emby Premiere required.

You cannot enable Watcher and Webhook at the same time. Pick one mode.

Watcher setup (recommended)

Open Settings → Scrobbler → Watcher.

1. Set Provider (source media server).

2. Set Sink (targets).

3. Enable Watcher.

4. Click the red Save button.

Common options:

• Filtering for shared servers

• Autostart to start Watcher on boot

• Auto remove from Watchlist (movies) after completion

Related: Watcher

Plex ratings (Watcher + helper webhook)

Ratings are Plex-only. They require the helper webhook endpoint:

• http://YOUR_HOST:8787/webhook/plexwatcher

If you expose this endpoint as https://..., use a publicly trusted certificate.

Self-signed TLS certificates will cause webhook delivery to fail (Plex hard-fails here).

Use a reverse proxy with Let’s Encrypt. Keep CrossWatch on HTTP behind the proxy. See Reverse proxies.

Webhook setup (legacy)

Webhook scrobbling is Trakt-only. It is deprecated. Use it only if you must.

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

Plex is usually plug-and-play. Jellyfin and Emby need extra configuration.

Related: Webhooks (legacy)

Related topics

• Syncing — periodic syncing for watchlists, history, and ratings.

• Docker setup — run CrossWatch locally.

• Providers — supported services.

• Reverse proxies — required settings for webhooks and WebSockets.