Webhook or Watcher

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

Use this page if you just need the fast answer.

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

Scrobbling has two modes:

• Watcher — recommended

• Webhooks — legacy only

Use Watcher when

Choose Watcher if you want the supported path.

It is the right choice for almost everyone.

Why:

• More reliable than legacy webhooks

• Supports multiple routes and profiles

• No Plex Pass required

• No Emby Premiere required

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

Guide: Watcher.

Use Webhooks only when

Choose Webhooks only if you still depend on the old webhook flow.

Limits:

• Deprecated and unsupported

• More fragile around HTTPS and reverse proxies

• Best treated as a compatibility path only

Guide: Webhooks (legacy).

Quick decision

• Want the supported setup: use Watcher

• Want the overview and setup order: use Scrobble

• Need the legacy endpoint details: use Webhooks (legacy)

TLS note

If you expose webhook endpoints over https://..., use a publicly trusted certificate.

Self-signed certificates commonly break webhook delivery.

Related topics

• Scrobble — overview and setup flow

• Watcher — recommended mode

• Webhooks (legacy) — deprecated compatibility mode

• Reverse proxies — webhook and WebSocket proxy rules