Plex watchlist acquisition

Plex watchlist is an adapter on the shared acquisition engine, alongside Seerr. Existing watchlist.enabled and legacy Plex watchlist settings keep working. The adapter resolves cloud-watchlist titles and hands them to the shared executor. It starts after the library loads. It needs an nzb provider on the same zurg instance, a debrid account that takes torrents, or both.

Progress lives in data/acquisition.json. The previous data/plex-watchlist.json is imported once without deleting it. History, retry deadlines, attempt counts and acquisitions waiting only for Plex removal survive reboots. Both state files are included in normal backups. Keep data/ and nzbs/ when recreating containers.

Releases come from Newznab indexers as NZBs and from Torznab indexers as info hashes handed to a debrid account that already holds them. An NZB needs the nzb provider. A torrent needs the debrid account. prefer decides which is tried first. See Newznab and Torznab.

Successful acquisition removes an item from the watchlist, unless remove_after_grab: false says otherwise; with it off the title stays and zurg satisfies it in the background. A title you already had stays either way: when every release that settles it was already in the library, zurg fetched nothing for it and leaves your list alone. only_new_items (on by default) means turning the feature on starts watching the list rather than working through everything already on it. Both are documented under what acquiring does to the source's own list. Every planned season must now be acquired before a show is removed; successful seasons are remembered while missing ones retry. A season pack is preferred. The loose-episode fallback acquires episodes found in indexer results, since the watchlist does not provide an expected episode inventory. This is not continuous monitoring of future episodes after the item leaves the watchlist.

Removal waits for the check. A watchlist entry is the only record that you wanted a title. Plex keeps no history of a removed one. So a title is never removed on the strength of a grab nobody has checked. An NZB is checked against the news servers. A torrent has to reach the library with files in it. A release that fails the check leaves the title where it is and is remembered as dead. The retry then ranks the next candidate. A check that could not be made leaves the title queued rather than deciding either way. See verifying a grab.

Failures retry with persistent backoff while the item remains on the list. Once acquisition is recorded, failed or interrupted Plex removal retries only that removal. Corrupt state is preserved and acquisition pauses until repaired or restored. A write failure pauses acquisition until saving succeeds.

See acquisition sources for configuration, retry intervals, Seerr behavior and the adapter contract.