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

Tautulli

Tautulli adapter notes for importing Plex watch history into CW.

Tautulli adapter is a read-only history importer. It pulls old Plex plays from an existing Tautulli database and normalizes them.

Connect Tautulli first. Use: Tautulli (Authentication provider).

What CrossWatch can sync

Feature
Read
Write
Notes

Watchlist

No

No

Unsupported.

History

Yes

No

Read-only Plex play history, including retained plays for unavailable library items.

Ratings

No

No

Unsupported.

Progress

No

No

Unsupported.

Playlists

No

No

Unsupported.

Collection

No

No

Unsupported.

Read brings data into CrossWatch; Write sends changes to this provider. Enable only features supported by both sides.

Connect the provider first: Tautulli setup.

How indexing works

  1. Pull pages from get_history until the end or a safety stop.

  2. Keep only media_type in {movie, episode}.

  3. Extract IDs from GUIDs + Plex/Tautulli keys (rating_key, grandparent_rating_key).

  4. If IDs are incomplete, call get_metadata(rating_key) to enrich external IDs.

  5. Emit normalized items keyed by external IDs where possible.

If Tautulli reports that metadata is unavailable for a history item, CrossWatch keeps the available history details and continues importing the remaining records. The item may have only a Plex ID, so another provider may not be able to match it. Authentication failures, connection failures, and other API errors still stop the read.

History is indexed as a de-duplicated snapshot. Newest entry wins per canonical key.

Output shape

Movie example
Episode example
1

Run a pair: Tautulli → CW with History enabled.

Then use CW as the source to seed Trakt/SIMKL/etc.

Related: Adapter: CW.

2

Import into Editor dataset

Use this if you want to clean history before syncing it anywhere:

  • fix wrong matches

  • remove junk plays

  • merge duplicates

  • correct titles/years

Endpoints used (for debugging)

API calls
  • History pages: GET /api/v2?cmd=get_history

  • Metadata enrichment (optional): GET /api/v2?cmd=get_metadata&rating_key=...

Last updated

Was this helpful?