# CrossWatch

CrossWatch is a sync hub for what you've watched and what you want to watch. You connect media servers ([Plex](</app/plex/>), [Jellyfin](</app/jellyfin/>), Emby) and trackers (*Trakt, SIMKL, MDBList, AniList and more*), then set up **sync pairs** between them: Plex to Trakt, Jellyfin to SIMKL, one way or both ways. Each pair can carry watchlists, watch history, ratings and playback progress.

Its **Watcher** follows playback on Plex, Jellyfin and Emby and reports it to your trackers as you watch, without needing Plex Pass or Emby Premiere. When an item won't match, the **Analyzer** shows what's missing and the **Editor** lets you fix or block the mapping, and **Captures** give you something to roll back to if a sync does something you didn't want.

**When does hosted CrossWatch make sense?**

- **Always on.** Scheduled syncs and the Watcher only work while CrossWatch is running. On ElfHosted it doesn't stop because a laptop went to sleep.
- **Your servers can live anywhere.** CrossWatch connects to the media servers and trackers you give it credentials for, on ElfHosted or not.
- **Behind your ElfHosted login.** The CrossWatch site is private to you.
- **Backed up while it runs.** CrossWatch's database (*your pairs, mappings and history*) is copied every day with SQLite's online backup, which is safe against a running app.
- **Updates are done for you.**

[Get a 7-day trial of ElfHosted CrossWatch! 🪄](<https://store.elfhosted.com/product/crosswatch/>)

## How do I access CrossWatch?

CrossWatch is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-crosswatch.elfhosted.com](<https://your-username-crosswatch.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/crosswatch/>) and these become your personal, clickable links.

## How do I use it?

Open CrossWatch from your dashboard. Your ElfHosted login gets you to the site, and then CrossWatch asks you to create its own username and password (*at least 8 characters*). That's CrossWatch's own sign-in, on top of your ElfHosted one; keep it somewhere safe, because we can't read it back for you.

Upstream's advice for a first run is to start small, and it's good advice:

1. Go to **Settings → Connections**. Connect **one** media server and **one** tracker. For trackers, click **Connect / Sign In**, approve access in the new tab, and come back.
2. Add **TMDb** as the metadata provider, so CrossWatch can match titles reliably.
3. Create **one** sync pair, one way, with one feature (*say, Plex history to Trakt*).
4. Click the red floating **Save** button. Most changes do nothing until you save.
5. Run the pair once and check the result. Then add more pairs, features and schedules.

If your media server runs on ElfHosted, these are its addresses inside your stack:

| App | Address |
| --- | --- |
| [Plex](</app/plex/>) | `http://plex:32400` |
| [Jellyfin](</app/jellyfin/>) | `http://jellyfin:8096` |
| [Emby](</app/emby/>) | `http://emby:8096` |

### Scrobbling as you watch

Use the **Watcher** for live playback reporting. It connects out to your media server, so it works wherever that server lives.

CrossWatch also accepts media server **webhooks**, but your CrossWatch address is behind your ElfHosted login, and a media server can't sign in. Webhooks sent to the public address will be refused. Stick with the Watcher.

### Server to server

CrossWatch can sync Plex and Jellyfin directly (*for example while you move from one to the other*). Upstream's guidance is that this works only when both servers hold near-identical libraries, and that one-way sync carries less risk than two-way. Take a Capture first.

### Big libraries

CrossWatch is a UI-first tool, not a bulk-sync engine. Upstream suggests rough upper bounds of about 2,500 watchlist or progress items and 25,000 history, rating or collection items. Above that, syncs get slow and heavy; see upstream's [limitations](<https://wiki.crosswatch.app/getting-started/limitations>) page.

## CrossWatch also works with

- [x] [Plex](</app/plex/>)
- [x] [Jellyfin](</app/jellyfin/>)
- [x] [Emby](</app/emby/>)
- [x] [Yamtrack](</app/yamtrack/>)

## How do I get support for CrossWatch?

1. For general use of CrossWatch, refer to the [official site](<https://github.com/cenodude/CrossWatch>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## CrossWatch resources

- [CrossWatch (*official site*)](<https://github.com/cenodude/CrossWatch>)
- [CrossWatch Website](<https://crosswatch.app>)
- [CrossWatch Wiki](<https://wiki.crosswatch.app>)
