Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,110 @@
+---
+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]]