Torrra - “rrr”
A Python tool that lets you search and download torrents without leaving your CLI.
Torrra provides a streamlined command-line interface for torrent search and downloads, powered by Jackett/Prowlarr and Libtorrent. Built with Textual, it offers a beautiful TUI with pause/resume support - all without leaving your terminal.
Installation
uv tool install torrra
# or pipx install torrra
Other options: AUR, standalone binaries, Homebrew or Docker.
Quick Usage
1. Interactive Search
Launch torrra with an indexer.
torrra # if default indexer is configured
# or torrra jackett
# or torrra jackett --url http://localhost:9117 --api-key <your_api_key>
Replace
<your_jackett_api_key>with your actual Jackett API key.
2. Direct Search
You can bypass the initial welcome screen and search
for torrents directly from your command line using the search command:
torrra search "arch linux iso"
# or torrra search "arch linux iso" --no-cache
3. Direct Download
You can download torrents directly from magnet URIs, URLs, or local
.torrent files without searching using the download command:
torrra download "magnet:?xt=urn:btih:..."
# or torrra download "/path/to/file.torrent"
# choose a destination for this torrent
torrra download "magnet:?xt=urn:btih:..." --save-path /downloads/linux
Full Usage guide →
See full CLI & TUI guide →
Configuration
For persistent settings, torrra uses a config.toml file where you can configure your indexers, download paths, and themes. This avoids the need to pass arguments on every run.
For example, to set up Jackett as your default indexer:
# set your Jackett URL and API key
torrra config set indexers.jackett.url http://localhost:9117
torrra config set indexers.jackett.api_key <your_api_key>
# set Jackett as the default indexer
torrra config set indexers.default jackett
Now you can simply run torrra to start searching:
torrra # default indexer will be used
Learn more about configuration →
Features
- Search with
JackettorProwlarr - Download torrents directly with pause/resume support
- Choose and persist a separate download directory for each torrent
- Beautiful and responsive TUI built with
Textual - Customizable themes (dark, light, and more)
- Smart config + opt-in caching for fast searches
- Sort search results by seeders, size, title or leechers, and hide dead torrents
- Native support for Linux, macOS, and Windows
Contributing
Contributions are welcome and greatly appreciated!
Whether it's reporting a bug, submitting a feature request, or writing code, we value your help.
- Found a bug or have an idea? Open an issue to let us know.
- Want to contribute code? Check out the Contributing Guide,
to learn how to set up your development environment and submit a pull request.
License
Like my work?
This project needs a ⭐ from you. Don't forget to leave a ⭐
If you found this helpful, consider supporting me with a coffee.
1 maintainer
Metadata
1 maintainer
Release files for torrra 2.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| torrra-2.3.1.tar.gz | 10.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| torrra-2.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.4 MB
Release files / torrra-2.3.1.tar.gz
| Download URL | torrra-2.3.1.tar.gz |
|---|---|
| Size | 10.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d9ad8f150eb3a7a259c4f850bdff144f307d4098fc4a30e82f2d7a9660f80f3a
|
|
BLAKE2b-256 checksum How to use checksums |
fe5740761bcc4eec8c7801ceea3475217e9538e7b1b4e4ae4cd81714814be79b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / torrra-2.3.1-py3-none-any.whl
| Download URL | torrra-2.3.1-py3-none-any.whl |
|---|---|
| Size | 65.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c842e0ac0e8fadde693ed19a0bcdcc0781c3fa0ad6ef998f98682a2dfed4264a
|
|
BLAKE2b-256 checksum How to use checksums |
f0e8cf078ca7e96e694baf9388bb742826f7abc44fc17151a9d20173e832bab7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
