SuperAPI AI 工具集

pp-plexctl

编程与开发

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能驱动 plexctl-pp-cli 二进制,用于访问 Plex 媒体服务器 API。资料未说明具体子命令,仅描述其依赖的 API 能力。

安装与验证:需先确认 CLI 已安装。可通过 Printing Press 安装器安装:npx -y @mvanhorn/printing-press-library install plexctl --cli-only。macOS/Linux 默认装到 $HOME/.local/bin,Windows 装到 %LOCALAPPDATA%\Programs\PrintingPress\bin。验证命令为 plexctl-pp-cli --version,并确保安装目录在 $PATH 中。若 npx 安装失败(无 Node、离线等),可回退用 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/plexctl/cmd/plexctl-pp-cli@latest,该方式装入 $GOPATH/bin(默认 $HOME/go/bin)。

主要能力:API 同时支持 XML 和 JSON,默认 XML,需 JSON 时显式请求 Accept: application/json。支持 X-Plex-{name} 自定义请求头(如 X-Plex-Client-Identifier、X-Plex-Token),这些头也可作为查询参数传递。多数端点需令牌认证,令牌来自 plex.tv。支持基于 key 的相对路径解析、type/subtype 元数据类型、source URI、分页(X-Plex-Container-Start、X-Plex-Container-Size 等头部或 limit 参数)以及响应裁剪(includeFields/excludeFields、includeElements/excludeElements、includeOptionalFields 等)。

适用场景:需要以命令行方式操作 Plex 媒体服务器的新应用或自动化脚本。

限制:资料未给出各具体命令、计费或价格信息;若 --version 报“command not found”,说明运行环境未识别二进制目录,验证成功前不应继续执行技能命令。