selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
watchlistarr logo

Self-host watchlistarr

v0.2.6

Sync Plex watchlists to Sonarr and Radarr in real-time

BetaOpen SourceGPL-3.0
Updated11 months ago
LanguageScala
Setup difficultyModerate
Stars
361
RAM
-Xmx100m (100 MB heap)
Requires
Plex, Radarr, Sonarr
Docker
nylonee/watchlistarr
Install with Docker
watchlistarr screenshot 1

What is watchlistarr?

Watchlistarr is a self-hosted synchronization tool that connects Plex watchlists to Sonarr and Radarr. It uses multiple Plex API methods — RSS feeds, metadata calls, and GraphQL — to fetch watchlist data in real-time and automatically add matching movies and TV shows to the *arr applications. A full delete sync feature can remove content from Sonarr/Radarr when users remove items from their Plex watchlists. The application runs as a Docker container or a standalone Java JAR (Java 11+), configured via environment variables or a YAML config file. It requires Sonarr v3+, Radarr v3+, and a Plex token; a Plex Pass subscription is recommended for RSS feed access.

Should you self-host watchlistarr?

watchlistarr scores 46/100 on selfhost.directory (how scoring works) and ranks #92 of 142 in Media Management. It has 361 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Scala.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 472 stars). It scores higher overall, so compare the two before you pick. See watchlistarr vs Sonarr side by side.

Features

  • Bypass exclusion lists
  • Configurable delete intervals
  • Configurable quality profiles
  • Debug logging
  • Friends' watchlist support
  • Full delete syncDisabled by default
  • Season monitoring control
  • Skip friend sync option
  • Tag support
  • YAML configuration file

watchlistarr README

How to install watchlistarr

Install watchlistarr with Docker

Docker
Environment variables
SONARR_API_KEY, RADARR_API_KEY, PLEX_TOKEN, and many others (see entrypoint.sh)

docker run -e SONARR_API_KEY=YOUR_API_KEY -e RADARR_API_KEY=YOUR_API_KEY -e PLEX_TOKEN=YOUR_PLEX_TOKEN nylonee/watchlistarr

Recommended method. Supports latest, beta, and alpha tags.

How to configure watchlistarr

  • ALLOW_CONTINUING_SHOW_DELETINGfalseEnable delete sync for continuing shows not on watchlist

    Enable delete sync for continuing shows not on watchlist

    values: true/false

  • ALLOW_ENDED_SHOW_DELETINGfalseEnable delete sync for ended shows not on watchlist

    Enable delete sync for ended shows not on watchlist

    values: true/false

  • ALLOW_MOVIE_DELETINGfalseEnable delete sync for movies not on watchlist

    Enable delete sync for movies not on watchlist

    values: true/false

  • DELETE_INTERVAL_DAYSDays to wait before deleting content from *arr apps

    Days to wait before deleting content from *arr apps

  • LOG_LEVELLog level for debugging

    Log level for debugging

    values: DEBUG, INFO, etc.

  • PLEX_TOKENPlex authentication token

    Plex authentication token

  • PLEX_WATCHLIST_URL_1First Plex watchlist RSS feed URL

    First Plex watchlist RSS feed URL

  • PLEX_WATCHLIST_URL_2Second Plex watchlist RSS feed URL

    Second Plex watchlist RSS feed URL

  • RADARR_API_KEYAPI key for Radarr

    API key for Radarr

  • RADARR_BASE_URL127.0.0.1:7878Base URL for Radarr including http and port

    Base URL for Radarr including http and port

  • RADARR_BYPASS_IGNOREDfalseBypass movies on Radarr exclusion list

    Bypass movies on Radarr exclusion list

    values: true/false

  • RADARR_QUALITY_PROFILEQuality profile name in Radarr

    Quality profile name in Radarr

  • RADARR_ROOT_FOLDERRoot folder path in Radarr

    Root folder path in Radarr

  • RADARR_TAGSwatchlistarrTags to attach to movies in Radarr

    Tags to attach to movies in Radarr

  • REFRESH_INTERVAL_SECONDS10How often to pull from Plex in seconds

    How often to pull from Plex in seconds

  • SKIP_FRIEND_SYNCfalseDon't sync friends' watchlists, only own

    Don't sync friends' watchlists, only own

    values: true/false

  • SONARR_API_KEYAPI key for Sonarr

    API key for Sonarr

  • SONARR_BASE_URL127.0.0.1:8989Base URL for Sonarr including http and port

    Base URL for Sonarr including http and port

  • SONARR_BYPASS_IGNOREDfalseBypass TV shows on Sonarr exclusion list

    Bypass TV shows on Sonarr exclusion list

    values: true/false

  • SONARR_QUALITY_PROFILEQuality profile name in Sonarr

    Quality profile name in Sonarr

  • SONARR_ROOT_FOLDERRoot folder path in Sonarr

    Root folder path in Sonarr

  • SONARR_SEASON_MONITORINGallSeason monitoring type for Sonarr

    Season monitoring type for Sonarr

    values: MonitorTypes from Sonarr API

  • SONARR_TAGSwatchlistarrTags to attach to shows in Sonarr

    Tags to attach to shows in Sonarr

watchlistarr releases & version history

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…