addarr

Docker app from Selfhosters

Overview

TelegramBot for Sonarr and Radarr This is a Telegram Bot made to add series to Sonarr or movies to Radarr with a couple of commands. You can also communicate with your Transmission/Sabnzbd service to change its download speed. You will need to create a config.yaml file and place in the addarr appdata folder. To create this file, you will need to follow the guide on the Addarr wiki to get authenticated to Telegram.

ADDARR

Docker Pulls

This is a Telegram Bot made to add series to Sonarr or movies to Radarr with a couple of commands. You can also communicate with your Transmission/Sabnzbd service to change its download speed. The bot uses the InlineKeyboard to let you select the wanted commands, as you can see in the screenshots.

FEATURES

  • Add series/movies to Sonarr/Radarr
  • Get a list of all the series on Sonarr
  • Change down-/uploadspeed of Transmission (Temporary Speed Limit)
  • Secure bot with a password. New chats first need to authenticate
  • Wrong login attempts are saved in addarr.log
  • Possibility to enable the Transmission-command only for admins
  • Possibility to change the entrypoints of the commands
  • Translated in English (US), Dutch (Belgium), Spanish (Spain), Italian (Italy), Portuguese (Portugal), Polish (Poland), German (Germany) and French (France)
  • Command to give an overview of all the other commands

[!IMPORTANT]
Addarr only works with Sonarr V4, because of some breaking API changes between V3 and V4.

COMMANDS

These are the default commands:

  • /help: gives an overview of all the commands with their action
  • /auth: authenticate the chat to use this bot
  • /start: start adding a series or movie to Sonarr/Radarr
  • /delete: remove a series or movie from Sonarr/Radarr
  • /movie (en-us) - /film (nl-be, it-it, de-de, fr-fr) - /file (pt-pt) - /Película (es-es): start adding a movie to Radarr
  • /series (en-us) - /serie (nl-be, it-it, pt-pt, es-es, de-de, fr-fr) : start adding a series to Sonarr
  • /allSeries: receive a list of all the series on Sonarr
  • /allMovies: receive a list of all the movies on Radarr
  • /transmission: change the down-/upload speed of Transmission from Temporary Speed Limit to normal or the other way around
  • /sabnzbd: change the down-/upload speed of Sabnzbd to 25%, 50% or 100% of the defined limit.
  • /stop: stops the command you were executing. Can be used at any moment

Every command does also work if you send a message without / and no other words before or after the entrypoint

CONFIG

An example of the config file (config_example.yaml) can be found in this repository. Change it to your configuration. After you've filled in all the necessary fields, rename it to config.yaml.

ADMIN

There is a functionality to only let admins use the transmission command, list or delete series/movies from sonarr/radarr. Before you can use this, you should enable each variable in the config file config.yaml. Then you need to add the admins to admin.txt. You can add the username or id of the user. Every added user should be on a new line to prevent errors.

ALLOWLIST

There is a very restrictive functionality to only reply to already approved users. You can enable it in the config file config.yaml. Then you need to add the users to allowlist.txt. You can add the username or id of the user. Every added user should be on a new line to prevent errors.

INSTALLATION

You can find the installation guides on the wikipage.

SCREENSHOTS

Screenshot 1 Screenshot 2 Screenshot 3

Install Addarr on Unraid in a few clicks.

Find Addarr 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 Addarr Review the template variables and paths Click Install

Download Statistics

490,906
Total Downloads
1,391
This Month
1,648
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
waterboy1602/addarr
Last Updated2025-06-15
First Seen2024-01-22

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

ConfigPathro
Target
/app/config.yaml
Default
/mnt/user/appdata/addarr/config.yaml
Value
/mnt/user/appdata/addarr/config.yaml
Chat IDPathrw
Target
/app/chatid.txt
Default
/mnt/user/appdata/addarr/chatid.txt
Value
/mnt/user/appdata/addarr/chatid.txt
Admin IDPathro
Target
/app/admin.txt
Default
/mnt/user/appdata/addarr/admin.txt
Value
/mnt/user/appdata/addarr/admin.txt
LogsPathrw
Target
/app/logs
Default
/mnt/user/appdata/addarr/logs
Value
/mnt/user/appdata/addarr/logs