Chromecast control CLI for discovering devices, casting online or local media or web pages, and managing playback.
$pipx install catt
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
catt is a Chromecast control CLI for discovering devices on your local network, launching media on them, and sending playback commands from the shell. It covers both one-off casting and ongoing control of TVs, speakers, and speaker groups that expose the Chromecast protocol.
What It Enables
- Discover Chromecast devices on the local network and inspect their IPs, model metadata, and current playback details.
- Cast supported online videos, direct media URLs, local audio, video, or image files, subtitles, or arbitrary web pages to Chromecast targets.
- Pause, resume, seek, adjust volume, manage YouTube queues, and save or restore playback state from scripts.
Agent Fit
- Most commands are direct and non-interactive, so agents can use it as a simple control surface once a target device is known.
- Machine-readable output exists for device scans and playback info via
scan -jandinfo -j, but the rest of the command surface is mostly plain text. - Best suited to local media, signage, or home automation loops rather than broad service automation, because everything depends on LAN-reachable Chromecast hardware.
Caveats
- Discovery and control only work when the calling machine can reach the Chromecast on the local network.
- Casting local files starts a temporary local HTTP server, so firewall rules and the documented TCP port range 45000-47000 matter.