Skip to content
M1KE
Back to projects

pytv-chaos

TUI to discover and control Chromecasts and smart TVs on your local network: YouTube, volume, Wake-on-LAN and prank modes.

This README is only available in Spanish.

pytv-chaos: descubre y controla Chromecasts en tu red local desde la terminal.

Python Motor nativo Ámbito


TUI en terminal (Python + rich) que descubre Chromecasts y Smart TVs en la red local y los controla: reproducir vídeo de YouTube, volumen, pausa/play, despertar por Wake-on-LAN y unos cuantos "modos caóticos" para gastar bromas (silenciar a ráfagas, pausar y reanudar solo, etc.).

Solo para tu propia red. Esto controla dispositivos que ya exponen su API de casting públicamente en la LAN (el mismo mecanismo que usa la app oficial de Google Home) — pero úsalo únicamente en redes tuyas o con permiso explícito de quien las administra.

Cómo descubre las TVs

Dos motores en paralelo:

  • pychromecast — descubrimiento estándar mDNS de dispositivos Cast.
  • Motor nativo en C++ (NATIVE_SCANNER_SOURCE) — un escáner SSDP/UPnP embebido como código fuente en el propio script, que se autocompila la primera vez que se ejecuta (g++ -O3 -shared → bin/libscanner.so, cargado luego con ctypes) para encontrar Smart TVs que no hablan el protocolo Cast pero sí responden a SSDP. Si no hay compilador disponible, cae solo al escáner SSDP hecho en Python puro — no rompe nada, solo va un poco más despacio.

Instalar y ejecutar

pip install -r requirements.txt
python tv_chaos_v13.py

Requiere g++ en el PATH para el motor nativo (opcional — si falta, usa el fallback en Python).

Qué puedes hacer con una TV descubierta

Acción Qué hace
Reproducir YouTube Pega una URL o ID de vídeo y lo lanza en la TV
Rickroll Atajo directo al clásico
Volumen % Pone el volumen exacto que pidas
Ramp Sube el volumen solo, poco a poco, hasta el máximo
Panic Silencia y quita el silencio a ráfagas rápidas
Ghost (poltergeist) Pausa y reanuda el contenido solo, en bucle
Play/Pause, Seek, Stop Control normal de reproducción
Wake-on-LAN Enciende la TV por IP/MAC (necesita WOL activado en la propia TV)
Info Estado detallado: app activa, contenido, volumen

Estructura

tv_chaos_v13.py   todo el programa: descubrimiento, motor nativo embebido, control, TUI
bin/              libscanner.so autocompilada (no se versiona, se genera sola)

Licencia

MIT © 2026 macorredor270.