Adapter: Tautulli

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

circle-exclamation
circle-info

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

What it supports

  • Direction: source-only

  • Features:

    • History (movies + episodes)

    • Watchlist / ratings / playlists (not supported)

  • Writes: not supported (always read-only)

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.

circle-info

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

Output shape

chevron-rightMovie examplehashtag
chevron-rightEpisode examplehashtag
1

Run a pair: Tautulli → CrossWatch with History enabled.

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

Related: Adapter: CrossWatch.

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)

chevron-rightAPI callshashtag
  • History pages: GET /api/v2?cmd=get_history

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

Last updated