https://github.com/danimart1991/jackett2telegram
Jackett RSS to Telegram Bot (Docker Included)
https://github.com/danimart1991/jackett2telegram
indexer jackett notifications rss sickrage telegram telegram-bot torrent torznab trackers
Last synced: 26 days ago
JSON representation
Jackett RSS to Telegram Bot (Docker Included)
- Host: GitHub
- URL: https://github.com/danimart1991/jackett2telegram
- Owner: danimart1991
- License: gpl-3.0
- Created: 2021-01-19T16:52:40.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-26T09:12:48.000Z (about 1 year ago)
- Last Synced: 2024-08-02T06:14:12.839Z (9 months ago)
- Topics: indexer, jackett, notifications, rss, sickrage, telegram, telegram-bot, torrent, torznab, trackers
- Language: Python
- Homepage:
- Size: 229 KB
- Stars: 45
- Watchers: 3
- Forks: 28
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-arr - jackett2telegram - A self-hosted Telegram Python Bot that dumps posts from Jackett RSS feeds to a Telegram chat. (Bots)
README
[](https://github.com/danimart1991/jackett2telegram/releases)
[](https://github.com/danimart1991/jackett2telegram/actions/workflows/deploy.yml)
[](https://github.com/danimart1991/jackett2telegram/blob/main/LICENSE)
[](https://hub.docker.com/r/danimart1991/jackett2telegram)
[](https://www.paypal.me/danimart1991)
[](https://github.com/sponsors/danimart1991)
# 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**](https://github.com/BoKKeR/RSS-to-Telegram-Bot) by [_BoKKeR_](https://github.com/BoKKeR) (Thanks for your effort).
## Requirements
A Telegram Bot is needed that the script will connect to.
You could use [this post](https://www.danielmartingonzalez.com/en/home-assistant-notifications-on-telegram/) to create your own with the [BotFather Telegram Bot](https://telegram.me/botfather).
> WARNING!! Without `chat_id` the bot wont be able to send automated messages and will only be able to respond to messages.
## Docker Installation
```bash
$ docker create \
--name=jackett2telegram \
-e TOKEN= \
-e CHATID= \
-v :/app/config \
-v :/app/blackhole \
--restart unless-stopped \
danimart1991/jackett2telegram
```
You could include `-e DELAY=` where `` is the seconds between each RSS fetching.
You could include `-e LOG_LEVEL=` where `` must be _critical_, _error_, _warning_, _info_ (default) or _debug_.
## Manual Installation
Python 3.X
1. Clone the script
2. Install depedencies with:
```bash
pip install -r requirements.txt
```
5. Run the script with:
```bash
python jackett2telegram.py --token --chat_id
```
You could include `--delay=` where `` is the seconds between each RSS fetching.
You could include `--log_level=` where `` 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](https://github.com/danimart1991/jackett2telegram).
### 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.