> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/settings.md).

# Settings

Use **Settings** to configure CW.

Start with **Connections** and **Synchronization**.

{% hint style="success" %}
CW has lots of knobs. Most users can leave the defaults alone.

Focus on the few things that matter:

* Connect providers in **Connections**
* Configure **TMDb** in **Connections**
* Create a sync pair in **Synchronization**
  {% endhint %}

### Jump to a settings area

<table data-view="cards"><thead><tr><th>Area</th><th data-card-target data-type="content-ref">Open</th></tr></thead><tbody><tr><td><strong>Connections</strong><br>Connect Plex, Jellyfin, Emby, Trakt, and other providers.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/lCTegLtxemF834DhMv5R">/spaces/3rh5THg1PdhVsBt3GALo/pages/lCTegLtxemF834DhMv5R</a></td></tr><tr><td><strong>Metadata / ID Mapping</strong><br>Improve matching before you sync.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/8L38pVPE2gL0y3sD7I8D">/spaces/3rh5THg1PdhVsBt3GALo/pages/8L38pVPE2gL0y3sD7I8D</a></td></tr><tr><td><strong>Configure Pairs</strong><br>Choose direction, writes, and features.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/C1lNlN7T3a0xWpl0jEU5">/spaces/3rh5THg1PdhVsBt3GALo/pages/C1lNlN7T3a0xWpl0jEU5</a></td></tr><tr><td><strong>Scheduling</strong><br>Run pairs on a schedule without overlaps.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/hVUNomZiBduGHBlvojRV">/spaces/3rh5THg1PdhVsBt3GALo/pages/hVUNomZiBduGHBlvojRV</a></td></tr><tr><td><strong>Scrobbler</strong><br>Set up Watcher, Webhooks, and routes.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/YwgRnxeZmi2IG39XFA7l">/spaces/3rh5THg1PdhVsBt3GALo/pages/YwgRnxeZmi2IG39XFA7l</a></td></tr><tr><td><strong>UI settings</strong><br>Control theme, login, HTTPS, and dashboard widgets.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/vH3t2HJ1dWPYhjONtnAF">/spaces/3rh5THg1PdhVsBt3GALo/pages/vH3t2HJ1dWPYhjONtnAF</a></td></tr><tr><td><strong>Maintenance</strong><br>Backups, cache clears, logs, and recovery tools.</td><td><a href="/spaces/3rh5THg1PdhVsBt3GALo/pages/IlKhfb6pyOgsPrOKgCe6">/spaces/3rh5THg1PdhVsBt3GALo/pages/IlKhfb6pyOgsPrOKgCe6</a></td></tr></tbody></table>

### Settings overview

The **Overview** screen is a dashboard. Use it to spot missing config fast.

This overview focuses on setup completeness.

The **Main** page focuses on live operational state.

{% hint style="info" %}
If setup feels overwhelming, finish connections first, then synchronization, then scheduling.
{% endhint %}

#### Quick actions

Use **Quick actions** to jump straight into common setup:

* **Open connections** (providers and metadata)
* **Open synchronization** (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 providers
* Configured **Synchronization providers** and pair count
* **Metadata / ID Mapping** status
* **Scheduling** status
* **Scrobbler** status

Use [Main dashboard](/crosswatch/main-dashboard.md) and [Status dashboard](/crosswatch/main-dashboard/status-dashboard.md) when you want the live **Main** page view.

### Connections

**Connections** is the home for:

* Connected providers (tokens, URLs, profile IDs)
* **Metadata / ID Mapping** (TMDb and Anime ID Mapping)

#### Connect providers

Connect providers like Plex, Jellyfin, Emby, Trakt, SIMKL, and MDBList.

Providers appear in **Synchronization** only after they connect.

Related: [Connections](/crosswatch/settings/connections.md).

#### Metadata / ID Mapping

TMDb metadata improves matching across providers.

Anime ID Mapping improves AniList matching against TMDb, TVDb, and IMDb based providers.

Related:

* [Metadata / ID Mapping](/crosswatch/settings/connections/metadata.md)
* [TMDb Metadata](/crosswatch/settings/connections/metadata/tmdb-metadata.md)
* [Anime ID Mapping](/crosswatch/settings/connections/metadata/anime-id-mapping.md)

### Synchronization

Synchronization defines what syncs with what.

{% hint style="info" %}
The default pair settings are good for most users. Start with **one-way** and **one feature**
{% endhint %}

* **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:

* [Configure Pairs](/crosswatch/settings/configure-pairs.md)
* [Synchronization](/crosswatch/settings/synchronization.md)

### Scheduling

Configure periodic runs.

Avoid overlaps. Start daily and tune later.

Related: [Scheduling](/crosswatch/settings/scheduling.md).

### Scrobbler

Real-time scrobbling uses **Watcher** (preferred) or **Webhooks**.

It requires connected providers (example: Plex + Trakt).

{% hint style="info" %}
Defaults are good here too. Add your scrobble **routes**, then enable **Watcher**.
{% endhint %}

If both paths are enabled, CW shows their status separately.

Related:

* [Scrobbler](/crosswatch/settings/scrobbler.md)
* [Watcher](/crosswatch/settings/scrobbler/watcher.md)

### UI settings

UI settings covers things like:

* dashboard visibility
* Recent Activity widget visibility and display mode
* web sign-in and Plex SSO
* CW Tracker defaults

Related: [UI settings](/crosswatch/settings/ui-settings.md).

#### Security (UI login)

Protect CW with a username and password. Set both credentials, then click **Log-in to activate**.

Sessions expire when the browser closes by default. You can keep sessions for `1–365` days.

Review active browser sessions here. Use **Log out other sessions** to remove old sessions.

**Plex SSO**

You can optionally add **Sign in with Plex** for the web app.

This is an extra sign-in method.

Local CW credentials stay as the fallback and recovery path.

Guide: [Plex SSO](/crosswatch/settings/ui-settings/security/plex-sso.md).

**Trusted reverse proxies**

If you run CW 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](/crosswatch/advanced-and-api/reverse-proxy-setup.md).

### Maintenance

Operational tools:

* Manage local state, caches, tracker data, and captures.
* Run targeted recovery and cleanup actions.
* Enable debug logging.
* Open backup and restore tools.

Related:

* [Maintenance](/crosswatch/settings/maintenance.md)
* [Backup & Restore](/crosswatch/settings/maintenance/backup-and-restore.md)

{% hint style="warning" %}
Maintenance actions affect local CW data.
{% endhint %}

### Saving and applying changes

* Use **Save** to persist changes.
* If a run is active, changes apply on the next run.


---

# 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 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, and the optional `goal` query parameter:

```
GET https://wiki.crosswatch.app/crosswatch/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.