Linux-Agent (PromoBrowser) — Installation

PromoBrowser ist ein Browser im Kiosk-Stil auf Basis von Python + PyQt5 / QtWebEngine. Er läuft im Vollbild, ohne Desktop (startet direkt auf der VT7), als systemd-Dienst.

Voraussetzungen

• Debian 12 (Bookworm) oder höher bzw. Ubuntu 22.04 LTS oder höher.
• root-Zugriff (zum Installieren von Systempaketen und Registrieren des Dienstes).
• Python 3.11+ (in Debian 12 / Ubuntu 22.04 enthalten).
• Keine Desktop-Umgebung erforderlich.

Schnellinstallation (empfohlen)

Als root ausführen:

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

Das Skript:

1. Installiert die Systempakete:
   • PyQt5 + QtWebEngine + gstreamer (Player)
   • python3-xlib, xorg, xinit (minimale X-Sitzung)
   • gpsd + gpsd-clients (optionales GPS-Modul — ein angeschlossenes USB-GPS wird über USBAUTO=true automatisch erkannt)
   • onboard (Bildschirmtastatur für Touchscreens, erscheint automatisch beim Öffnen des Einstellungsdialogs)
   • scrot (Werkzeug für Screenshots; wird vom System für Remote-Aufnahmen aus RDS genutzt)
2. Legt das venv unter /opt/promobrowser/.venv mit --system-site-packages an.
3. Registriert den systemd-Dienst kiosk-browser.
4. Richtet den automatischen Start auf VT7 ein.
5. Aktiviert gpsd.socket (Socket-Aktivierung) — der Daemon startet bei Bedarf, sobald der Agent oder ein Client ihn anfordert.

Nach der Installation:

systemctl start kiosk-browser
chvt 7

chvt 7 wechselt die aktive virtuelle Konsole, damit Sie den Browser auf dem Bildschirm sehen. Wenn Ihr Rechner bereits mit einer aktiven grafischen Umgebung startet, überspringen Sie das.

Manuelle Installation

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

Entwicklung (ohne Dienst)

Wenn Sie den Agenten testen möchten, ohne ihn als Dienst zu installieren:

bash run.sh

Installiert Abhängigkeiten automatisch und startet X selbstständig, wenn kein Display erkannt wird.

Überprüfung

systemctl status kiosk-browser        # Status des Dienstes
journalctl -u kiosk-browser -f        # systemd-Logs live
tail -f /tmp/kiosk.log                # Logs der Anwendung

Wenn alles korrekt ist, sollten Sie den Browser im Vollbild auf der VT7 sehen — mit der Standard-URL oder Ihrer Start-URL, falls diese bereits konfiguriert ist.

Erstkonfiguration

Beim ersten Start öffnet der Agent einen leeren Browser und wartet darauf, dass Sie das Gerät verknüpfen:

1. Öffnen Sie die Einstellungen — auf zwei gleichwertige Arten:
   • Tastatur: Geben Sie 12345 ein (die Kombination funktioniert jederzeit, auch wenn der Fokus auf der Webseite liegt).
   • Touchscreen / Maus: Tippen Sie innerhalb von 2 Sekunden 5-mal auf die linke obere Ecke.
2. Es erscheint ein Ziffernblock, der den Passcode abfragt. Standard ist 0000. Ändern Sie ihn so bald wie möglich über die Registerkarte Security.
3. Wechseln Sie zur Registerkarte Server:
   • Server URL — https://rds.digitalsignagerds.com (Standard).
   • Username — der von Promotienda für Sie angelegte Benutzer.
   • Device ID — die RDSXXXX, die Sie diesem Gerät im Web-Panel zugewiesen haben.
   • Klicken Sie auf Test Connection — das prüft die Zugangsdaten und registriert das Gerät auf dem Server.
4. Die Kiosk-Konfiguration (Modus Web / Playlist, Start-URL, Whitelist, Passcode) verwalten Sie über das Web-Panel — das Gerät erhält sie mit seinem nächsten Heartbeat.

Mindestversion