For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

BingeBase is not available for standard pairs. Use it as a Watcher or webhook destination.

MyAnimeList is experimental and anime-only. It supports watchlist, ratings, and cumulative history in either direction. Playback progress, playlists, and collections are unsupported.

Feature
Valid sources
Valid destinations

Watchlist

Emby, Jellyfin, Plex; Nuvio, Stremio; AniList, FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, TMDb, Trakt, WeTrakr; CrossWatch local

Emby, Jellyfin, Plex; Nuvio, Stremio; AniList, FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, TMDb, Trakt, WeTrakr; CrossWatch local

Ratings

Plex; Kodi; AniList, FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, TMDb, Trakt, WeTrakr; CrossWatch local

Plex; Kodi, Stremio; AniList, FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, TMDb, Trakt, WeTrakr; CrossWatch local

History

Emby, Jellyfin, Plex; Kodi, Nuvio, Stremio; FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, Trakt, WeTrakr; CrossWatch local, Tautulli, Tracearr

Emby, Jellyfin, Plex; Kodi, Nuvio, Stremio; FlickList, Floppy, MDBList, MyAnimeList, PublicMetaDB, PunchPlay, Scrob, SIMKL, Trakt, WeTrakr; CrossWatch local

Progress

Emby, Jellyfin, Plex; Kodi, Nuvio, Stremio; Floppy, FlickList, PublicMetaDB, PunchPlay, Scrob, WeTrakr; CrossWatch local

Emby, Jellyfin, Plex; Kodi, Nuvio, Stremio; Floppy, FlickList, PublicMetaDB, PunchPlay, Scrob, WeTrakr; CrossWatch local

Collection

Plex, Emby, Jellyfin, Kodi; Trakt, MDBList, CrossWatch local, PunchPlay, Floppy, Scrob

Trakt, MDBList, CrossWatch local, PunchPlay, Floppy, Scrob

Pair behavior

Pair behavior
Supported
Notes

One-way sync

Source writes to destination

Two-way sync

Both sides are compared and synced

Collection sync

One-way only

Enabling Collection locks the pair to One-way mode

Per-feature enablement

Watchlist, ratings, history, progress, and Collection 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

Capability
Scope
Supported
Notes

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

Capability
Scope
Supported
Notes

Strict ID matching

Emby, Jellyfin, Plex

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

Recover older Plex history

Plex

Imports retained play history for items no longer available in Plex.

Stremio IMDb matching

Stremio

Uses IMDb IDs. TMDb can enrich missing metadata.

Floppy TMDb ID matching

Floppy

Requires TMDb IDs for supported synchronization.

WeTrakr ID matching

WeTrakr

Uses TMDb, IMDb, TVDb, and native IDs. Progress writes require an external ID.

Anime and metadata enrichment

Capability
Scope
Supported
Notes

AniBridge local anime mapping

AniList pairs

Enriches IDs for watchlist and ratings

Anime-only filtering

AniList and MyAnimeList 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

For runtime behavior, conflict resolution, deletion safeguards, and playlist mappings, see Synchronization policies.

Write controls

Control
Supported
Default or behavior

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

Control
Supported
Default or behavior

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

Control
Scope
Default or 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

Incremental reads

WeTrakr

Uses activity timestamps and checkpoints when possible; full reads detect removals

Library filtering

Emby, Jellyfin, Plex

Per-feature and scrobble library allowlists

Ignore dropped shows

MDBList, SIMKL, Trakt

Optional history filter

Trakt Collection write

Trakt

Optional when adding history

Include manually marked watched

Plex

Optional. Enabled by default.

Progress-specific controls

Progress uses pair thresholds and Destination completion policies.

See Playback progress thresholds and completion policies for defaults, provider limits, and manual editing rules.

Last updated

Was this helpful?