Authentication

Connect CrossWatch to providers. Tokens and URLs live here. Pairs use them for syncing and scrobbling.

Authentication is where you connect CrossWatch to providers.

You connect each provider once.

Pairs use those connections for syncing and Watcher scrobbling.

Open Settings → Authentication.

Connect only what you use.

Recommended first setup: 1 media server + 1 tracker. Validate one clean run. Then add more.

What we store (and what we don’t)

CrossWatch stores only what it needs to call provider APIs:

• OAuth tokens, API keys, or user tokens

• Provider URLs (for self-hosted services)

• Provider user IDs and server IDs (when required)

CrossWatch does not store your provider password.

To remove access, revoke it in the provider.

Then reconnect in CrossWatch.

Generic connection flow

Each provider has its own details, but the flow is consistent:

1. Click Connect (or Sign In).

2. Approve access in the provider tab.

3. Return to CrossWatch.

4. Open Settings for that provider.

5. Verify IDs and URLs. Use Auto-Fetch where available.

6. Click Save.

If the auth tab never opens, disable popup blockers for CrossWatch.

Provider guides

Category

Media servers

Open

Media servers

Category

Trackers

Open

Trackers

Category

Others

Open

Others

Troubleshooting quick checks

• Use a URL reachable from the CrossWatch host/container. Prefer LAN IPs over hostnames.

• If OAuth uses a callback URL, it must match the provider app settings.

• If libraries don’t load, check whitelisting. Then click Load Libraries.

Next steps

• Pick the two services you want to sync: Providers

• Create your first pair: Configure Pairs

• Enable real-time plays after the first clean run: Watcher