neoris/TubeScript-API

Fork 0

cesarmendivil 8e6df294dc Add Docker management scripts for TubeScript API

2026-02-21 12:19:08 -07:00

13 KiB

Raw Blame History

✅ RESUMEN EJECUTIVO - Implementación Completa

🎯 Sistema Implementado: TubeScript API Pro

Sistema de retransmisión multi-plataforma desde YouTube Live hacia redes sociales

📦 Componentes Principales

1. Backend - FastAPI (Puerto 8080)

✅ Endpoint /stream/{video_id} - Obtiene URL m3u8 de videos en vivo
✅ Endpoint /transcript/{video_id} - Obtiene subtítulos/transcripciones
✅ Manejo robusto de errores con mensajes claros
✅ Estrategia de fallback para obtener streams
✅ Soporte para cookies de YouTube
✅ Documentación interactiva (Swagger/ReDoc)

2. Frontend - Streamlit (Puerto 8501)

✅ Panel web completo con 3 pestañas principales
✅ Búsqueda de videos en vivo de YouTube
✅ Control individual por plataforma con switches
✅ Monitoreo en tiempo real con semáforos de estado
✅ Gestión de PIDs de procesos FFmpeg
✅ Configuración intuitiva de plataformas

3. Infraestructura Docker

✅ Docker Compose para despliegue conjunto
✅ Scripts separados para cada servicio
✅ Gestor interactivo todo-en-uno
✅ Red compartida entre contenedores
✅ Volúmenes persistentes para configuración

🎨 Funcionalidades del Panel Web

Pestaña 1: 🔍 Búsqueda

- Buscar videos en vivo por palabra clave
- Ingresar URL directa de YouTube
- Preview con miniatura y datos del canal
- Verificación de estado EN VIVO (🔴)

Pestaña 2: 🎛️ Control

- Vista del video seleccionado con preview
- Switches individuales por plataforma
- Botones para iniciar/detener todas
- Tabla resumen de redes configuradas
- Tarjetas individuales con:
  * Semáforo de estado (🟢 🔴 ⚪)
  * PID del proceso FFmpeg
  * Tiempo activo de transmisión
  * Switch para activar/desactivar

Pestaña 3: 📊 Monitor

- Auto-refresh cada 5 segundos
- Resumen general con métricas
- Detalle por plataforma:
  * Estado del proceso (✅ Vivo / ❌ Muerto)
  * PID y hora de inicio
  * Tiempo activo
  * Botón para detener
- Información técnica expandible

Barra Lateral: ⚙️ Configuración

- 6 plataformas preconfiguradas:
  * YouTube, Facebook, Twitch
  * X (Twitter), Instagram, TikTok
- Para cada plataforma:
  * Switch para habilitar/deshabilitar
  * Campo para Stream Key (obligatorio)
  * RTMP URL (opcional, usa defaults)
- URLs RTMP por defecto incluidas
- Botón para guardar configuración
- Guías de ayuda integradas

🔧 Mejoras Implementadas

Backend (main.py)

✅ get_transcript_data: Mejorado con:
- Manejo robusto de errores
- Soporte para subtítulos automáticos
- Mensajes de error claros
- Timeout de 60 segundos
- Validación de respuestas
✅ get_stream_url: Mejorado con:
- Estrategia de fallback (4 formatos)
- Cliente Android para mayor compatibilidad
- Mejor manejo de timeouts
- Mensajes de error descriptivos

Frontend (streamlit_app.py)

Ya estaba muy completo, incluye:

✅ Gestión de procesos con PIDs
✅ Verificación de estado en tiempo real
✅ Persistencia de configuración
✅ Sistema de switches funcional
✅ Semáforos de estado visuales
✅ Monitoreo activo de transmisiones

📁 Archivos Creados

Scripts de Gestión

docker-manager.sh                    # Gestor interactivo todo-en-uno
docker-start-api.sh                  # Iniciar solo FastAPI
docker-start-streamlit.sh            # Iniciar solo Streamlit
docker-stop-all.sh                   # Detener todos los servicios
docker-logs-separate.sh              # Ver logs por servicio
docker-create-network.sh             # Crear red de Docker

