README.md

---

📡 YTS API Status

Status is automatically monitored every 15 minutes.
_{🟢 Green = Operational   •   🔴 Red = Outage / API Down}

---

🎬 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:

demo.mov

---

🛠 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