Hybirdss/smartest-tv

smartest-tv
The CLI your TV has been waiting for.
Play Netflix / Apple TV+ / YouTube / Spotify by name. Cast URLs. Multi-room audio. AI concierge. All from your terminal.
한국어 · 中文 · 日本語 · Español · Deutsch · Português · Français
pip install stv && stv play "Frieren"
No TV? Opens in your browser. Got a TV? stv setup to connect it.
---
😩 Without stv
😎 With stv
1. Pick up remote
2. Open Netflix app
3. Search for show
4. Pick the season
5. Pick the episode
6. Press play
**~30 seconds**
**~3 seconds**
> **No TV? No problem.** Without a TV configured, stv opens content directly in your browser.
> Netflix, YouTube, Spotify, Disney+ — just pip install stv and go.
---
🛋 Vibe-code and chill
Vibe-coding at 2am. Claude writes your code. You tell it to put on a show. It does.
Already installed stv? Just tell Claude:
Also available as an MCP server (21 tools) for Claude Code, Codex, Antigravity, and other MCP clients.
---
🎯 Just type stv
No subcommand? You get a Now Playing card and three contextual next-actions
based on your watch history — not a 30-command help dump.
Unknown input? You get a friendly hint, not an error.
---
🎨 A CLI that looks like a product
Every command renders with Catppuccin Mocha colors, semantic icons, and real
visual hierarchy. Prefer another palette? Set STV_THEME=nord or STV_THEME=gruvbox.
--format json is always available when you need to pipe to jq.
---
✨ What it does
🎬 Play by name
Say the name. stv finds the ID, opens the app, starts playback. Netflix and Apple TV+ resolve via HTML parsing. Disney+, Max, Prime, Hulu, Paramount+, Peacock, Crunchyroll, and every platform on JustWatch resolve via their API — no login, no API key. Skip the platform name and stv auto-detects where it's streaming in your region.
🔗 Cast any URL
Friend sends a link. Paste it. TV plays it.
🎵 Queue & party
Everyone adds their pick. TV plays in order.
🎭 Scene presets
One command sets the vibe.
🔊 Multi-room audio
Screens off. Music everywhere. **Free Sonos.**
📺 TV as display
Dashboards, clocks, signage. **$0/month.**
📊 Watch intelligence
Is your Netflix worth $18/month?
🌐 Sync party
Every TV. At once. Even remote friends.
🤖 AI concierge
21 MCP tools. One sentence is enough.
---
🤖 Tell your AI to control your TV
stv is an **MCP server**. Claude, GPT, Cursor, or any MCP client can control your TV with natural language.
**Setup (one line):**
Or via OpenClaw:
**Then just talk:**
All 21 MCP tools
| Category | Tool | What it does |
|----------|------|-------------|
| **Play** | tv_play | Search + play by name |
| | tv_cast | Cast any URL |
| | tv_next | Continue watching |
| | tv_launch | Launch app with ID |
| | tv_resolve | Get content ID only |
| **Discover** | tv_whats_on | Trending content |
| | tv_recommend | Personalized picks |
| **Control** | tv_power | On/off |
| | tv_volume | Get/set/step/mute |
| | tv_screen | Screen on/off |
| | tv_notify | Toast notification |
| | tv_status | Current state |
| **Organize** | tv_queue | Play queue |
| | tv_scene | Scene presets |
| | tv_history | Watch history |
| **Intelligence** | tv_insights | Viewing stats |
| | tv_display | TV as display |
| | tv_audio | Multi-room audio |
| **Multi-TV** | tv_sync | Play on all TVs |
| | tv_list_tvs | List TVs |
| | tv_groups | TV groups |
---
📅 A day with stv
| Time | What happens |
|------|-------------|
| **7am** | stv display dashboard "Weather:18°C" "Meeting:10am" on kitchen TV |
| **8am** | stv scene kids --tv kids-room -- Cocomelon, volume 15 |
| **12pm** | Friend sends Netflix link → stv cast |
| **5pm** | stv screen-time → kids watched 2h 15m today |