名称： appletv
版本： 1.0.0
描述： 通过 pyatv 控制 Apple TV。支持播放/暂停、导航、音量调节、启动应用、电源控制以及查看当前播放内容。触发词包括："Apple TV"、"TV"、"what's playing"、"pause TV"、"play TV"、"turn off TV"。
许可证： MIT

Apple TV 控制

通过 pyatv 库控制 Apple TV。

环境要求

pipx install pyatv --python python3.11

注意： pyatv 要求 Python 版本 ≤3.13。Python 3.14+ 存在不兼容的 asyncio 变更。请使用 pipx 时指定 --python python3.11 或 python3.13。

配置

配置文件位于 ~/clawd/config/appletv.json：

{
  "name": "客厅",
  "id": "设备_ID",
  "ip": "192.168.x.x",
  "credentials": {
    "companion": "...",
    "airplay": "..."
  }
}

首次配对

# 查找您的 Apple TV
atvremote scan

# 配对 Companion 协议（必需）
atvremote --id <设备_ID> --protocol companion pair

# 配对 AirPlay 协议（用于媒体控制）
atvremote --id <设备_ID> --protocol airplay pair

将获取到的凭据保存到配置文件中。

快捷命令

状态与播放信息

scripts/appletv.py status     # 完整状态，包含当前播放内容
scripts/appletv.py playing    # 当前正在播放的内容

播放控制

scripts/appletv.py play       # 播放/恢复播放
scripts/appletv.py pause      # 暂停
scripts/appletv.py stop       # 停止
scripts/appletv.py next       # 下一曲/下一章节
scripts/appletv.py prev       # 上一曲/上一章节

导航控制

scripts/appletv.py up         # 向上导航
scripts/appletv.py down       # 向下导航
scripts/appletv.py left       # 向左导航
scripts/appletv.py right      # 向右导航
scripts/appletv.py select     # 选择/确认
scripts/appletv.py menu       # 菜单按钮
scripts/appletv.py home       # 返回主屏幕

音量控制

scripts/appletv.py volume_up   # 增大音量
scripts/appletv.py volume_down # 减小音量

电源控制

scripts/appletv.py turn_on    # 唤醒
scripts/appletv.py turn_off   # 进入睡眠
scripts/appletv.py power      # 切换电源状态

应用管理

scripts/appletv.py apps       # 列出已安装应用
scripts/appletv.py app Netflix
scripts/appletv.py app YouTube
scripts/appletv.py app "Disney+"

设备发现

scripts/appletv.py scan       # 扫描网络中的 Apple TV

使用示例

• "电视上在播什么？" → scripts/appletv.py status
• "暂停电视" → scripts/appletv.py pause
• "关闭 Apple TV" → scripts/appletv.py turn_off
• "在电视上打开 Netflix" → scripts/appletv.py app Netflix