Skip to content

Repository files navigation

Stars Forks Contributors License Python 3.14+

Torrent Hunt Bot

Open in Telegram

🔍 Torrent Hunt Bot

Torrent Hunt is a Telegram bot for searching torrents. Send it a keyword and it searches your configured indexers and delivers the magnet links right inside Telegram, in your language.

✨ Features

  • Search any keyword, browse results in a single message, and tap a title to get its magnet link
  • Filter & sort by category, seeders, size, or upload date; jump to any page
  • Inline search in any chat (@torrenthuntbot <query>), per-site too
  • Bookmarks to save torrents for later
  • 19 languages and an optional restricted mode for adult content

🔌 Search Provider

Torrent Hunt supports Jackett and Prowlarr as its search providers. Every indexer you configure in them becomes searchable from the bot.

🗣️ Languages

Torrent Hunt Bot speaks 19 languages.

Full list & translation credits
  • Arabic (Added by Omar Khalid)
  • Bengali (Checked and fixed by sobuj53)
  • Belarusian
  • Catalan
  • Dutch
  • English (Original)
  • French (Checked and fixed by xav35000)
  • German
  • Hindi
  • Italian (Checked and fixed by bacchilega)
  • Korean
  • Malay
  • Nepali
  • Polish (Checked and fixed by Oskar)
  • Portuguese
  • Russian
  • Spanish
  • Turkish (Checked and fixed by Berce)
  • Ukrainian

⚒️ Deployment

Run locally

# 1. Configure: copy sample.env to .env and fill in the values
cp sample.env .env

# 2. Install dependencies and run
uv sync
uv run app/main.py

Docker

docker build -t torrenthunt .
docker run --env-file .env torrenthunt

Heroku

Deploy


❇️ Author/Maintainer: Hemanta Pokharel [✉️ 💬]