CineCLI, pour rechercher des films et lancer des torrents directement depuis le terminal

• CineCLI est un outil CLI multiplateforme qui permet de rechercher des informations sur des films et de lancer directement des torrents depuis un terminal
• Il récupère les données des films via l’API YTS et sélectionne automatiquement la meilleure qualité et les seeds les plus sains
• Développé en Python 3.11+, il offre une interface intuitive grâce à Typer et Rich
• Dans les environnements Nix/NixOS, il peut être exécuté sans installation séparée et transmet les liens magnet au client torrent par défaut de l’OS
• Il prend en charge aussi bien les recherches en ligne de commande simples qu’un mode interactif, ce qui en fait un outil utile pour les développeurs comme pour les cinéphiles

---

Présentation de CineCLI

• CineCLI est une application CLI rapide et minimaliste permettant de parcourir, consulter et lancer des torrents de films depuis le terminal
  • Fonctionne sous Linux, macOS et Windows
  • Fournit une interface terminal visuellement soignée basée sur rich
• Il utilise l’API YTS pour rechercher des informations sur les films, et affiche les résultats sous la forme ID, titre, année et note
• L’utilisateur peut sélectionner l’ID d’un film pour consulter les détails, puis choisir le torrent souhaité ou utiliser la sélection automatique

Fonctionnalités principales

• Recherche de films : recherche sur YTS avec la commande cinecli search <titre>
• Affichage des détails : montre les informations détaillées du film sélectionné ainsi que la liste des torrents disponibles
• Sélection automatique du torrent : choisit automatiquement selon la meilleure qualité d’image et des seeds en bon état
• Lancement du torrent : transmet le lien magnet au client par défaut enregistré dans l’OS (qBittorrent, Transmission, etc.)
• Option de téléchargement de fichier .torrent
• Prise en charge d’un mode interactif permettant d’effectuer pas à pas la recherche → la sélection → le téléchargement

Installation et exécution

• Installation avec pip :

  pip install cinecli
  

  • Python 3.11 ou version supérieure requis
• Prise en charge de Nix/NixOS :
  • Basé sur flake, exécutable sans installer Python ni pip
  • Exécution directe avec la commande nix run github:eyeblech/cinecli
  • Ajout possible au profil avec nix profile add github:eyeblech/cinecli
• Installation depuis le code source (pour les développeurs) :

  git clone https://github.com/eyeblech/cinecli.git
  cd cinecli
  pip install -e .
  

Exemples d’utilisation

• Exemple de recherche

  cinecli search matrix
  

  Exemple de résultat :

  ID     Title                 Year   Rating
  3525   The Matrix            1999   8.7
  3526   The Matrix Reloaded   2003   7.2
  

• Commande pour regarder un film

  cinecli watch 3525
  

  • Affiche les détails du film
  • Affiche la liste des torrents disponibles
  • Après sélection automatique ou manuelle, lance le magnet ou télécharge le fichier .torrent

Stack technique

• Basé sur Python
• Typer : framework CLI
• Rich : construction de l’interface terminal
• Requests : communication avec l’API
• API YTS : source des données des films

Autres informations

• Publié sous licence MIT, avec libre utilisation et modification
• L’état de l’API YTS est surveillé automatiquement toutes les 15 minutes et affiché comme normal (🟢) ou en panne (🔴)
• En tant que projet open source, les PR et les étoiles (⭐) sont les bienvenues
• Créateur : eyeblech (e-mail : [e-mail])