{"id":13551265,"url":"https://github.com/NiNiyas/Bettarr-Notifications","last_synced_at":"2025-04-03T01:31:51.448Z","repository":{"id":50277103,"uuid":"468693010","full_name":"NiNiyas/Bettarr-Notifications","owner":"NiNiyas","description":"Better Notifications for Sonarr, Radarr and Prowlarr. Supports Discord, Telegram, Slack, Pushover and ntfy. ","archived":false,"fork":false,"pushed_at":"2022-11-26T14:07:15.000Z","size":266,"stargazers_count":27,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-02T23:11:17.141Z","etag":null,"topics":["discord","notifications","ntfysh","prowlarr","pushover","radarr","slack","sonarr","telegram"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NiNiyas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-11T09:48:35.000Z","updated_at":"2025-03-09T16:02:34.000Z","dependencies_parsed_at":"2023-01-22T06:16:58.756Z","dependency_job_id":null,"html_url":"https://github.com/NiNiyas/Bettarr-Notifications","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiNiyas%2FBettarr-Notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiNiyas%2FBettarr-Notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiNiyas%2FBettarr-Notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiNiyas%2FBettarr-Notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NiNiyas","download_url":"https://codeload.github.com/NiNiyas/Bettarr-Notifications/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246922156,"owners_count":20855341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","notifications","ntfysh","prowlarr","pushover","radarr","slack","sonarr","telegram"],"created_at":"2024-08-01T12:01:45.253Z","updated_at":"2025-04-03T01:31:51.090Z","avatar_url":"https://github.com/NiNiyas.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Bettarr Notifications\n\nBetter Notifications for Sonarr, Radarr and Prowlarr.\n\nTested with v3.0.9.1549 of Sonarr, v4.2.4.6635 of Radarr and v0.4.7.2016 of Prowlarr.\n\n## Installation\n\n- Clone the repo, `git clone https://github.com/NiNiyas/Bettarr-Notifications.git` and `cd Bettarr-Notifications/src`.\n- Install requirements `pip install --no-cache --upgrade -r requirements.txt`.\n- On *arrs, add a custom script in `Settings -\u003e Connect`.\n    - `Sonarr`: select everything except `On Rename`.\n    - `Radarr`: select everything except `On Rename`.\n    - `Prowlarr`: select everything.\n\n## Docker Installation\n\n- Clone the repo.\n- Mount it to the docker container.\n- Install requirements:\n    - For [linuxserver's](https://linuxserver.io/) image,\n      read [this](https://www.linuxserver.io/blog/2019-09-14-customizing-our-containers).\n    - For [hotio's](https://hotio.dev/) image, read [this](https://hotio.dev/faq/#guides)\n    - Custom script is available in [install](https://github.com/NiNiyas/Bettarr-Notifications/tree/master/src/install)\n      folder.\n\n# API Keys\n\n### TMDB (Required)\n\n- To create TMDB API, check [here](https://www.themoviedb.org/settings/api). This has no known limit.\n- Fill in the `TMDB_APIKEY` in `config.py` file.\n- If you need the JustWatch providers for your country, fill in the `TMDB_COUNTRY_CODE`.\n- For country codes, see [here](https://www.justwatch.com/), scroll down to the very bottom of the page.\n\nIf your ISP block access to TMDB API like mine does, host a [tmdb-proxy](https://github.com/chervontsev/tmdb-proxy) on\nRailway and fill in `TMDB_URL`. I personally host mine in [Railway](https://railway.app).\n\n### mdblist (Optional)\n\nTo get ratings, you should set `MDBLIST_APIKEY` in `config.py` file.\n\n- Create your mdblist API key from [here](https://mdblist.com/).\n- You will need a [Trakt](https://trakt.tv) account for this. This has a 1000 calls per day limit.\n\n### OMDb API (Optional)\n\nTo get awards, you should set `OMDB_APIKEY` in `config.py` file.\n\n- Create your API key [here](https://www.omdbapi.com/apikey.aspx). This has a 1000 calls per day limit.\n\n# Notifiers\n\n`*_*_WEBHOOK` is for downloading and importing notifications. \\\n`*_HEALTH_*_WEBHOOK` is for health notifications. \\\n`*_MISC_*_WEBHOOK` is for file deletion and app update notifications.\n\n## [Discord](https://discord.com/)\n\nCreate a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your server.\n\n##### Radarr\n\n- Fill in `RADARR_DISCORD_WEBHOOK`, `RADARR_HEALTH_DISCORD_WEBHOOK` and `RADARR_MISC_DISCORD_WEBHOOK`.\n\n##### Sonarr\n\n- Fill in `SONARR_DISCORD_WEBHOOK`, `SONARR_HEALTH_DISCORD_WEBHOOK` and `SONARR_MISC_DISCORD_WEBHOOK`.\n\n##### Prowlarr\n\n- Fill in `PROWLARR_DISCORD_WEBHOOK` and `PROWLARR_MISC_DISCORD_WEBHOOK`.\n\n## [Slack](https://slack.com)\n\nCreate a webhook. More info [here](https://api.slack.com/messaging/webhooks#create_a_webhook).\n\n##### Radarr\n\n- Fill in `RADARR_SLACK_WEBHOOK`, `RADARR_HEALTH_SLACK_WEBHOOK` and `RADARR_MISC_SLACK_WEBHOOK`.\n\n##### Sonarr\n\n- Fill in `SOANRR_SLACK_WEBHOOK`, `SONARR_HEALTH_SLACK_WEBHOOK` and `SONARR_MISC_SLACK_WEBHOOK`.\n\n##### Prowlarr\n\n- Fill in `PROWLARR_SLACK_WEBHOOK` and `PROWLARR_MISC_SLACK_WEBHOOK`.\n\n## [Telegram](https://telegram.org/)\n\nCreate a bot using [BotFather](https://t.me/botfather). \\\nSet `TELEGRAM_SILENT` to `True` if you want silent notifications. \\\nSet `TELEGRAM_DISABLE_IMAGES` to `True` if you want to disable images in notifications.\n\nIf you are sending message to a group chat,\nsee [here](https://stackoverflow.com/questions/32423837/telegram-bot-how-to-get-a-group-chat-id)\n\nFill in `TELEGRAM_CHAT_ID`,`TELEGRAM_MISC_CHAT_ID` and `TELEGRAM_HEALTH_CHAT_ID`.\n\n##### Radarr\n\n- Fill in `RADARR_TELEGRAM_BOT_ID`, `RADARR_HEALTH_TELEGRAM_BOT_ID` and `RADARR_MISC_TELEGRAM_BOT_ID`.\n\n##### Sonarr\n\n- Fill in `SONARR_TELEGRAM_BOT_ID`, `SONARR_HEALTH_TELEGRAM_BOT_ID` and `SONARR_MISC_TELEGRAM_BOT_ID`.\n\n##### Prowlarr\n\n- Fill in `PROWLARR_TELEGRAM_BOT_ID` and `PROWLARR_MISC_TELEGRAM_BOT_ID`.\n\n## [Pushover](https://pushover.net)\n\nCreate an application on [Pushover](https://pushover.net).\n\nFill in `PUSHOVER_USER` with your user token.\n\nIf you want to change priority, fill in `PUSHOVER_PRIORITY`. List of available\npriorities can be found [here](https://pushover.net/api#priority).\\\nIf you want to change notification sound, fill in `PUSHOVER_SOUND`. List of available\nnotification sounds can be found [here](https://pushover.net/api#sounds).\\\nIf you want to route message to different device, fill in`PUSHOVER_DEVICE`.\n\nEmergency priority (2) has default 30 second timeout between retries and will expire after 1 hour.\n\n##### Radarr\n\n- Fill in `RADARR_PUSHOVER_TOKEN`, `RADARR_HEALTH_PUSHOVER_TOKEN` and `RADARR_MISC_PUSHOVER_TOKEN`.\n\n##### Sonarr\n\n- Fill in `SONARR_PUSHOVER_TOKEN`, `SONARR_HEALTH_PUSHOVER_TOKEN` and `SONARR_MISC_PUSHOVER_TOKEN`.\n\n##### Prowlarr\n\n- Fill in `PROWLARR_PUSHOVER_TOKEN` and `PROWLARR_MISC_PUSHOVER_TOKEN`.\n\n## [ntfy](https://ntfy.sh)\n\nFill in your server url `NTFY_URL`. \\\nIf you have got authentication set up, fill in `NTFY_HEADER` with **Basic Auth** headers. More details can be\nfound [here](https://ntfy.sh/docs/publish/#authentication). \\\nIf you want to change the priority, fill in `NTFY_*_PRIORITY`. List of available priorities can be\nfound [here](https://ntfy.sh/docs/publish/#message-priority). Default is `3`(i.e., Default priority.).\n\n##### Radarr\n\n- Fill in `NTFY_RADARR_TOPIC`, `NTFY_RADARR_HEALTH_TOPIC` and `NTFY_RADARR_MISC_TOPIC`.\n\n##### Sonarr\n\n- Fill in `NTFY_SONARR_TOPIC`, `NTFY_SONARR_HEALTH_TOPIC` and `NTFY_SONARR_MISC_TOPIC`.\n\n##### Prowlarr\n\n- Fill in `NTFY_PROWLARR_TOPIC` and `NTFY_PROWLARR_MISC_TOPIC`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNiNiyas%2FBettarr-Notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNiNiyas%2FBettarr-Notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNiNiyas%2FBettarr-Notifications/lists"}