{"id":13522652,"url":"https://github.com/danimart1991/jackett2telegram","last_synced_at":"2025-12-24T08:33:47.285Z","repository":{"id":43601351,"uuid":"331048050","full_name":"danimart1991/jackett2telegram","owner":"danimart1991","description":"Jackett RSS to Telegram Bot (Docker Included)","archived":false,"fork":false,"pushed_at":"2024-04-26T09:12:48.000Z","size":234,"stargazers_count":45,"open_issues_count":0,"forks_count":28,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-08-02T06:14:12.839Z","etag":null,"topics":["indexer","jackett","notifications","rss","sickrage","telegram","telegram-bot","torrent","torznab","trackers"],"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/danimart1991.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"danimart1991","custom":"https://www.paypal.me/danimart1991"}},"created_at":"2021-01-19T16:52:40.000Z","updated_at":"2024-04-26T09:11:42.000Z","dependencies_parsed_at":"2022-08-23T05:50:45.431Z","dependency_job_id":"ca008dec-4613-4036-9d2e-76956f81f177","html_url":"https://github.com/danimart1991/jackett2telegram","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danimart1991%2Fjackett2telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danimart1991%2Fjackett2telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danimart1991%2Fjackett2telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danimart1991%2Fjackett2telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danimart1991","download_url":"https://codeload.github.com/danimart1991/jackett2telegram/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246558107,"owners_count":20796696,"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":["indexer","jackett","notifications","rss","sickrage","telegram","telegram-bot","torrent","torznab","trackers"],"created_at":"2024-08-01T06:00:50.706Z","updated_at":"2025-12-24T08:33:47.278Z","avatar_url":"https://github.com/danimart1991.png","language":"Python","funding_links":["https://github.com/sponsors/danimart1991","https://www.paypal.me/danimart1991"],"categories":["Bots"],"sub_categories":[],"readme":"![Jackett RSS to Telegram Bot logo](https://github.com/danimart1991/jackett2telegram/blob/main/docs/images/logo.png?raw=true)\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/danimart1991/jackett2telegram)](https://github.com/danimart1991/jackett2telegram/releases)\n[![Build](https://img.shields.io/github/actions/workflow/status/danimart1991/jackett2telegram/deploy.yml)](https://github.com/danimart1991/jackett2telegram/actions/workflows/deploy.yml)\n[![License](https://img.shields.io/github/license/danimart1991/jackett2telegram)](https://github.com/danimart1991/jackett2telegram/blob/main/LICENSE)\n[![Docker Pulls](https://img.shields.io/docker/pulls/danimart1991/jackett2telegram)](https://hub.docker.com/r/danimart1991/jackett2telegram)\n\n[![Tip Me via PayPal](https://img.shields.io/badge/PayPal-tip%20me-blue?logo=paypal\u0026style=flat)](https://www.paypal.me/danimart1991)\n[![Sponsor Me via GitHub](https://img.shields.io/badge/GitHub-sponsor%20me-blue?logo=github\u0026style=flat)](https://github.com/sponsors/danimart1991)\n\n# Jackett (and Prowlarr) RSS to Telegram Bot\n\nA **self-hosted Telegram Python Bot** that dumps posts from **Jackett or Prowlarr RSS feeds to a Telegram** chat.\n\nBased on [**RSS to Telegram bot**](https://github.com/BoKKeR/RSS-to-Telegram-Bot) by [_BoKKeR_](https://github.com/BoKKeR) (Thanks for your effort).\n\n![Image of the chat](https://github.com/danimart1991/jackett2telegram/blob/main/docs/images/example.png?raw=true)\n\n## Requirements\n\nA Telegram Bot is needed that the script will connect to.\n\nYou 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).\n\n\u003e WARNING!! Without `chat_id` the bot wont be able to send automated messages and will only be able to respond to messages.\n\n## Docker Installation\n\n```bash\n$ docker create \\\n  --name=jackett2telegram \\\n  -e TOKEN=\u003cyour_telegram_bot_token\u003e \\\n  -e CHATID=\u003cyour_telegram_bot_chatid\u003e \\\n  -v \u003c/path/to/host/config\u003e:/app/config \\\n  -v \u003c/path/to/host/blackhole\u003e:/app/blackhole \\\n  --restart unless-stopped \\\n  danimart1991/jackett2telegram\n```\n\n## Manual Installation\n\nPython 3.X\n\n1. Clone the script\n2. Install depedencies with:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Run the script with:\n\n   ```bash\n   python jackett2telegram.py --token \u003cYOUR_TELEGRAM_TOKEN\u003e --chat_id \u003cYOUR_TELEGRAM_CHAT_ID\u003e\n   ```\n\n## Optional Parameters\n\nThe following parameters can be used in both Docker (as environment variables) and Manual installation (as command line arguments):\n\n| Docker Env          | Command Line Arg      | Description                                                                                      | Default |\n| ------------------- | --------------------- | ------------------------------------------------------------------------------------------------ | ------- |\n| `MESSAGE_THREAD_ID` | `--message_thread_id` | Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | -       |\n| `DELAY`             | `--delay`             | Seconds between each RSS fetching                                                                | 600     |\n| `LOG_LEVEL`         | `--log_level`         | Log level (_critical_, _error_, _warning_, _info_, _debug_)                                      | info    |\n\n\u003e Note: `MESSAGE_THREAD_ID` is optional. If you run the Docker image you can leave the environment variable empty (for example `ENV MESSAGE_THREAD_ID=\"\"`) and the container entrypoint will omit the `--message_thread_id` argument. Only set `MESSAGE_THREAD_ID` (or pass `--message_thread_id` when running manually) when you need to target a specific forum topic in a supergroup.\n\n## Usage\n\nSend `/help` command to the bot to get this message:\n\n\u003e **Jackett2Telegram (Jackett and Prowlarr RSS to Telegram Bot)**\n\u003e\n\u003e After successfully adding a Jackett or Prowlarr RSS link, the bot starts fetching the feed every 600 seconds. (This can be set)\n\u003e\n\u003e Titles are used to easily manage RSS feeds and should contain only one word and are case sensitive.\n\u003e\n\u003e Commands:\n\u003e\n\u003e - /help Posts this help message. 😑\n\u003e - /add TITLE JACKETT_OR_PROWLARR_RSS_FEED_URL - Adds new Jackett or Prowlarr RSS Feed (overwrited if title previously exist).\n\u003e - /remove TITLE - Removes the RSS link.\n\u003e - /list Lists all the titles and the asociated Jackett or Prowlarr RSS links from the DB.\n\u003e - /test JACKETT_OR_PROWLARR_RSS_FEED_URL - Inbuilt command that fetches a post (usually latest) from a Jackett or Prowlarr RSS.\n\u003e\n\u003e In order to use **Blackhole**, your _Torrent_ client must support it and be configured to point to **Jackett2Telegram** _Blackhole_ folder.\n\u003e\n\u003e If you like the project, star it on [GitHub](https://github.com/danimart1991/jackett2telegram).\n\n### How to add a new Indexer\n\nYou could get the **Jackett or Prowlarr RSS Feed Url** using the action button in Indexers list:\n\n![Jackett RSS Feed Button](https://github.com/danimart1991/jackett2telegram/blob/main/docs/images/rssfeed-jackett.png?raw=true)\n\nYou could get the **Prowlarr RSS Feed Url** using the action button in Indexers list:\n\n![Prowlarr RSS Feed Button](https://github.com/danimart1991/jackett2telegram/blob/main/docs/images/rssfeed-prowlarr.png?raw=true)\n\nThen 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.\n\n### How to use Blackhole\n\n**Blackhole** folder is a monitored folder that your _Torrent_ client checks to look for `.torrent` files and then download them automatically.\n\nFirst, 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**.\n\nWhen a new release is showed in Telegram, a Blackhole button could be pressed and download the `.torrent` file locally, then _Torrent_ client use it.\n\n\u003e If you use the _Docker_ installation, make a bind between folders.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanimart1991%2Fjackett2telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanimart1991%2Fjackett2telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanimart1991%2Fjackett2telegram/lists"}