CineCLI, alat untuk mencari film dan menjalankan torrent langsung dari terminal

 (github.com/eyeblech)
3 poin oleh GN⁺ 2025-12-25 | 1 komentar | Bagikan ke WhatsApp
  • CineCLI adalah alat CLI lintas platform yang memungkinkan pencarian informasi film dan menjalankan torrent langsung dari lingkungan terminal
  • Mengambil data film melalui YTS API, serta otomatis memilih kualitas terbaik dan seed yang sehat
  • Dibangun dengan Python 3.11+ dan menyediakan antarmuka intuitif menggunakan Typer dan Rich
  • Di lingkungan Nix/NixOS, dapat dijalankan tanpa instalasi terpisah, dan tautan magnet diteruskan ke klien torrent bawaan OS
  • Mendukung mulai dari pencarian berbasis perintah sederhana hingga mode interaktif, sehingga berguna bagi developer maupun penggemar film

Gambaran umum CineCLI

  • CineCLI adalah aplikasi CLI yang cepat dan minimalis untuk menelusuri, memeriksa, dan menjalankan torrent film dari terminal
    • Berjalan di Linux, macOS, dan Windows
    • Menyediakan UI terminal yang rapi secara visual berbasis rich
  • Menggunakan YTS API untuk mencari informasi film, lalu menampilkan hasil dalam bentuk ID, judul, tahun, dan rating
  • Pengguna dapat memilih ID film untuk melihat detail, lalu memilih torrent yang diinginkan atau memakai fitur pemilihan otomatis

Fitur utama

  • Pencarian film: cari film di YTS dengan perintah cinecli search <judul>
  • Lihat detail: menampilkan informasi lengkap film terpilih dan daftar torrent yang tersedia
  • Pemilihan torrent otomatis: otomatis memilih berdasarkan kualitas terbaik dan seed yang sehat
  • Menjalankan torrent: meneruskan tautan magnet ke klien bawaan OS yang terdaftar (qBittorrent, Transmission, dll.)
  • Menyediakan opsi unduh file .torrent
  • Mendukung mode interaktif (interactive) untuk menjalankan alur pencarian→pemilihan→unduhan secara bertahap

Instalasi dan menjalankan

  • Instalasi via pip: 
    pip install cinecli
    • Memerlukan Python 3.11 atau lebih baru
  • Dukungan Nix/NixOS:
    • Berbasis flake, sehingga bisa dijalankan tanpa memasang Python atau pip
    • Bisa langsung dijalankan dengan perintah nix run github:eyeblech/cinecli
    • Bisa ditambahkan ke profil dengan nix profile add github:eyeblech/cinecli
  • Instalasi dari source code (untuk developer): 
    git clone https://github.com/eyeblech/cinecli.git
cd cinecli
pip install -e .

Contoh penggunaan

  • Contoh pencarian 
    cinecli search matrix
    Contoh hasil: 
    ID     Title                 Year   Rating
3525   The Matrix            1999   8.7
3526   The Matrix Reloaded   2003   7.2
  • Perintah untuk menonton film 
    cinecli watch 3525
    • Menampilkan detail film
    • Menampilkan daftar torrent yang tersedia
    • Setelah pemilihan otomatis atau manual, menjalankan magnet atau mengunduh .torrent

Tech stack

  • Berbasis Python
  • Typer: framework CLI
  • Rich: penyusun UI terminal
  • Requests: komunikasi API
  • YTS API: sumber data film

Informasi lainnya

  • Dirilis di bawah lisensi MIT, sehingga bebas digunakan dan dimodifikasi
  • Status YTS API dipantau otomatis setiap 15 menit, dan ditampilkan sebagai normal (🟢) atau gangguan (🔴)
  • Sebagai proyek open source, PR dan bintang (⭐) sangat diterima
  • Pembuat: eyeblech (email: 0x1123@proton.me)

Bacaan terkait

