# Install torrra with Homebrew

Find and download torrents without leaving your CLI. Version 2.0.7 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:torrra
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install torrra
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:torrra
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/torrra>
- **Version:** 2.0.7
- **Source summary:** Find and download torrents without leaving your CLI
- **Homepage:** <https://torrra.readthedocs.io/en/latest/>
- **Repository:** <https://github.com/stabldev/torrra>
- **Upstream docs:** <https://torrra.readthedocs.io/en/latest>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/f9/12/5102a5e69a07e8e7500928087ae850b5940404f31681a588084b4d50985e/torrra-2.0.7.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- torrra (cli)
- torrra (alias)

## Dependencies

- certifi
- libtorrent-rasterbar
- python@3.14

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.0.7
- Local data: ok
- Upstream repository: https://torrra.readthedocs.io/en/latest/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Torrra is a Python CLI/TUI for searching and downloading torrents from the terminal. Its README describes it as powered by Jackett or Prowlarr for search and libtorrent for downloads, with a Textual-based interface.

### Project history

The project is a recent terminal-first BitTorrent client wrapper rather than an old ecosystem package. Its README identifies it as MIT licensed with 2025 copyright, and the official documentation title shows a 2.0.7 documentation build.

Torrra's project direction is to combine several pieces that package nerds often run separately: Jackett or Prowlarr indexers, libtorrent downloading, a persistent TOML config, caching, themes, and a Textual TUI with pause/resume controls.

### Adoption history

Official installation notes in the README lead with pipx and uv tool install, then list AUR, standalone binaries, Homebrew, and Docker as additional options. The input package facts confirm Homebrew packaging, placing Torrra in the cross-platform Python CLI packaging pattern rather than a single-distribution tool.

### How it is used

The README shows three main workflows: interactive search by running torrra with a configured indexer, direct search with torrra search, and direct download from magnet URIs or .torrent files with torrra download. Configuration commands set Jackett URL, Jackett API key, default indexer, download paths, and themes in config.toml.

For package nerds, Torrra is mainly interesting because it brings the torrent search/download loop into the terminal while still integrating with self-hosted indexer tools. The credentials file doubles as configuration because API keys for Jackett or Prowlarr are stored in the same TOML config.

### Why package nerds care

Torrra is significant as a modern Python/Textual example in the torrent CLI space: it packages search, indexer credentials, libtorrent downloads, and a TUI into one command while supporting pipx, uv, AUR, Homebrew, binaries, and Docker.

### Timeline

- 2025: README license line identifies MIT copyright for the project.
- 2.0.7 docs: Read the Docs publishes Torrra documentation with usage, configuration, indexer, roadmap, and contributing sections.
- Current packaging: README lists pipx, uv tool install, AUR, standalone binaries, Homebrew, and Docker options.

### Related projects

- The README names Jackett, Prowlarr, libtorrent, and Textual as the main surrounding ecosystem. It also mentions pipx, uv, AUR, Homebrew, and Docker as packaging/install surfaces.

### Sources

- <https://github.com/stabldev/torrra#readme>
- <https://torrra.readthedocs.io/en/latest/configuration.html>
- <https://torrra.readthedocs.io/en/latest/usage.html>
- source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/torrra/config.toml
- Windows: %APPDATA%\torrra\config.toml

## Credential files

- Unix: ~/.config/torrra/config.toml
- Windows: %APPDATA%\torrra\config.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** torrra
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [mabel](https://www.automicvault.com/pkg/brew/mabel/) - Shares av.db curated category or tags: bittorrent, cli, networking, tui.
- [torf-cli](https://www.automicvault.com/pkg/brew/torf-cli/) - Shares av.db curated category or tags: bittorrent, cli, networking, python.
- [intermodal](https://www.automicvault.com/pkg/brew/intermodal/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [mkbrr](https://www.automicvault.com/pkg/brew/mkbrr/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [mktorrent](https://www.automicvault.com/pkg/brew/mktorrent/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [qbittorrent-cli](https://www.automicvault.com/pkg/brew/qbittorrent-cli/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [rqbit](https://www.automicvault.com/pkg/brew/rqbit/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [rtorrent](https://www.automicvault.com/pkg/brew/rtorrent/) - Shares av.db curated category or tags: bittorrent, cli, networking.
- [pferd](https://www.automicvault.com/pkg/brew/pferd/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, download, downloader, networking.
- [toot](https://www.automicvault.com/pkg/brew/toot/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, networking, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/torrra.yml](https://github.com/automic-vault/db/blob/main/combined/torrra.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
