Manual de Usuario — TotalPlay

El estado DOWN significa que el monitor del canal detectó que FFmpeg terminó con error — es decir, la fuente del stream no está respondiendo o envió datos inválidos.

Causas más comunes:

• La URL fuente del canal dejó de funcionar o cambió.
• El proveedor del stream cortó la señal temporalmente.
• Problema de red entre el servidor y la fuente.
• La fuente usa un formato de video no soportado.

Qué hacer: Copia la URL del canal y pégala en un reproductor (VLC, por ejemplo) para comprobar si la fuente responde. Si no responde, el problema está en el proveedor. Si sí responde, usa el botón 🔄 Reiniciar en la lista de canales.

El estado STARTING significa que el proceso de FFmpeg arrancó pero aún no está generando señal estable. Puede quedarse así si:

• La URL fuente responde pero tarda mucho en entregar datos (fuente lenta o con alta latencia).
• El formato del stream es incompatible y FFmpeg no logra decodificarlo.
• Los parámetros de análisis (probesize / stream_max_analyze) son muy bajos para esa fuente.

Qué hacer: Espera 2-3 minutos. Si no cambia a ONLINE, haz clic en ⏹ Detener y luego ▶ en la lista de canales para reiniciarlo. Si el problema persiste, prueba la URL en VLC.

Desde la sección Servidores, haz clic en el botón ▶ (Iniciar streams) del servidor correspondiente. Esto arranca todos los canales asignados a ese servidor de una vez.

Para detenerlos todos, usa el botón ⏹ en el mismo servidor. Úsalo con precaución — todos los usuarios perderán la señal mientras los canales reinician.

En la lista de canales, el estado ONLINE con un tiempo de uptime (ej: "01h 20m 45s") indica que el canal lleva ese tiempo transmitiendo sin interrupciones. A mayor uptime, más estable es la señal.

Para confirmar visualmente, haz clic en el botón ▶ Reproductor en la columna de acciones. Abrirá el canal en el reproductor interno del panel.

El contador de Clientes (columna verde) te muestra cuántos usuarios están viendo ese canal en este momento.

Sí. Al crear o editar un canal, en el campo URL del Stream hay un botón + que permite agregar URLs adicionales. El sistema intentará con la primera; si falla, pasará automáticamente a la siguiente.

Usa las flechas ▲▼ para cambiar el orden de prioridad de las fuentes.

En la sección Canales → Agregar Canal, haz clic en el botón "Importar M3U". Pega o proporciona la URL de una lista M3U y el sistema importará todos los canales que contiene, asignándoles automáticamente nombre, categoría y URL.

También puedes ir a Canales → Importar Canales desde el menú lateral para importar desde un archivo local.

Revisa estos puntos en orden:

• Estado de la cuenta: en la lista de usuarios verifica que el punto de estado sea verde (activo). Si es rojo, la cuenta está desactivada o vencida.
• Fecha de vencimiento: confirma que no haya expirado. Si venció, edita el usuario y extiende la fecha.
• Grilla asignada: abre el usuario, ve a la pestaña Grillas y verifica que tenga al menos una grilla asignada. Sin grilla no hay contenido.
• Formato de salida: confirma que el formato que usa el reproductor del cliente (HLS, MPEGTS o RTMP) esté habilitado en la cuenta.
• Límite de pantallas: si el usuario tiene Pantallas = 1 y ya hay una sesión activa desde otro dispositivo, será bloqueado.

Tienes dos opciones:

• Cambiar la fecha de vencimiento a una fecha pasada. El usuario queda inaccesible y cuando quieras reactivarlo simplemente extiende la fecha.
• Poner la fecha de hoy como vencimiento. El acceso se corta inmediatamente al vencer.

No elimines el usuario si quieres mantener su historial — la desactivación por fecha es reversible.

En la lista de usuarios, haz clic en el botón ··· (Acciones) del usuario y selecciona Editar. En la pestaña Detalles encontrarás el campo contraseña. Cámbiala y guarda.

También puedes hacer clic en el ícono del ojo 👁 en la lista para ver la contraseña actual sin necesidad de editarla.

Tienes dos opciones según lo que necesites:

• Conexión actual: ve a Servidores → Conexiones Online. Verás la IP, país y dispositivo de cada sesión activa en tiempo real.
• Historial: ve a Registros de Clientes, busca el nombre del usuario y revisa sus conexiones pasadas con fecha, hora, IP y contenido visto.

Al crear un usuario, ingresa su Correo del Cliente y luego haz clic en el botón "Notificar" que aparece junto al campo de correo. El sistema enviará automáticamente un mensaje con el usuario y contraseña.

Para que esto funcione, el servidor de correo SMTP debe estar configurado en Configuración → Pestaña Correo.

En TotalPlay, Grilla y Paquete son el mismo concepto — la nomenclatura interna del sistema es "Grilla". Una grilla es un conjunto de canales y/o series que se asigna a uno o más usuarios para definir qué contenido pueden ver.

Un usuario puede tener múltiples grillas asignadas al mismo tiempo, accediendo al contenido de todas ellas combinadas.

El estado ERROR en una película significa que el servidor intentó acceder a la URL del archivo y no pudo. Las causas más comunes son:

• La URL del archivo expiró o el hosting externo la eliminó.
• El archivo fue movido a otra ruta.
• El servidor no tiene acceso de red a la URL (problema de firewall o DNS).

