Settings
Configure providers, pairs, scheduling, UI options, and maintenance.
Settings is where you configure CrossWatch (CW).
Use the Settings dropdown in the top nav to jump fast.
Start in Providers and Sync pairs.
CW has lots of knobs. Most users can leave the defaults alone.
Focus on the few things that matter:
Connect providers in Providers
Configure TMDb metadata
Create a Sync pair and enable the feature you want
Settings overview
The Overview screen is a dashboard.
Use it to spot missing config fast.
Quick actions
Use Quick actions to jump straight into common setup:
Open providers (auth, sync, metadata)
Open sync pairs (create source/target pairs)
Open scrobbler (routes, webhook, filters)
Open UI settings (UI, security, CW Tracker)
Status overview
Use Status overview to confirm what CW currently detects:
Connected Authentication providers
Configured Synchronization providers and pair count
Metadata providers detected vs configured
Scheduling status (enabled/disabled)
Scrobbler status (running/stopped) and active routes
Providers
Providers is the home for:
Authentication (tokens, URLs, profile IDs)
Synchronization provider configuration (what adapters are available)
Metadata (TMDb)
Authentication
Connect providers like Plex, Jellyfin, Emby, Trakt, SIMKL, and MDBList.
Providers appear in Sync pairs only after they connect.
Related: Authentication.
Metadata
Metadata (TMDb) improves matching. It reduces wrong links and missing peers.
Related: Metadata.
Sync pairs
Sync pairs define what syncs with what.
The default pair settings are good for most users.
Start with one-way + one feature + Dry run.
Direction: source → target (example: Plex → Trakt).
Mode: one-way or two-way.
Features: Watchlist, History, Ratings, Progress (where supported).
Writes: allow Add and/or Remove.
Related:
Scheduling
Configure periodic runs.
Avoid overlaps. Start daily and tune later.
Related: Scheduling.
Scrobbler
Real-time scrobbling uses Watcher (preferred) or legacy Webhooks.
It requires connected providers (example: Plex + Trakt).
Defaults are good here too. Add your scrobble routes, then enable Watcher.
Related:
UI settings
Watchlist preview: show/hide the Watchlist preview pane on Main.
Playing Card: show/hide the footer “Now Playing” card (used by scrobbling).
It only shows when it’s enabled and a TMDb API key is configured.
Protocol: HTTP or HTTPS.
Prefer HTTPS on untrusted networks.
See HTTPS/TLS.
Security (UI login)
Enable login to protect CW with a username and password.
Click Log-in to activate after enabling.
Sessions are kept for up to 30 days.
Trusted reverse proxies
If you run CrossWatch behind a reverse proxy, set Trusted reverse proxies here.
This makes forwarded client IPs and scheme accurate.
It improves secure cookies and rate limiting.
Related: Reverse proxies.
CW-Tracker
Configure CW-Tracker integration (if enabled in your build).
Maintenance
Operational tools:
Enable debug logging.
Clear state and cache.
Reset statistics.
Related: Maintenance.
Clearing state changes the next plan.
Use it after changing direction, features, or provider identity.
Saving and applying changes
Use Save to persist changes.
If a run is active, changes apply on the next run.
Last updated
Was this helpful?