CineCLI 是一个用 Python 编写的跨平台命令行工具,让你直接在终端中搜索、浏览电影,并一键启动下载。它专注 YTS 平台的资源,界面干净、操作高效,适合喜欢用键盘、厌恶图形干扰的用户。

核心功能
- 从 YTS 搜索电影:输入关键词,快速列出匹配结果。
- 查看详细信息:包括年份、评分、简介、画质选项等。
- 自动选最优种子:优先选择高画质(如 1080p/2160p)且做种健康的 torrent。
- 一键启动下载:点击即用磁力链接(magnet)唤醒你系统默认的种子客户端(如 qBittorrent、Transmission)。
- 也可下载 .torrent 文件:适合需要手动管理的场景。
- 跨平台支持:Windows、macOS、Linux 全兼容。
- 优雅终端界面:基于
rich库,信息层次清晰,视觉清爽。 - 默认智能,但不强制:自动选择可被随时手动覆盖,确保控制权在你手中。
安装方式
1. 通过 pip(需 Python 3.11+)
pip install cinecli
2. 通过 Nix(无需预装 Python)
CineCLI 提供完整的 Nix flake 支持:
- 临时运行(不安装):
nix run github:eyeblech/cinecli - 永久安装:
nix profile add github:eyeblech/cinecli安装后直接运行cinecli。
3. 从源码安装(适合开发者)
git clone https://github.com/eyeblech/cinecli.git
cd cinecli
pip install -e .
基本用法
搜索电影
cinecli search matrix
输出示例:
ID Title Year Rating
3525 The Matrix 1999 8.7
3526 The Matrix Reloaded 2003 7.2
观看并下载某部电影
cinecli watch 3525
执行流程:
- 显示电影详情(简介、时长、IMDb 评分等)
- 列出所有可用 torrent
- 自动高亮推荐选项(最高画质 + 最多活跃做种)
- 确认后,自动调用系统默认磁力链接处理器(即你的种子客户端)
⚠️ 安全设计:所有操作都需用户确认,不会静默启动下载。
交互模式(推荐探索时使用)
cinecli interactive
进入交互式菜单:搜索 → 选择电影 → 选择种子 → 启动下载。全程键盘操作,无需离开终端。
技术细节:磁力链接如何工作?
CineCLI 不内置下载器,而是将磁力链接交给操作系统处理。这意味着:
- 只要你的系统已设置默认 torrent 客户端(如 Windows 上的 qBittorrent,macOS 上的 Transmission),CineCLI 会自动调起它。
- 无需配置额外路径或 API。
你可以在 Linux 上通过以下命令查看当前默认处理器:
xdg-mime query default x-scheme-handler/magnet











评论