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.
What CrossWatch can sync
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
Pull pages from
get_historyuntil the end or a safety stop.Keep only
media_typein{movie, episode}.Extract IDs from GUIDs + Plex/Tautulli keys (
rating_key,grandparent_rating_key).If IDs are incomplete, call
get_metadata(rating_key)to enrich external IDs.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.
Output shape
Workflows (recommended)
Import into CW (recommended)
Run a pair: Tautulli → CW with History enabled.
Then use CW as the source to seed Trakt/SIMKL/etc.
Related: Adapter: CW.
Endpoints used (for debugging)
Last updated
Was this helpful?