CineCLI: Filmsuche und Torrent-Start direkt im Terminal

• CineCLI ist ein plattformübergreifendes CLI-Tool, mit dem sich in einer Terminal-Umgebung Filminformationen suchen und Torrents direkt starten lassen
• Es lädt Filmdaten über die YTS API und wählt automatisch die beste Qualität und gesunde Seeds aus
• Es basiert auf Python 3.11+ und bietet mit Typer und Rich eine intuitive Oberfläche
• In Nix/NixOS-Umgebungen kann es ohne separate Installation ausgeführt werden und übergibt Magnet-Links an den Standard-Torrent-Client des OS
• Es unterstützt von einfacher befehlsbasierter Suche bis zum interaktiven Modus alles und ist damit sowohl für Entwickler als auch für Filmfans nützlich

---

Überblick über CineCLI

• CineCLI ist eine schnelle und minimalistische CLI-Anwendung, mit der sich Film-Torrents im Terminal durchsuchen, prüfen und starten lassen
  • Läuft unter Linux, macOS und Windows
  • Bietet eine auf rich basierende visuell aufgeräumte Terminal-UI
• Es verwendet die YTS API, um nach Filminformationen zu suchen, und zeigt die Ergebnisse in Form von ID, Titel, Jahr und Bewertung an
• Nutzer können eine Film-ID auswählen, um Details anzusehen, und anschließend den gewünschten Torrent wählen oder die automatische Auswahl nutzen

Hauptfunktionen

• Filmsuche: Suche nach Filmen auf YTS mit dem Befehl cinecli search <Titel>
• Details anzeigen: Anzeige der Detailinformationen zum ausgewählten Film und der verfügbaren Torrents
• Automatische Torrent-Auswahl: Automatische Auswahl anhand bester Qualität und gesunder Seeds
• Torrent starten: Übergibt Magnet-Links an den im OS registrierten Standard-Client (qBittorrent, Transmission usw.)
• Bietet eine Option zum Herunterladen von .torrent-Dateien
• Unterstützt einen interaktiven Modus (interactive), in dem Suche → Auswahl → Download schrittweise durchgeführt werden

Installation und Ausführung

• Installation per pip:

  pip install cinecli
  

  • Python 3.11 oder neuer erforderlich
• Unterstützung für Nix/NixOS:
  • Kann flake-basiert ohne Installation von Python oder pip ausgeführt werden
  • Sofortiger Start mit dem Befehl nix run github:eyeblech/cinecli
  • Kann mit nix profile add github:eyeblech/cinecli zum Profil hinzugefügt werden
• Installation aus dem Quellcode (für Entwickler):

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

Anwendungsbeispiele

• Suchbeispiel

  cinecli search matrix
  

  Beispielausgabe:

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

• Befehl zum Anschauen eines Films

  cinecli watch 3525
  

  • Zeigt Filmdetails an
  • Gibt eine Liste verfügbarer Torrents aus
  • Startet nach automatischer oder manueller Auswahl einen Magnet-Link oder lädt eine .torrent-Datei herunter

Tech-Stack

• Python-basiert
• Typer: CLI-Framework
• Rich: Aufbau der Terminal-UI
• Requests: API-Kommunikation
• YTS API: Datenquelle für Filme

Weitere Informationen

• Unter der MIT-Lizenz veröffentlicht und frei nutz- sowie anpassbar
• Der Status der YTS API wird alle 15 Minuten automatisch überwacht und als normal (🟢) oder gestört (🔴) angezeigt
• Open-Source-Projekt, PRs und Sterne (⭐) sind willkommen
• Entwickler: eyeblech (E-Mail: [e-mail])