Skip to content

Latest commit

 

History

History
423 lines (327 loc) · 11.4 KB

File metadata and controls

423 lines (327 loc) · 11.4 KB


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

PyPI Downloads Tests MIT License Python MCP Tools Glama Score Awesome MCP Servers Awesome Smart TV HACS

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

stv play netflix "Dark" s1e1
stv play "Frieren"              # auto-detects platform

~3 secondes



✨ Ce que ça fait

🎬 Lance par son nom

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

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

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

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

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

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

Tableaux de bord, horloges, affichage.
0€/mois.

📊 Intelligence de visionnage

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

Ton Netflix vaut-il 18$/mois ?

🌐 Soirée synchronisée

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

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

Ou via OpenClaw :

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 <url>
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 sleepstv --all off — bonne nuit

🔥 Combos imbattables

🌙 Pilote automatique du coucher

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

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

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 →


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

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
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 Configuration pour n'importe quelle marque de TV
Lire du contenu play, cast, queue, resolve
Scènes movie-night, kids, sleep, personnalisées
Sync & Soirée Multi-TV, soirée de visionnage à distance
Recettes 10 combos de fonctionnalités puissants
Agents IA MCP pour Claude, Cursor, OpenClaw
Référence CLI Toutes les commandes et options
Outils MCP Les 21 outils avec paramètres

🤝 Contribuer

211 tests. Pas besoin de TV pour les exécuter.

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.

Contributions au cache · Développement de drivers


MIT License · Fait avec Python · Aucun cloud requis