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

pip install torrra
torrra --help

Via Docker

# 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é)

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

4.9 KiB Raw Blame History