home / media / catt

catt

3.6k

Chromecast control CLI for discovering devices, casting online or local media or web pages, and managing playback.

$pipx install catt
Language
Python
Stars
3,633
Category
Media & Video
Agent
Ready
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 -j and info -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.