9.2 KiB
📺 Guía Visual del Panel TubeScript
Interfaz Principal
El panel de TubeScript está dividido en 3 pestañas principales:
🔍 Pestaña de Búsqueda
Esta pestaña permite buscar y seleccionar videos en vivo de YouTube.
Funcionalidades:
- Campo de búsqueda: Ingresa términos como "noticias", "deportes", "gaming live"
- Botón Buscar: Ejecuta la búsqueda en YouTube
- URL Directa: Pega directamente la URL de un video de YouTube en vivo
- Resultados: Lista de videos en vivo encontrados
- Vista previa: Miniatura, título, canal del video seleccionado
- Indicador EN VIVO: 🔴 Confirma que el video está transmitiendo
Flujo de trabajo:
Búsqueda → Resultados → Seleccionar → Vista Previa → Listo para transmitir
🎛️ Pestaña de Control
Centro de comando para gestionar tus transmisiones a múltiples plataformas.
Tarjetas de Plataforma:
Cada plataforma tiene su propia tarjeta con:
┌─────────────────────────────────┐
│ YouTube 🟢 │
│ Transmitiendo │
│ │
│ [▶️ Iniciar] [⏹️ Detener] │
└─────────────────────────────────┘
Estados visuales:
- 🟢 Verde: Transmisión activa y funcionando correctamente
- 🔴 Rojo: Error en la transmisión (revisar configuración)
- ⚫ Gris: Detenido (listo para iniciar)
- ⚠️ Advertencia: No configurado (falta RTMP URL o Stream Key)
Botones de control:
- ▶️ Iniciar: Comienza la retransmisión a esa plataforma
- ⏹️ Detener: Detiene la retransmisión de esa plataforma
Transmisión simultánea: Puedes iniciar transmisiones a múltiples plataformas al mismo tiempo. Cada una se gestiona independientemente.
📊 Pestaña de Monitor
Panel de monitoreo en tiempo real de todas las transmisiones activas.
Características:
- Auto-refresh: Se actualiza automáticamente cada 5 segundos
- Estado en tiempo real: Muestra si cada stream está activo o tiene errores
- Uptime: Contador de tiempo desde que inició cada transmisión
- Control rápido: Botón para detener streams directamente desde el monitor
Vista del Monitor:
┌──────────────────────────────────────────────────────┐
│ Plataforma │ Estado │ Tiempo Activo │ [⏹️] │
├──────────────────────────────────────────────────────┤
│ YouTube │ 🟢 ACTIVO│ 00:15:32 │ [⏹️] │
│ Facebook │ 🟢 ACTIVO│ 00:15:28 │ [⏹️] │
│ Twitch │ 🟢 ACTIVO│ 00:14:45 │ [⏹️] │
└──────────────────────────────────────────────────────┘
⚙️ Configuración en Barra Lateral
La barra lateral contiene toda la configuración de plataformas.
Configuración por Plataforma
Cada plataforma tiene un expander con:
🎥 YouTube
├── RTMP URL: [ ]
├── Stream Key: [••••••••••••••••••••••••••••••••]
🎥 Facebook
├── RTMP URL: [ ]
├── Stream Key: [••••••••••••••••••••••••••••••••]
... (más plataformas)
Plantillas RTMP
La sección de plantillas incluye ejemplos de configuración para:
- YouTube
- Twitch
- X (Twitter)
Botón Guardar: Al terminar de configurar, haz clic en 💾 Guardar Configuración para almacenar los cambios.
🔄 Flujo de Trabajo Completo
1. Primera vez
graph LR
A[Instalar FFmpeg] --> B[Ejecutar setup.sh]
B --> C[streamlit run streamlit_app.py]
C --> D[Configurar plataformas]
D --> E[Listo para usar]
2. Uso normal
graph TD
A[Abrir Panel] --> B[Configurar RTMP]
B --> C[Buscar video en vivo]
C --> D[Seleccionar video]
D --> E[Iniciar transmisiones]
E --> F[Monitorear estado]
F --> G{¿Continuar?}
G -->|Sí| F
G -->|No| H[Detener transmisiones]
🎯 Casos de Uso
Caso 1: Retransmitir un Evento Deportivo
- En Búsqueda, ingresa "mundial fútbol live"
- Selecciona el partido que quieres retransmitir
- En Control, inicia YouTube y Facebook
- En Monitor, verifica que ambos estén 🟢
- Deja corriendo, el monitor se actualiza solo
Caso 2: Retransmitir Noticias 24/7
- Obtén la URL de un canal de noticias en vivo
- Pégala en el campo "URL directa"
- Configura todas las plataformas que quieras
- Inicia todas las transmisiones
- El sistema seguirá retransmitiendo automáticamente
Caso 3: Streaming Multi-Plataforma de Gaming
- Busca un streamer popular en vivo
- Selecciona su transmisión
- Activa YouTube, Twitch, y Facebook
- Monitorea en tiempo real
- Si una plataforma falla (🔴), puedes reiniciarla individualmente
🔧 Personalización
Ajustar Calidad de Video
Edita streamlit_app.py, función start_ffmpeg_stream():
Alta Calidad (requiere buen internet):
"-c:v", "libx264",
"-preset", "fast",
"-b:v", "6000k", # 6 Mbps
"-c:a", "aac",
"-b:a", "192k",
Calidad Media (balanceada):
"-c:v", "libx264",
"-preset", "veryfast",
"-b:v", "3500k", # 3.5 Mbps
"-c:a", "aac",
"-b:a", "128k",
Calidad Baja (internet limitado):
"-c:v", "libx264",
"-preset", "ultrafast",
"-b:v", "1500k", # 1.5 Mbps
"-c:a", "aac",
"-b:a", "96k",
Copia Directa (sin recodificación):
"-c:v", "copy", # Copia el video sin recodificar
"-c:a", "copy", # Copia el audio sin recodificar
📊 Indicadores de Estado
Semáforo de Estado
| Color | Estado | Significado | Acción |
|---|---|---|---|
| 🟢 Verde | Activo | Transmitiendo correctamente | Ninguna |
| 🔴 Rojo | Error | Falló la transmisión | Revisar configuración o reiniciar |
| ⚫ Gris | Detenido | No está transmitiendo | Presionar ▶️ para iniciar |
| ⚠️ Amarillo | Advertencia | Falta configuración | Configurar RTMP y Stream Key |
Mensajes Comunes
"✅ Stream listo para transmitir"
- Todo está configurado correctamente
- Puedes iniciar las transmisiones
"ℹ️ Selecciona un video primero"
- Ve a la pestaña de Búsqueda
- Selecciona o ingresa URL de video
"❌ No se pudo obtener la URL del stream"
- El video no está en vivo, o
- YouTube bloqueó la petición (intenta con cookies)
"ℹ️ Configura RTMP y Stream Key"
- Ve a la barra lateral
- Completa la configuración de esa plataforma
🚨 Solución Visual de Problemas
Problema: Tarjeta muestra 🔴 Rojo
Diagnóstico:
- Verifica RTMP URL en barra lateral
- Verifica Stream Key (sin espacios extra)
- Verifica que la plataforma permita streaming externo
- Revisa que FFmpeg esté instalado:
ffmpeg -version
Solución:
- Detén la transmisión (⏹️)
- Corrige la configuración en la barra lateral
- Guarda la configuración (💾)
- Recarga la página (F5)
- Vuelve a iniciar (▶️)
Problema: No aparecen resultados en la búsqueda
Solución:
- Usa términos más específicos: "noticiero en vivo", "partido fútbol live"
- Verifica tu conexión a internet
- Intenta con URL directa en lugar de búsqueda
Problema: El video no se reproduce en las plataformas
Solución:
- Verifica que el video original siga en vivo (🔴)
- Verifica tu ancho de banda de subida (necesitas ~5 Mbps por plataforma)
- Reduce el número de plataformas simultáneas
- Reduce la calidad del stream (ver sección Personalización)
💡 Tips y Trucos
Tip 1: Búsqueda Efectiva
Use términos en inglés para encontrar más resultados: "news live", "sports live", "gaming live stream"
Tip 2: Cookies para Videos Restringidos
Algunos videos requieren inicio de sesión. Exporta cookies de YouTube y colócalas en cookies.txt
Tip 3: Monitoreo Continuo
Deja la pestaña de Monitor abierta. Se actualiza automáticamente cada 5 segundos.
Tip 4: Transmisión de Prueba
Antes de un evento importante, haz una prueba con un video cualquiera para verificar que todo funcione.
Tip 5: Backup
Si una plataforma falla, puedes detenerla y reiniciarla sin afectar las demás.
🎓 Glosario
- RTMP: Real-Time Messaging Protocol - Protocolo para streaming de video
- Stream Key: Clave secreta que identifica tu cuenta en cada plataforma
- FFmpeg: Software para procesar video y audio
- yt-dlp: Herramienta para descargar/extraer URLs de YouTube
- Uptime: Tiempo que lleva activa una transmisión
- Bitrate: Cantidad de datos por segundo (mayor = mejor calidad pero más internet)
¿Necesitas más ayuda? Consulta README.md para documentación completa o QUICKSTART.md para inicio rápido.