<p align="center"> <img src="https://img.shields.io/pypi/v/cinecli?style=for-the-badge" /> <img src="https://img.shields.io/badge/python-3.11%2B-blue?style=for-the-badge" /> <img src="https://img.shields.io/badge/Nix-Flake-5277C3?style=for-the-badge&logo=nixos&logoColor=white" /> <img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" /> <img src="https://img.shields.io/pypi/dm/cinecli?style=for-the-badge" /> </p> <p align="center"> <img src="https://img.shields.io/github/stars/eyeblech/cinecli?style=for-the-badge" /> </p>

---

📡 YTS API Status

<p align="center"> <img src="https://img.shields.io/github/actions/workflow/status/eyeblech/cinecli/api-health.yml?label=YTS%20API&style=for-the-badge" alt="YTS API Status" /> </p> <p align="center"> <strong>Status is automatically monitored every 15 minutes.</strong><br/> _{🟢 Green = Operational &nbsp; • &nbsp; 🔴 Red = Outage / API Down} </p>

---

🎬 CineCLI

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

---

✨ Features

• 🔍 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

---

📦 Installation

pip install cinecli

Requires Python 3.11+

---

❄️ Nix / NixOS (flake support)

CineCLI includes first-class Nix flake support, so you can run it without installing Python or pip.

Run without installing (one-off)

nix run github:eyeblech/cinecli

Install to your profile

nix profile add github:eyeblech/cinecli

Then run:

cinecli

---

🧪 From source (developers)

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

---

🚀 Usage

🔎 Search for movies

cinecli search matrix

Displays matching movies with IDs:

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

---

🎬 Watch a movie

cinecli watch 3525

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)

cinecli interactive

• 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

---

🎞 Demo Video

Full terminal walkthrough:

https://github.com/user-attachments/assets/3e3df97f-d1e2-428f-a5a1-54cba121a2f8

---

🛠 Tech Stack

• Python

• Typer — CLI framework

• Rich — terminal UI

• Requests — API communication

• YTS API — movie data source

---

📄 License

MIT—see LICENSE.

Use it. Fork it. Improve it.

---

🙌 Author

Built by eyeblech
📧 0x1123@proton.me

---

STAR the repo if you like it! ⭐

⭐ Star History