📺
smartest-tv

Die CLI, auf die dein Fernseher gewartet hat.

Netflix beim Namen nennen. URLs casten. Mehrzimmer-Audio. KI-Concierge. Alles vom Terminal aus.

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

pip install stv && stv play "Frieren"

_{Kein TV? Öffnet im Browser. TV vorhanden? stv setup zum Verbinden.}

The Evolution of TV Control

---

😩 Ohne stv	😎 Mit stv
1. Fernbedienung nehmen 2. Netflix-App öffnen 3. Nach der Serie suchen 4. Staffel auswählen 5. Folge auswählen 6. Play drücken ~30 Sekunden	```bash stv play netflix "Dark" s1e1 stv play "Frieren" # auto-detects platform ``` ~3 Sekunden

--- ## ✨ Was es kann

### 🎬 Nach Name abspielen ```bash stv play netflix "Dark" s1e1 stv play "Frieren" # auto-detects platform stv play youtube "baby shark" stv play spotify "chill vibes" ``` Sag den Namen. stv findet die ID, öffnet die App, startet die Wiedergabe.	### 🔗 Beliebige URL casten ```bash stv cast https://youtu.be/dQw4w stv cast https://netflix.com/watch/... stv cast https://open.spotify.com/... ``` Freund schickt einen Link. Einfügen. Fernseher spielt ihn ab.	### 🎵 Queue und Party ```bash stv queue add youtube "Gangnam Style" stv queue add spotify "Blinding Lights" stv queue play ``` Jeder fügt seinen Song hinzu. Fernseher spielt sie der Reihe nach ab.
### 🎭 Szenen-Presets ```bash stv scene movie-night # Lautstärke 20, Kino stv scene kids # Lautstärke 15, Cocomelon stv scene sleep # Regengeräusche, Auto-Aus ``` Ein Befehl setzt die Stimmung.	### 🔊 Mehrzimmer-Audio ```bash stv audio play "lo-fi beats" stv audio volume kitchen 30 stv audio stop ``` Bildschirme aus. Musik überall. Kostenloses Sonos.	### 📺 TV als Display ```bash stv display message "Essen ist fertig!" stv display clock stv display dashboard "Temp:22°C" ``` Dashboards, Uhren, Beschilderung. $0/Monat.
### 📊 Sehverhalten-Analyse ```bash stv insights stv screen-time stv sub-value netflix --cost 17.99 ``` Ist dein Netflix $18 im Monat wert?	### 🌐 Sync-Party ```bash stv --all play youtube "lo-fi beats" stv --group party play netflix "Wed..." stv --all off # gute Nacht ``` Jeder Fernseher. Gleichzeitig. Auch entfernte Freunde.	### 🤖 KI-Concierge ``` "Spiel etwas Entspanntes" → tv_recommend → tv_play → Spielt The Queen's Gambit ``` 21 MCP-Tools. Ein Satz reicht.

--- ## 🤖 Lass deine KI deinen Fernseher steuern stv ist ein **MCP-Server**. Claude, GPT, Cursor oder jeder MCP-Client kann deinen Fernseher mit natürlicher Sprache steuern.

**Einrichtung (eine Zeile):** ```json { "mcpServers": { "tv": { "command": "uvx", "args": ["stv"] } } } ``` Oder über [OpenClaw](../../docs/integrations/openclaw.md): ```bash clawhub install smartest-tv ```

**Dann einfach sprechen:** ``` Du: "Ich bin gerade heimgekommen, richte Filmabend ein" Claude: 🎬 Filmabend aktiviert. Lautstärke → 20, Kinomodus an. Basierend auf deinem Verlauf: 1. The Queen's Gambit (Netflix) 2. Ozark (Netflix) 3. Squid Game S2 (Netflix) Du: "Spiel 1, stell eine Uhr auf den Küchen-TV" Claude: ✓ Spielt The Queen's Gambit ✓ Uhr auf Küchen-TV ```

Alle 21 MCP-Tools

| Kategorie | Tool | Was es tut | |----------|------|-------------| | **Abspielen** | `tv_play` | Suchen + nach Name abspielen | | | `tv_cast` | Beliebige URL casten | | | `tv_next` | Weiterschauen | | | `tv_launch` | App per ID starten | | | `tv_resolve` | Nur Inhalts-ID abrufen | | **Entdecken** | `tv_whats_on` | Trendige Inhalte | | | `tv_recommend` | Personalisierte Vorschläge | | **Steuern** | `tv_power` | Ein/Aus | | | `tv_volume` | Abrufen/Setzen/Schritt/Stummschalten | | | `tv_screen` | Bildschirm ein/aus | | | `tv_notify` | Toast-Benachrichtigung | | | `tv_status` | Aktueller Zustand | | **Organisieren** | `tv_queue` | Wiedergabeliste | | | `tv_scene` | Szenen-Presets | | | `tv_history` | Sehverlauf | | **Analyse** | `tv_insights` | Sehstatistiken | | | `tv_display` | TV als Display | | | `tv_audio` | Mehrzimmer-Audio | | **Multi-TV** | `tv_sync` | Auf allen TVs abspielen | | | `tv_list_tvs` | TVs auflisten | | | `tv_groups` | TV-Gruppen |

