---
title: torrra
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, indexer, torrent, search, tui]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/stabldev/torrra]
---

# 🎬 torrra

> Indexeur/chercheur de torrents simple en ligne de commande (TUI) : interroge plusieurs trackers publics/privés, agrège les résultats, et trie par seeds/taille/date dans une interface terminal élégante.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | torrra |
| **Slug** | torrra |
| **Description** | Client TUI (Terminal User Interface) pour rechercher des torrents sur trackers publics et privés, alternative à jackett/prowlarr en mode CLI |
| **Site officiel** | https://github.com/stabldev/torrra |
| **Repository** | https://github.com/stabldev/torrra |
| **Stars** | 1 193 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Python |
| **Catégorie** | *arr (utilitaires) |
| **Tags** | [catalogue, arr, indexer, torrent, search, tui] |

## 📝 Description

**torrra** est un outil **minimaliste et rapide** pour ceux qui veulent chercher un torrent **depuis leur terminal**, sans ouvrir Prowlarr ou Jackett dans un navigateur. C'est un **client TUI** (interface texte dans le terminal) qui :
- Interroge **plusieurs indexeurs** simultanément (trackers publics comme 1337x, ThePirateBay, YTS, ETTV, Nyaa ; trackers privés via credentials).
- Agrège les résultats dans une **liste triable** (seeds, leechers, taille, date, source).
- Permet de **copier le magnet link** ou de **l'envoyer** vers un client local (qBittorrent, Transmission, rTorrent).
- Fonctionne en **SSH**, sur un serveur headless, dans tmux, dans un pipeline shell.

**Différenciation** :
- **Plus simple** que Prowlarr (pas d'UI web, pas de synchro avec Sonarr/Radarr, pas de web UI).
- **Plus rapide** qu'ouvrir un navigateur (parfait en SSH).
- **Plus discret** qu'une web UI (pas de port exposé, pas de reverse proxy).
- **Limite** : pas d'automation, c'est un outil de **recherche manuelle** assistée.

Cas d'usage typique : vous voulez un film précis, vous êtes en SSH sur votre seedbox, vous tapez `torrra "inception 2010 1080p"`, vous voyez 30 résultats triés par seeds, vous appuyez sur `Enter` pour copier le magnet, vous le collez dans qBittorrent via son API.

## 🚀 Installation
### Via pip
```bash
pip install torrra
torrra --help
```
### Via Docker
```yaml
# docker-compose.yml
services:
  torrra:
    image: ghcr.io/stabldev/torrra:latest
    container_name: torrra
    stdin_open: true
    tty: true
    volumes:
      - ./config:/root/.config/torrra
    environment:
      - TZ=Europe/Paris
```
Lancement : `docker compose run --rm torrra "nom du film 1080p"`.
### Via pipx (recommandé)
```bash
pipx install torrra
torrra
```

## ⚙️ Configuration
- **Trackers par défaut** : 1337x, ThePirateBay, YTS, ETTV, Nyaa — fonctionnent out of the box.
- **Trackers privés** : ajouter dans `~/.config/torrra/config.toml` avec URL + credentials.
- **Tri par défaut** : seeds décroissant (les plus populaires en premier).
- **Filtres** : taille min/max, exclude mots-clés, catégorie.
- **Output** : mode interactif (TUI), mode JSON (`--json`), mode magnet direct (`--magnet`).
- **Client torrent local** : optionnel, peut pousser vers qBittorrent via API.

## 🔗 Alternatives
- **Prowlarr** — web UI complète, indexeur managé, synchro *arr. Plus complet, plus lourd.
- **Jackett** — précurseur de Prowlarr, mono-instance, vieillissant.
- **CLI torrent tools** — `nyaa-cli`, `tpb`, scripts ad-hoc par tracker.
- **qBittorrent search plugins** — intégrés au client, mais peu fiables, dépendants des sources.
- **rtshadows / bt-tracker-cli** — projets TUI similaires, plus confidentiels.

## 🔒 Sécurité
- **Pas d'auth UI** : il n'y a pas d'UI exposée, c'est un CLI, on tape `torrra` dans son terminal.
- **VPN** : torrra ne télécharge rien, il cherche ; mais le **torrent** qui en sortira passera par votre client (qBittorrent derrière [[app-gluetun]] recommandé).
- **Credentials trackers privés** : stockés en clair dans `~/.config/torrra/config.toml`, **chiffrer** le home ou restreindre les droits (`chmod 600`).
- **Logs / historique** : torrra n'a pas de logs persistants par défaut, c'est un avantage (privacy by design).
- **Téléchargements** : torrra n'envoie pas le torrent à qBittorrent par défaut, vous devez le faire manuellement (sauf config explicite) — c'est un choix sûr.

## 📚 Ressources
- Repository : https://github.com/stabldev/torrra
- Documentation : https://github.com/stabldev/torrra/wiki
- Wiki *arr : https://wiki.servarr.com

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-prowlarr]] — équivalent web complet
- [[app-jackett]] — précurseur de Prowlarr
- [[app-qbittorrent]]
- [[app-sonarr]]
- [[app-radarr]]
- [[app-gluetun]] — VPN pour clients torrent
- [[securisation-home-lab]]
- [[recettes-docker-compose]]