Torrra (“rrr”) is an open source Python tool for searching and downloading torrents without leaving the terminal. It queries your existing Jackett or Prowlarr indexer for results, hands the chosen torrent to libtorrent for the transfer itself, and draws the whole workflow as a text user interface built with Textual — so the search box, result table and download queue behave like a desktop application while staying inside a shell session.

Downloading is a first-class part of the app rather than a hand-off to another client: torrents can be added from a magnet URI, a URL or a local .torrent file, paused and resumed from the queue, and pointed at their own destination directory, which is remembered across runs. Settings live in a config.toml, so an indexer URL and API key are stored once instead of being passed on every invocation.

Features

• Indexer search through Jackett or Prowlarr, with a default indexer set once in the configuration.
• Built-in libtorrent downloader with pause and resume, so no separate BitTorrent client is required.
• Per-torrent download directories that are chosen once and persisted for each torrent.
• Textual TUI with a live results table and keyboard shortcuts (ctrl+q quit, ctrl+t theme switcher, ctrl+d downloads, ? shortcuts).
• Sortable results by seeders, leechers, size or title, with an option to hide dead torrents.
• Direct commands for scripting: torrra search "arch linux iso", torrra download "magnet:?xt=urn:btih:...", torrra downloads.
• Themes (dark, light and more), opt-in result caching for faster repeat searches, and an in-app notice when a newer release ships.
• Native Linux, macOS and Windows support, plus a packaged Docker image.

Requirements

A running Jackett or Prowlarr instance and its API key supply the search results; Torrra itself needs Python 3.10–3.13 (libtorrent does not publish wheels for 3.14 yet). Install with uv tool install torrra or pipx install torrra; standalone binaries, WinGet, AUR and a Homebrew tap are also available — see the installation guide. Directory entries for the indexers it drives: Jackett and Prowlarr. For heavier queue management, pair it with a full client such as qBittorrent.

Licence

Open source — MIT License. Copyright the Torrra contributors (stabldev). Source code: github.com/stabldev/torrra; documentation: torrra.readthedocs.io.