# CrossWatch - [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, 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: 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: 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](https://wiki.crosswatch.app/crosswatch/providers/metadata.md): Configure metadata providers (TMDb) to improve matching and stabilize IDs across services. - [Meta: TMDb](https://wiki.crosswatch.app/crosswatch/providers/metadata/meta-tmdb.md): Configure TMDb metadata to improve matching and stabilize IDs across providers. - [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. - [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 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 dashboard cards, help 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. - [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). - [Webhooks](https://wiki.crosswatch.app/crosswatch/scrobble/webhooks.md): Deprecated legacy webhook setup for scrobbling (use Watcher instead). - [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. - [Playing Card](https://wiki.crosswatch.app/crosswatch/scrobble/playing-card.md): Footer widget showing the currently playing item and live progress (when available). - [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, run safe cleanup tasks, and restart the CrossWatch service. - [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): Default throttles for upstream APIs (SIMKL + Trakt + MDBList) and how to override them. - [FAQ](https://wiki.crosswatch.app/crosswatch/faq.md): Common questions about installation, setup, syncing, scrobbling, and troubleshooting. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.crosswatch.app/crosswatch.md?ask= ``` 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.