# WIKI

## WIKI

- [Help Center](https://wiki.crosswatch.app/help-center.md): CrossWatch documentation
- [About CrossWatch](https://wiki.crosswatch.app/getting-started/about-crosswatch.md): Self-hosted watchlist, history, ratings, and resume progress sync plus real-time scrobbling for Plex/Jellyfin/Emby and Trakt/SIMKL/MDBList/PublicMetaDB/AniList/TMDb.
- [Limitations](https://wiki.crosswatch.app/getting-started/limitations.md): Soft size guidance, provider plan limits, and request-throttling limits that affect CrossWatch behavior.
- [Docker setup](https://wiki.crosswatch.app/getting-started/docker-setup.md): Run CrossWatch in Docker and persist state by mounting /config.
- [First-time setup](https://wiki.crosswatch.app/getting-started/first-time-setup.md): Connect providers, add TMDb metadata, create your first pair, then (optionally) enable Watcher for real-time scrobbling.
- [What do you need?](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need.md): Choose between periodic syncing and real-time scrobbling, based on what you want to keep in sync.
- [Syncing](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/syncing.md): Align watchlists, history, and ratings between services. Start with one-way + one feature + dry run, then scale up.
- [Sync results](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/syncing/sync-results.md): What the Done counters mean after a sync run.
- [Best practices](https://wiki.crosswatch.app/getting-started/best-practices.md): Recommended defaults for safe syncing, conflict handling, and operational hygiene.
- [Providers](https://wiki.crosswatch.app/crosswatch/providers.md): Connect services CrossWatch supports and jump to docs for authentication, media servers, trackers, metadata, and adapters.
- [Authentication](https://wiki.crosswatch.app/crosswatch/providers/authentication.md): Connect CrossWatch to providers. Tokens and URLs live here. Pairs use them for syncing and scrobbling.
- [Auth: Media servers](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-media-servers.md): Supported media servers (Plex, Jellyfin, Emby) and setup notes for authentication, whitelisting, and matching.
- [Auth: Plex](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-media-servers/auth-plex.md): Connect Plex via token auth, configure libraries, and enable watchlist, history, ratings, and progress syncing.
- [Auth: Jellyfin](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-media-servers/auth-jellyfin.md): Connect Jellyfin via server URL and user token, configure libraries, and sync watchlist, history, and progress.
- [Auth: Emby](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-media-servers/auth-emby.md): Connect Emby via server URL and user token, configure libraries, and sync watchlist, history, and progress.
- [Auth: Trackers](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers.md): Connect tracker providers (Trakt, SIMKL, MDBList, PublicMetaDB, AniList, TMDb) for syncing and scrobbling.
- [Auth: AniList](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-anilist.md): Anime specific tracker
- [Auth: MDBList](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-mdblist.md): Movies, Shows, Seasons, Episodes and Limited Anime
- [Auth: PublicMetaDB](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-publicmetadb.md): Movies, Shows, and Episodes with watchlist, ratings, history, and progress
- [Auth: SIMKL](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-simkl.md): Movies, Shows, Seasons, Episodes and Anime
- [Auth: Trakt](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-trakt.md): Movies, Shows, Seasons, Episodes and Limited Anime
- [Auth: TMDb](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-tmdb.md): Connect TMDb (Sync) to read/write your TMDb watchlist and ratings (separate from TMDb metadata).
- [Auth: Others](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-others.md)
- [Auth: Tautulli](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-others/auth-tautulli.md): Plex history import
- [Synchronization](https://wiki.crosswatch.app/crosswatch/providers/synchronization.md): Adapter reference for how CrossWatch reads/writes provider data during syncing.
- [Adapter: AniList](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-anilist.md): Anime specific adapter
- [Adapter: CrossWatch](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-crosswatch.md): Local backup adapter that stores watchlist/history/ratings on disk for rollback and restore.
- [Adapter: Emby](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-emby.md): Emby adapter notes for syncing watchlist/history/ratings and handling ID/matching quirks.
- [Adapter: Jellyfin](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-jellyfin.md): Jellyfin adapter notes for syncing watchlist/history/ratings and handling missing external IDs.
- [Adapter: MDBList](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-mdblist.md): MDBList adapter notes for syncing watchlist/history/ratings and handling rate limits.
- [Adapter: PublicMetaDB](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-publicmetadb.md): PublicMetaDB adapter notes for syncing watchlist, history, ratings, and progress with TMDb-based matching.
- [Adapter: Plex](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-plex.md): Plex adapter notes for syncing watchlist/history/ratings with stable external IDs.
- [Adapter: SIMKL](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-simkl.md): SIMKL adapter notes for syncing watchlist/history/ratings using activity watermarks and batching.
- [Adapter: Trakt](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-trakt.md): Trakt adapter notes for syncing watchlist/history/ratings, including ETag caching and batching.
- [Adapter: Tautulli](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-tautulli.md): Tautulli adapter notes for importing Plex watch history into CrossWatch.
- [Adapter: TMDb](https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-tmdb.md): TMDb adapter notes for syncing TMDb account data (watchlist/ratings) via TMDb (Sync).
- [Metadata / ID Mapping](https://wiki.crosswatch.app/crosswatch/providers/metadata-id-mapping.md): Configure TMDb metadata and Anime ID Mapping to improve matching and stabilize IDs across services.
- [TMDb Metadata](https://wiki.crosswatch.app/crosswatch/providers/metadata-id-mapping/tmdb-metadata.md): Configure TMDb metadata to improve matching and stabilize IDs across providers.
- [Anime ID Mapping](https://wiki.crosswatch.app/crosswatch/providers/metadata-id-mapping/anime-id-mapping.md): Configure Anime ID Mapping to bridge AniList IDs with TMDb, TVDb, IMDb, MAL, and AniDB identifiers.
- [Profiles](https://wiki.crosswatch.app/crosswatch/profiles.md): Configure multiple accounts/servers per provider in a single CrossWatch install.
- [Library Whitelisting](https://wiki.crosswatch.app/crosswatch/library-whitelisting.md): Limit which Plex/Jellyfin/Emby libraries CrossWatch reads, writes, or scrobbles.
- [Configure Pairs](https://wiki.crosswatch.app/crosswatch/configure-pairs.md): How to configure a sync pair, feature toggles, and safety controls.
- [Global settings](https://wiki.crosswatch.app/crosswatch/configure-pairs/global-settings.md): Pair-wide safety switches and advanced guardrails.
- [Provider settings](https://wiki.crosswatch.app/crosswatch/configure-pairs/provider-settings.md): Pair-scoped provider behavior (matching, watched-state quirks, and more).
- [Pair-level Whitelisting](https://wiki.crosswatch.app/crosswatch/configure-pairs/provider-settings/pair-level-whitelisting.md): Limit libraries for a single pair (history/ratings) and keep other pairs unaffected.
- [Features](https://wiki.crosswatch.app/crosswatch/configure-pairs/features.md)
- [Watchlist](https://wiki.crosswatch.app/crosswatch/configure-pairs/features/watchlist.md): Configure watchlist syncing (adds, removes, and Jellyfin/Emby modes).
- [Ratings](https://wiki.crosswatch.app/crosswatch/configure-pairs/features/ratings.md): Configure ratings sync, scope, and backfill windows.
- [History](https://wiki.crosswatch.app/crosswatch/configure-pairs/features/history.md): Configure watched-state syncing and safety limitations.
- [Playlists](https://wiki.crosswatch.app/crosswatch/configure-pairs/features/playlists.md): Playlist syncing isn’t supported. The UI has placeholders, but no provider adapters enable playlist read/write.
- [Progress](https://wiki.crosswatch.app/crosswatch/configure-pairs/features/progress.md): Sync resume position (“Continue Watching”) between Plex, Emby, and Jellyfin.
- [AniList pair options](https://wiki.crosswatch.app/crosswatch/configure-pairs/anilist-pair-options.md): Pair-level AniList options for Watchlist and Ratings connections.
- [Navigation](https://wiki.crosswatch.app/crosswatch/navigation.md): Overview of the CrossWatch web UI navigation and key settings.
- [Settings](https://wiki.crosswatch.app/crosswatch/navigation/settings.md): Configure providers, pairs, scheduling, UI options, and maintenance.
- [UI settings](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings.md): Control theme, dashboard cards, sign-in behavior, HTTPS mode, and CW Tracker defaults.
- [User interface](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/user-interface.md): Control theme, visibility, and HTTP/HTTPS mode for the web app.
- [HTTPS/TLS](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/user-interface/https-tls.md): Enable HTTPS for the CrossWatch UI and manage TLS certificates.
- [Security](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/security.md): Configure local login, session duration, session cleanup, Plex sign-in, and trusted reverse proxies.
- [Plex SSO](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/security/plex-sso.md): Link one Plex account as an optional sign-in method for the CrossWatch web app.
- [CW Tracker](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/cw-tracker.md): Configure CW Tracker retention, auto snapshots, and tracker snapshot selectors.
- [Insights](https://wiki.crosswatch.app/crosswatch/navigation/insights.md): Filter the Insights dashboard by feature and provider profile.
- [Quick Add](https://wiki.crosswatch.app/crosswatch/navigation/quick-add.md): Manually send history, ratings, and watchlist actions to one or more providers for titles watched outside your usual media server flow.
- [Playback](https://wiki.crosswatch.app/crosswatch/navigation/playback.md): View and manage unfinished playback records across connected providers.
- [Mobile devices](https://wiki.crosswatch.app/crosswatch/navigation/mobile-devices.md): Use CrossWatch on phones, switch compact/full UI, and install it as a PWA over HTTPS.
- [Scrobble](https://wiki.crosswatch.app/crosswatch/scrobble.md): Real-time playback progress syncing (now playing, pause/stop, and completion).
- [Webhook or Watcher](https://wiki.crosswatch.app/crosswatch/scrobble/webhook-or-watcher.md): Pick the right scrobble path. Watcher is recommended. Webhooks remain available.
- [Webhooks](https://wiki.crosswatch.app/crosswatch/scrobble/webhooks.md): Configure webhook-based scrobbling from Plex, Jellyfin, or Emby to Trakt.
- [Watcher](https://wiki.crosswatch.app/crosswatch/scrobble/watcher.md): Real-time scrobbling from Plex/Emby/Jellyfin to Trakt, SIMKL and MDBList.
- [Migrate to routes mode](https://wiki.crosswatch.app/crosswatch/scrobble/watcher/migrate-to-routes-mode.md): Move from legacy Watcher config (provider + sink) to routes.
- [Scrobble filters](https://wiki.crosswatch.app/crosswatch/scrobble/scrobble-filters.md): How user, server, and library filters work across Plex, Emby, and Jellyfin scrobbling.
- [Playing Card](https://wiki.crosswatch.app/crosswatch/scrobble/playing-card.md): Footer widget showing the currently playing item and live progress (when available).
- [Recent Activity](https://wiki.crosswatch.app/crosswatch/scrobble/recent-activity.md): Local scrobble activity on the dashboard, full history view, UI controls, and storage details.
- [Scheduling](https://wiki.crosswatch.app/crosswatch/scheduling.md): Configure standard recurring syncs or advanced plans with timed steps, automated captures, and event triggers.
- [Advanced scheduling](https://wiki.crosswatch.app/crosswatch/scheduling/advanced-scheduling.md): Configure timed sync steps, capture schedules, and event triggers for more precise automation.
- [Maintenance](https://wiki.crosswatch.app/crosswatch/maintenance.md): Control log verbosity, manage backups, run safe cleanup tasks, and restart the CrossWatch service.
- [Backup & Restore](https://wiki.crosswatch.app/crosswatch/maintenance/backup-and-restore.md): Create, import, validate, restore, schedule, and delete CrossWatch backups.
- [Tools](https://wiki.crosswatch.app/crosswatch/tools.md): Debug matching, edit local state, and export CSVs.
- [Analyzer](https://wiki.crosswatch.app/crosswatch/tools/analyzer.md): Find items that didn’t sync and identify missing IDs or mismatches.
- [Exporter](https://wiki.crosswatch.app/crosswatch/tools/exporter.md): Export watchlist, history, and ratings from state.json to import-friendly CSV files.
- [Editor](https://wiki.crosswatch.app/crosswatch/tools/editor.md): Inspect and edit CrossWatch local data in CW Tracker or Current State, including imports, blocks, manual adds, and save behavior.
- [Captures](https://wiki.crosswatch.app/crosswatch/tools/captures.md): Create point-in-time captures for restore, compare, and scheduled retention workflows.
- [Capture Compare](https://wiki.crosswatch.app/crosswatch/tools/captures/capture-compare.md): Run a read-only diff between two same-provider captures to see added, removed, updated, and unchanged items.
- [Capture Compare (Advanced)](https://wiki.crosswatch.app/crosswatch/tools/captures/capture-compare-advanced.md): Advanced capture diff viewer with raw JSON and field-level changes.
- [Configuration (config.json)](https://wiki.crosswatch.app/crosswatch/configuration-config-json.md): Config file location, load rules, and key reference for config.json.
- [Default config values](https://wiki.crosswatch.app/crosswatch/configuration-config-json/default-config-values.md): Reference list of CrossWatch config.json
- [Config encryption](https://wiki.crosswatch.app/crosswatch/configuration-config-json/config-encryption.md): How CrossWatch encrypts secret values in config.json, where the master key comes from, and what to back up.
- [Provider rate limiting](https://wiki.crosswatch.app/crosswatch/provider-rate-limiting.md): How CrossWatch paces SIMKL, MDBList, PublicMetaDB, and Trakt requests, retries temporary failures, and exposes tuning knobs.
- [FAQ](https://wiki.crosswatch.app/crosswatch/faq.md): Common questions about installation, setup, syncing, scrobbling, and troubleshooting.
- [Overview](https://wiki.crosswatch.app/blueprint-architecture/overview.md): Big-picture map of how Auth, Meta, Sync, Scrobble, and the Orchestrator fit together.
- [Orchestrator](https://wiki.crosswatch.app/blueprint-architecture/orchestrator.md): How the orchestrator runtime loads providers, plans changes, applies writes, and persists state safely.
- [Snapshots](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/snapshots.md): How the orchestrator builds, normalizes, and caches provider snapshots (indices), including canonical keys, checkpoints, and drop-guard safety.
- [Blackbox](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/blackbox.md): Quarantine noisy “flapping” items so runs stay safe, quiet, and cheap.
- [One-way sync](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/one-way-sync.md): Exact one-way pipeline (src → dst) used by the orchestrator for one feature run, including guardrails and state writes.
- [Two-way sync](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/two-way-sync.md): Exact two-way pipeline (A ↔ B), including tombstones, observed deletions, and guarded removal propagation.
- [Guardrails](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/guardrails.md): Safety mechanisms that prevent transient provider issues from becoming destructive writes.
- [State](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/state.md): Where CrossWatch stores orchestrator baselines, checkpoints, and guardrail internals on disk.
- [Applier](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/applier.md): Write engine that executes provider adds/removes, chunks batches, and normalizes results.
- [Planner](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/planner.md): Diff engine that compares two snapshots and produces add/remove plans.
- [Tombstones](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/tombstones.md): Deletion memory that prevents re-add loops and enables safer delete propagation in two-way sync.
- [Unresolved](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/unresolved.md): Records per-item apply failures so the orchestrator can stop retrying known-bad items.
- [Phantom Guard](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/phantom-guard.md): Watchlist anti-flap guard that blocks “ghost adds” that don’t stick on the destination.
- [Scope](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/scope.md): How pair scoping prevents guardrail state and cache files from bleeding across pairs and modes.
- [Eventing](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/eventing.md): Structured events and log conventions used by the orchestrator and UI during runs.
- [Runtime](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/runtime.md): Runtime config knobs for debug output, snapshot caching, chunking, and telemetry warnings.
- [Conflicts](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/conflicts.md): Two-way conflict resolution for ratings, adds vs deletes, and ambiguous “missing” states.
- [Blocklists](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/blocklists.md): How tombstones, blackbox, and unresolved block planned adds to prevent repeated failures.
- [Health](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/health.md): Provider health checks and how they gate pairs, features, and safe write behavior.
- [Chunking](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/chunking.md): How write batches are split and throttled to reduce rate limits and failure blast radius.
- [Caching layers](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/caching-layers.md): Where snapshots can get stale across orchestrator caching, baselines, and provider-side caches.
- [State.json](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/state-json.md): On-disk schema and semantics of /config/state.json (baselines, checkpoints, manual policy, metrics).
- [Provider contract](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/provider-contract.md): Contract providers implement so the orchestrator can snapshot, plan, and apply changes safely.
- [Provider specifics](https://wiki.crosswatch.app/blueprint-architecture/orchestrator/provider-specifics.md): Real-world provider quirks that affect IDs, freshness, consistency, and write confirmations.
- [Auth](https://wiki.crosswatch.app/blueprint-architecture/auth.md): Internal docs for auth provider modules used by Settings → Authentication.
- [Registry](https://wiki.crosswatch.app/blueprint-architecture/auth/registry.md): Discovers auth provider modules and exposes manifests and HTML blocks to the UI/API.
- [\_auth\_ANILIST](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_anilist.md): Internal AniList auth provider module (OAuth flow + token storage).
- [\_auth\_base](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_base.md): Internal base classes and shared helpers for auth provider implementations.
- [\_auth\_EMBY](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_emby.md): Internal Emby auth provider module (server URL + access token handling).
- [\_auth\_JELLYFIN](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_jellyfin.md): Internal Jellyfin auth provider module (server URL + access token handling).
- [\_auth\_MDBLIST](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_mdblist.md): Internal MDBList auth provider module (API key handling).
- [\_auth\_PLEX](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_plex.md): Internal Plex auth provider module (PIN/device auth and token storage).
- [\_auth\_SIMKL](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_simkl.md): Internal SIMKL auth provider module (device PIN flow and token refresh handling).
- [\_auth\_TAUTULLI](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_tautulli.md): Internal Tautulli auth provider module (server URL + API key handling).
- [\_auth\_TMDB](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_tmdb.md): Internal TMDb (Sync) auth provider module (API key + session flow).
- [\_auth\_TRAKT](https://wiki.crosswatch.app/blueprint-architecture/auth/_auth_trakt.md): Internal Trakt auth provider module (device PIN flow and token refresh handling).
- [Meta](https://wiki.crosswatch.app/blueprint-architecture/meta.md): Internal docs for metadata modules that resolve IDs and enrich items (TMDb).
- [Registry](https://wiki.crosswatch.app/blueprint-architecture/meta/registry.md): Internal registry that discovers metadata modules and exposes manifests to the app.
- [\_meta\_TMDB](https://wiki.crosswatch.app/blueprint-architecture/meta/_meta_tmdb.md): Internal TMDb metadata module (ID resolution and poster/backdrop URL support).
- [Sync](https://wiki.crosswatch.app/blueprint-architecture/sync.md): Low-level sync provider modules under sync/ (used by the Orchestrator).
- [Engine-level features](https://wiki.crosswatch.app/blueprint-architecture/sync/engine-level-features.md): Shared feature semantics the orchestrator uses across providers.
- [History](https://wiki.crosswatch.app/blueprint-architecture/sync/engine-level-features/history.md): Watched-state feature. Uses watched\_at timestamps when available.
- [Ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/engine-level-features/ratings.md): Rating feature. Syncs rating values plus rated\_at when available.
- [Watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/engine-level-features/watchlist.md): Set-like feature used for “plan to watch” lists.
- [\_mod\_ANILIST](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_anilist.md): Sync module for AniList (GraphQL). Watchlist and ratings.
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_anilist/overview.md): AniList sync module overview (capabilities and key behaviors).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_anilist/watchlist.md): AniList watchlist feature implementation (anime watchlist reads and writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_anilist/ratings.md): AniList ratings feature implementation and behavior.
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_anilist/history.md): AniList history feature implementation (if enabled) and behavior.
- [\_mod\_CROSSWATCH](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_crosswatch.md): Local file-backed tracker(watchlist/history/ratings).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_crosswatch/overview.md): CrossWatch local provider sync module overview (snapshots, restore, and persistence).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_crosswatch/watchlist.md): CrossWatch local provider watchlist feature (file-backed set semantics).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_crosswatch/ratings.md): CrossWatch local provider ratings feature (file-backed ratings store).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_crosswatch/history.md): CrossWatch local provider history feature (file-backed watched events store).
- [\_mod\_EMBY](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby.md): Sync module for Emby (MediaBrowser API).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby/overview.md): Emby sync module overview (capabilities, setup links, and matching notes).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby/watchlist.md): Emby watchlist feature implementation (favorites/playlist modes and writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby/ratings.md): Emby ratings feature implementation and limitations.
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby/history.md): Emby history feature implementation (watched state indexing and writes).
- [progress](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_emby/progress.md): Emby progress feature implementation (resume position indexing and writes).
- [\_mod\_JELLYFIN](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin.md): Sync engine module for Jellyfin (watchlist/history indexing and writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin/overview.md): Jellyfin sync module overview (capabilities, setup links, and matching notes).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin/watchlist.md): Jellyfin watchlist feature implementation (favorites/playlist modes and write behavior).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin/ratings.md): Jellyfin ratings feature implementation and limitations.
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin/history.md): Jellyfin history feature implementation (watched state indexing and writes).
- [progress](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_jellyfin/progress.md): Jellyfin progress feature implementation (resume position indexing and writes).
- [\_mod\_MDBLIST](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_mdblist.md): Sync engine module for MDBList (watchlist/history/ratings indexing and writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_mdblist/overview.md): MDBList sync module overview (capabilities, setup links, and rate-limit notes).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_mdblist/watchlist.md): MDBList watchlist feature implementation (indexing and batch writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_mdblist/ratings.md): MDBList ratings feature implementation (indexing and batch writes).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_mdblist/history.md): MDBList history feature implementation (watched/unwatched writes and pagination).
- [\_mod\_PLEX](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex.md): Sync engine module for Plex (watchlist/history/ratings indexing and writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex/overview.md): Plex sync module overview (capabilities, setup links, and matching behavior).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex/watchlist.md): Plex watchlist feature implementation (Discover-driven reads and writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex/ratings.md): Plex ratings feature implementation (indexing and rating writes).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex/history.md): Plex history feature implementation (watched-state indexing and writes).
- [progress](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_plex/progress.md): Plex progress feature implementation (resume position indexing and writes).
- [\_mod\_SIMKL](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_simkl.md): Sync engine module for SIMKL (activity-based indexing and batch writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_simkl/overview.md): SIMKL sync module overview (activities/watermarks, caching, and rate-limit notes).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_simkl/watchlist.md): SIMKL watchlist feature implementation (indexing and batch writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_simkl/ratings.md): SIMKL ratings feature implementation (indexing, scale behavior, and writes).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_simkl/history.md): SIMKL history feature implementation (watched events indexing and writes).
- [\_mod\_TAUTULLI](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tautulli.md): Sync engine module for Tautulli (Plex history import support).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tautulli/overview.md): Tautulli sync module overview (history import behavior and limitations).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tautulli/watchlist.md): Tautulli watchlist feature placeholder and notes (if supported).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tautulli/ratings.md): Tautulli ratings feature placeholder and notes (if supported).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tautulli/history.md): Tautulli history feature implementation (Plex play history import).
- [\_mod\_TMDB](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tmdb.md): Sync engine module for TMDb account sync (watchlist/ratings indexing and writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tmdb/overview.md): TMDb sync module overview (account sync behavior and limitations).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tmdb/watchlist.md): TMDb watchlist feature implementation (account watchlist reads and writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tmdb/ratings.md): TMDb ratings feature implementation (account ratings reads and writes).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_tmdb/history.md): TMDb history feature notes (if supported) and behavior.
- [\_mod\_TRAKT](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_trakt.md): Sync engine module for Trakt (watchlist/history/ratings indexing and writes).
- [overview](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_trakt/overview.md): Trakt sync module overview (ETag caching, batching, and rate-limit notes).
- [watchlist](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_trakt/watchlist.md): Trakt watchlist feature implementation (indexing, ETag caching, and batch writes).
- [ratings](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_trakt/ratings.md): Trakt ratings feature implementation (indexing and batch writes).
- [history](https://wiki.crosswatch.app/blueprint-architecture/sync/_mod_trakt/history.md): Trakt history feature implementation (watched events indexing and writes).
- [Scrobble](https://wiki.crosswatch.app/blueprint-architecture/scrobble.md): Internal blueprint for the scrobble pipeline (event parsing, filtering, and sink dispatch).
- [Sink](https://wiki.crosswatch.app/blueprint-architecture/scrobble/sink.md): Scrobble sink modules that send playback events to trackers (Trakt, SIMKL, MDBList).
- [Sink: SIMKL](https://wiki.crosswatch.app/blueprint-architecture/scrobble/sink/sink-simkl.md): Scrobble sink implementation for sending playback events to SIMKL.
- [Sink: Trakt](https://wiki.crosswatch.app/blueprint-architecture/scrobble/sink/sink-trakt.md): Scrobble sink implementation for sending playback events to Trakt.
- [Sink: MDBList](https://wiki.crosswatch.app/blueprint-architecture/scrobble/sink/sink-mdblist.md): Scrobble sink implementation for sending playback events to MDBList.
- [Providers](https://wiki.crosswatch.app/blueprint-architecture/scrobble/providers.md): Scrobble provider modules that produce playback events (Plex, Jellyfin, Emby).
- [Watch: PLEX](https://wiki.crosswatch.app/blueprint-architecture/scrobble/providers/watch-plex.md): Scrobble provider implementation for Plex (live sessions and playback events).
- [Watch: Jellyfin](https://wiki.crosswatch.app/blueprint-architecture/scrobble/providers/watch-jellyfin.md): Scrobble provider implementation for Jellyfin (live sessions and playback events).
- [Watch: Emby](https://wiki.crosswatch.app/blueprint-architecture/scrobble/providers/watch-emby.md): Scrobble provider implementation for Emby (live sessions and playback events).
- [Webhooks](https://wiki.crosswatch.app/blueprint-architecture/scrobble/webhooks.md): Legacy webhook-based scrobble integrations (deprecated; use Watcher when possible).
- [Webhook: embytrakt](https://wiki.crosswatch.app/blueprint-architecture/scrobble/webhooks/webhook-embytrakt.md): Legacy webhook bridge for Emby → Trakt scrobbling (deprecated).
- [Webhook: jellyfintrakt](https://wiki.crosswatch.app/blueprint-architecture/scrobble/webhooks/webhook-jellyfintrakt.md): Legacy webhook bridge for Jellyfin → Trakt scrobbling (deprecated).
- [Webhook: plextrakt](https://wiki.crosswatch.app/blueprint-architecture/scrobble/webhooks/webhook-plextrakt.md): Legacy webhook bridge for Plex → Trakt scrobbling (deprecated).
- [Services](https://wiki.crosswatch.app/blueprint-architecture/scrobble/services.md): Scrobble service helpers and state files under /config/.cw\_state (now playing, auto-remove, etc.).
- [Overview](https://wiki.crosswatch.app/blueprint-architecture/scrobble/services/overview.md): Overview of scrobble service state files under /config/.cw\_state, including currently\_watching and auto-remove dedupe.
- [Auto remove watchlist](https://wiki.crosswatch.app/blueprint-architecture/scrobble/services/auto-remove-watchlist.md): How Watcher can auto-remove items from watchlists on completion (and how it dedupes deletes).
- [Currently watching](https://wiki.crosswatch.app/blueprint-architecture/scrobble/services/currently-watching.md): State file format and behavior for the “currently watching” scrobble output.
- [API](https://wiki.crosswatch.app/blueprint-architecture/api.md): Use the CrossWatch REST API from your own self-hosted instance. Includes base URL and the OpenAPI reference link.
- [Community](https://wiki.crosswatch.app/related-information/community.md)
- [Install scripts](https://wiki.crosswatch.app/related-information/community/install-scripts.md): Community-built install helpers and setup wrappers for CrossWatch.
- [Proxmox LXC installer](https://wiki.crosswatch.app/related-information/community/install-scripts/proxmox-lxc-installer.md): Deploy CrossWatch in an unprivileged Proxmox Debian 12 LXC with automated setup, persistent /config storage, and a built-in update command.
- [Synology with Portainer or Dockhand](https://wiki.crosswatch.app/related-information/community/install-scripts/synology-with-portainer-or-dockhand.md): Community guide for running CrossWatch on Synology with Portainer or Dockhand.
- [Reverse proxies](https://wiki.crosswatch.app/related-information/reverse-proxies.md): Configure NGINX (and similar proxies) for CrossWatch with correct webhook and WebSocket settings.
- [Trackers vs. Media Servers](https://wiki.crosswatch.app/related-information/trackers-vs.-media-servers.md): How to choose a source of truth between trackers and media servers.
- [Media Server to Media Server](https://wiki.crosswatch.app/related-information/media-server-to-media-server.md): Why server-to-server syncing is fragile, when it can work, and the safety checks you need.
- [Tracker to Media Server](https://wiki.crosswatch.app/related-information/tracker-to-media-server.md): Why syncing from a tracker into a media server is risky, and safer defaults for history and ratings.
- [Trakt vs SIMKL (Free plans)](https://wiki.crosswatch.app/related-information/trakt-vs-simkl-free-plans.md): Quick comparison of common free-plan limits that affect watchlists and lists.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://wiki.crosswatch.app/help-center.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.