Trakt
Connect Trakt to synchronize supported activity and configure real-time scrobbling.

What CrossWatch can sync
Read brings data into CrossWatch; Write sends changes to this provider.
Watchlist
Yes
Yes
Movies and shows.
History
Yes
Yes
Movies and episodes.
Ratings
Yes
Yes
Movies, shows, seasons and episodes.
Progress
Yes
Yes
Resume positions for movies and episodes.
Playlists
Yes
Yes
Writable lists only; actions depend on ownership and permissions.
Collection
Yes
Yes
Movies, shows, seasons and episodes, with optional media info.
Live scrobbling: Scrobble destination; cannot be a Watcher source.
See the synchronization guide for matching rules and feature restrictions.
Connect Trakt (PIN Flow, recommended)
Open the Trakt connection in CrossWatch. PIN Flow is selected by default.
Click Connect Trakt. CrossWatch shows a link code and opens a new tab.

Enter the link code at https://auth.trakt.tv/activate and approve CrossWatch.
Return to CrossWatch. The status changes to Connected.
The link code is valid for 10 minutes. If it expires, click Restart to get a new one.
Connect with your own Trakt app (optional)
Use this only if you want CrossWatch to run on your own Trakt API app. Existing connections that were set up this way keep working and do not need to be changed.
Create a Trakt app:
Create a new app.
Set App name:
CrossWatch.Set Redirect URIs:
urn:ietf:wg:oauth:2.0:oob.Leave Allowed origins empty.
Save the app.
In CrossWatch, select the Own app (Client ID) tab.
Copy the Client ID and Client Secret into CrossWatch.
Click Connect Trakt, then enter the link code at https://auth.trakt.tv/activate.
Switching methods
Each profile has its own method. One profile can use PIN Flow while another uses its own app.
To switch a connected profile, click Delete first, pick the other tab, and connect again.
Connecting with PIN Flow replaces the Client ID stored for that profile and clears its Client Secret.
Staying connected
CrossWatch refreshes your Trakt login automatically in the background. You do not need to reconnect every week.
If Trakt no longer accepts the login, CrossWatch shows Trakt login expired - reconnect. Click Connect Trakt again to fix it.
Logins created before Trakt changed its authentication can no longer be refreshed and need one reconnect.
Playlists
CrossWatch discovers the supported liked, followed, shared, and smart-list categories for the connected account. Ownership and collaboration determine whether a list is writable.
Liking or following a list does not grant edit access. Supported public lists can also be resolved by link.
See Playlists for playlist setup.
Troubleshooting
If the auth tab doesn't open, disable popup blockers for CrossWatch, or open https://auth.trakt.tv/activate yourself and enter the code.
If the code fails or has expired, click Restart to generate a new link code.
If you see Trakt login expired - reconnect, connect again. Your sync settings are kept.
CrossWatch paces Trakt requests automatically to stay within Trakt's limits. During a large sync it may pause for a few minutes and then continue.
If you still see
429 Too Many Requests, see the guide: Provider rate limiting.
Power users
Config keys
Stored under: trakt.*
Common keys:
trakt.auth_method:pin(built-in CrossWatch client) orapp(your own Trakt app)trakt.client_id: set automatically for PIN Flow, your own value forapptrakt.client_secret: only used forapptrakt.access_token,trakt.refresh_token,trakt.expires_attrakt.auth_error:reconnect_requiredwhen Trakt rejected the logintrakt.rate_limit.get_per_sec,trakt.rate_limit.post_per_sec: sync pacing
Profiles other than the default store the same keys under trakt.instances.<profile>.*.
Tokens
Access tokens are valid for 7 days. Refresh tokens are single use and are replaced on every refresh.
A background worker checks hourly and refreshes a token when it is within 24 hours of expiring.
The PIN Flow never sends a client secret.
Rate limiting
All Trakt calls share one pacer per account:
Writes: 1 per second
Reads: 500 per 5 minutes
After a
429, calls for that account wait untilRetry-Afterhas passed
Environment variables
CROSSWATCH_TRAKT_CLIENT_ID: use a different client ID for PIN FlowCW_TRAKT_READ_LIMIT: reads allowed per 5 minutes (default500)CW_TRAKT_PACING: set to0to turn the shared pacer offCW_TRAKT_UA: custom User-Agent for Trakt calls
Related docs
Sync module: Trakt module
Adapter: Adapter: Trakt
Last updated
Was this helpful?