Skip to content

Clarify Plex watchlist rule behavior and cloud lookup limitations#93

Merged
enoch85 merged 2 commits into
mainfrom
copilot/document-plex-watchlist-rule-behavior
Jun 7, 2026
Merged

Clarify Plex watchlist rule behavior and cloud lookup limitations#93
enoch85 merged 2 commits into
mainfrom
copilot/document-plex-watchlist-rule-behavior

Conversation

Copilot AI commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

The docs did not explain that Plex watchlist rules operate on all users returned by the Plex server account list or that these lookups depend on Plex cloud services. This left gaps around private watchlists, removed friends still being scanned, and why Test Media can succeed while full runs time out.

  • Rules guidance

    • Added a dedicated Plex watchlist note to Rules.mdx covering:
      • Watchlisted by and Is Watchlisted scanning all Plex users returned by the server account list
      • lack of a per-user exclude mechanism
      • dependency on plex.tv / community.plex.tv, not just the local Plex server
      • Watchlisted by being experimental and more fragile than local metadata rules
  • Troubleshooting expectations

    • Documented expected warnings for private watchlists
    • Called out that local Plex IP changes are usually irrelevant for this code path
    • Clarified that repeated cloud lookups during full rule execution can fail even when Test Media succeeds
  • Glossary updates

    • Expanded the Watchlisted by (username) and Is Watchlisted glossary entries so the rule behavior and cloud dependency are visible where users look up individual rule definitions
:::warning Plex Watchlist Rules
`Watchlisted by` and `Is Watchlisted` do not only check the current Plex user.
Maintainerr scans every user still returned by the Plex server account list
and then resolves the Plex cloud identities needed for watchlist lookups.
:::

Copilot AI changed the title [WIP] Document Plex watchlist rule behavior and cloud dependency Clarify Plex watchlist rule behavior and cloud lookup limitations Jun 7, 2026
Copilot AI requested a review from enoch85 June 7, 2026 00:08
@enoch85 enoch85 marked this pull request as ready for review June 7, 2026 00:11
@enoch85 enoch85 merged commit 77e64ad into main Jun 7, 2026
3 checks passed
@enoch85 enoch85 deleted the copilot/document-plex-watchlist-rule-behavior branch June 7, 2026 00:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document Plex watchlist rule behavior and cloud dependency

2 participants