Without a TV configured, stv opens content directly in your browser.
Netflix, YouTube, Spotify, Disney+ — just and go.
📺 Control any smart TV with natural language. Play Netflix by name from your terminal. PyPI: stv · MCP server · LG/Samsung/Roku/Android
TV_PLATFORM, TV_IP, TV_MAC
ตรวจสอบล่าสุด
2026-11-14
ดาว
59
เครื่องมือ
—
อัปไทม์
—
No TV? No problem.
pip install stv
🛋 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 resolve via their API — no login, no API key. Skip the platform name and stv auto-detects where it's streaming in your region.
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
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 <url>
5pm
stv screen-time → kids watched 2h 15m today
6:30pm
stv scene movie-night -- volume 20, cinema mode
7pm
stv recommend --mood chill → suggests Ozark
9pm
stv audio play "friday vibes" -p spotify -- music everywhere
10pm
stv --group party play netflix "Wednesday" s1e1 -- sync
11:30pm
stv scene sleep → stv --all off -- good night
🔥 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.
"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)
Add as a custom repository (default listing in review: hacs/default#6907):
Android TV / Fire TV: the setup flow shows a 6-digit PIN on the TV —
enter it in the pairing form to finish. In HA OS / HA Container set
STV_CONFIG_DIR=/config/smartest-tv so pairing survives container
rebuilds. See docs/integrations/home-assistant.md.
This does what HA's built-in media_player.play_media can't: resolve a show by name and deep-link into the streaming app. Power, volume, and playback controls also work as standard HA media player entities.
🔌 Works with
Integration
How
Home Assistant
HACS custom integration → media_player.play_media with content resolution
Every line of stv is on GitHub — the CLI, resolvers (Netflix, Apple TV+, YouTube, Spotify, Disney+, Max, Prime Video, Paramount+, Hulu, Peacock, Crunchyroll, and more via JustWatch), all 4 TV drivers (LG, Samsung, Roku, Android), cache, sync engine, scenes, and all 253 tests. Streaming availability data powered by JustWatch.
🔒 Privacy
stv runs on your local network. No telemetry, no analytics, no cloud
sync, no phoning home about what you watch. There is no posthog, no
amplitude, no sentry, no mixpanel — grep the source.
One exception — community cache contribution. When you play content
that isn't in the local cache, stv resolves it (via web parsing) and
submits the resolved ID to a shared community cache so the next user
gets an instant lookup. This is the same pattern as Wikipedia or a
package mirror — many small contributions, anonymous.
What's sent (background HTTPS, fire-and-forget, never blocks playback):
Platform name (netflix / youtube / spotify)
Content slug (e.g. frieren)
Resolved content ID (Netflix title ID, YouTube video ID, Spotify URI)
What's not sent:
Your name, email, or any user identifier
Your IP address (the CDN sees a connection IP per standard HTTP, but
the client never reads or transmits it)
ตรวจสอบล่าสุดเมื่อ 2026-11-14 📺 Control any smart TV with natural language. Play Netflix by name from your terminal. PyPI: stv · MCP server · LG/Samsung/Roku/Android