media-cli-local — Terminal Control for Your *arr Media Stack
One bash script to manage your entire media automation stack. Search, add, download, and monitor movies and TV shows without touching a web UI.
Designed for setups where the agent and media services run on the same machine. If your *arr stack runs on a different host, see media-cli which includes SSH remote support.
Source: https://github.com/solomonneas/media-cli
Install: Clone the repo and copy the script to your PATH. Review it first.
CODEBLOCK0
Supported Services
| Service | Required | What It Does |
|---|
| Sonarr | Yes | TV show management |
| Radarr |
Yes | Movie management |
| Prowlarr | Yes | Indexer management |
| qBittorrent | Yes | Download monitoring |
| Bazarr | Optional | Subtitles |
| Jellyseerr | Optional | User requests + trending |
| Tdarr | Optional | Transcode monitoring |
Setup
The setup wizard asks for API URLs and keys, saves to ~/.config/media-cli/config (chmod 600). All connections are localhost only.
CODEBLOCK1
Commands
Movies
CODEBLOCK2
TV Shows
CODEBLOCK3
Downloads
CODEBLOCK4
Status & Monitoring
CODEBLOCK5
Subtitles (Bazarr)
CODEBLOCK6
Requests (Jellyseerr)
CODEBLOCK7
Transcoding (Tdarr)
CODEBLOCK8
AI Agent Integration
Commands output clean, parseable text designed for AI agents:
CODEBLOCK9
Works with OpenClaw, LangChain, Claude computer use, or any agent framework with shell execution.
Requirements
- - bash 4.0+
- curl
- python3 (standard library only, no pip)
Technical Details
- - Single bash script (~900 lines)
- All API calls go to localhost (no remote connections)
- Talks to *arr v3 APIs (Sonarr/Radarr), v1 (Prowlarr), v2 (qBittorrent WebUI)
- Python3 used strictly for JSON parsing (standard library)
- No telemetry, no analytics, no network calls except to your own services
- Config stored at
~/.config/media-cli/config with chmod 600
media-cli-local — 终端控制你的*arr媒体栈
一个bash脚本即可管理你的整个媒体自动化栈。无需触碰网页界面即可搜索、添加、下载和监控电影与电视剧。
专为代理和媒体服务运行在同一台机器上的环境设计。如果你的*arr栈运行在其他主机上,请参阅包含SSH远程支持的media-cli。
来源: https://github.com/solomonneas/media-cli
安装: 克隆仓库并将脚本复制到你的PATH路径。请先审查脚本内容。
bash
git clone https://github.com/solomonneas/media-cli.git
cd media-cli
cp media ~/bin/media && chmod +x ~/bin/media
media setup
支持的服务
是 | 电影管理 |
| Prowlarr | 是 | 索引器管理 |
| qBittorrent | 是 | 下载监控 |
| Bazarr | 可选 | 字幕 |
| Jellyseerr | 可选 | 用户请求 + 热门趋势 |
| Tdarr | 可选 | 转码监控 |
设置
设置向导会询问API URL和密钥,并保存到~/.config/media-cli/config(权限为chmod 600)。所有连接仅限于本地主机。
bash
media setup # 交互式配置向导
media status # 验证所有连接是否正常
命令
电影
bash
media movies search 星际穿越 # 在线搜索
media movies add 星际穿越 # 添加 + 开始下载
media movies list # 显示库及下载状态
media movies missing # 已监控但无文件的电影
media movies remove 片名 # 移除(保留文件)
电视剧
bash
media shows search 绝命毒师 # 在线搜索
media shows add 绝命毒师 # 添加 + 搜索剧集
media shows list # 显示库及剧集数量
下载
bash
media downloads # 按状态显示所有种子
media downloads active # 显示活跃下载(速度+预计完成时间)
media downloads pause <哈希|all>
media downloads resume <哈希|all>
media downloads remove <哈希> [true] # true = 同时删除文件
状态与监控
bash
media status # 健康状态 + 库数量 + 活跃下载
media queue # Sonarr/Radarr下载队列
media wanted # 缺失剧集 + 电影
media calendar 14 # 即将发布的内容(未来N天)
media history # 最近活动
media refresh # 触发库重新扫描
media indexers # Prowlarr索引器状态
字幕(Bazarr)
bash
media subs # 需要的字幕
media subs history # 最近下载的字幕
请求(Jellyseerr)
bash
media requests # 待处理的用户请求
media requests trending # 热门趋势
media requests users # 用户列表及请求数量
转码(Tdarr)
bash
media tdarr # 状态 + 活跃工作进程
media tdarr workers # 每个文件的进度:百分比、帧率、预计完成时间
media tdarr queue # 排队等待处理的项目
AI代理集成
命令输出清晰、可解析的文本,专为AI代理设计:
我有哪些剧集缺失? → media wanted
添加继承之战 → media shows add 继承之战
当前正在下载什么? → media downloads active
暂停所有下载 → media downloads pause all
兼容OpenClaw、LangChain、Claude计算机使用或任何支持shell执行的代理框架。
系统要求
- - bash 4.0+
- curl
- python3(仅使用标准库,无需pip)
技术细节
- - 单个bash脚本(约900行)
- 所有API调用均指向本地主机(无远程连接)
- 与*arr v3 API(Sonarr/Radarr)、v1(Prowlarr)、v2(qBittorrent WebUI)通信
- Python3严格用于JSON解析(标准库)
- 无遥测、无分析、除你自己的服务外无任何网络调用
- 配置文件存储在~/.config/media-cli/config,权限为chmod 600