Skip to content

Latest commit

 

History

History
423 lines (327 loc) · 11.3 KB

File metadata and controls

423 lines (327 loc) · 11.3 KB


📺
smartest-tv

La CLI que tu tele estaba esperando.

Pon Netflix por nombre. Castea URLs. Audio en todas las habitaciones. Concierge IA. Todo desde tu 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"

¿Sin TV? Se abre en el navegador. ¿Con TV? stv setup para conectarlo.

The Evolution of TV Control




😩 Sin stv 😎 Con stv
  1. Coger el mando
  2. Abrir la app de Netflix
  3. Buscar la serie
  4. Elegir la temporada
  5. Elegir el episodio
  6. Dar play

~30 segundos

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

~3 segundos



✨ Qué hace

🎬 Reproduce por nombre

stv play netflix "Dark" s1e1
stv play "Frieren"              # auto-detects platform
stv play youtube "baby shark"
stv play spotify "chill vibes"

Di el nombre. stv encuentra el ID, abre la app, empieza a reproducir.

🔗 Castea cualquier URL

stv cast https://youtu.be/dQw4w
stv cast https://netflix.com/watch/...
stv cast https://open.spotify.com/...

Un amigo te manda un enlace. Lo pegas. La tele lo pone.

🎵 Cola y fiesta

stv queue add youtube "Gangnam Style"
stv queue add spotify "Blinding Lights"
stv queue play

Todos añaden su canción. La tele las pone en orden.

🎭 Escenas preestablecidas

stv scene movie-night   # volumen 20, cine
stv scene kids          # volumen 15, Cocomelon
stv scene sleep         # lluvia, apagado automático

Un comando pone el ambiente.

🔊 Audio en todas las habitaciones

stv audio play "lo-fi beats"
stv audio volume kitchen 30
stv audio stop

Pantallas apagadas. Música en todas partes.
Sonos gratis.

📺 La tele como pantalla

stv display message "¡A cenar!"
stv display clock
stv display dashboard "Temp:22°C"

Dashboards, relojes, señalética.
$0/mes.

📊 Inteligencia de visionado

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

¿Vale tu Netflix $18 al mes?

🌐 Fiesta sincronizada

stv --all play youtube "lo-fi beats"
stv --group party play netflix "Wed..."
stv --all off   # buenas noches

Todas las teles. A la vez. Incluso amigos remotos.

🤖 Concierge IA

"Pon algo tranquilo"tv_recommendtv_playPoniendo The Queen's Gambit

21 herramientas MCP. Una frase es suficiente.


🤖 Di a tu IA que controle tu tele

stv es un servidor MCP. Claude, GPT, Cursor o cualquier cliente MCP puede controlar tu tele con lenguaje natural.

Configuración (una línea):

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

O vía OpenClaw:

clawhub install smartest-tv

Luego solo habla:

Tú: "Acabo de llegar a casa, prepara la noche de película"

Claude: 🎬 Noche de película activada.
  Volumen20, modo cine activado.
  
  Según tu historial:
  1. The Queen's Gambit (Netflix)
  2. Ozark (Netflix)
  3. Squid Game S2 (Netflix)

Tú: "Pon el 1, y un reloj en la tele de la cocina"

Claude: ✓ Poniendo The Queen's GambitReloj en la tele de la cocina
Las 21 herramientas MCP
Categoría Herramienta Qué hace
Reproducir tv_play Busca y reproduce por nombre
tv_cast Castea cualquier URL
tv_next Continúa viendo
tv_launch Lanza app por ID
tv_resolve Obtiene solo el ID del contenido
Descubrir tv_whats_on Contenido en tendencia
tv_recommend Recomendaciones personalizadas
Controlar tv_power Encender/apagar
tv_volume Obtener/establecer/ajustar/silenciar
tv_screen Pantalla encendida/apagada
tv_notify Notificación toast
tv_status Estado actual
Organizar tv_queue Cola de reproducción
tv_scene Escenas preestablecidas
tv_history Historial de visionado
Inteligencia tv_insights Estadísticas de visionado
tv_display La tele como pantalla
tv_audio Audio en todas las habitaciones
Multi-tele tv_sync Reproducir en todas las teles
tv_list_tvs Listar teles
tv_groups Grupos de teles

