/telegram-media-bot

A Telegram bot to deliver torrent search results to users

Primary LanguagePythonMIT LicenseMIT

Telegram media bot

version: v1.0.0

A Telegram bot integrating with the Jackett search engine to streamline torrent searches. It efficiently fetches and presents a curated list of torrent results to users, complete with magnet links for easy access and download.

Quick start

  1. Run the Jackett server and note the API key. (see linuxserver/jackett for detailed instructions)
    Simple run example for demo purpose:
    docker run -d --name=myjackett -p 9117:9117 linuxserver/jackett
    • Then, go to http://localhost:9117 and copy the API key.
    • After, press the + Add indexer button and add some torrent providers to search for torrents, for example 1337x and The Pirate Bay.
    • Jackett is now ready to use.
  2. Create a new bot on Telegram and note the bot token. (use @BotFather to do it)
  3. Run this bot using the following command:
docker run -d --rm --name telegram-media-bot \
    -e JACKETT_API_KEY=your_jackett_api_key_here \
    -e JACKETT_URL=http://myjackett:9117 \
    -e BOT_TOKEN=your_telegram_bot_token_here \
    windranger/telegram-media-bot:latest

Usage

Usage it pretty straightforward. Just start a chat with the bot and write a message to make the bot search for torrents.

image

Use the buttons to filter the results.

image

Choose a torrent from the list and click the /select... link to get your download.

image

Press the button to download the torrent.

Disclaimer

This project is intended for educational purposes only. The author does not condone the use of it for illegal activities.