From 2810cba6ec39c2f62a14e8996c089ca79f345a98 Mon Sep 17 00:00:00 2001 From: enoch85 Date: Fri, 28 Aug 2026 20:34:46 +0000 Subject: [PATCH] docs: explain why Tracearr rules can report 0 views --- docs/Common.md | 22 ++++++++++++++++++++++ docs/Configuration.md | 2 ++ 2 files changed, 24 insertions(+) diff --git a/docs/Common.md b/docs/Common.md index 6ce20e89f..958ca11a1 100644 --- a/docs/Common.md +++ b/docs/Common.md @@ -61,6 +61,28 @@ If `Take action after days` is set to `0`, the action will run when one of these So `0` means "no waiting period before eligibility," not "take action instantly at save time." ::: +## Tracearr rules always say 0 views + +**Problem:** My Tracearr rules report 0 views on items I know have been watched, and Tracearr itself shows the plays. + +Maintainerr reads watch history from exactly one Tracearr server: the one that tracks the media server Maintainerr is connected to. Plays that Tracearr recorded against any of its other servers are not counted. + +So when the viewing happened on a different server, the rule returns 0 views. That 0 is a real answer and not a failure, which means nothing appears in the log and the rule acts on it. A rule that removes items nobody has watched will go ahead and remove them. + +If you run two media servers over the same files and watch on both, Maintainerr counts only the server it is connected to. There is no way to combine the two. + +:::tip Fix + +- Check which server is selected under `Settings`, `Tracearr`, `Tracearr server`. +- Connect Maintainerr to the media server where the watching actually happens. +- If the watching really is split across two servers, Tracearr rules cannot give a complete answer, so do not let a deletion rule depend on them alone. + +::: + +:::note +A Tracearr rule can also read 0 views for a different reason: Tracearr does not backfill history from before it was connected to your media server. See [Tracearr](./Configuration.md#tracearr) under Configuration. +::: + ## Pre-made Rules **Problem:** Is there a set of pre-made rules I can use as a starting point? diff --git a/docs/Configuration.md b/docs/Configuration.md index 357f9fef7..ac79eca09 100644 --- a/docs/Configuration.md +++ b/docs/Configuration.md @@ -291,3 +291,5 @@ Maintainerr uses the Tracearr server that tracks your media server. Watch histor - Every run checks the server before reading its history. If that fails, Tracearr rule values are unavailable for that run and the log says why, instead of the rules reading as watched by nobody. `Test Connection` checks the URL and the API key. The server is checked when you save. + +If a Tracearr rule reports 0 views on something you know was watched, see [Tracearr rules always say 0 views](./Common.md#tracearr-rules-always-say-0-views) under Common Problems.