smartest-tv

📺
smartest-tv

テレビが待ち望んでいた CLI。

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

_{Claude Code、Codex、Antigravity、その他の MCP クライアント向けに、MCP サーバー（21 ツール）としても利用できます。}

🎯 stv と入力するだけ

サブコマンドを指定しないと、Now Playing カードと、視聴履歴に基づく状況に応じた次のアクションが3つ表示されます。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 キーも、クラウドへの依存もありません。結果はキャッシュされるため、2 回目以降はすぐに再生できます。

📦 インストール

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 種類すべての TV ドライバー（LG、Samsung、Roku、Android）、キャッシュ、同期エンジン、シーン、253 件すべてのテストが含まれます。ストリーミング配信状況データは JustWatch によって提供されています。

🔒 プライバシー

stv はローカルネットワーク上で動作します。テレメトリー、アナリティクス、クラウド同期、視聴内容の外部送信はありません。posthog も、amplitude も、sentry も、mixpanel もありません。ソースを grep して確認できます。

例外が 1 つあります。コミュニティキャッシュへの貢献です。 ローカルキャッシュにないコンテンツを再生すると、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 で開発 · クラウド不要}