claude-cast-local

▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃

 ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗       ██████╗ █████╗ ███████╗████████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝      ██╔════╝██╔══██╗██╔════╝╚══██╔══╝
██║     ██║     ███████║██║   ██║██║  ██║█████╗  █████╗██║     ███████║███████╗   ██║
██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝  ╚════╝██║     ██╔══██║╚════██║   ██║
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗      ╚██████╗██║  ██║███████║   ██║
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝       ╚═════╝╚═╝  ╚═╝╚══════╝   ╚═╝

▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃▁▃▅▇█▇▅▃▁▂▅▇▆▃

Setup

1. Install dependencies

brew install mpv streamlink tmux

2. Start a tmux session

claude-cast runs as a side pane in tmux. Start tmux first, then launch Claude Code inside it.

tmux new-session -s dev
claude

3. Install the plugin

/plugin install claude-cast

4. Start a stream

# Twitch — just the channel name
/claude-cast shroud

# Twitch — full URL works too
/claude-cast https://www.twitch.tv/swagg

# Kick
/claude-cast kick.com/myrongainesx

# YouTube
/claude-cast https://www.youtube.com/live/dQw4w9WgXcQ

# Force a platform
/claude-cast xqc kick

Audio plays. Chat scrolls. Code continues.

Features

Multi-Platform Streaming
Twitch, YouTube, and Kick. Auto-detects the platform from the channel name or URL. Powered by streamlink + mpv.

Live Chat
Real-time chat alongside your code. Twitch IRC (zero-config), YouTube Data API, and Kick WebSocket. Colored usernames and badges.

Three Layout Modes
Switch between compact, rich, and minimal layouts to match your workflow. Cycle with l or /claude-cast layout <mode>.

compact — max chat, minimal player chrome (default)
rich    — full player with volume bar and elapsed time
minimal — single-line player, maximum chat density

Non-Blocking Tmux Pane
Player opens as a side pane in your terminal via tmux. Your Claude Code session stays untouched. Auto-installs tmux if needed.

Full Keyboard Control
Control everything without leaving your terminal.

p — pause / play          m — mute / unmute
c — toggle chat           l — cycle layout
↑↓ — volume               q — hide player (audio continues)
Q — stop everything

Slash Command Control
Every action available as a Claude Code command for AI-assisted control.

Commands

/claude-cast <channel>        Start streaming (auto-detect platform)
/claude-cast pause            Pause audio
/claude-cast play             Resume audio
/claude-cast mute             Mute audio
/claude-cast unmute           Unmute audio
/claude-cast volume <0-100>   Set volume
/claude-cast hide-chat        Hide chat panel
/claude-cast show-chat        Show chat panel
/claude-cast hide-player      Close TUI (audio continues)
/claude-cast show-player      Open TUI
/claude-cast layout <mode>    Switch layout (compact|rich|minimal)
/claude-cast stop             Stop everything
/claude-cast status           Current state
/claude-cast:configure        API keys and preferences

Architecture

┌─ Terminal (tmux) ──────────────────────────────────────┐
│                                                        │
│  Claude Code             │  claude-cast TUI            │
│  (your work)             │  (player + chat)            │
│                          │                             │
│  > /claude-cast swagg    │  ▶ swagg  ▁▃▅▇█▇▅▃ Vol:75% │
│  Now streaming swagg...  │  user1: nice play!          │
│                          │  user2: GG                  │
│  > fixing bugs...        │  user3: lol                 │
│                          │                             │
└──────────────────────────┴─────────────────────────────┘
         │                          │
         │ MCP (stdio)              │ file-based IPC
         ▼                          │
    stream-server ◄─────────────────┘
      │       │
      ▼       ▼
    mpv    chat (IRC/WS/API)

Tech Stack

Project Structure