Metadata-Version: 2.3
Name: torrra
Version: 1.3.5
Summary: A Python tool that lets you find and download torrents without leaving your CLI.
Keywords: torrent,cli,download,p2p,libtorrent,jackett,magnet,terminal,filesharing,torrent-client,textual,tui,torrent-search
Author: stabldev
Author-email: stabldev <thestabldev@gmail.com>
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: File Sharing
Classifier: Topic :: Terminals
Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
Requires-Dist: click>=8.3.0
Requires-Dist: diskcache>=5.6.3
Requires-Dist: httpx>=0.28.1
Requires-Dist: libtorrent>=2.0.11
Requires-Dist: libtorrent-windows-dll>=0.0.3
Requires-Dist: platformdirs>=4.5.0
Requires-Dist: textual>=6.5.0
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: myst-parser>=4.0.1 ; extra == 'docs'
Requires-Dist: qiskit-sphinx-theme>=2.0.0 ; extra == 'docs'
Requires-Dist: sphinx>=8,<9 ; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5.2 ; extra == 'docs'
Requires-Python: >=3.10
Project-URL: Bug Tracker, https://github.com/stabldev/torrra/issues
Project-URL: homepage, https://github.com/stabldev/torrra
Project-URL: repository, https://github.com/stabldev/torrra
Provides-Extra: docs
Description-Content-Type: text/markdown

# Torrra - “rrr”

> A Python tool that lets you search and download torrents without leaving your CLI.

[![Python Versions](https://img.shields.io/pypi/pyversions/torrra?style=flat-square)](https://pypi.org/project/torrra/)
[![PyPI](https://img.shields.io/pypi/v/torrra?style=flat-square)](https://pypi.org/project/torrra/)
[![AUR Version](https://img.shields.io/aur/version/torrra?style=flat-square)](https://aur.archlinux.org/packages/torrra)
[![Pepy Total Downloads](https://img.shields.io/pepy/dt/torrra?style=flat-square&color=blue)](https://pypi.org/project/torrra/)
[![Docs](https://readthedocs.org/projects/torrra/badge/?version=latest&style=flat-square)](https://torrra.readthedocs.io/)
[![License](https://img.shields.io/github/license/stabldev/torrra?style=flat-square)](https://github.com/stabldev/torrra/blob/main/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://github.com/stabldev/torrra/issues)

![demo](./docs/_static/demo.gif)

_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.

**Full documentation**: https://torrra.readthedocs.io/en/latest/

## Installation

```bash
pipx install torrra
# or uv tool install torrra
```

Other options: [`AUR`](https://aur.archlinux.org/packages/torrra), [`standalone binaries`](https://github.com/stabldev/torrra/releases), [`Homebrew`](https://github.com/Maniacsan/homebrew-torrra) or [`Docker`](https://hub.docker.com/r/stabldev/torrra).

[See full install options →](https://torrra.readthedocs.io/en/latest/installation.html)

## Quick Usage

### 1. Interactive Search

Launch `torrra` with an indexer.

```bash
torrra jackett --url http://localhost:9117 --api-key <your_api_key>
```

### 2. Direct Search

Or, search directly from your command line and see instant results.

```bash
torrra search "arch linux iso"
```

[Full Usage guide →](https://torrra.readthedocs.io/en/latest/usage.html)\
[See full CLI & TUI guide →](https://torrra.readthedocs.io/en/latest/usage.html#text-user-interface-tui-controls)

## 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:

```bash
# 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:

```bash
torrra
```

[Learn more about configuration →](https://torrra.readthedocs.io/en/latest/configuration.html)

## Features

- Search with [`Jackett`](https://github.com/Jackett/Jackett) or [`Prowlarr`](https://github.com/Prowlarr/Prowlarr)
- Download torrents directly with pause/resume support
- Beautiful and responsive TUI built with [`Textual`](https://textual.textualize.io/)
- Customizable themes (dark, light, and more)
- Smart config + opt-in caching for fast searches
- Native support for Linux, macOS, and Windows

[Full feature list →](https://torrra.readthedocs.io/en/latest/#features)

## 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](https://github.com/stabldev/torrra/issues/new/choose) to let us know.
- **Want to contribute code?** Check out the [Contributing Guide](https://torrra.readthedocs.io/en/latest/contributing.html),\
  to learn how to set up your development environment and submit a pull request.

## License

[MIT](LICENSE) © 2025 ^\_^ [`@stabldev`](https://github.com/stabldev)