Documentación

QUICKSTART_COMPLETO.md               # Guía de inicio rápido completa
DOCKER_COMANDOS_SEPARADOS_COMPLETO.md # Comandos Docker detallados
PANEL_STREAMLIT_GUIA.md              # Guía completa del panel web
API_EXAMPLES.md                       # Ejemplos de uso de la API

Configuración

.env.example                          # Variables de entorno
docker-compose.yml                    # Configuración Docker Compose (ya existía)

🚀 Comandos de Uso

Inicio Rápido

# Método 1: Gestor interactivo (Recomendado)
./docker-manager.sh

# Método 2: Docker Compose
docker-compose up -d

# Método 3: Servicios separados
./docker-create-network.sh      # Primera vez
./docker-start-api.sh           # FastAPI
./docker-start-streamlit.sh     # Streamlit

Gestión

# Ver estado
docker ps

# Ver logs
docker logs -f tubescript_api
docker logs -f streamlit_panel

# Detener
./docker-stop-all.sh
# o
docker-compose down

# Actualizar yt-dlp
docker exec streamlit_panel pip install --upgrade yt-dlp
docker exec tubescript_api pip install --upgrade yt-dlp

🎯 Flujo de Trabajo Completo

1. Configuración Inicial

# Crear red de Docker
./docker-create-network.sh

# Iniciar servicios
./docker-manager.sh
# Seleccionar opción 1

# Acceder al panel
open http://localhost:8501

2. Configurar Plataformas

En el panel web:
1. Abrir barra lateral (⚙️ Configuración)
2. Para cada plataforma:
   - Activar switch "Habilitar esta plataforma"
   - Ingresar Stream Key
   - (Opcional) Personalizar RTMP URL
3. Guardar configuración

3. Buscar y Seleccionar Video

Pestaña 🔍 Búsqueda:
1. Buscar: "noticias live" o pegar URL directa
2. Seleccionar video de los resultados
3. Verificar que esté EN VIVO (🔴)

4. Iniciar Transmisiones

Pestaña 🎛️ Control:
1. Ver preview del video seleccionado
2. Opciones:
   a) Activar switches individuales por plataforma
   b) O clic en "▶️ Iniciar Todas"
3. Ver semáforos cambiar a 🟢 TRANSMITIENDO

5. Monitorear

Pestaña 📊 Monitor:
- Se actualiza cada 5 segundos
- Ver PIDs de procesos FFmpeg
- Verificar estado: ✅ Vivo / ❌ Muerto
- Ver tiempo activo
- Detener si es necesario

📊 Características Técnicas

Arquitectura

Usuario → Streamlit (8501) → FastAPI (8000/8080) → yt-dlp → YouTube
                ↓
            FFmpeg (PIDs) → RTMP/RTMPS → Plataformas Sociales

Gestión de Procesos

# Cada transmisión:
- Proceso FFmpeg independiente
- PID registrado y monitoreado
- Verificación continua de estado
- Logs separados por plataforma

Almacenamiento

stream_config.json       # Configuración de plataformas
process_state.json       # Estado de procesos FFmpeg
streams_state.json       # Estado de transmisiones

Comando FFmpeg Usado

ffmpeg -re -i "URL_M3U8" -c copy -f flv RTMP_URL/STREAM_KEY

🎨 Semáforos de Estado

Semáforo	Estado	Descripción
🟢	TRANSMITIENDO	Activo y funcionando correctamente
⚪	LISTO	Configurado pero no transmitiendo
🔴	ERROR	Problema con la transmisión
⚠️	DESHABILITADA	Configurada pero desactivada

🔧 Solución de Problemas Comunes

❌ "No se pudo obtener la URL del stream"

Solución:

# Actualizar yt-dlp
./docker-manager.sh → opción 11

# O reconstruir
./docker-manager.sh → opción 6

❌ "Error al descargar subtítulos"

Causa: Video sin subtítulos o con restricciones Solución: Probar con otro video

❌ "Transmisión se detuvo"

Verificar:

Video sigue en vivo
Stream Key correcta
Ver logs: docker logs streamlit_panel

❌ "Puerto ya en uso"