⌘Ctrlk

_mod_TRAKT

Sync engine module for Trakt (watchlist/history/ratings indexing and writes).

Provider ID: TRAKT Version (module): 3.2.0

Trakt support in the sync engine.

Use it to sync:

watchlist
history
ratings

Setup docs:

Entry point: sync/_mod_TRAKT.py

Provider surface

health()
build_index(feature)
add(feature, items)
remove(feature, items)

Features

watchlist → providers/trakt/_watchlist.py
history → providers/trakt/_history.py
ratings → providers/trakt/_ratings.py

Capabilities

bidirectional: true
provides_ids: true
index_semantics: "present"

Config

Config block name:

Trakt or trakt

Common keys:

client_id, access_token
timeout (default 15.0)
max_retries (default 3)
history_number_fallback (default false)
history_collection (default false)

Gotchas

history_number_fallback can change episode matching behavior.

Use it only if your library numbering is consistent.

Runtime call flow

Orchestrator
  └─ OPS.build_index(cfg, feature)
       └─ TRAKTModule.build_index(feature)
            └─ providers/trakt/_{feature}.py : build_index(adapter, ...)

Writes are symmetric:

Orchestrator plan → OPS.add/remove(...)
  └─ TRAKTModule.add/remove(feature, items, dry_run=...)
       └─ providers/trakt/_{feature}.py : add/remove(adapter, items)

OPS contract

name()
label()
features()
capabilities()
is_configured(cfg)
build_index(cfg, feature=...)
add(cfg, items, feature=..., dry_run=False)
remove(cfg, items, feature=..., dry_run=False)
health(cfg)

Capabilities (raw)

{
  "bidirectional": true,
  "index_semantics": "present",
  "provides_ids": true,
  "ratings": {
    "from_date": false,
    "types": {
      "episodes": true,
      "movies": true,
      "seasons": true,
      "shows": true
    },
    "unrate": true,
    "upsert": true
  }
}

Full config reference

Config namespace:

cfg["trakt"] (fallback: cfg["auth"]["trakt"])

Fields:

client_id
access_token
timeout (default: 15.0)
max_retries (default: 3)
history_number_fallback (default: false)
history_collection (default: false)

Dependencies:

requires: []

Endpoints:

https://api.trakt.tv

Previoushistory Nextoverview

Last updated 30 minutes ago

Was this helpful?

Good afternoon

hashtagProvider surface

hashtagFeatures

hashtagCapabilities

hashtagConfig

hashtagGotchas

Provider surface

Features

Capabilities

Config

Gotchas