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

Tracearr

Import watch history from Tracearr.

Tracearr is read-only in CrossWatch. It imports existing watch history and never writes back to Tracearr.

Tracearr can monitor Plex, Jellyfin, and Emby. One connection can import history from all three.

Tracearr 2.0 or later is required. Earlier versions do not provide the public API v2 used by CrossWatch.

Connect Tracearr

  1. Enter your Server URL, such as http://192.168.1.10:3000.

  2. Enter your API Key.

    • In Tracearr, open Settings → API.

    • Public API keys start with trr_pub_.

  3. Click Connect Tracearr and wait for confirmation.

  4. Optionally choose a User to import one user's history.

    • Leave All users selected to import everyone.

  5. Click Save changes.

CrossWatch loads the user list after a successful connection. You do not need user IDs.

How it works

  • History only. Tracearr does not provide watchlists, ratings, progress, or playlists.

  • Source only. Use Tracearr as a source in a sync pair. It cannot be a target.

  • Watched plays only. CrossWatch imports plays Tracearr marks as watched. Tracearr uses its own thresholds under Settings → API → Public API. The default is 85% for movies and episodes.

  • Rewatches. Each play stays separate. Compatible targets can receive rewatches.

  • Episodes. CrossWatch matches the show's TMDb, IMDb, or TVDB ID, plus season and episode numbers.

Troubleshooting

  • Could not connect: Ensure the CrossWatch container can reach the Server URL.

  • Invalid API key: Create or copy the key again under Settings → API.

  • Tracearr 2.0 or later is required: Update Tracearr. Older releases only support API v1.

  • Empty or small import: Check the selected User, or choose All users.

  • Some plays are missing: Tracearr only returns IDs for titles linked to your library. CrossWatch skips older plays without IDs. The sync log reports skipped plays.

  • Slow first sync: Tracearr allows about 240 requests per minute. Large, multi-user histories can take several minutes.

Config keys

  • tracearr.server_url

  • tracearr.api_key

  • tracearr.verify_ssl

  • tracearr.history.user_id — optional Tracearr user ID

  • tracearr.history.server_id — optional Tracearr server ID

  • tracearr.history.watched_only — defaults to true

  • tracearr.history.min_percent_movie — defaults to 85 when a play lacks a watched flag

  • tracearr.history.min_percent_episode — defaults to 85 when a play lacks a watched flag

PreviousTautulli
NextMetadata

Last updated

Was this helpful?