Agent Linux (PromoBrowser) — Installation

PromoBrowser est un navigateur de type kiosk basé sur Python + PyQt5 / QtWebEngine. Il fonctionne en plein écran, sans bureau (démarre directement sur la VT7), via un service systemd.

Prérequis

• Debian 12 (Bookworm) ou supérieur, ou Ubuntu 22.04 LTS ou supérieur.
• Accès root (pour installer les paquets système et enregistrer le service).
• Python 3.11+ (inclus dans Debian 12 / Ubuntu 22.04).
• Pas besoin d'environnement de bureau.

Installation rapide (recommandée)

Exécuter en tant que root :

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

Le script :

1. Installe les paquets système :
   • PyQt5 + QtWebEngine + gstreamer (lecteur)
   • python3-xlib, xorg, xinit (session X minimale)
   • gpsd + gpsd-clients (module GPS optionnel — si vous branchez un GPS USB, il est auto-détecté via USBAUTO=true)
   • onboard (clavier à l'écran pour écrans tactiles, affiché automatiquement à l'ouverture du dialogue de Paramètres)
   • scrot (utilitaire de capture d'écran ; utilisé par le système de captures distantes depuis RDS)
2. Crée le venv dans /opt/promobrowser/.venv avec --system-site-packages.
3. Enregistre le service systemd kiosk-browser.
4. Configure le démarrage automatique sur VT7.
5. Active gpsd.socket (activation par socket) — le daemon démarre à la demande lorsque l'agent ou un client le sollicite.

Après installation :

systemctl start kiosk-browser
chvt 7

chvt 7 change la console virtuelle active pour voir le navigateur à l'écran. Sautez cette étape si votre machine démarre déjà avec un environnement graphique actif.

Installation manuelle

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

Développement (sans service)

Pour tester l'agent sans l'installer comme service :

bash run.sh

Auto-installe les dépendances et démarre X automatiquement si aucun display n'est détecté.

Vérification

systemctl status kiosk-browser        # état du service
journalctl -u kiosk-browser -f        # logs systemd en direct
tail -f /tmp/kiosk.log                # logs de l'application

Si tout est correct, vous devriez voir le navigateur plein écran sur la VT7 avec l'URL par défaut (ou votre URL d'accueil si elle est déjà configurée).

Configuration initiale

Au premier démarrage, l'agent ouvre un navigateur vide en attendant que vous lui liiez l'appareil :

1. Ouvrez les paramètres — deux moyens équivalents :
   • Clavier : tapez 12345 (la combinaison fonctionne à tout moment, même avec le focus sur la page web).
   • Écran tactile / souris : touchez 5 fois dans le coin supérieur gauche en moins de 2 secondes.
2. Un pavé numérique demande le mot de passe. Par défaut 0000. Changez-le depuis l'onglet Security dès que possible.
3. Allez dans l'onglet Server :
   • Server URL — https://rds.digitalsignagerds.com (par défaut).
   • Username — l'utilisateur que Promotienda a créé pour vous.
   • Device ID — le RDSXXXX que vous avez assigné à cet appareil dans le panneau web.
   • Appuyez sur Test Connection — vérifie les identifiants et enregistre l'appareil auprès du serveur.
4. La configuration du kiosk (mode Web / Playlist, URL d'accueil, whitelist, mot de passe) est gérée depuis le panneau web — l'appareil la reçoit au prochain heartbeat.

Version minimale