Settings
Configure providers, pairs, scheduling, UI options, and maintenance.
Use Settings to configure CrossWatch.
Start with 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
UI settings covers:
dashboard visibility
web sign-in
protocol and TLS
CW Tracker defaults
Related: UI settings.
Security (UI login)
Enable login to protect CW with a username and password.
CW now enforces credential setup.
Set a username and password before login becomes active.
Click Log-in to activate after enabling.
Session persistence is configurable.
By default, persistent sessions are disabled.
Users sign in again after the browser closes.
You can enable persistent sessions for 1–365 days.
Plex SSO
You can optionally add Sign in with Plex for the web app.
This is an extra sign-in method.
Local CrossWatch credentials stay as the fallback and recovery path.
Guide: Plex SSO.
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.
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?