media-cli — 远程终端控制您的 *arr 媒体栈

一个 Bash 脚本，即可从远程机器全面管理您的媒体自动化栈。无需打开网页界面，即可搜索、添加、下载及监控电影与电视剧。

专为 AI 代理运行在与媒体服务不同主机的场景设计（例如：运行 OpenClaw 的 VPS 管理家庭服务器上的 *arr 栈）。若所有服务均运行在同一台机器上，请改用 media-cli-local。

源码地址： https://github.com/solomonneas/media-cli

安装方式： 克隆仓库并运行安装脚本，或手动将 media 文件复制到您的 PATH 中。详见 GitHub 仓库中的 README 文档。

支持的服务

配置流程

# 安装（请先克隆并审阅脚本）
git clone https://github.com/solomonneas/media-cli.git
cd media-cli
bash install.sh

# 配置（交互式向导）
media setup

# 测试
media status

配置向导将引导您输入各服务的 API URL 与密钥，并保存至 ~/.config/media-cli/config（权限设为 600）。

命令列表

电影

media movies search "Interstellar"    # 在线搜索
media movies add "Interstellar"       # 添加并立即开始下载
media movies list                     # 显示媒体库及下载状态
media movies missing                  # 已监控但尚未下载完成的影片
media movies remove "title"           # 移除条目（保留本地文件）

电视剧

media shows search "Breaking Bad"     # 在线搜索
media shows add "Breaking Bad"        # 添加并自动搜索剧集
media shows list                      # 显示媒体库及已入库剧集数

下载任务

media downloads                       # 按状态列出全部种子任务
media downloads active                # 列出活跃任务（含速度与预计完成时间）
media downloads pause 
media downloads resume 
media downloads remove  [true]  # 删除任务；传入 true 则同时删除关联文件

状态与监控

media status                          # 健康状态 + 媒体库统计 + 当前活跃下载
media queue                           # Sonarr / Radarr 下载队列
media wanted                          # 缺失的剧集与电影
media calendar 14                     # 即将发布内容（未来 N 天内）
media history                         # 最近操作记录
media refresh                         # 触发媒体库重新扫描
media indexers                        # Prowlarr 索引器状态

字幕（Bazarr）

media subs                            # 待获取的字幕列表
media subs history                    # 最近下载的字幕记录

用户请求（Jellyseerr）

media requests                        # 待处理的用户请求
media requests trending               # 当前热门请求
media requests users                  # 用户列表及其请求次数统计

转码（Tdarr）

media tdarr                           # Tdarr 总体状态 + 当前活跃工作进程
media tdarr workers                   # 每个待转码文件的进度：完成百分比、帧率、预计完成时间
media tdarr queue                     # 已排队等待处理的任务列表

连接模式

本地模式（所有服务运行在同一台机器）

MEDIA_HOST="local"

SSH 远程模式（服务运行在另一台主机）

MEDIA_HOST="ssh:hyperv-host"       # 使用 SSH 配置别名
MEDIA_HOST_OS="linux"          # 或设为 "windows"

SSH 模式通过您已有的 SSH 配置对全部 API 请求进行隧道转发。所有服务仍绑定在远端主机的 localhost 上，不会暴露于网络中。除常规 SSH 访问权限外，无需额外开放端口或提供其他凭证。Windows 主机会自动使用 PowerShell 的 Invoke-RestMethod 执行 POST 请求。

AI 代理集成

所有命令均面向 AI 代理解析做了优化设计。任何支持执行 Shell 命令的工具均可直接调用：

"我有哪些剧集尚未下载？"         →  media wanted
"添加《继承之战》"              →  media shows add "Succession"
"当前正在下载什么？"           →  media downloads active
"暂停所有下载任务"             →  media downloads pause all

兼容 OpenClaw、LangChain、Claude 的计算机使用能力（computer use），或任意支持 Shell 执行的 AI 代理框架。

系统要求

• bash 4.0+
• curl
• python3（仅依赖标准库，无需 pip）
• ssh（仅远程模式需要）

技术细节

• 单个 Bash 脚本（约 900 行）
• 对接 *arr v3 API（Sonarr/Radarr）、v1（Prowlarr）、v2（qBittorrent WebUI）
• Python3 仅用于 JSON 解析（严格使用标准库）
• 无遥测、无分析、除调用您自有服务外不发起任何外部网络请求
• 配置文件存储于 ~/.config/media-cli/config，权限设为 600