Skip to content

causefx/Sonarr-Series-Checker

Repository files navigation

Sonarr Series Checker

A basic script to check your Sonarr instance for any Series that are continuing, but are currently not monitored, or any Series that have ended, but are currently monitored. The script can then notify you via a Discord webhook of its findings and/or action the Series or Seasons that it finds for you. Action means to monitor or unmonitor the discovered Series or Seasons, depending on the state of the Series.

Usage

Docker

docker create \
  --name=sonarr-checker \
  -v /etc/localtime:/etc/localtime:ro \ # Needed so that the Container matches the TZ of the Host for the cronjob
  -v /etc/localtime:/etc/timezone:ro \ # Needed so that the Container matches the TZ of the Host for the cronjob
  -e SONARR_URL="" \
  -e SONARR_KEY="" \
  -e MONITORED_IGNORE_TAG_ID="" \
  -e UNMONITORED_IGNORE_TAG_ID="" \
  -e DISCORD_URL="" \
  -e DISCORD_NOTIFICATION_TYPE="both" \
  -e ACTION='false' \
  -e SEASON_ACTION='false' \
  -e STARTUP='false' \
  -e CRON="5 2,11 * * *" \
  ghcr.io/causefx/sonarrchecker

Docker-Compose

  sonarr-checker:
    container_name: sonarr-checker
    image: ghcr.io/causefx/sonarrchecker
    restart: on-failure
    environment:
      - SONARR_URL=""
      - SONARR_KEY=""
      - MONITORED_IGNORE_TAG_ID=""
      - UNMONITORED_IGNORE_TAG_ID=""
      - DISCORD_URL=""
      - DISCORD_NOTIFICATION_TYPE="both"
      - ACTION='false'
      - SEASON_ACTION='false'
      - STARTUP='false'
      - CRON=5 2,11 * * *"
    volumes:
      - "/etc/localtime:/etc/localtime:ro" # Needed so that the Container matches the TZ of the Host for the cronjob
      - "/etc/localtime:/etc/timezone:ro" # Needed so that the Container matches the TZ of the Host for the cronjob

Environment Variables

Variable Explanation
SONARR_URL URL for your Sonarr instance
SONARR_KEY API key for your Sonarr instance
MONITORED_IGNORE_TAG_ID Optional; The Id of the Sonarr tag that you do not want the scanner to pickup for series that are monitored
UNMONITORED_IGNORE_TAG_ID Optional; The Id of the Sonarr tag that you do not want the scanner to pickup for series that are unmonitored
DISCORD_URL Optional; The Discord webhook URL you want notifications to be sent to
DISCORD_NOTIFICATION_TYPE Optional; The type of change you want to be notified i.e. m/monitored = series changed to monitored; u/unmonitored = series changed to unmonitored; both
ACTION Optional; Whether or not you want Sonarr Checker to action the discovered Series
SEASON_ACTION Optional; Whether or not you want Sonarr Checker to action the discovered Series Seasons
STARTUP Optional; Perform scan on Container startup
CRON Optional; Specify when you want the scan to run via cronjob

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages