Show HN: CineCLI – Browse and torrent movies directly from your terminal

2025-12-235:17348111github.com

CineCLI is a cross-platform command-line movie browser built with Python. - eyeblech/cinecli

PyPI Python License Downloads

🟢 API STATUS: ACTIVE & OPERATIONAL
All CineCLI features are fully functional.

Browse, inspect, and launch movie torrents directly from your terminal.
Fast. Cross-platform. Minimal. Beautiful.

Demo

Platform CLI Terminal

  • 🔍 Search movies from YTS
  • 🎥 View detailed movie information
  • 🧲 Launch magnet links directly into your torrent client
  • 📦 Download .torrent files if preferred
  • ⚡ Auto-select best torrent (highest quality + healthy seeds)
  • 🖥 Cross-platform (Linux, macOS, Windows)
  • 🎨 Rich, clean terminal UI (powered by rich)
  • 🧠 Smart defaults with full user control

Built with Typer Built with Rich

Requires Python 3.9+

Displays matching movies with IDs:

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

What happens:

  1. Shows movie details

  2. Lists available torrents

  3. Auto-selects the best option (you can override)

  4. Launches magnet or downloads .torrent

  • Search → select movie → choose torrent

  • Manual selection by design (safe & explicit)

CineCLI delegates magnet handling to your OS.

That means:

  • Whatever torrent client is registered (qBittorrent, Transmission, etc.)

  • CineCLI will launch it directly

Example (Linux):

xdg-mime query default x-scheme-handler/magnet

Full terminal walkthrough:

demo.mov
  • Python

  • Typer — CLI framework

  • Rich — terminal UI

  • Requests — API communication

  • YTS API — movie data source

MIT—see LICENSE.

Use it. Fork it. Improve it.

Built by eyeblech
📧 0x1123@proton.me

STAR the repo if you like it! ⭐

Open Source Maintained PRs Welcome


Read the original article

HackerNews