Watchlistarr

June 24, 2024 ยท View on GitHub

Alternate Text

Sync plex watchlists in realtime with Sonarr and Radarr.

watchlistarr-gif

How it works

There are several ways of fetching watchlist information from Plex

MethodProsConsSupported by WatchlistarrSupported by Overseer/OmbiSupported by Sonarr/Radarr
Plex Watchlist RSS FeedsFast and instantly updated, can create one for self and one for friendsWill only show the most recent 50 movies/shows, currently brokenYesXOnly for self, refreshes every 6 hours
Plex Watchlist MetadataCan fetch the full watchlist for the userNeed a plex token for each user who wants to have their watchlist synced, Plex token expires after a few monthsYesYes, up to ~20 min intervalsX
Plex Watchlist GraphQL CallCan fetch the full watchlist for every friend of the main userSlow, relies on main user providing a plex tokenYesXX
Plex Watchlist Metadata for other usersCan fetch the full watchlist for every user who provides a tokenDifficult to ask every user to generate a Plex token, or log into a serviceYesYes, up to ~20 min intervalsX

In order to fully integrate with Plex Watchlists, Watchlistarr uses a combination of multiple methods to ensure that it does a comprehensive, yet fast real-time sync.

Full Delete Sync

Watchlistarr also supports a full delete sync with your watchlist. This means that if a user removes an item off their watchlist, Watchlistarr can detect that and delete content from Sonarr/Radarr.

Note: This feature is disabled by default Whether you've enabled this or not, you can enjoy a little "sneak peek" upon startup of the app, where the logs will list the movies/tv shows that are out of sync.

Requirements

  • Plex Pass Subscription (Recommended, otherwise see "Plex Pass Alternative" section below)
  • Sonarr v3 or higher
  • Radarr v3 or higher
  • Friends' Watchlists Account Visibility must be changed to 'Friends Only' or 'Friends of Friends'
  • Docker or Java v11 or higher (Recommended version JDK 21)
  • Plex Token (see here)

Getting Started

See Configuration for steps on getting started and configuring Watchlistarr

Plex Pass Alternative

The Plex Pass subscription is required to generate the RSS Feed URLs. Without a Plex Pass, the normal API calls are too heavy-hitting on Plex's servers.

If the app detects that you are not a Plex Pass user (i.e. the app tries to generate an RSS URL, and it fails), it will fall back into a periodic sync.

The periodic sync will run every 19 minutes, ignoring the configuration for REFRESH_INTERVAL_SECONDS

All other settings will still be valid

Developers Corner

Build the docker image:

docker build -t nylonee/watchlistarr:latest -f docker/Dockerfile .

Run the docker image:

docker run nylonee/watchlistarr