Agente Linux (PromoBrowser) — Installazione

PromoBrowser è un browser in stile kiosk basato su Python + PyQt5 / QtWebEngine. Funziona a schermo intero, senza desktop (si avvia direttamente sulla VT7), con servizio systemd.

Requisiti

• Debian 12 (Bookworm) o superiore, oppure Ubuntu 22.04 LTS o superiore.
• Accesso root (per installare i pacchetti di sistema e registrare il servizio).
• Python 3.11+ (incluso in Debian 12 / Ubuntu 22.04).
• Non richiede un ambiente desktop.

Installazione rapida (consigliata)

Esegua come root:

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

Lo script:

1. Installa i pacchetti di sistema:
   • PyQt5 + QtWebEngine + gstreamer (riproduttore)
   • python3-xlib, xorg, xinit (sessione X minima)
   • gpsd + gpsd-clients (modulo GPS opzionale — se collega un GPS USB viene rilevato automaticamente tramite USBAUTO=true)
   • onboard (tastiera a schermo per i pannelli touch, compare automaticamente all'apertura della finestra Impostazioni)
   • scrot (utility per gli screenshot; usata dal sistema di acquisizioni remote di RDS)
2. Crea il venv in /opt/promobrowser/.venv con --system-site-packages.
3. Registra il servizio systemd kiosk-browser.
4. Configura l'avvio automatico sulla VT7.
5. Abilita gpsd.socket (attivazione via socket) — il daemon parte su richiesta quando l'agente o un client lo interpella.

Dopo l'installazione:

systemctl start kiosk-browser
chvt 7

chvt 7 cambia la console virtuale attiva per farle vedere il browser sullo schermo. Se il suo apparecchio si avvia con un ambiente grafico già attivo, salti questo passaggio.

Installazione manuale

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

Sviluppo (senza servizio)

Se desidera provare l'agente senza installarlo come servizio:

bash run.sh

Installa automaticamente le dipendenze e avvia X in autonomia se non rileva alcun display.

Verifica

systemctl status kiosk-browser        # stato del servizio
journalctl -u kiosk-browser -f        # log systemd in tempo reale
tail -f /tmp/kiosk.log                # log dell'applicazione

Se è tutto corretto, dovrebbe vedere il browser a schermo intero sulla VT7 con l'URL predefinito (o il suo URL iniziale, se già configurato).

Configurazione iniziale

Al primo avvio l'agente apre un browser vuoto in attesa che lei colleghi il dispositivo:

1. Apra le impostazioni — in due modi equivalenti:
   • Tastiera: digiti 12345 (la combinazione funziona in qualsiasi momento, anche con il focus sulla pagina web).
   • Touch screen / mouse: tocchi 5 volte l'angolo in alto a sinistra in meno di 2 secondi.
2. Compare un tastierino numerico che chiede il passcode. Per impostazione predefinita è 0000. Lo cambi dalla scheda Security il prima possibile.
3. Vada alla scheda Server:
   • Server URL — https://rds.digitalsignagerds.com (predefinito).
   • Username — l'utente creato per lei da Promotienda.
   • Device ID — l'RDSXXXX assegnato a questo dispositivo nel pannello web.
   • Prema Test Connection — verifica le credenziali e registra il dispositivo sul server.
4. La configurazione del kiosk (modalità Web / Playlist, URL iniziale, whitelist, passcode) si gestisce dal pannello web — il dispositivo la riceve all'heartbeat successivo.

Versione minima