Wiki / People & watch data
People & History
One card per person in your Plex household (Home users, managed users, shared friends), plus what Kustos knows about them.
- Watch history across Plex, Tautulli, Trakt and Simkl.
- Linking — Trakt and Simkl accounts, and public Trakt profiles.
- Tokens. Reading (history, cleanup protection, who-watched-what) needs no token. Writing as someone — their watchlist into requests, or pushing history back into Plex — needs their own Plex token. Controls that need a token they don't have are shown greyed with the reason, never hidden.
- Absorb folds a replaced account's history into the current one. An account can only be absorbed once.
- Per-user tags — the import tag applied to their requests, plus the dropped and rewatch tags that tell cleanup to ignore or protect a title for that person.
- Push — per linked account, whether Kustos writes this person's plays to that service.
- Rename — changes only what Kustos calls them; history, tags and rules are unaffected.
What needs their token, and what does not
This is the rule behind every greyed-out control on the screen, and it is worth learning once rather than meeting it eight times:
| Needs their Plex token? | |
|---|---|
| Watch history, who watched what | No — Kustos reads this from your own server |
| Cleanup protection based on their plays | No |
| Their watchlist turning into requests | Yes — Kustos is acting as them |
| Pushing history back into Plex as them | Yes |
| Writing to their Trakt or Simkl | Their own link, not a Plex token |
Reading is free; writing as somebody is not. A control that needs a token they have not given is shown greyed with the reason attached, never hidden — so the answer to "why can't I do this" is on the screen rather than in the docs. Send them an invite link and it lights up.
The per-person controls
| Control | What it does | Watch out |
|---|---|---|
| Linked accounts | Their Trakt or Simkl account, or a public Trakt profile | A public profile is read-only — you can see the list, you cannot write to it. That is Trakt's rule, not Kustos's |
| New titles on this watchlist | Ignore / Ask me first / Add automatically | Add automatically sends new titles straight to Sonarr/Radarr. See Watchlists for how this differs from the per-service mode |
| Per-service watchlist mode | Untouched / Append / Sync, one per service | Sync removes titles from their watchlist. The only setting here that deletes somebody else's data |
| Push (per linked account) | Whether Kustos writes this person's plays to that service | |
| Live scrobbling (household-wide, in Scrobbling conflicts) | Tells Trakt what is being watched as it is watched — the "now playing" card. One switch for the whole house, not per person. The same panel blocks Kustos from writing to a service another tool already records plays to | Off by default, deliberately: it writes to a service outside Kustos every single time something plays |
| Import tag | The tag put on requests they make | |
| Dropped / rewatch tags | Tell cleanup to ignore, or to protect, a title for that person | |
| Absorb | Folds a replaced account's history into the current one | Once only. An account cannot be absorbed twice |
| Rename | Changes what Kustos calls them | Nothing else moves — history, tags and rules are untouched |