📺
smartest-tv

La CLI que ta TV attendait.

Lance Netflix par son nom. Caste des URLs. Audio multi-pièces. Concierge IA. Tout depuis le terminal.

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

pip install stv && stv play "Frieren"

_{Pas de TV ? Ouvre dans le navigateur. TV disponible ? stv setup pour le connecter.}

The Evolution of TV Control

---

😩 Sans stv	😎 Avec stv
1. Prendre la télécommande 2. Ouvrir l'app Netflix 3. Chercher la série 4. Choisir la saison 5. Choisir l'épisode 6. Appuyer sur play ~30 secondes	```bash stv play netflix "Dark" s1e1 stv play "Frieren" # auto-detects platform ``` ~3 secondes

--- ## ✨ Ce que ça fait

### 🎬 Lance par son nom ```bash stv play netflix "Dark" s1e1 stv play "Frieren" # auto-detects platform stv play youtube "baby shark" stv play spotify "chill vibes" ``` Dis le nom. stv trouve l'ID, ouvre l'app, lance la lecture.	### 🔗 Caste n'importe quelle URL ```bash stv cast https://youtu.be/dQw4w stv cast https://netflix.com/watch/... stv cast https://open.spotify.com/... ``` Un ami t'envoie un lien. Tu le colles. La TV le joue.	### 🎵 File d'attente et soirée ```bash stv queue add youtube "Gangnam Style" stv queue add spotify "Blinding Lights" stv queue play ``` Tout le monde ajoute son choix. La TV joue dans l'ordre.
### 🎭 Scènes prédéfinies ```bash stv scene movie-night # volume 20, cinéma stv scene kids # volume 15, Cocomelon stv scene sleep # pluie, extinction auto ``` Une commande crée l'ambiance.	### 🔊 Audio multi-pièces ```bash stv audio play "lo-fi beats" stv audio volume kitchen 30 stv audio stop ``` Écrans éteints. Musique partout. Sonos gratuit.	### 📺 La TV comme écran d'affichage ```bash stv display message "À table !" stv display clock stv display dashboard "Temp:22°C" ``` Tableaux de bord, horloges, affichage. 0€/mois.
### 📊 Intelligence de visionnage ```bash stv insights stv screen-time stv sub-value netflix --cost 17.99 ``` Ton Netflix vaut-il 18$/mois ?	### 🌐 Soirée synchronisée ```bash stv --all play youtube "lo-fi beats" stv --group party play netflix "Wed..." stv --all off # bonne nuit ``` Toutes les TV. En même temps. Même les amis à distance.	### 🤖 Concierge IA ``` "Lance quelque chose de calme" → tv_recommend → tv_play → Lecture de The Queen's Gambit ``` 21 outils MCP. Une phrase suffit.

--- ## 🤖 Laisse ton IA contrôler ta TV stv est un **serveur MCP**. Claude, GPT, Cursor ou n'importe quel client MCP peut contrôler ta TV en langage naturel.

**Configuration (une ligne) :** ```json { "mcpServers": { "tv": { "command": "uvx", "args": ["stv"] } } } ``` Ou via [OpenClaw](../../docs/integrations/openclaw.md) : ```bash clawhub install smartest-tv ```

**Puis parle simplement :** ``` Toi : "Je viens de rentrer, prépare la soirée ciné" Claude : 🎬 Soirée ciné activée. Volume → 20, mode cinéma activé. D'après ton historique : 1. The Queen's Gambit (Netflix) 2. Ozark (Netflix) 3. Squid Game S2 (Netflix) Toi : "Lance le 1, mets une horloge sur la TV cuisine" Claude : ✓ Lecture de The Queen's Gambit ✓ Horloge sur la TV cuisine ```

Les 21 outils MCP

| Catégorie | Outil | Ce qu'il fait | |----------|------|-------------| | **Lire** | `tv_play` | Cherche + lance par nom | | | `tv_cast` | Caste n'importe quelle URL | | | `tv_next` | Continue de regarder | | | `tv_launch` | Lance une app par ID | | | `tv_resolve` | Récupère seulement l'ID du contenu | | **Découvrir** | `tv_whats_on` | Contenus tendance | | | `tv_recommend` | Recommandations personnalisées | | **Contrôler** | `tv_power` | Allumer/éteindre | | | `tv_volume` | Obtenir/définir/ajuster/couper | | | `tv_screen` | Écran allumé/éteint | | | `tv_notify` | Notification toast | | | `tv_status` | État actuel | | **Organiser** | `tv_queue` | File de lecture | | | `tv_scene` | Scènes prédéfinies | | | `tv_history` | Historique de visionnage | | **Intelligence** | `tv_insights` | Statistiques de visionnage | | | `tv_display` | TV comme écran d'affichage | | | `tv_audio` | Audio multi-pièces | | **Multi-TV** | `tv_sync` | Jouer sur toutes les TV | | | `tv_list_tvs` | Lister les TV | | | `tv_groups` | Groupes de TV |