📅 Un día con stv

Hora Qué pasa
7am stv display dashboard "Tiempo:18°C" "Reunión:10am" en la tele de la cocina
8am stv scene kids --tv kids-room — Cocomelon, volumen 15
12pm Un amigo manda un enlace de Netflix → stv cast <url>
5pm stv screen-time → los niños han visto 2h 15m hoy
6:30pm stv scene movie-night — volumen 20, modo cine
7pm stv recommend --mood chill → sugiere Ozark
9pm stv audio play "friday vibes" -p spotify — música en todas partes
10pm stv --group party play netflix "Wednesday" s1e1 — sincronizado
11:30pm stv scene sleepstv --all off — buenas noches

🔥 Combos que matan

🌙 Piloto automático al dormir

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

Sonido ambiente, pantalla apagada, temporizador, todas las teles apagadas.

🎧 Sonos gratis

stv audio play "lo-fi beats"
stv audio volume kitchen 40
stv audio volume bedroom 15

Cada tele es un altavoz. Volumen por habitación. Pantallas apagadas.

💰 Auditoría de suscripciones

stv sub-value netflix --cost 17.99
# → $8.50/hr — considera cancelar

stv sub-value youtube --cost 13.99
# → $1.20/hr — buen valor

10 recetas más →


⚙️ Cómo funciona

  "Pon Dark S1E1"
        │
        ▼
  ┌─── Resolución ───┐
  │ Caché → APIWebcontent_id0.1s   1s    3s  │──────────────▶ 📺 La tele lo pone
  └───────────────────┘       │
                         Deep link vía
                    LG / Samsung / Roku / Android

Di un nombre. stv lo resuelve a un ID de contenido y hace deep-link en la app de tu tele. Sin automatización de navegador, sin claves API, sin dependencia en la nube. Los resultados se cachean, así que las reproducciones repetidas son instantáneas.


📦 Instalación

pip install stv                    # LG webOS (por defecto)
pip install "stv[samsung]"         # Samsung Tizen
pip install "stv[android]"         # Android TV / Fire TV
pip install "stv[all]"             # Todo
stv setup                          # autodescubre y empareja tu tele

Compatible con LG webOS · Samsung Tizen · Android TV / Fire TV · Roku


🔌 Compatible con

Integración Cómo
Claude Code / Cursor Añade config MCP → "pon Dark s1e1"
OpenClaw clawhub install smartest-tv → bot de Telegram
Home Assistant Comandos shell en automatizaciones
cron 0 7 * * * stv display dashboard ...
Scripts de shell One-liners de sleep-mode, party-mode
Cualquier cliente MCP 21 herramientas, stdio o HTTP (stv serve)

📚 Documentación

Primeros pasos Configuración para cualquier marca de TV
Reproducir contenido play, cast, queue, resolve
Escenas movie-night, kids, sleep, personalizadas
Sync y fiesta Multi-tele, fiesta de visionado remoto
Recetas 10 combos de funciones potentes
Agentes IA MCP para Claude, Cursor, OpenClaw
Referencia CLI Todos los comandos y opciones
Herramientas MCP Las 21 herramientas con parámetros

🤝 Contribuir

211 tests. No hace falta tele para ejecutarlos.

pip install -e ".[dev]"
python -m pytest tests/ -v

Los drivers de Samsung, Roku y Android TV necesitan pruebas reales. Si tienes uno, tu opinión importa.

Contribuir al caché · Desarrollo de drivers


MIT License · Hecho con Python · Sin nube requerida