名称： chromecast
描述： 控制局域网内的 Chromecast 设备——发现设备、投屏媒体、控制播放、管理队列以及保存/恢复状态
主页： https://github.com/skorokithakis/catt
元数据： {"clawdbot":{"emoji":"📺","requires":{"bins":["catt"]},"install":[{"id":"pip","kind":"uv","package":"catt","bins":["catt"],"label":"通过 pip/uv 安装"}]}}

Chromecast 控制

使用 catt（Cast All The Things）控制局域网内的 Chromecast 及支持 Google Cast 的设备。

快速参考

使用 -d <device> 参数可按名称或 IP 指定目标设备。

设备发现与管理

# 查找所有设备
catt scan

# 设置默认设备（保存到配置）
catt -d "客厅电视" set_default

# 创建别名以便快速访问
catt -d 192.168.1.163 set_alias tv

# 删除别名或默认设备
catt -d tv del_alias
catt del_default

媒体投屏

基础投屏

# 从 URL 投屏（支持 YouTube、Vimeo 及数百个 yt-dlp 兼容的网站）
catt cast "https://www.youtube.com/watch?v=视频ID"

# 投屏本地文件
catt cast ./视频.mp4

# 投屏网页（在电视上显示网页）
catt cast_site "https://example.com"

高级投屏选项

# 投屏并加载字幕
catt cast -s ./字幕.srt ./视频.mp4

# 从指定时间点开始播放
catt cast -t 01:30:00 "https://youtube.com/watch?v=视频ID"

# 随机播放播放列表中的项目
catt cast -r "https://youtube.com/playlist?list=播放列表ID"

# 仅播放视频（忽略 URL 中的播放列表）
catt cast -n "https://youtube.com/watch?v=视频ID&list=播放列表ID"

# 禁用自动加载字幕
catt cast --no-subs ./视频.mp4

# 传递 yt-dlp 选项（例如选择格式）
catt cast -y format=best "https://youtube.com/watch?v=视频ID"

# 阻塞直到播放结束（适用于脚本）
catt cast -b "https://example.com/video.mp4"

播放控制

catt play              # 恢复播放
catt pause             # 暂停播放
catt play_toggle       # 切换播放/暂停
catt stop              # 完全停止播放
catt skip              # 跳转到内容末尾

# 跳转
catt seek 300          # 跳转到 5 分钟处（单位：秒）
catt seek 01:30:00     # 跳转到 1 小时 30 分钟处（格式：HH:MM:SS）
catt ffwd 30           # 快进 30 秒
catt rewind 30         # 快退 30 秒

音量控制

catt volume 50         # 设置音量为 50%
catt volumeup 10       # 音量增加 10
catt volumedown 10     # 音量减少 10
catt volumemute on     # 静音
catt volumemute off    # 取消静音

队列管理（YouTube）

# 将视频添加到队列末尾
catt add "https://youtube.com/watch?v=视频ID"

# 将视频添加到下一首播放
catt add -n "https://youtube.com/watch?v=视频ID"

# 从队列中移除视频
catt remove "https://youtube.com/watch?v=视频ID"

# 清空整个队列
catt clear

状态管理

# 保存当前状态（播放位置、音量、正在播放的内容）
catt save

# 稍后恢复已保存的状态
catt restore

设备信息

catt status    # 简要信息：时间、音量、静音状态
catt info      # 完整信息：标题、URL、播放器状态、媒体类型等

配置

配置文件：~/.config/catt/catt.cfg

[options]
device = 客厅电视

[aliases]
tv = 客厅电视
bedroom = 卧室音箱

网络要求

• Chromecast 与电脑必须在同一网络
• 投屏本地文件时：TCP 端口 45000-47000 必须开放
• 部分网络会屏蔽 mDNS——若 catt scan 失败，请直接使用 IP 地址

支持的来源

Catt 内部使用 yt-dlp，支持：
- YouTube（视频、播放列表、直播流）
- Vimeo、Dailymotion、Twitch
- 直接视频 URL（MP4、MKV、WebM 等）
- 本地文件（视频、音频、图片）
- 数百个其他网站（详见 yt-dlp 支持的网站列表）