> 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/main-dashboard/navigation.md).

# Navigation

Map the CrossWatch web UI and find the main settings and tools.

Use the UI to connect providers, configure pairs, manage playlists, and run syncs.

Most setup problems come from [**Connections**](https://wiki.crosswatch.app/crosswatch/settings/connections.md), [**Pairs**](https://wiki.crosswatch.app/crosswatch/settings/configure-pairs.md), or [**Metadata / ID Mapping**](https://wiki.crosswatch.app/crosswatch/settings/connections/metadata.md).

{% hint style="success" %}
If you feel lost in the UI, start from **Settings** and **Main**.
{% endhint %}

{% tabs %}
{% tab title="End users" %}

### Start here

Use these pages most often:

* [Main dashboard](https://wiki.crosswatch.app/crosswatch/main-dashboard.md) — overview and top actions
* [Status dashboard](https://wiki.crosswatch.app/crosswatch/main-dashboard/status-dashboard.md) — live system status
* [Dashboard widgets](https://wiki.crosswatch.app/crosswatch/main-dashboard/dashboard-widgets.md) — watchlist, history, ratings, and scrobble widgets
* [Watchlist](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/profile/watchlist.md) — unified watchlist view
* [Playlists](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/playlists.md) — named playlist endpoints and mappings
* [Tracker](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/cw-tracker.md) — CrossWatch’s lightweight local tracker for watches, lists, ratings and notes
* [Quick Add](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/quick-add.md) — manual history, watchlist, and rating actions
* [Playback](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/profile/playback.md) — unfinished playback records
* [Output panel](https://wiki.crosswatch.app/crosswatch/main-dashboard/output-panel.md) — Sync, Watcher, and Debug output
* [Hub](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/profile.md) — visual overview and actions for connected provider accounts

<figure><img src="https://565675962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3rh5THg1PdhVsBt3GALo%2Fuploads%2FbvicXzY1XjIEGyA5Atv3%2Fimage.png?alt=media&amp;token=b94a4367-946f-4391-88e6-090d1dbf9633" alt=""><figcaption><p>Main navigation with the dashboard, tools, and settings entry points.</p></figcaption></figure>

### Main navigation

Select **Hub** to open Media Hub Overview, then use its Watchlist, History, Ratings, Progress and Collection tabs. **Tracker** opens your local CW Tracker. On narrower desktop windows, **Captures** and **Playlists** move into **More**; **Tools** stays visible. The settings icon opens **Settings**.

### Tools menu

Open **Tools** for **Events**, **Logs**, **Editor**, **Analyzer**, **Import / Export** and **Backup & Restore**, subject to your permissions. Editor is now inside this menu. On mobile, open **More → Tools**; **Back** returns to the navigation menu.

### Account menu

Open your avatar menu for:

* [**My profile**](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/settings.md) — account details, security, linked identities and sessions.
* **Help & About** — **Help** and **About CrossWatch**. Use **Back** to return to the account menu.
* **Log out** — end your session.

### Mobile navigation

Use the bottom bar for **Home**, two configurable shortcuts, and **More**. **Tracker** and **Hub** are the default shortcuts when available; existing saved choices are kept. Open **More → Mobile settings → Navigation shortcuts** to choose the two shortcuts for this browser, including **Tracker** and **Hub**. Your permissions determine which destinations are offered.

For swipe navigation, card action sheets and home-screen installation, see [Mobile devices](https://wiki.crosswatch.app/crosswatch/main-dashboard/mobile-devices.md).

### Common paths

#### Connect providers

1. Open **Settings → Connections**
2. Connect what you need
3. Click **Save**

#### Create a pair

1. Open **Synchronization**
2. Create one pair first
3. Start with **one-way** and **one feature**

#### Synchronize a playlist

1. Open **Main Dashboard → Playlists**
2. Create a source and destination endpoint
3. Create a mapping with **Direct sync**
4. Run the mapping and review its result

#### Run and check

1. Go to **Main**
2. Run a sync
3. Review the results
4. Fix mismatches in [Analyzer](https://wiki.crosswatch.app/crosswatch/main-dashboard/tools/analyzer.md) or [Editor](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/editor.md)

### Saving changes

* Click **Save** to persist changes.
* Active runs use the next saved settings.
* Some changes need a restart.
  {% endtab %}

{% tab title="Power users" %}

### Key settings areas

Most configuration lives under **Settings**.

Use these pages for the deeper controls:

* [Settings](https://wiki.crosswatch.app/crosswatch/settings.md)
* [Connections](https://wiki.crosswatch.app/crosswatch/settings/connections.md)
* [Metadata / ID Mapping](https://wiki.crosswatch.app/crosswatch/settings/connections/metadata.md)
* [Configure Pairs](https://wiki.crosswatch.app/crosswatch/settings/configure-pairs.md)
* [Playlists](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/playlists.md)
* [Scheduling](https://wiki.crosswatch.app/crosswatch/settings/scheduling.md)
* [Scrobble](https://wiki.crosswatch.app/crosswatch/settings/scrobbler.md)
* [Recent Activity](https://wiki.crosswatch.app/crosswatch/settings/scrobbler/recent-activity.md)
* [Maintenance](https://wiki.crosswatch.app/crosswatch/settings/maintenance.md)
* [HTTPS/TLS](https://wiki.crosswatch.app/crosswatch/advanced-and-api/https-and-tls.md)
* [Plex SSO](https://wiki.crosswatch.app/crosswatch/settings/ui-settings/security/plex-sso.md)

### Notes

Connected providers appear in **Synchronization** only after they connect.

Most setup issues come from authentication, mapping, or pair rules.

For feature-level behavior, use [Synchronization](https://wiki.crosswatch.app/crosswatch/settings/synchronization.md) and [Tools](https://wiki.crosswatch.app/crosswatch/main-dashboard/tools.md).
{% endtab %}
{% endtabs %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
