chromecast-with-google-tv

# Chromecast with Google TV control

Use this skill when I ask to cast YouTube or Tubi video content, play or pause Chromecast media playback, check if the Chromecast is online, launch episodic content in another streaming app via global search fallback, or pair with a Chromecast device for the first time.

## Setup

This skill runs with `uv`, `adb`, `yt-api`, and `scrcpy` in the PATH. No venv required.

- Ensure `uv`, `adb`, `yt-api`, and `scrcpy` are available in the PATH.
- Use `./run` as a convenience wrapper around `uv run google_tv_skill.py`.

### First-time pairing

Before using this skill, you must pair your Chromecast with ADB wireless debugging:

1. Enable Developer Options on the Chromecast (Settings > System > About > tap "Android TV OS build" 7 times)
2. Enable USB debugging and Wireless debugging in Developer options
3. Use the `pair` command to pair with the pairing code shown on screen:
   - `./run pair --show-instructions` - Display detailed pairing instructions
   - `./run pair --pairing-ip <IP> --pairing-port <PORT> --pairing-code <CODE>` - Perform pairing

After pairing once, you can use the connection port shown on the Wireless debugging screen for all other commands.

## Capabilities

This skill provides a small CLI wrapper around ADB to control a Google TV device. It exposes the following subcommands:

- pair: pair with Chromecast using wireless debugging (first-time setup)
- status: show adb devices output
- play <query_or_id_or_url>: play content via YouTube, Tubi, or global-search fallback.
- pause: send media pause
- resume: send media play

### Usage examples

`./run pair --show-instructions`

`./run pair --pairing-ip 192.168.1.100 --pairing-port 12345 --pairing-code 123456`

`./run status --device 192.168.4.64 --port 5555`

`./run play "7m714Ls29ZA" --device 192.168.4.64 --port 5555`

`./run play "family guy" --app hulu --season 3 --episode 4 --device 192.168.4.64 --port 5555`

`./run pause --device 192.168.4.64 --port 5555`

### Device...

# Chromecast with Google TV Skill

CLI tooling for controlling a Chromecast with Google TV over ADB. It plays YouTube or Tubi directly, and falls back to Google TV global search for other streaming apps.

## Requirements

- macOS/Linux host with `adb`, `scrcpy`, `yt-api`, and `uv` in your PATH
- Python 3.11+
- Chromecast with Google TV with Developer Options enabled and Wireless Debugging paired

## Setup

Before you can use this skill, you need to pair your Chromecast with ADB wireless debugging:

### First-time setup: Enable Wireless Debugging and Pair

1. **Enable Developer Options** on your Chromecast:
   - Navigate to Settings > System > About
   - Scroll down to "Android TV OS build"
   - Press SELECT on the build number 7 times
   - You'll see "You are now a developer!" message

2. **Enable USB Debugging and Wireless Debugging**:
   - Go back to Settings > System > Developer options
   - Turn ON "USB debugging"
   - Turn ON "Wireless debugging"

3. **Pair with pairing code**:
   - In Wireless debugging menu, select "Pair device with pairing code"
   - A dialog will show IP address, port, and a 6-digit pairing code
   - Use the `pair` command with these values:
   ```bash
   ./run pair --pairing-ip 192.168.1.100 --pairing-port 12345 --pairing-code 123456
   ```

4. **Get the connection port**:
   - After successful pairing, press BACK on the Chromecast remote
   - You'll see the Wireless debugging screen with IP address and port
   - Use these values for all other commands

**Note**: Pairing only needs to be done once. After pairing, you can connect directly using the device IP and connection port.

## Quick start

```bash
# Show pairing instructions
./run pair --show-instructions

# Pair with device (first time only)
./run pair --pairing-ip 192.168.1.100 --pairing-port 12345 --pairing-code 123456

# Once paired, use other commands
./run status --device 192.168.4.64 --port 5555
./run play "7m714Ls29ZA" --device 192.168.4.64 --port 5555
./run play "family guy"...