Stream Together. Right From Your Terminal.
Streamix is a terminal-first streaming and watch party platform. Host synchronized watch sessions with friends complete with real-time voice chat, text messaging, and admin moderation — or go solo and binge on your own. Everything runs from your terminal across Windows, macOS, and Linux.
| Solo | Watch Party | |
|---|---|---|
| Stream content | Browse, search, and play instantly | Host syncs playback for everyone |
| Voice chat | — | Built-in voice with noise gate |
| Text chat | — | Full chat with notifications |
| Moderation | — | Mute, deafen, kick, ban by Hash-ID |
| Auto-play | Sequential episode playback | Synced auto-play across all clients |
| Discord RPC | Shows what you're watching | Shows party info and member count |
- Real-Time Voice Chat — 24kHz audio with noise gate, loopback testing, and per-user volume controls
- Synchronized Playback — When the host plays, pauses, or seeks, every client follows via mpv IPC
- Moderation Tools — Hash-ID based muting, deafening, kicking, and banning that survives name changes
- Global & Local Controls — Admins manage the room; participants tune their own experience
- Secure Tunneling — Sessions are hosted via ngrok with automatic link generation and clipboard copy
- Instant Search — Find any series by title or browse trending/seasonal content
- Sequential Auto-Play — Episodes play back-to-back without touching the keyboard
- Watch History — Tracks progress and resume-points automatically
- Character & Recommendation Browser — Explore cast info and discover similar series
- Cross-Platform — Windows, macOS, and Linux with OS-specific dependency detection
- Startup Health Check — Animated dependency checker validates uv, mpv, and ngrok on launch
- Discord Rich Presence — Shows real-time status with smart rate-limited updates
- Premium TUI — Clean, keyboard-driven interface powered by Rich and Questionary
- Clone the repository.
git clone https://github.com/VibhasDutta/streamix.git
cd streamix- Install the Python dependencies with
uv.
uv sync- Install and verify
mpvandngrokfor your operating system using the links above.
Linux voice chat dependency (required for Watch Party voice):
sudo apt install libportaudio2 portaudio19-dev- Add your ngrok auth token before starting a watch party.
ngrok config add-authtoken YOUR_TOKEN_HEREGet your authtoken from the ngrok dashboard.
uv run src/main.pyChoose Solo to watch alone or Party to host/join a watch session.
| Key | Action |
|---|---|
Ctrl+K |
Toggle microphone mute |
Ctrl+T |
Toggle speaker deafen |
Ctrl+N |
Toggle notification sounds |
Page Up / Down |
Scroll chat history |
Note
Standalone executables are in progress for:
- Windows (.exe)
- macOS (.app / Homebrew)
- Linux (.deb / AppImage)
Stay tuned for v1.1.0!
- Miruro-API — Anime metadata backend
- ani-cli — Terminal workflow inspiration
MIT License. Built with love by Vibhas Dutta & Abhinav.