Agente Linux (PromoBrowser) — Instalación

PromoBrowser es un navegador estilo kiosk basado en Python + PyQt5 / QtWebEngine. Funciona a pantalla completa, sin escritorio (arranca directamente sobre la VT7), con servicio systemd.

Requisitos

• Debian 12 (Bookworm) o superior, o Ubuntu 22.04 LTS o superior.
• Acceso root (para instalar paquetes del sistema y registrar el servicio).
• Python 3.11+ (incluido en Debian 12 / Ubuntu 22.04).
• No necesita entorno de escritorio.

Instalación rápida (recomendado)

Ejecuta como root:

curl -fsSL https://rds.digitalsignagerds.com/install.sh | bash

El script:

1. Instala los paquetes del sistema:
   • PyQt5 + QtWebEngine + gstreamer (reproductor)
   • python3-xlib, xorg, xinit (sesión X mínima)
   • gpsd + gpsd-clients (módulo GPS opcional — si conectas un GPS USB se autodetecta vía USBAUTO=true)
   • onboard (teclado en pantalla para pantallas táctiles, se muestra automáticamente al abrir el diálogo de Ajustes)
   • scrot (utilidad para capturas de pantalla; usada por el sistema de capturas remotas desde RDS)
2. Crea el venv en /opt/promobrowser/.venv con --system-site-packages.
3. Registra el servicio systemd kiosk-browser.
4. Configura el arranque automático en VT7.
5. Habilita gpsd.socket (activación por socket) — el daemon arranca a demanda cuando el agente o un cliente lo solicita.

Después de instalar:

systemctl start kiosk-browser
chvt 7

chvt 7 cambia la consola virtual activa para que veas el navegador en pantalla. Si tu equipo arranca con un entorno gráfico ya activo, sáltalo.

Instalación manual

git clone --branch main --depth 1 https://github.com/promotienda/promobrowser.git
cd promobrowser
sudo bash install.sh
systemctl start kiosk-browser
chvt 7

Desarrollo (sin servicio)

Si quieres probar el agente sin instalarlo como servicio:

bash run.sh

Auto-instala dependencias y arranca X automáticamente si no hay display detectado.

Verificación

systemctl status kiosk-browser        # estado del servicio
journalctl -u kiosk-browser -f        # logs systemd en vivo
tail -f /tmp/kiosk.log                # logs de la aplicación

Si todo está correcto, deberías ver el navegador a pantalla completa en la VT7 con la URL por defecto (o tu URL de inicio si ya está configurada).

Configuración inicial

Al arrancar por primera vez el agente abre un navegador en blanco a la espera de que vincules el dispositivo:

1. Abre los ajustes — dos maneras equivalentes:
   • Teclado: teclea 12345 (la combinación funciona en cualquier momento, incluso con el foco en la página web).
   • Pantalla táctil / ratón: toca 5 veces en la esquina superior izquierda en menos de 2 segundos.
2. Aparece un teclado numérico pidiendo el passcode. Por defecto es 0000. Cámbialo desde la pestaña Security lo antes posible.
3. Ve a la pestaña Server:
   • Server URL — https://rds.digitalsignagerds.com (por defecto).
   • Username — el usuario que te creó Promotienda.
   • Device ID — el RDSXXXX que asignaste a este dispositivo en el panel web.
   • Pulsa Test Connection — verifica credenciales y registra el dispositivo en el servidor.
4. La configuración del kiosk (modo Web / Playlist, URL inicio, whitelist, passcode) la gestionas desde el panel web — el dispositivo la recibe en su próximo heartbeat.

Versión mínima