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. 拿起遥控器
2. 打开Netflix应用程序
3. 搜索节目
4. 选择季节
5. 选择剧集
6. 按播放

约30秒

stv play netflix "Dark" s1e1

约3秒

没有电视？没问题 如果没有配置电视，stv会直接在浏览器中打开内容。 网飞、YouTube、Spotify、迪士尼+——只是 pip install stv 然后走。

______________________________________________________________________

🛋 Vibe代码和寒意

凌晨2点进行振动编码。Claude编写你的代码。你让它表演。确实如此。

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.

是否已安装stv？告诉克劳德：

# 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

也可用作Claude Code、Codex、Antigravity和其他MCP客户端的MCP服务器（21个工具）。

______________________________________________________________________

🎯 只需键入 stv

没有子命令？你会得到一张正在玩的牌和三个上下文相关的下一步动作 基于您的手表历史记录，而不是30命令的帮助转储。

$ stv "play dark on netflix"     # natural language works
$ stv play "Frieren"             # auto-detects platform
$ stv next                       # continue last show
$ stv stats                      # → insights

未知输入？你会得到一个友好的提示，而不是错误。

______________________________________________________________________

🎨 一个看起来像产品的CLI

每个命令都使用Catppuccin Mocha颜色、语义图标和实数进行渲染 视觉层次。喜欢另一个调色板吗？集 STV_THEME=nord 或 STV_THEME=gruvbox.

--format json 当您需要管道连接时，始终可用 jq.

______________________________________________________________________

✨ 它的作用

🎬 按名称播放

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

说出名字。stv找到ID，打开应用程序，开始播放。Netflix和Apple TV+通过HTML解析进行解析。迪士尼+、Max、Prime、Hulu、派拉蒙+、孔雀、Crunchyroll和 JustWatch上的每个平台 通过他们的API解决-没有登录，没有API密钥。跳过平台名称，stv会自动检测它在您所在地区的流媒体位置。

🔗 投射任何URL

stv cast https://youtu.be/dQw4w
stv cast https://netflix.com/watch/...
stv cast https://open.spotify.com/...

朋友发送了一个链接。粘贴它。电视播放它。

🎵 排队和聚会

stv queue add youtube "Gangnam Style"
stv queue add spotify "Blinding Lights"
stv queue play

每个人都添加了自己的选择。电视按顺序播放。

🎭 场景预设

stv scene movie-night   # volume 20, cinema
stv scene kids          # volume 15, Cocomelon
stv scene sleep         # rain sounds, auto-off

一个命令设置氛围。

🔊 多房间音响

stv audio play "lo-fi beats"
stv audio volume kitchen 30
stv audio stop

屏幕关闭，到处都是音乐。 免费Sonos。

📺 电视作为显示器

stv display message "Dinner!"
stv display clock
stv display dashboard "Temp:22°C"

仪表盘、时钟、标牌。 0美元/月。

📊 观察情报

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

你的Netflix每月值18美元吗？

🌐 同步方

stv --all play youtube "lo-fi beats"
stv --group party play netflix "Wed..."
stv --all off   # good night

每台电视，一次。即使是远方的朋友。

🤖 人工智能礼宾

"Play something chill"
→ tv_recommend → tv_play
→ Playing The Queen's Gambit

21个MCP工具。一句话就够了。

______________________________________________________________________

🤖 告诉你的AI控制你的电视

stv是一个 MCP服务器.Claude、GPT、Cursor或任何MCP客户端都可以用自然语言控制您的电视。

设置（一行）：

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

或通过 开爪:

clawhub install smartest-tv

那就说吧：

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

______________________________________________________________________

📅 与stv共度的一天

______________________________________________________________________

🔥 杀手组合

🌙 睡前自动驾驶仪

stv audio play "rain" --rooms bedroom
stv scene sleep
stv --all off

环境声音，屏幕关闭，自动定时器，其他所有电视都坏了。

🎧 免费Sonos

stv audio play "lo-fi beats"
stv audio volume kitchen 40
stv audio volume bedroom 15

每台电视都是扬声器。每个房间的体积。屏幕关闭。

💰 订阅审核

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更多食谱→

______________________________________________________________________

▲ Click to watch the full demo

______________________________________________________________________

⚙️ 运作原理

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

说出一个名字。stv将其解析为内容ID，深度链接到电视上的应用程序。没有浏览器自动化，没有API密钥，没有云依赖性。结果被缓存，因此重复播放是即时的。

______________________________________________________________________

📦 安装

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

支持 LG网络操作系统 · 三星Tizen · 安卓电视/消防电视 · 年

家庭助理（HACS）

](https://github.com/hacs/integration)

添加为自定义存储库（审核中的默认列表： hacs/default#6907):

HACS → ⋮ (top right) → Custom repositories
  URL: https://github.com/Hybirdss/smartest-tv
  Category: Integration → Add
Then: Install → Restart HA
Settings → Integrations → Add → "Smartest TV" → auto-discovers your TVs

然后在自动化中使用：

service: media_player.play_media
target:
  entity_id: media_player.living_room
data:
  media_content_type: stv
  media_content_id: "netflix:Frieren:s2e8"

这实现了HA的内置功能 media_player.play_media 无法：按名称和深度链接将节目解析到流媒体应用程序中。电源、音量和播放控件也可作为标准HA媒体播放器实体使用。

______________________________________________________________________

🔌 适用于

______________________________________________________________________

📚 文档

______________________________________________________________________

🔓 开源

stv的每一行都在GitHub上——CLI、解析器（通过JustWatch的Netflix、Apple TV+、YouTube、Spotify、Disney+、Max、Prime Video、Paramount+、Hulu、Peacock、Crunchyroll等）、所有4个电视驱动程序（LG、三星、Roku、安卓）、缓存、同步引擎、场景和所有253个测试。流媒体可用性数据由 JustWatch.

______________________________________________________________________

🔒 隐私

stv在你的 本地网络.没有遥测，没有分析，没有云 同步，不要给家里打电话问你看了什么。没有 posthog，没有 amplitude，没有 sentry，没有 mixpanel --grep源代码。

一个例外——社区缓存贡献。 播放内容时 这不在本地缓存中，stv会解析它（通过web解析），然后 将解析后的ID提交到共享社区缓存，以便下一个用户 得到即时查找。这与维基百科或 包镜像——许多小贡献，匿名。

发送的内容（后台HTTPS、即发即弃、从不阻止播放）：

• 平台名称(netflix / youtube / spotify)
• 内容块（例如。 frieren)
• 解析的内容ID（Netflix标题ID、YouTube视频ID、Spotify URI）

什么 不 发送：

• 您的姓名、电子邮件或任何用户标识符
• 您的IP地址（CDN根据标准HTTP看到连接IP，但

客户端从不读取或传输它）

• 您的手表历史记录或播放时间戳
• 电视的IP地址或硬件信息
• 关于你使用stv的频率或时间

要完全禁用缓存贡献，请执行以下操作：

export STV_NO_CONTRIBUTE=1

来源： src/smartest_tv/cache.py --搜索 _contribute.

______________________________________________________________________

🤝 贡献

211测试。不需要电视来运行它们。

pip install -e ".[dev]"
python -m pytest tests/ -v

三星、Roku和安卓电视驱动程序需要实际测试。如果你有一个， 你的反馈很重要.

缓存贡献 · 驾驶员发展

______________________________________________________________________

MIT License · Made with Python · No cloud required