Qué hacer: Edita la película, verifica que la URL esté correcta y activa. Puedes probarla pegándola en el navegador — si descarga o reproduce, está bien.

Hay dos causas posibles:

• URL de portada vacía o inválida: edita la película y verifica que el campo de imagen tenga una URL que responda. Si usas TMDb para importar metadatos, las portadas se completan automáticamente.
• "Descargar imágenes al servidor" desactivado: si las portadas vienen de URLs externas que luego expiran, activa esta opción en Configuración → Panel para guardar las imágenes localmente en el servidor.

El sistema se integra con The Movie Database (TMDb) para obtener metadatos automáticamente. Para usarlo:

• Regístrate en themoviedb.org y obtén una clave de API gratuita.
• Ingresa la clave en Configuración → Panel → Clave de API de TMDb.
• Define el idioma preferido (Español recomendado para contenido latino).

Una vez configurado, al agregar una película el sistema buscará automáticamente su portada, sinopsis, género y año en TMDb usando el nombre del archivo.

No exactamente. Las películas individuales no se asignan por grilla — se organizan por categorías. Si un usuario tiene acceso a una categoría de películas (a través de su grilla), verá todas las películas de esa categoría.

Las series sí se asignan directamente en las grillas. Puedes seleccionar qué series incluye cada paquete en la pestaña Series del formulario de grilla.

Las películas no se borran automáticamente al eliminar su categoría — quedan sin categoría asignada y dejan de aparecer en el catálogo visible para los usuarios, pero siguen existiendo en la base de datos.

Antes de borrar una categoría, reasigna sus películas a otra categoría o elimínalas si ya no las necesitas.

El contador de usuarios activos en el dashboard se actualiza automáticamente cada cierto intervalo. Si el contador tarda en reflejar conexiones reales:

• Haz clic en "Actualizar" (botón azul superior derecho del dashboard).
• Verifica que "Actualización automática" esté activa en Configuración → Panel.
• Reduce el Intervalo de estadísticas a un valor menor (ej: 60 segundos) si necesitas datos más frescos.

Para ver en tiempo real usa Servidores → Conexiones Online, que muestra sesiones activas inmediatamente.

En la barra superior del panel siempre verás los indicadores de CPU y RAM. Si el CPU supera el 80% de forma sostenida o la RAM supera el 90%, el servidor está bajo alta carga.

En la sección Servidores, cada servidor muestra sus métricas de CPU y RAM en tiempo real, junto con el conteo Conexiones / Máximo. Si las conexiones se acercan al máximo configurado, considera agregar otro servidor o reducir el límite de canales activos.

Señales de saturación: canales que entran y salen de DOWN/STARTING frecuentemente, usuarios que reportan cortes, latencia alta en el panel administrativo.

Se recomienda:

• Respaldo automático diario en instalaciones con cambios frecuentes (nuevos usuarios, canales o contenido).
• Respaldo manual antes de cualquier cambio importante: actualización del sistema, borrado masivo de contenido, modificaciones en la base de datos.
• Guarda al menos 7 respaldos (una semana) para poder revertir a un estado anterior si algo falla.
• Descarga una copia a un lugar externo al servidor (Google Drive, NAS local) para protegerte ante fallo del disco del servidor.

Configura esto en Respaldos → Respaldos Automáticos.

Verifica estos pasos en orden:

• EPG configurado: en EPG, confirma que haya al menos una fuente con URL válida. Usa "Forzar Recarga de EPG" para importar la guía ahora.
• Canal vinculado al EPG: edita el canal, ve a la pestaña EPG y selecciona el ID de programa correspondiente de la fuente cargada. Sin este vínculo, el canal no muestra programación aunque el EPG esté cargado.
• Zona horaria correcta: si la programación aparece pero con horarios incorrectos, verifica la zona horaria en Configuración → Servidor.

En la pantalla de login hay un enlace "¿Olvidaste tu contraseña?". Al hacer clic, el sistema te pedirá tu correo y enviará un enlace de restablecimiento.

Requisito: el servidor de correo SMTP debe estar configurado. Si no puedes acceder al correo registrado, contacta al administrador técnico del servidor para restablecer la contraseña directamente en la base de datos.

El enlace de restablecimiento expira en 30 minutos por seguridad.

La mayoría de los cambios de configuración tienen efecto inmediato. Si no ves cambios:

• Limpia el caché del navegador (Ctrl+Shift+R) — algunas opciones de interfaz se aplican al recargar.
• Verifica que el guardado fue exitoso: debería aparecer un mensaje verde de confirmación. Si apareció rojo, hubo un error — revisa los datos ingresados.
• Parámetros de streaming (búfer, sondeo, FFmpeg): algunos solo se aplican cuando se reinicia el canal. Detén y vuelve a iniciar el canal afectado.
• Configuración de correo o Telegram: usa los botones de prueba para verificar que los cambios guardados estén activos.

Sí. El panel administrativo es responsive y funciona desde navegadores móviles (Chrome, Safari). Sin embargo, para tareas de gestión intensiva (importación masiva, edición de múltiples canales) se recomienda usar una pantalla más grande para mayor comodidad.

Para visualizar el estado del sistema (dashboard, conexiones activas, estado de canales) desde el celular es perfectamente funcional.