Claude Cast

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

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

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

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

claude-cast/
├── packages/
│   ├── stream-server/    MCP server, player engine, chat engines
│   ├── stream-tui/       Blessed TUI with layouts and widgets
│   └── shared/           Types, IPC protocol, platform detection
├── skills/               Slash command definitions
├── hooks/                Session lifecycle hooks
└── scripts/              Dependency checks, tmux install

Requirements

Supported on macOS and Linux.

Configuration

Run /claude-cast:configure to set:

Config stored at ~/.claude/channels/claude-cast/config.json.

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

Development setup:

git clone https://github.com/kvreem/claude-cast
cd claude-cast
bun install
bun run dev

Before submitting:

bun run typecheck    # Type checking
bun run lint         # Linting
bun test             # Run tests

Repository Activity

License

MIT License

Copyright (c) 2026 claude-cast contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.