Back Original

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

PyPI Python License Downloads


🟒 API STATUS: ACTIVE & OPERATIONAL


Browse, inspect, and launch movie torrents directly from your terminal.

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


🧭 Interactive mode (recommended for exploration)

  • Search β†’ select movie β†’ choose torrent

  • Manual selection by design (safe & explicit)


βš™οΈ How magnet launching works

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


STAR the repo if you like it! ⭐

Open Source Maintained PRs Welcome