For the complete documentation index, see llms.txt. This page is also available as Markdown.

WeTrakr

Connect WeTrakr to sync watch activity, ratings, and playback progress.

WeTrakr

Connect WeTrakr to sync your watchlist, watched history, ratings, and playback progress with CrossWatch. It can also receive scrobbles from your configured players.

You do not need an API key, client secret, or developer account. Approve CrossWatch in WeTrakr, then copy the authorization code back into CrossWatch.

Connect WeTrakr

  1. Open Settings → Connections and select WeTrakr.

  2. Select the provider profile you want to connect.

  3. Click Connect WeTrakr.

  4. In the browser tab that opens, sign in to WeTrakr and approve CrossWatch.

  5. Copy the authorization code displayed by WeTrakr.

  6. Return to CrossWatch and paste it into Authorization code.

  7. Click Complete connection.

  8. Wait until CrossWatch shows Connected as your account name.

Keep the connection dialog open and stay on the same provider profile while completing these steps. The login session expires after 10 minutes.

Account status

After connecting, CrossWatch displays your account name and Free or VIP plan. The provider status tooltip also shows your remaining daily API calls and reset time when WeTrakr supplies that information.

Connecting an account does not start synchronization automatically. Configure your sync pairs or scrobble routes separately. Rewatch syncing is optional in the pair settings and does not require WeTrakr VIP.

Troubleshooting

  • If no browser tab opens, click Open WeTrakr approval page or allow popups for CrossWatch.

  • If the code is invalid or the login session expires, click Connect WeTrakr again and complete the new approval flow.

  • If CrossWatch asks you to reconnect, repeat the connection steps for the affected profile.

  • If you reach an API quota, wait for its reset before retrying. Check the provider status tooltip for the remaining allowance when available.

Power users

Authentication

CrossWatch uses Authorization Code + PKCE (S256) with the out-of-band redirect URI urn:ietf:wg:oauth:2.0:oob. The browser displays a code for the user to paste into CrossWatch; no public callback URL is required.

CrossWatch includes its public client ID and does not require a client secret. WeTrakr's media-center Device Code flow is not used for this connection.

Access and refresh tokens are stored automatically for the selected provider profile. CrossWatch refreshes access tokens automatically; reconnect if authorization expires or is revoked.

Config keys

The wetrakr provider configuration includes:

  • auth_method: pkce

  • access_token, refresh_token, token_type, expires_at: managed by CrossWatch

  • username, user_id, plan: account details obtained during authentication

  • reauth_required: whether the profile needs to reconnect

Use the connection UI to manage credentials. Additional provider profiles keep their own authentication state.

Last updated

Was this helpful?