cr4zyhead/telegram-servarr-bot

telegram-servarr-bot is a Telegram bot that lets you manage Radarr and Sonarr, two popular self hosted tools people use to automatically download movies and TV series, straight from a chat conversation instead of opening a web dashboard. You search for a movie or show by typing a command, and the bot replies with a poster carousel you can page through with buttons, showing a synopsis for each result before you pick one to add. Once you choose something to add, the bot walks you through picking a quality profile and a folder, and for series it also asks which seasons you want to monitor, such as all of them, only future ones, or just the first or last season. If a series is already in your library, the bot shows its seasons along with download progress instead of adding it again. Other commands let you browse your combined movie and series library with an optional filter, check an upcoming release calendar, and see the current download queue with progress percentages across both services. The bot also understands English and Spanish, automatically matching each user's Telegram app language, with a command to override that choice per person. Access is controlled with a password based authentication command, and one designated admin user gets extra commands to remove titles from the library, trigger a search for missing items, refresh the libraries, and manage which users are allowed in. There is also an optional webhook feature that sends a Telegram notification when a download finishes importing, grouping multiple episodes of the same season into a single message. Setup requires a Telegram bot token from BotFather, a running Radarr and optionally Sonarr instance with their API keys, and either Docker or Node.js 22 or later. Configuration is done through a JSON file that is never committed to the repository. The project is released under the MIT license.