1 komentar

 
GN⁺ 2025-12-25
Komentar Hacker News

  • Di Android TV, saya mendapatkan hasil yang mirip dengan memakai plugin Stremio(stremio.com) dan Torrentio(torrentio.org)
    Akan keren kalau bisa streaming lewat terminal juga di Linux, dan akan lebih sempurna lagi kalau ada fitur pemeriksaan file berbahaya sebelum mengunduh

    • Torrentio menyediakan metadata, sementara Stremio menangani UI dan pemutaran
      Dengan cara ini, kebutuhan ruang penyimpanan bisa diminimalkan
      Saya jadi penasaran apakah konfigurasi serupa juga memungkinkan di Jellyfin, lalu setelah mencari tahu ternyata ia mendukung file .strm
      .strm hanyalah file teks sederhana yang berisi URL; saya merujuk ke dokumentasi terkait dan pencarian issue
      Karena saya memakai private tracker, saya harus membuat sendiri scraper kustom untuk menggantikan fungsi Torrentio, tetapi sepertinya tidak akan sulit untuk membuat file .strm secara otomatis
      Hanya saja, masalah performa atau transcoding masih perlu dicek lebih lanjut
    • (respons singkat) Sst...

  • Rasanya seperti mendengar gema Popcorn Time lagi
    Kalau CineCLI jadi terlalu mudah digunakan, mungkin peringatan hak cipta akan mulai berdatangan, tetapi karena tampaknya tidak ada fitur pemutaran langsung, mungkin justru sedikit lebih aman

    • Popcorn Time benar-benar aplikasi legendaris. RIP

  • Kalau seseorang tahu cara memakai alat CLI, mengunduh rilis berkualitas tinggi secara langsung juga bukan hal yang sulit
    Tidak perlu prosedur seperti wawancara private tracker
    YTS kualitasnya terlalu rendah, jadi saya kurang paham siapa target proyek ini — kalau ini hanya proyek eksperimen untuk mencoba membuat aplikasi di atas API, itu masih masuk akal

    • Saya jadi penasaran sekarang tempat yang masih layak dipakai itu yang mana. Nuansa Napster lama mulai terasa lagi

  • Saya juga pernah membuat sesuatu yang mirip, yaitu webapp yang bisa mencari di tracker mana pun yang didukung Jackett lalu langsung streaming di browser
    Kodenya terbuka, jadi bisa dilihat di GitHub - rapidbay

  • Saya penasaran perintah apa yang paling cocok untuk memasang atau menjalankan ini dengan cepat memakai uv

    • Bisa langsung dijalankan dengan perintah uvx cinecli search "star wars"

  • Yang saya inginkan adalah alat yang bisa streaming hanya rentang timestamp tertentu, lalu menyimpan bagian itu sebagai file lokal
    Kalau ada fitur seperti ini, banyak alur kerja akan jadi jauh lebih efisien

    • Kalau orang bisa mengumpulkan data unduhan hanya untuk bagian tertentu alih-alih seluruh stream, rasanya itu juga bisa dipakai sebagai dasar argumen fair use pada torrent
    • Saya penasaran bagaimana cara melakukan streaming berdasarkan timestamp
    • Saya juga punya pertanyaan yang sama — apakah streaming berdasarkan timestamp itu memungkinkan?

  • Terrarium TV adalah yang pertama, lalu setelah itu muncul fork seperti Corn Time, Cinema APK, TeaTV, dan BeeTV

  • Ini pada dasarnya cuma wrapper API YTS

  • Kelihatannya cukup keren. Akan saya masukkan ke daftar untuk dites

  • Sulit membedakan apakah GIF-nya yang tersendat atau memang kecepatan mengetiknya seperti itu
    Kalau mau, saya bisa bantu dengan pelajaran mengetik supaya WPM-nya naik ke dua digit

    • Hal seperti ini rasanya bisa dibuat jauh lebih mulus hanya dengan sedikit persiapan
      Proyeknya sendiri bagus, tetapi untuk video demo sebaiknya tentukan dulu apa yang mau ditunjukkan lalu latihan beberapa kali agar bisa direkam dengan alur yang natural
      Berhenti sebentar agar penonton bisa mengikuti tidak masalah, tetapi mengetik pelan itu sulit ditonton
    • Ironisnya, di profil GitHub pembuatnya ada tautan monkeytype
      Sebenarnya cukup belajar editing ffmpeg dasar saja pun hasilnya akan jauh lebih baik
    • Saya juga datang ke komentar karena video lambat itu
      Saya tidak sanggup menontonnya sampai habis, dan sebagai tambahan, sepertinya pip-nya juga perlu diperbarui