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

stv play netflix "Dark" s1e1

~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.

you: play frieren on the living room tv

claude: Playing Frieren s2e8 on Living Room. (3s)

you: bit quieter claude: Volume → 18.

you: good night claude: All 3 TVs off.

Already installed stv? Just tell Claude:

# Option 1 — just talk (zero config)

"run stv play netflix Frieren s2e8"

Option 2 — install the Skill for auto-trigger

clawhub install smartest-tv

now "play Frieren", "good night", "next episode" just work mid-session

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.

$ stv "play dark on netflix"     # natural language works

$ stv play "Frieren" # auto-detects platform $ stv next # continue last show $ stv stats # → insights

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

stv play netflix "Dark" s1e1

stv play disney "Percy Jackson" s1e1 stv play prime "The Boys" s1e1 stv play "Frieren" s2e8 # auto-detects platform

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](https://www.justwatch.com/) 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

stv cast https://youtu.be/dQw4w

stv cast https://netflix.com/watch/... stv cast https://open.spotify.com/...

Friend sends a link. Paste it. TV plays it.

🎵 Queue & party

stv queue add youtube "Gangnam Style"

stv queue add spotify "Blinding Lights" stv queue play

Everyone adds their pick. TV plays in order.

🎭 Scene presets

stv scene movie-night   # volume 20, cinema

stv scene kids # volume 15, Cocomelon stv scene sleep # rain sounds, auto-off

One command sets the vibe.

🔊 Multi-room audio

stv audio play "lo-fi beats"

stv audio volume kitchen 30 stv audio stop

Screens off. Music everywhere.<br>**Free Sonos.**

📺 TV as display

stv display message "Dinner!"

stv display clock stv display dashboard "Temp:22°C"

Dashboards, clocks, signage.<br>**$0/month.**

📊 Watch intelligence

stv insights

stv screen-time stv sub-value netflix --cost 17.99

Is your Netflix worth $18/month?

🌐 Sync party

stv --all play youtube "lo-fi beats"

stv --group party play netflix "Wed..." stv --all off # good night

Every TV. At once. Even remote friends.

🤖 AI concierge

"Play something chill"

→ tv_recommend → tv_play → Playing The Queen's Gambit

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):

{

"mcpServers": { "tv": { "command": "uvx", "args": ["stv"] } } }

Or via OpenClaw:

clawhub install smartest-tv

Then just talk:

You: "I just got home, set up movie night"

Claude: 🎬 Movie night activated. Volume → 20, cinema mode on.

Based on your history:

1. The Queen's Gambit (Netflix)
2. Ozark (Netflix)
3. Squid Game S2 (Netflix)

You: "Play 1, put a clock on kitchen TV"

Claude: ✓ Playing The Queen's Gambit ✓ Clock on kitchen TV

All 21 MCP tools

---

📅 A day with stv

---

🔥 Killer combos

🌙 Bedtime autopilot

stv audio play "rain" --rooms bedroom

stv scene sleep stv --all off

Ambient sound, screen off, auto-timer, every other TV killed.

🎧 Free Sonos

stv audio play "lo-fi beats"

stv audio volume kitchen 40 stv audio volume bedroom 15

Every TV is a speaker. Per-room volume. Screens off.

💰 Subscription audit

stv sub-value netflix --cost 17.99

→ $8.50/hr — consider canceling

stv sub-value youtube --cost 13.99

→ $1.20/hr — good value

10 more recipes →

---

▲ Click to watch the full demo

---

⚙️ How it works

  "Play Dark S1E1"

│ ▼ ┌─── Resolution ───┐ │ Cache → API → Web │ content_id │ 0.1s 1s 3s │──────────────▶ 📺 TV plays it └───────────────────┘ │ Deep link via LG / Samsung / Roku / Android

Say a name. stv resolves it to a content ID, deep-links into the app on your TV. No browser automation, no API keys, no cloud dependency. Results are cached so repeat plays are instant.

---

📦 Install

pip install stv                    # LG webOS (default)

pip install "stv[samsung]" # Samsung Tizen pip install "stv[android]" # Android TV / Fire TV pip install "stv[all]" # Everything

stv setup                          # auto-discover + pair your TV

Supports LG webOS · Samsung Tizen · Android TV / Fire TV · Roku

Home Assistant (HACS)

[](https://github.com/hac