Watchlistarr

Watchlistarr

Docker app from nylonee's Repository

Overview

Sync RSS Plex watchlists in realtime with Sonarr and Radarr https://github.com/nylonee/watchlistarr

Watchlistarr

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

Method Pros Cons Supported by Watchlistarr Supported by Overseer/Ombi Supported by Sonarr/Radarr
Plex Watchlist RSS Feeds Fast and instantly updated, can create one for self and one for friends Will only show the most recent 50 movies/shows, currently broken Yes X Only for self, refreshes every 6 hours
Plex Watchlist Metadata Can fetch the full watchlist for the user Need a plex token for each user who wants to have their watchlist synced, Plex token expires after a few months Yes Yes, up to ~20 min intervals X
Plex Watchlist GraphQL Call Can fetch the full watchlist for every friend of the main user Slow, relies on main user providing a plex token Yes X X
Plex Watchlist Metadata for other users Can fetch the full watchlist for every user who provides a token Difficult to ask every user to generate a Plex token, or log into a service Yes Yes, up to ~20 min intervals X

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

Install Watchlistarr on Unraid in a few clicks.

Find Watchlistarr in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Watchlistarr Review the template variables and paths Click Install

Requirements

Requires Plex Pass

Download Statistics

215,624
Total Downloads
10,244
This Month
8,691
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
nylonee/watchlistarr
Last Updated2024-10-17
First Seen2023-10-28

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

Sonarr API KeyVariable

Your Sonarr API Key, found in Sonarr UI Settings -> General

Target
SONARR_API_KEY
Sonarr URLVariable

Your Sonarr URL

Target
SONARR_BASE_URL
Value
http://localhost:8989
Radarr API KeyVariable

Your Sonarr API Key, found in Sonarr UI Settings -> General

Target
RADARR_API_KEY
Radarr URLVariable
Target
RADARR_BASE_URL
Value
http://localhost:7878
Plex TokenVariable

Your Plex token, see https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/

Target
PLEX_TOKEN
Refresh Interval (Seconds)Variable

The number of seconds to wait between syncing watchlists

Target
REFRESH_INTERVAL_SECONDS
Value
60
Sonarr Quality ProfileVariable

The Sonarr Quality Profile you'd like new shows to inherit

Target
SONARR_QUALITY_PROFILE
Sonarr Root FolderVariable

Your Sonarr Root folder, found in Sonarr Settings

Target
SONARR_ROOT_FOLDER
Radarr Quality ProfileVariable

The Radarr Quality Profile you'd like new movies to inherit

Target
RADARR_QUALITY_PROFILE
Radarr Root FolderVariable

Your Radarr Root folder, found in Radarr Settings

Target
RADARR_ROOT_FOLDER
Sonarr Bypass ExclusionsVariable

Set to true to bypass excluded sonarr lists

Target
SONARR_BYPASS_IGNORED
Radarr Bypass ExclusionsVariable

Set to true to bypass excluded radarr lists

Target
RADARR_BYPASS_IGNORED
Sonarr Default Season MonitoringVariable

Default season monitoring. If not set, will be 'all'. Possible values are all, future, missing, existing, pilot, firstSeason, latestSeason, none

Target
SONARR_SEASON_MONITORING