π’ API STATUS: ACTIVE & OPERATIONAL
Browse, inspect, and launch movie torrents directly from your terminal.
- π Search movies from YTS
- π₯ View detailed movie information
- π§² Launch magnet links directly into your torrent client
- π¦ Download
.torrentfiles 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
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:
-
Shows movie details
-
Lists available torrents
-
Auto-selects the best option (you can override)
-
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
STAR the repo if you like it! β