--- ## 📅 Une journée avec stv | Heure | Ce qui se passe | |------|-------------| | **7h** | `stv display dashboard "Météo:18°C" "Réunion:10h"` sur la TV cuisine | | **8h** | `stv scene kids --tv kids-room` — Cocomelon, volume 15 | | **12h** | Un ami envoie un lien Netflix → `stv cast ` | | **17h** | `stv screen-time` → les enfants ont regardé 2h15 aujourd'hui | | **18h30** | `stv scene movie-night` — volume 20, mode cinéma | | **19h** | `stv recommend --mood chill` → suggère Ozark | | **21h** | `stv audio play "friday vibes" -p spotify` — musique partout | | **22h** | `stv --group party play netflix "Wednesday" s1e1` — synchronisé | | **23h30** | `stv scene sleep` → `stv --all off` — bonne nuit | --- ## 🔥 Combos imbattables

**🌙 Pilote automatique du coucher** ```bash stv audio play "rain" --rooms bedroom stv scene sleep stv --all off ``` Son ambiant, écran éteint, minuterie auto, toutes les autres TV éteintes.

**🎧 Sonos gratuit** ```bash stv audio play "lo-fi beats" stv audio volume kitchen 40 stv audio volume bedroom 15 ``` Chaque TV est une enceinte. Volume par pièce. Écrans éteints.

**💰 Audit des abonnements** ```bash stv sub-value netflix --cost 17.99 # → $8.50/h — envisager de résilier stv sub-value youtube --cost 13.99 # → $1.20/h — bon rapport qualité-prix ```

> [**10 recettes supplémentaires →**](../../docs/guides/recipes.md) --- ## ⚙️ Comment ça marche ``` "Lance Dark S1E1" │ ▼ ┌─── Résolution ───┐ │ Cache → API → Web │ content_id │ 0.1s 1s 3s │──────────────▶ 📺 La TV le joue └───────────────────┘ │ Deep link via LG / Samsung / Roku / Android ``` Dis un nom. stv le résout en ID de contenu et fait un deep-link dans l'app sur ta TV. Pas d'automatisation de navigateur, pas de clés API, pas de dépendance cloud. Les résultats sont mis en cache, donc les lectures répétées sont instantanées. --- ## 📦 Installation ```bash pip install stv # LG webOS (défaut) pip install "stv[samsung]" # Samsung Tizen pip install "stv[android]" # Android TV / Fire TV pip install "stv[all]" # Tout ``` ```bash stv setup # découverte auto + jumelage de ta TV ``` > Compatible avec **LG webOS** · **Samsung Tizen** · **Android TV / Fire TV** · **Roku** --- ## 🔌 Compatible avec | Intégration | Comment | |------------|-----| | **Claude Code / Cursor** | Ajoute la config MCP → `"lance Dark s1e1"` | | **OpenClaw** | `clawhub install smartest-tv` → bot Telegram | | **Home Assistant** | Commandes shell dans les automatisations | | **cron** | `0 7 * * * stv display dashboard ...` | | **Scripts shell** | One-liners `sleep-mode`, `party-mode` | | **N'importe quel client MCP** | 21 outils, stdio ou HTTP (`stv serve`) | --- ## 📚 Documentation | | | |---|---| | [Premiers pas](../../docs/getting-started/installation.md) | Configuration pour n'importe quelle marque de TV | | [Lire du contenu](../../docs/guides/playing-content.md) | play, cast, queue, resolve | | [Scènes](../../docs/guides/scenes.md) | movie-night, kids, sleep, personnalisées | | [Sync & Soirée](../../docs/guides/sync-party.md) | Multi-TV, soirée de visionnage à distance | | [Recettes](../../docs/guides/recipes.md) | **10 combos de fonctionnalités puissants** | | [Agents IA](../../docs/guides/ai-agents.md) | MCP pour Claude, Cursor, OpenClaw | | [Référence CLI](../../docs/reference/cli.md) | Toutes les commandes et options | | [Outils MCP](../../docs/reference/mcp-tools.md) | Les 21 outils avec paramètres | --- ## 🤝 Contribuer 211 tests. Pas besoin de TV pour les exécuter. ```bash pip install -e ".[dev]" python -m pytest tests/ -v ``` Les drivers Samsung, Roku et Android TV ont besoin de tests en conditions réelles. Si tu en as un, [ton retour compte](https://github.com/Hybirdss/smartest-tv/issues). [Contributions au cache](../../docs/contributing/cache-contributions.md) · [Développement de drivers](../../docs/contributing/driver-development.md) ---

_{MIT License · Fait avec Python · Aucun cloud requis}

📺 smartest-tv

La CLI que ta TV attendait.

📺
smartest-tv