--- ## 📅 Ein Tag mit stv | Zeit | Was passiert | |------|-------------| | **7 Uhr** | `stv display dashboard "Wetter:18°C" "Meeting:10Uhr"` auf dem Küchen-TV | | **8 Uhr** | `stv scene kids --tv kids-room` — Cocomelon, Lautstärke 15 | | **12 Uhr** | Freund schickt Netflix-Link → `stv cast ` | | **17 Uhr** | `stv screen-time` → Kinder haben heute 2h 15m geschaut | | **18:30 Uhr** | `stv scene movie-night` — Lautstärke 20, Kinomodus | | **19 Uhr** | `stv recommend --mood chill` → schlägt Ozark vor | | **21 Uhr** | `stv audio play "friday vibes" -p spotify` — Musik überall | | **22 Uhr** | `stv --group party play netflix "Wednesday" s1e1` — synchron | | **23:30 Uhr** | `stv scene sleep` → `stv --all off` — gute Nacht | --- ## 🔥 Killer-Kombos

**🌙 Schlafens-Autopilot** ```bash stv audio play "rain" --rooms bedroom stv scene sleep stv --all off ``` Umgebungsklang, Bildschirm aus, Auto-Timer, alle anderen TVs aus.

**🎧 Kostenloses Sonos** ```bash stv audio play "lo-fi beats" stv audio volume kitchen 40 stv audio volume bedroom 15 ``` Jeder TV ist ein Lautsprecher. Lautstärke pro Zimmer. Bildschirme aus.

**💰 Abonnement-Audit** ```bash stv sub-value netflix --cost 17.99 # → $8.50/Std — Kündigung erwägen stv sub-value youtube --cost 13.99 # → $1.20/Std — guter Wert ```

> [**10 weitere Rezepte →**](../../docs/guides/recipes.md) --- ## ⚙️ Wie es funktioniert ``` "Spiel Dark S1E1" │ ▼ ┌─── Auflösung ───┐ │ Cache → API → Web │ content_id │ 0.1s 1s 3s │──────────────▶ 📺 TV spielt es ab └───────────────────┘ │ Deep link via LG / Samsung / Roku / Android ``` Sag einen Namen. stv löst ihn zu einer Inhalts-ID auf und deep-linkt in die App auf deinem TV. Keine Browser-Automatisierung, keine API-Keys, keine Cloud-Abhängigkeit. Ergebnisse werden gecacht, sodass wiederholte Abspielungen sofort funktionieren. --- ## 📦 Installation ```bash pip install stv # LG webOS (Standard) pip install "stv[samsung]" # Samsung Tizen pip install "stv[android]" # Android TV / Fire TV pip install "stv[all]" # Alles ``` ```bash stv setup # TV automatisch entdecken und koppeln ``` > Unterstützt **LG webOS** · **Samsung Tizen** · **Android TV / Fire TV** · **Roku** --- ## 🔌 Funktioniert mit | Integration | Wie | |------------|-----| | **Claude Code / Cursor** | MCP-Config hinzufügen → `"spiel Dark s1e1"` | | **OpenClaw** | `clawhub install smartest-tv` → Telegram-Bot | | **Home Assistant** | Shell-Befehle in Automationen | | **cron** | `0 7 * * * stv display dashboard ...` | | **Shell-Skripte** | `sleep-mode`-, `party-mode`-Einzeiler | | **Jeder MCP-Client** | 21 Tools, stdio oder HTTP (`stv serve`) | --- ## 📚 Dokumentation | | | |---|---| | [Erste Schritte](../../docs/getting-started/installation.md) | Einrichtung für jede TV-Marke | | [Inhalte abspielen](../../docs/guides/playing-content.md) | play, cast, queue, resolve | | [Szenen](../../docs/guides/scenes.md) | movie-night, kids, sleep, eigene | | [Sync & Party](../../docs/guides/sync-party.md) | Multi-TV, Remote-Watch-Party | | [Rezepte](../../docs/guides/recipes.md) | **10 leistungsstarke Funktionskombos** | | [KI-Agenten](../../docs/guides/ai-agents.md) | MCP für Claude, Cursor, OpenClaw | | [CLI-Referenz](../../docs/reference/cli.md) | Alle Befehle und Optionen | | [MCP-Tools](../../docs/reference/mcp-tools.md) | Alle 21 Tools mit Parametern | --- ## 🤝 Mitmachen 211 Tests. Kein TV nötig, um sie auszuführen. ```bash pip install -e ".[dev]" python -m pytest tests/ -v ``` Samsung-, Roku- und Android-TV-Treiber brauchen Tests in der Praxis. Wenn du einen hast, [zählt dein Feedback](https://github.com/Hybirdss/smartest-tv/issues). [Cache beitragen](../../docs/contributing/cache-contributions.md) · [Treiberentwicklung](../../docs/contributing/driver-development.md) ---

_{MIT License · Mit Python erstellt · Keine Cloud erforderlich}

📺 smartest-tv

Die CLI, auf die dein Fernseher gewartet hat.

📺
smartest-tv