From f348f535848fd85b3c18887d4880dd17dd16b318 Mon Sep 17 00:00:00 2001 From: whitestrake Date: Sat, 5 Sep 2026 00:25:01 +1000 Subject: [PATCH] docs: cover watcher lists since media was added --- docs/Glossary.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ docs/Rules.mdx | 2 ++ 2 files changed, 46 insertions(+) diff --git a/docs/Glossary.md b/docs/Glossary.md index 5c1a0caa6..5af46b3c6 100644 --- a/docs/Glossary.md +++ b/docs/Glossary.md @@ -172,6 +172,17 @@ List of users who have watched every available episode of the Plex item. This ru - Availability: shows, seasons - Type: text[] +#### Users that watched every episode since added + +:::info +List of users who watched every available episode strictly after the selected Plex show or season was added. + +::: + +- Key: Plex.sw_allEpisodesSeenBySinceAdded +- Availability: shows, seasons +- Type: text[] + #### Newest episode view date :::info @@ -276,6 +287,17 @@ List of users who have watched at least one episode of the Plex item. This rule - Availability: shows, seasons, episodes - Type: text[] +#### Users that watched at least one episode since added + +:::info +List of users who watched at least one available episode strictly after the selected Plex show or season was added. + +::: + +- Key: Plex.sw_watchersSinceAdded +- Availability: shows, seasons +- Type: text[] + #### Collections media is present in (titles) :::info @@ -771,6 +793,17 @@ List of users who have watched every available episode of the Jellyfin item. - Availability: shows, seasons - Type: text[] +#### Users that watched every episode since added + +:::info +List of users who watched every available episode strictly after the selected Jellyfin show or season was added. + +::: + +- Key: Jellyfin.sw_allEpisodesSeenBySinceAdded +- Availability: shows, seasons +- Type: text[] + #### Newest episode view date :::info @@ -864,6 +897,17 @@ List of users who have watched at least one episode of the Jellyfin item. This r - Availability: shows, seasons, episodes - Type: text[] +#### Users that watched at least one episode since added + +:::info +List of users who watched at least one available episode strictly after the selected Jellyfin show or season was added. + +::: + +- Key: Jellyfin.sw_watchersSinceAdded +- Availability: shows, seasons +- Type: text[] + #### Collections media is present in (titles) :::info diff --git a/docs/Rules.mdx b/docs/Rules.mdx index 78b9c986e..86821859e 100644 --- a/docs/Rules.mdx +++ b/docs/Rules.mdx @@ -45,6 +45,8 @@ The watch-history getters keep these cases separate: a confirmed empty history r `Newest episode view date in this or an earlier season` (`sw_lastViewedAtThroughSeason`) answers for a run of seasons rather than one. A rule on season 3 sees the last time anyone watched anything in seasons 1 to 3, so you can clear watched seasons without getting ahead of someone still working through the show. It is offered for Plex, Jellyfin, and Emby season rules. Plex counts views of episodes that have since left the library, while Jellyfin and Emby count only the episodes the show holds at the time of the run. +`Users that watched every episode since added` (`sw_allEpisodesSeenBySinceAdded`) and `Users that watched at least one episode since added` (`sw_watchersSinceAdded`) are available for Plex, Jellyfin, and Emby show and season rules. They count only episode views strictly after the selected show or season was added. The first requires a qualifying view for every available episode, while the second returns users with at least one qualifying view. Re-adding a season while its parent show remains does not restart the show's cycle, so use a season rule when the cycle should begin with that season's addition. + ::: :::warning Plex Watchlist Rules