Castor is a CLI tool that extracts video streams from websites and casts them to TVs in real time, with optional auto-generated subtitles burned into the video. It launches a headless Chrome instance with stealth scripts to capture streams via Chrome DevTools Protocol, handling format compatibility through ffmpeg transcoding. Run `castor cast` to browse trending titles via TMDB integration, search, inspect metadata, and cast directly from the terminal.

Installation options include Homebrew on macOS, a Docker image bundling Chrome, ffmpeg, and ffprobe, or building from source with Go 1.26+ and cmake for whisper.cpp bindings. The tool supports DLNA/UPnP Media Renderer devices — virtually every smart TV from the last decade including Samsung, LG, Sony, Panasonic, Philips, Hisense, TCL, VIZIO, and Sharp. Networked players like Kodi, VLC, and Plex also work. Chromecast support is experimental.

Configuration requires a config.yaml specifying the target device name from `castor scan`, streaming sources with URL templates, and a free TMDB API key. Auto-generated subtitles via whisper.cpp (ggml-tiny.en, ~75 MB) are opt-in. Run `castor cast` for the interactive TMDB browser, `castor cast player <URL>` for direct site casting, or `castor cast movie <IMDB_ID>` using configured sources.