Destination Library

Control which destination libraries each scrobble route can update.

When a media server is a scrobble destination, CrossWatch can limit its writable libraries.

This applies to Watcher and Webhook routes targeting Plex, Jellyfin, Emby, or Kodi.

This whitelist controls where CrossWatch writes scrobbles. It does not control playback-event sources.

Why use destination libraries

A server can hold the same title in multiple libraries:

• Movies and 4K Movies
• Kids Movies
• Anime or language-specific libraries

Media-ID matching can find several valid copies. Destination libraries ensure each route updates only intended copies.

Use this when different routes target different libraries. It also protects shared-server libraries from route updates.

Configure a Watcher route

Open Settings → Scrobbler → Watcher → Route → Libraries.

Load available libraries. Then select libraries that CrossWatch may update. The route considers only media in those libraries.

Configure a Webhook route

Webhook routes use the same destination-library logic.

For Plex, Jellyfin, Emby, or Kodi destinations, choose libraries on the route. A Webhook route and Watcher route can use different scopes for one connection.

Route and connection scopes

CrossWatch has two destination-library scopes:

• The connection History and Progress whitelist defines the usual scope.
• A route-level whitelist controls writes for that specific Watcher or Webhook route.

The route whitelist takes priority when it contains selected libraries.

Route libraries	Result
One or more libraries selected	CrossWatch updates only those libraries.
No libraries selected	CrossWatch falls back to the connection History and Progress whitelist.
No route or applicable connection whitelist	CrossWatch uses the normal connection scope.

An empty route whitelist still respects the destination connection settings. The route inherits the applicable connection library scope.

Example

Your Plex connection uses Movies and Movies 4K for History and Progress. A Watcher route selects only Movies 4K.

That route can update Movies 4K only. It cannot update Movies or Kids.

Clear the route selection to restore the connection scope. The route can then use Movies and Movies 4K.

Update all copies

Media-server destinations provide Update all copies.

When enabled, CrossWatch updates every matching copy in the allowed destination libraries. When disabled, it updates the first valid match.

Library whitelisting applies first. Update all copies never expands the route's allowed libraries.

Source scrobble whitelist

The connection Scrobble whitelist controls incoming playback events from Plex, Jellyfin, and Emby. It determines which source libraries can generate scrobbles.

Destination Library Whitelisting controls outgoing media-server updates.

• Connection Scrobble whitelist: incoming playback scope
• Watcher or Webhook destination whitelist: outgoing update scope
• Connection History and Progress whitelist: fallback destination scope for routes without selected libraries