名称： tautulli
描述： 通过 Tautulli API 监控 Plex 活动与统计数据。查看谁正在观看、浏览历史记录、获取媒体库统计信息以及查看服务器状态。
元数据：
openclaw:
emoji: 📊
requires:
bins:
- curl
- jq
env:
- TAUTULLI_URL
- TAUTULLI_API_KEY

Tautulli

通过 Tautulli API 监控 Plex Media Server 的活动。

环境配置

设置以下环境变量：
- TAUTULLI_URL – Tautulli 实例的 URL（例如：http://192.168.1.100:8181）
- TAUTULLI_API_KEY – 在 Tautulli 的“设置” → “Web 界面” → “API 密钥”中获取

命令列表

当前活动

bash {baseDir}/scripts/activity.sh

显示当前活跃的流媒体会话，包括用户、标题、播放进度、画质和播放器信息。

观看历史

bash {baseDir}/scripts/history.sh [limit]

默认显示最近 10 条记录。可通过参数指定显示数量。

媒体库统计

bash {baseDir}/scripts/libraries.sh

列出所有媒体库分区及其包含的项目数量。

最近添加

bash {baseDir}/scripts/recent.sh [limit]

显示最近添加的媒体内容。默认显示 10 项。

用户统计

bash {baseDir}/scripts/users.sh

列出所有用户，显示其总观看时长和最后在线时间。

服务器信息

bash {baseDir}/scripts/server.sh

显示 Plex 服务器名称、版本、运行平台及连接状态。

API 参考

所有 Tautulli API 调用均使用以下基础格式：

$TAUTULLI_URL/api/v2?apikey=$TAUTULLI_API_KEY&cmd=<command>

常用命令包括：get_activity、get_history、get_libraries、get_recently_added、get_users、get_server_info。