castlocal

Stream any local video to Chromecast — from your terminal.

$ pipx install castlocal

Any Format

MKV, AVI, MOV, WMV, FLV — automatically transcodes to H.264 with hardware acceleration.

Instant Playback

HLS streaming starts playing in seconds. No waiting for full transcode.

Retro TUI

Far Manager-style dual-pane interface. Browse files, pick device, cast. All keyboard.

CLI Too

Just cast movie.mkv. Auto-discovers devices. Full playback controls.

Quick Start

# Install
pipx install castlocal
brew install ffmpeg  # if you don't have it

# Cast a file
cast movie.mkv

# Or use the TUI
cast-tui

How It Works

1. Discovers Chromecast devices on your network (mDNS)
2. Probes the video — if MP4/H.264, streams directly
3. Otherwise, transcodes to H.264+AAC via ffmpeg (HW accelerated)
4. Serves HLS segments over HTTP as they encode
5. Casts to device with full playback controls