Agent Linux (PromoBrowser) — Instal·lació

PromoBrowser és un navegador estil kiosk basat en Python + PyQt5 / QtWebEngine. Funciona a pantalla completa, sense escriptori (arrenca directament sobre la VT7), amb servei systemd.

Requisits

• Debian 12 (Bookworm) o superior, o Ubuntu 22.04 LTS o superior.
• Accés root (per instal·lar paquets del sistema i registrar el servei).
• Python 3.11+ (inclòs a Debian 12 / Ubuntu 22.04).
• No necessita entorn d'escriptori.

Instal·lació ràpida (recomanada)

Executa com a root:

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

L'script:

1. Instal·la els paquets del sistema:
   • PyQt5 + QtWebEngine + gstreamer (reproductor)
   • python3-xlib, xorg, xinit (sessió X mínima)
   • gpsd + gpsd-clients (mòdul GPS opcional — si connectes un GPS USB s'autodetecta via USBAUTO=true)
   • onboard (teclat en pantalla per a pantalles tàctils, es mostra automàticament en obrir el diàleg d'Ajustaments)
   • scrot (utilitat per a captures de pantalla; usada pel sistema de captures remotes des de RDS)
2. Crea el venv a /opt/promobrowser/.venv amb --system-site-packages.
3. Registra el servei systemd kiosk-browser.
4. Configura l'arrencada automàtica a VT7.
5. Habilita gpsd.socket (activació per socket) — el daemon arrenca a demanda quan l'agent o un client el sol·licita.

Després d'instal·lar:

systemctl start kiosk-browser
chvt 7

chvt 7 canvia la consola virtual activa perquè vegis el navegador a pantalla. Si el teu equip arrenca amb un entorn gràfic ja actiu, saltà-t'ho.

Instal·lació 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

Desenvolupament (sense servei)

Si vols provar l'agent sense instal·lar-lo com a servei:

bash run.sh

Auto-instal·la dependències i arrenca X automàticament si no es detecta cap display.

Verificació

systemctl status kiosk-browser        # estat del servei
journalctl -u kiosk-browser -f        # logs systemd en viu
tail -f /tmp/kiosk.log                # logs de l'aplicació

Si tot és correcte, hauries de veure el navegador a pantalla completa a la VT7 amb la URL per defecte (o la teva URL d'inici si ja està configurada).

Configuració inicial

En arrencar per primera vegada l'agent obre un navegador en blanc a l'espera que vinculis el dispositiu:

1. Obre els ajustaments — dues maneres equivalents:
   • Teclat: tecleja 12345 (la combinació funciona en qualsevol moment, fins i tot amb el focus a la pàgina web).
   • Pantalla tàctil / ratolí: toca 5 vegades a la cantonada superior esquerra en menys de 2 segons.
2. Apareix un teclat numèric demanant el passcode. Per defecte és 0000. Canvia'l des de la pestanya Security al més aviat possible.
3. Vés a la pestanya Server:
   • Server URL — https://rds.digitalsignagerds.com (per defecte).
   • Username — l'usuari que t'ha creat Promotienda.
   • Device ID — el RDSXXXX que has assignat a aquest dispositiu al panell web.
   • Prem Test Connection — verifica credencials i registra el dispositiu al servidor.
4. La configuració del kiosk (mode Web / Playlist, URL inici, whitelist, passcode) la gestiones des del panell web — el dispositiu la rep al seu pròxim heartbeat.

Versió mínima