Kaelus Panel Web Roku V15

Guía rápida

¿Cómo se conecta el panel con el canal Roku?

El canal Roku lee esta configuración usando la URL del panel, el app_key y la API Key que colocaste en el archivo manifest. Si cambias DNS, colores, textos o demos aquí, el Roku puede sincronizarlo desde Estado / Diagnóstico.

Configura DNS activas.
Personaliza imagen y textos.
Configura demo si la usarás.
Ejecuta API / Precheck.
Prueba en el Roku físico.

DNS IPTV

Agrega los servidores IPTV que usará el canal. Aquí nacen los servicios que luego podrán usarse para login normal o autodemo.

¿Qué es una DNS?

Es la URL base de tu servidor IPTV/Xtream. El cliente entrará con usuario y contraseña, y el canal construirá las llamadas a player_api.php.

Multi-DNS

Puedes agregar varias DNS. El Roku podrá guardar varios servicios y cambiar entre ellos sin borrar el anterior.

ID DNS

El panel asigna un número ID a cada DNS. Ese ID se usa en Autodemo para saber a qué servidor pertenece cada cuenta demo.

Nombre visible del servicio Nombre que te ayuda a identificar esta DNS dentro del panel. URL base de la DNS No escribas /player_api.php. Solo la URL base del servidor. Logo URL opcional Logo del servicio. Puedes dejarlo vacío y usar el logo general. Prioridad Número para ordenar. Menor número = más prioridad. Permitir login normal Permitir usar esta DNS para demo

Ejemplo correcto

URL DNS: https://midnsiptv.com. Ejemplo incorrecto: https://midnsiptv.com/player_api.php.

Imagen y colores

Define la identidad visual del canal. Estos colores los recibe el Roku para fondo, botones, tarjetas y foco del control remoto.

Color primario

Color principal de la marca. Se usa en títulos, detalles premium y elementos destacados.

Color de foco

Color que resalta el botón o tarjeta seleccionada con el control Roku. Debe verse fuerte y claro.

Presets

Los presets aplican paletas rápidas. Luego puedes ajustar cada color manualmente y guardar.

PrimarioColor principal de marca. SecundarioColor para textos o contrastes. AcentoDetalles pequeños y etiquetas. FocoSelección activa con el control Roku. BotónColor base de botones. FondoFondo general del canal. OverlayCapa oscura sobre fondos para mejorar lectura. CardTarjetas de menú y contenido.

Home Roku premium

Configura la primera pantalla que ve el cliente después de entrar. Aquí se define la imagen comercial del canal.

Hero

Es el banner o bloque principal del Home. Debe verse comercial y llamar la atención.

Ticker

Mensaje corto tipo anuncio o frase comercial. Ideal para promociones o avisos.

Accesos rápidos

Tarjetas adicionales para demo, agregar servicio, precheck o promociones.

Etiqueta superior Texto pequeño arriba del título principal. Título principal Frase más visible del Home. Imagen hero Puede ser imagen local Roku pkg:/images/... o URL pública. Texto sincronización Mensaje que indica conexión con el panel. Subtítulo Texto descriptivo bajo el título principal. Ticker comercial Úsalo para promociones, beneficios o avisos.

Accesos rápidos

Estos cards aparecen como accesos o promociones. El campo target le dice al Roku qué abrir.

Targets comunes: livemoviesseriesservicesadd_servicedemoprecheckstatus

TítuloNombre del card. SubtítuloTexto explicativo. TargetAcción que abrirá el Roku. IconoIcono local o URL pública. BadgeEtiqueta pequeña del card. ColorColor visual del card.

Login Roku premium

Controla el primer impacto antes de entrar al servicio IPTV: textos, botones y demo.

Login normal

El usuario escribe usuario y contraseña de su servicio IPTV.

Botón demo

Solo debe mostrarse si tienes Autodemo configurado con cuentas disponibles.

Mis servicios

Permite que el cliente cambie entre servicios guardados sin borrar cuentas.

Etiqueta superiorTexto pequeño arriba del título. TítuloTítulo principal del login. SubtítuloTexto comercial del login. Título del formularioTexto sobre los campos usuario/contraseña. Texto botón loginBotón para iniciar sesión. Texto botón demoBotón para solicitar demo automática. Texto botón serviciosBotón para servicios guardados. Mensaje soporteMensaje de ayuda o contacto. Mostrar botón demo en Roku

Autodemo

Entrega demos temporales desde cuentas IPTV reales que tú agregas al pool.

