Skip to content

Latest commit

 

History

History
157 lines (94 loc) · 5.56 KB

README.md

File metadata and controls

157 lines (94 loc) · 5.56 KB

Bettarr Notifications

Better Notifications for Sonarr, Radarr and Prowlarr.

Tested with v3.0.9.1549 of Sonarr, v4.2.4.6635 of Radarr and v0.4.7.2016 of Prowlarr.

Installation

  • Clone the repo, git clone https://github.com/NiNiyas/Bettarr-Notifications.git and cd Bettarr-Notifications/src.
  • Install requirements pip install --no-cache --upgrade -r requirements.txt.
  • On *arrs, add a custom script in Settings -> Connect.
    • Sonarr: select everything except On Rename.
    • Radarr: select everything except On Rename.
    • Prowlarr: select everything.

Docker Installation

  • Clone the repo.
  • Mount it to the docker container.
  • Install requirements:

API Keys

TMDB (Required)

  • To create TMDB API, check here. This has no known limit.
  • Fill in the TMDB_APIKEY in config.py file.
  • If you need the JustWatch providers for your country, fill in the TMDB_COUNTRY_CODE.
  • For country codes, see here, scroll down to the very bottom of the page.

If your ISP block access to TMDB API like mine does, host a tmdb-proxy on Railway and fill in TMDB_URL. I personally host mine in Railway.

mdblist (Optional)

To get ratings, you should set MDBLIST_APIKEY in config.py file.

  • Create your mdblist API key from here.
  • You will need a Trakt account for this. This has a 1000 calls per day limit.

OMDb API (Optional)

To get awards, you should set OMDB_APIKEY in config.py file.

  • Create your API key here. This has a 1000 calls per day limit.

Notifiers

*_*_WEBHOOK is for downloading and importing notifications.
*_HEALTH_*_WEBHOOK is for health notifications.
*_MISC_*_WEBHOOK is for file deletion and app update notifications.

Create a webhook in your server.

Radarr
  • Fill in RADARR_DISCORD_WEBHOOK, RADARR_HEALTH_DISCORD_WEBHOOK and RADARR_MISC_DISCORD_WEBHOOK.
Sonarr
  • Fill in SONARR_DISCORD_WEBHOOK, SONARR_HEALTH_DISCORD_WEBHOOK and SONARR_MISC_DISCORD_WEBHOOK.
Prowlarr
  • Fill in PROWLARR_DISCORD_WEBHOOK and PROWLARR_MISC_DISCORD_WEBHOOK.

Create a webhook. More info here.

Radarr
  • Fill in RADARR_SLACK_WEBHOOK, RADARR_HEALTH_SLACK_WEBHOOK and RADARR_MISC_SLACK_WEBHOOK.
Sonarr
  • Fill in SOANRR_SLACK_WEBHOOK, SONARR_HEALTH_SLACK_WEBHOOK and SONARR_MISC_SLACK_WEBHOOK.
Prowlarr
  • Fill in PROWLARR_SLACK_WEBHOOK and PROWLARR_MISC_SLACK_WEBHOOK.

Create a bot using BotFather.
Set TELEGRAM_SILENT to True if you want silent notifications.
Set TELEGRAM_DISABLE_IMAGES to True if you want to disable images in notifications.

If you are sending message to a group chat, see here

Fill in TELEGRAM_CHAT_ID,TELEGRAM_MISC_CHAT_ID and TELEGRAM_HEALTH_CHAT_ID.

Radarr
  • Fill in RADARR_TELEGRAM_BOT_ID, RADARR_HEALTH_TELEGRAM_BOT_ID and RADARR_MISC_TELEGRAM_BOT_ID.
Sonarr
  • Fill in SONARR_TELEGRAM_BOT_ID, SONARR_HEALTH_TELEGRAM_BOT_ID and SONARR_MISC_TELEGRAM_BOT_ID.
Prowlarr
  • Fill in PROWLARR_TELEGRAM_BOT_ID and PROWLARR_MISC_TELEGRAM_BOT_ID.

Create an application on Pushover.

Fill in PUSHOVER_USER with your user token.

If you want to change priority, fill in PUSHOVER_PRIORITY. List of available priorities can be found here.
If you want to change notification sound, fill in PUSHOVER_SOUND. List of available notification sounds can be found here.
If you want to route message to different device, fill inPUSHOVER_DEVICE.

Emergency priority (2) has default 30 second timeout between retries and will expire after 1 hour.

Radarr
  • Fill in RADARR_PUSHOVER_TOKEN, RADARR_HEALTH_PUSHOVER_TOKEN and RADARR_MISC_PUSHOVER_TOKEN.
Sonarr
  • Fill in SONARR_PUSHOVER_TOKEN, SONARR_HEALTH_PUSHOVER_TOKEN and SONARR_MISC_PUSHOVER_TOKEN.
Prowlarr
  • Fill in PROWLARR_PUSHOVER_TOKEN and PROWLARR_MISC_PUSHOVER_TOKEN.

Fill in your server url NTFY_URL.
If you have got authentication set up, fill in NTFY_HEADER with Basic Auth headers. More details can be found here.
If you want to change the priority, fill in NTFY_*_PRIORITY. List of available priorities can be found here. Default is 3(i.e., Default priority.).

Radarr
  • Fill in NTFY_RADARR_TOPIC, NTFY_RADARR_HEALTH_TOPIC and NTFY_RADARR_MISC_TOPIC.
Sonarr
  • Fill in NTFY_SONARR_TOPIC, NTFY_SONARR_HEALTH_TOPIC and NTFY_SONARR_MISC_TOPIC.
Prowlarr
  • Fill in NTFY_PROWLARR_TOPIC and NTFY_PROWLARR_MISC_TOPIC.