Jackett (and Prowlarr) RSS to Telegram Bot

A self-hosted Telegram Python Bot that dumps posts from Jackett or Prowlarr RSS feeds to a Telegram chat.

Based on RSS to Telegram bot by BoKKeR (Thanks for your effort).

Requirements

A Telegram Bot is needed that the script will connect to.

You could use this post to create your own with the BotFather Telegram Bot.

WARNING!! Without chat_id the bot wont be able to send automated messages and will only be able to respond to messages.

Docker Installation

$ docker create \
  --name=jackett2telegram \
  -e TOKEN=<your_telegram_bot_token> \
  -e CHATID=<your_telegram_bot_chatid> \
  -v </path/to/host/config>:/app/config \
  -v </path/to/host/blackhole>:/app/blackhole \
  --restart unless-stopped \
  danimart1991/jackett2telegram

You could include -e DELAY=<delay> where <delay> is the seconds between each RSS fetching.

You could include -e LOG_LEVEL=<log_level> where <log_level> must be critical, error, warning, info (default) or debug.

Manual Installation

Python 3.X

1. Clone the script

2. Install depedencies with:

   pip install -r requirements.txt

3. Run the script with:

   python jackett2telegram.py --token <YOUR_TELEGRAM_TOKEN> --chat_id <YOUR_TELEGRAM_CHAT_ID>

You could include --delay=<delay> where <delay> is the seconds between each RSS fetching.

You could include --log_level=<log_level> where <log_level> must be critical, error, warning, info (default) or debug.

Usage

Send /help command to the bot to get this message:

Jackett2Telegram (Jackett and Prowlarr RSS to Telegram Bot)

After successfully adding a Jackett or Prowlarr RSS link, the bot starts fetching the feed every 600 seconds. (This can be set)

Titles are used to easily manage RSS feeds and should contain only one word and are case sensitive.

Commands:

• /help Posts this help message. 😑
• /add TITLE JACKETT_OR_PROWLARR_RSS_FEED_URL - Adds new Jackett or Prowlarr RSS Feed (overwrited if title previously exist).
• /remove TITLE - Removes the RSS link.
• /list Lists all the titles and the asociated Jackett or Prowlarr RSS links from the DB.
• /test JACKETT_OR_PROWLARR_RSS_FEED_URL - Inbuilt command that fetches a post (usually latest) from a Jackett or Prowlarr RSS.

In order to use Blackhole, your Torrent client must support it and be configured to point to Jackett2Telegram Blackhole folder.

If you like the project, star it on GitHub.

How to add a new Indexer

You could get the Jackett or Prowlarr RSS Feed Url using the action button in Indexers list:

You could get the Prowlarr RSS Feed Url using the action button in Indexers list:

Then paste the Url in the chat like /add TITLE JACKETT_OR_PROWLARR_RSS_FEED_URL and send the message. The bot will reply with the result.

How to use Blackhole

Blackhole folder is a monitored folder that your Torrent client checks to look for .torrent files and then download them automatically.

First, you must read the documentation of the Torrent client to make sure is supported and simply configure it to point to the blackhole folder created by Jackett2Telegram.

When a new release is showed in Telegram, a Blackhole button could be pressed and download the .torrent file locally, then Torrent client use it.

If you use the Docker installation, make a bind between folders.