Agente Linux (PromoBrowser) — Instalação

PromoBrowser é um navegador estilo kiosk baseado em Python + PyQt5 / QtWebEngine. Funciona em ecrã inteiro, sem ambiente de trabalho (arranca diretamente sobre a VT7), com serviço systemd.

Requisitos

• Debian 12 (Bookworm) ou posterior, ou Ubuntu 22.04 LTS ou posterior.
• Acesso root (para instalar pacotes do sistema e registar o serviço).
• Python 3.11+ (incluído no Debian 12 / Ubuntu 22.04).
• Não necessita de ambiente de trabalho.

Instalação rápida (recomendado)

Execute como root:

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

O script:

1. Instala os pacotes do sistema:
   • PyQt5 + QtWebEngine + gstreamer (leitor)
   • python3-xlib, xorg, xinit (sessão X mínima)
   • gpsd + gpsd-clients (módulo GPS opcional — se ligar um GPS USB é autodetetado via USBAUTO=true)
   • onboard (teclado no ecrã para ecrãs táteis, é mostrado automaticamente ao abrir o diálogo de Definições)
   • scrot (utilitário para capturas de ecrã; usado pelo sistema de capturas remotas a partir do RDS)
2. Cria o venv em /opt/promobrowser/.venv com --system-site-packages.
3. Regista o serviço systemd kiosk-browser.
4. Configura o arranque automático na VT7.
5. Ativa gpsd.socket (ativação por socket) — o daemon arranca a pedido quando o agente ou um cliente o solicita.

Após instalar:

systemctl start kiosk-browser
chvt 7

chvt 7 muda a consola virtual ativa para que veja o navegador no ecrã. Se o seu equipamento arrancar com um ambiente gráfico já ativo, ignore-o.

Instalação 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

Desenvolvimento (sem serviço)

Se pretender testar o agente sem o instalar como serviço:

bash run.sh

Auto-instala as dependências e arranca o X automaticamente se não houver display detetado.

Verificação

systemctl status kiosk-browser        # estado do serviço
journalctl -u kiosk-browser -f        # logs systemd em direto
tail -f /tmp/kiosk.log                # logs da aplicação

Se tudo estiver correto, deverá ver o navegador em ecrã inteiro na VT7 com o URL por defeito (ou o seu URL inicial se já estiver configurado).

Configuração inicial

No primeiro arranque, o agente abre um navegador em branco a aguardar que vincule o dispositivo:

1. Abra as definições — duas formas equivalentes:
   • Teclado: escreva 12345 (a combinação funciona a qualquer momento, mesmo com o foco na página web).
   • Ecrã tátil / rato: toque 5 vezes no canto superior esquerdo em menos de 2 segundos.
2. Aparece um teclado numérico a pedir o passcode. Por defeito é 0000. Altere-o no separador Security o quanto antes.
3. Vá ao separador Server:
   • Server URL — https://rds.digitalsignagerds.com (por defeito).
   • Username — o utilizador que a Promotienda lhe criou.
   • Device ID — o RDSXXXX que atribuiu a este dispositivo no painel web.
   • Carregue em Test Connection — verifica as credenciais e regista o dispositivo no servidor.
4. A configuração do kiosk (modo Web / Playlist, URL inicial, whitelist, passcode) é gerida a partir do painel web — o dispositivo recebe-a no próximo heartbeat.

Versão mínima