1. Regla de demo

Define cuánto dura la demo, cuántas demos permite cada Roku y cuánto debe esperar el mismo dispositivo para pedir otra.

2. DNS demo

Primero crea una DNS en DNS IPTV y marca Permitir demo. Luego usa aquí el número ID de esa DNS.

3. Cuenta demo

El usuario y contraseña deben existir en tu panel/proveedor IPTV. Este panel no crea usuarios IPTV; solo los entrega al Roku.

Regla general del autodemo

Autodemo activo en el Roku Duración de la demo en minutos 60 = 1 hora, 720 = 12 horas, 1440 = 1 día, 4320 = 3 días, 10080 = 7 días. Máximo de demos por dispositivo Ejemplo: 1 significa que cada Roku solo puede pedir una demo. Cooldown en horas Tiempo de espera antes de permitir otra demo al mismo dispositivo. Nombre visible de la demo Texto que verá el usuario en el Roku.

DNS disponibles para demo

Estos son los servicios IPTV creados en DNS IPTV. Usa el ID de una DNS activa y marcada como demo.

Agregar cuenta demo al pool

Cada cuenta demo debe ser una cuenta real creada en tu servidor IPTV. Si quieres 10 demos al mismo tiempo, agrega 10 cuentas disponibles.

ID DNS Es el número ID de la DNS. No escribas la URL aquí. Usuario demo IPTV Usuario real de tu servicio IPTV. Contraseña demo IPTV Contraseña real de esa cuenta demo.

Sesiones demo activas

Aquí verás los dispositivos Roku que ya tomaron una demo, cuándo vence y si puedes liberar esa sesión manualmente.

Dispositivos Roku

Lista de equipos que han consultado el panel. Sirve para soporte, bloqueo y control de demos por dispositivo.

Roku Client ID

Identificador del dispositivo/canal. Te ayuda a reconocer el equipo del cliente.

Bloquear dispositivo

Impide que un Roku use el panel/API. Útil por abuso, pruebas vencidas o soporte.

Código soporte

El cliente puede decirte ese código para ubicar su equipo más rápido.

Subida de imágenes

Sube logos, fondos, hero e iconos para usarlos en Home, Login, cards y branding del Roku.

Logo principal

Logo de la marca que se verá en login/home.

Fondos

Imágenes para login, home o splash. Usa JPG/WEBP optimizados.

Iconos

Imágenes pequeñas para botones, menú y accesos rápidos.

Después de subir una imagen:

Copia su URL pública y úsala en Home, Login, Branding o Accesos rápidos según corresponda.

Notificaciones Roku

Mensajes administrables para mostrar avisos, promociones o mantenimiento en el canal Roku.

Tipo

Define si el mensaje es información, éxito, aviso, error, promoción o mantenimiento.

Ubicación

Define dónde debe mostrarse: global, home, login o estado.

Estado

Activa el mensaje para mostrarlo o inactívalo para ocultarlo sin borrarlo.

TítuloTítulo corto del aviso. TipoEstilo o intención del mensaje. UbicaciónDónde se mostrará en Roku. EstadoActiva = visible para Roku. MensajeTexto completo de la notificación.

Backups y snapshots

Guarda puntos de restauración antes de cambios importantes o exporta la configuración completa.

Snapshot

Guarda una copia del estado actual de configuración.

Exportar config

Genera un JSON completo para respaldo o revisión técnica.

Uso recomendado

Crea snapshot antes de cambiar DNS, colores o demo.

Eventos de dispositivos

Registro técnico de acciones, heartbeat y errores que el Roku reporta al panel.

Heartbeat

Señal periódica de que el Roku sigue activo y conectado.

Eventos

Acciones como sincronizar panel, validar servicio o pedir demo.

Soporte

Útil para detectar problemas sin estar frente al televisor del cliente.

API / Precheck

Diagnóstico para confirmar si el Roku puede recibir configuración, DNS, demo y estado del panel.

Config Roku

JSON completo que lee el canal: DNS, colores, Home, Login, demo y menú.

Precheck

Revisa si faltan DNS, cuentas demo, URLs o configuraciones importantes.

API Key

Si abres endpoints Roku sin API Key puede salir error. En el Roku la clave va en el manifest.

Prueba manual desde navegador

Para probar endpoints Roku desde el navegador usa: ?app_key=kaelus&api_key=TU_API_KEY. El Roku ya manda esos datos desde el manifest.