Pair synchronization
Feature compatibility, matching rules, and sync controls for standard pairs.
This section covers standard pair-based synchronization.
It shows which providers can act as sources or destinations, how matching works, and which safety controls affect writes.
Safest first sync:
one-way
one feature
dry run on
source is a media server
target is a tracker
Two-way sync and mirror delete mode are powerful.
They can also spread bad matches, conflicts, and deletes.
Feature compatibility
A normal connection is valid for a feature when the selected source can read that feature and the selected destination can write it.
Watchlist
CrossWatch local, Plex, Jellyfin, Emby, Trakt, SIMKL, MDBList, PublicMetaDB, AniList, TMDb
CrossWatch local, Plex, Jellyfin, Emby, Trakt, SIMKL, MDBList, PublicMetaDB, AniList, TMDb
Ratings
CrossWatch local, Plex, Trakt, SIMKL, MDBList, PublicMetaDB, AniList, TMDb
CrossWatch local, Plex, Trakt, SIMKL, MDBList, PublicMetaDB, AniList, TMDb
History
CrossWatch local, Plex, Jellyfin, Emby, Trakt, SIMKL, MDBList, PublicMetaDB, Tautulli
CrossWatch local, Plex, Jellyfin, Emby, Trakt, SIMKL, MDBList, PublicMetaDB
Progress
CrossWatch local, Plex, Jellyfin, Emby, PublicMetaDB
CrossWatch local, Plex, Jellyfin, Emby, PublicMetaDB
Pair behavior
One-way sync
Source writes to destination
Two-way sync
Both sides are compared and synced
Per-feature enablement
Watchlist, ratings, history, and progress can be enabled independently
Per-feature additions
Add and update writes can be enabled independently
Per-feature removals
Removal writes can be enabled independently
Multiple named provider profiles
Source and destination profile IDs are preserved
Dry run
Plans and logs changes without remote writes
Verify after write
Limited
Runs only when the destination provider supports verification
Matching and identity resolution
Global identity and fallback
Canonical identity mapping
Global
Normalizes provider IDs into common keys
IMDb IDs
Global
Used for matching and export
TMDb IDs
Global
Primary identity for PublicMetaDB
TVDB IDs
Global
Used where available
Trakt IDs
Global
Used where available
SIMKL IDs
Global
Used where available
MDBList IDs
Global
Used where available
Provider native IDs
Provider-specific
Preserved for provider-specific matching
Title and year fallback
General matching
Used when strict ID matching is disabled
Provider-specific matching
Strict ID matching
Plex, Jellyfin, Emby
Disables title and year search fallback
Plex Discover watchlist matching
Plex
Primary Plex watchlist path
Plex PMS metadata match
Plex
Can resolve external IDs through the selected server
Plex PMS watchlist fallback
Plex
Optional
Disabled by default for strict Discover behavior
Plex fallback GUID search
Plex
Optional
Searches beyond visible libraries. Best for temporary troubleshooting.
Anime and metadata enrichment
AniBridge local anime mapping
AniList pairs
Enriches IDs for watchlist and ratings
Anime-only filtering
AniList pairs
Skips content that cannot be confirmed as anime
Metadata locale
TMDb metadata
Default is en-US
Metadata cache
TMDb metadata
Default cache lifetime is 720 hours
Synchronization controls
Write controls
Global addition gate
Enabled
Global removal gate
Disabled
Pair feature additions
Pair setting overrides the global default
Pair feature removals
Pair setting overrides the global default
Source delete mode
Removes only when the source deletion is observed
Mirror delete mode
Destination is forced to follow the source. Destructive.
Include observed deletes
Enabled
Tombstone retention
Default 1 day
Dry run
Disabled
Verify after write
Limited
Disabled. Requires provider support.
Safety and guardrails
Drop guard
Disabled
Mass delete permission
Enabled
Suspect inventory shrink guard
Applies after a minimum previous inventory size
Blackbox unresolved item quarantine
Enabled
Pair-scoped blackbox
Enabled
Blackbox addition blocking
Enabled
Blackbox removal blocking
Enabled
Blackbox cooldown
Default 30 days
Unresolved and freeze state
Prevents repeated unsafe writes
Flapper protection
Integrated with blackbox behavior
Runtime and provider behavior
Provider rate limiting
All providers
Provider-specific GET and POST rates
Retry and backoff
All providers
Provider-specific retry budgets and rate-limit handling
Apply chunking
All providers
Global and provider-specific chunk sizes
Snapshot reuse cache
All providers
Default 300 seconds
Checkpoints and watermarks
Delta-capable flows
Used for incremental and delta-capable providers
Library filtering
Plex, Jellyfin, Emby
Per-feature and scrobble library allowlists
Ignore dropped shows
Trakt, SIMKL, MDBList
Optional history filter
Trakt Collection write
Trakt
Optional when adding history
Include manually marked watched
Plex
Optional. Enabled by default.
Progress-specific controls
Progress minimum seconds
All supported progress pairs
Default 60. Ignores tiny offsets
Progress change threshold
All supported progress pairs
Default 30. Avoids unnecessary writes
Ignore near-completed progress
All supported progress pairs
Default 95 percent. Lets history own watched state
Replay watched items
Plex, Jellyfin, and Emby destinations
Default off. Allows rewatches to restore progress
Progress timestamp tolerance
Plex, Jellyfin, and Emby destinations
Default 30 seconds. Accepted range 0 to 300
Last updated
Was this helpful?