Control Chromecast

# Chromecast Control

使用 `catt`（Cast All The Things）控制本地网络上的 Chromecast 和 Google Cast 设备。

## 快速参考

| 命令 | 描述 | |---------|-------------| | `catt scan` | 查找网络上的所有 Chromecast 设备 | | `catt cast <url>` | 投放视频/音频 | | `catt pause` / `play` | 暂停/恢复 | | `catt stop` | 停止播放 | | `catt status` | 当前播放信息 | | `catt volume <0-100>` | 设置音量 |

使用 `-d <device>` 按名称或 IP 定位特定设备。

## 发现与设备管理

```bash # Find all devices catt scan

# Set a default device (saves to config) catt -d "Living Room TV" set_default

# Create an alias for easier access catt -d 192.168.1.163 set_alias tv

# Remove alias or default catt -d tv del_alias catt del_default ```

## 投放媒体

### 基础投放 ```bash # Cast from URL (YouTube, Vimeo, and hundreds of yt-dlp supported sites) catt cast "https://www.youtube.com/watch?v=VIDEO_ID"

# Cast local file catt cast ./video.mp4

# Cast a website (displays webpage on TV) catt cast_site "https://example.com" ```

### 高级投放选项 ```bash # Cast with subtitles catt cast -s ./subtitles.srt ./video.mp4

# Start at specific timestamp catt cast -t 01:30:00 "https://youtube.com/watch?v=VIDEO_ID"

# Play random item from playlist catt cast -r "https://youtube.com/playlist?list=PLAYLIST_ID"

# Play only video (ignore playlist in URL) catt cast -n "https://youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID"

# Disable automatic subtitle loading catt cast --no-subs ./video.mp4

# Pass yt-dlp options (e.g., select format) catt cast -y format=best "https://youtube.com/watch?v=VIDEO_ID"

# Block until playback ends (useful for scripts) catt cast -b "https://example.com/video.mp4" ```

## 播放控制

```bash catt play # Resume playback catt pause # Pause playback catt play_toggle # Toggle play/pause catt stop # Stop playback completely catt skip # Skip to end of content

# Seeking catt seek 300 # Jump to 5 minutes (seconds) catt seek 01:30:00 # Jump to 1h 30m (HH:MM:SS) catt ffwd 30 # Fast forward 30 seconds catt rewind 30 # Rewind 30 seconds ```

## 音量控制

```bash catt volume 50 # Set volume to 50% catt volumeup 10 # Increase by 10 catt volumedown 10 # Decrease by 10 catt volumemute on # Mute catt volumemute off # Unmute ```

## 队列管理 (YouTube)

```bash # Add video to end of queue catt add "https://youtube.com/watch?v=VIDEO_ID"

# Add video to play next catt add -n "https://youtube.com/watch?v=VIDEO_ID"

# Remove video from queue catt remove "https://youtube.com/watch?v=VIDEO_ID"

# Clear entire queue catt clear ```

## 状态管理

```bash # Save current state (position, volume, what's playing) catt save

# Restore saved state later catt restore ```

## 设备信息

```bash catt status # Brief: time, volume, mute status catt info # Full: title, URL, player state, media type, etc. ```

## 配置

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

```ini [options] device = Living Room TV

[aliases] tv = Living Room TV bedroom = Bedroom Speaker ```

## 网络要求

- Chromecast 和计算机必须位于同一网络 - 对于本地文件投放：TCP 端口 45000-47000 必须开放 - 某些网络会阻止 mDNS —— 如果 `catt scan` 失败，请直接使用 IP 地址

## 支持的源

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