smartest-tv

📺
smartest-tv

你的电视一直在等待的命令行工具。

按名称播放 Netflix / Apple TV+ / YouTube / Spotify。投放 URL。多房间音频。AI 管家。所有操作都能在终端中完成。

한국어 · 中文 · 日本語 · Español · Deutsch · Português · Français

pip install stv && stv play "Frieren"

_{没有电视？会在浏览器中打开。有电视？运行 stv setup 连接设备。}

stv play netflix "Dark" s1e1

没有电视？没关系。 如果没有配置电视，stv 会直接在浏览器中打开内容。 Netflix、YouTube、Spotify、Disney+——只需运行 pip install stv，即可开始使用。

🛋 氛围编程，轻松追剧

凌晨 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？只要告诉 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

_{也可作为 MCP 服务使用（21 个工具），支持 Claude Code、Codex、Antigravity 和其他 MCP 客户端。}

🎯 只需输入 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。

需要通过管道传给 jq 时，始终可以使用 --format json。

✨ 功能介绍

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

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

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

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

🤖 让 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

📅 stv 的一天

🔥 绝妙组合

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

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 个配方 →

_{▲ 点击观看完整演示}

⚙️ 工作原理

  "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 webOS · Samsung Tizen · Android TV / Fire TV · Roku

Home Assistant（HACS）

添加为自定义仓库（默认列表正在审核：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

Android TV / Fire TV：设置流程会在电视上显示 6 位 PIN — 在配对表单中输入即可完成配对。在 HA OS / HA Container 中设置 STV_CONFIG_DIR=/config/smartest-tv，确保容器重建后配对信息仍然保留。参见 docs/integrations/home-assistant.md。

然后在自动化中使用：

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、解析器（Netflix、Apple TV+、YouTube、Spotify、Disney+、Max、Prime Video、Paramount+、Hulu、Peacock、Crunchyroll，以及通过 JustWatch 提供的更多服务）、全部 4 个电视驱动（LG、Samsung、Roku、Android）、缓存、同步引擎、场景，以及全部 253 项测试。流媒体可用性数据由 JustWatch 提供。

🔒 隐私

stv 在你的本地网络上运行。不收集遥测数据、不做分析、不进行云端 同步，也不会将你观看的内容发送回服务器。没有 posthog、没有 amplitude、没有 sentry、没有 mixpanel——搜索一下源代码即可确认。

一项例外——社区缓存贡献。 当你播放的内容不在本地缓存中时，stv 会解析该内容 （通过网页解析），并将解析出的 ID 提交到共享社区缓存，以便下一位用户 能立即查到。这与 Wikipedia 或软件包镜像的模式相同——许多人各自做出少量贡献，且匿名。

发送的内容（通过 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

Samsung、Roku 和 Android TV 驱动需要在实际环境中测试。如果你有其中一款设备，欢迎反馈。

缓存贡献 · 驱动开发

_{MIT 许可证 · 使用 Python 构建 · 无需云服务}