b2in/public/_cabinet/_docs/KIOSK_MODE_SETUP.md
2026-04-10 17:18:17 +02:00

11 KiB
Raw Blame History

Chrome Kiosk-Mode Setup für Android Digital Signage

🎯 Problem

Bei einem Page-Reload (z.B. nach 6h automatisch) wird der Vollbildmodus beendet - das ist eine Browser-Sicherheitsmaßnahme. Der Vollbildmodus kann nicht automatisch per Script reaktiviert werden.

Die Lösung: Chrome Kiosk-Mode

Der Kiosk-Mode ist die professionelle Lösung für Digital Signage. Chrome läuft dabei permanent im Vollbild ohne Browser-UI.


📱 Option 1: Chrome Kiosk-Mode (Empfohlen für Android)

Voraussetzungen:

  • Android-Gerät (Tablet/Display)
  • Chrome Browser installiert
  • ADB (Android Debug Bridge) für Setup

Setup-Schritte:

1. Developer-Optionen aktivieren

  1. Gehe zu EinstellungenÜber das Telefon/Tablet
  2. Tippe 7x auf "Build-Nummer"
  3. Developer-Optionen sind jetzt aktiv

2. USB-Debugging aktivieren

  1. Gehe zu EinstellungenEntwickleroptionen
  2. Aktiviere "USB-Debugging"
  3. Verbinde Gerät per USB mit Computer

3. ADB installieren (auf Computer)

Windows:

# Download Android Platform Tools
https://developer.android.com/studio/releases/platform-tools

# Entpacken und zu PATH hinzufügen

macOS:

brew install android-platform-tools

Linux:

sudo apt install android-tools-adb

4. Chrome im Kiosk-Mode starten

# Verbindung testen
adb devices

# Chrome beenden
adb shell am force-stop com.android.chrome

# Chrome im Kiosk-Mode starten
adb shell am start \
  -n com.android.chrome/com.google.android.apps.chrome.Main \
  -a android.intent.action.VIEW \
  -d "https://cabinet.b2in.eu" \
  --ez create_new_tab true \
  --activity-clear-task \
  --activity-clear-top \
  --activity-single-top

# Optional: Vollbild erzwingen
adb shell settings put global policy_control immersive.full=*

5. Auto-Start beim Boot (Optional)

Erstelle eine Boot-App oder nutze Automate-Apps:

Mit MacroDroid (kostenlose App):

  1. Installiere MacroDroid aus Play Store
  2. Erstelle Macro:
    • Trigger: "Device Boot"
    • Action: "Launch Application" → Chrome
    • Action: "Load Webpage" → https://cabinet.b2in.eu
  3. Speichern und aktivieren

📱 Option 2: Dedicated Kiosk-Browser Apps

Empfohlene Apps für Android Digital Signage:

1. Fully Kiosk Browser ( Empfohlen)

Features:

  • Echter Kiosk-Modus (keine UI, kein Zurück-Button)
  • Auto-Start beim Boot
  • Remote-Management
  • Screensaver-Funktion
  • Keep Screen On
  • Remote-Config via Web-Interface

Installation:

1. Download: https://www.fully-kiosk.com
2. Installiere APK auf Android
3. Öffne App
4. Settings:
   - Start URL: https://cabinet.b2in.eu
   - Kiosk Mode: ON
   - Launch on Boot: ON
   - Hide System UI: ON
   - Keep Screen On: ON
   - Reload on Network Restore: ON
5. Lock App (Admin Pin setzen)

Kosten:

  • Kostenlos für Single-Device
  • Plus Version: ~€20 (einmalig) für erweiterte Features

2. Kiosk Browser Lockdown

Features:

  • Einfaches Setup
  • Kiosk-Mode
  • Auto-Start
  • Kostenlos

Installation:

1. Play Store: "Kiosk Browser Lockdown"
2. URL setzen: https://cabinet.b2in.eu
3. Kiosk Mode aktivieren
4. PIN setzen

3. Chrome mit Custom Launcher

Features:

  • Nutzt Chrome Engine
  • Custom Launcher ersetzt Home-Screen
  • Kostenlos

Apps:

  • "Screen On" (Play Store)
  • "Stay Alive!" (Play Store)
  • "Screen Alive" (Play Store)

💻 Option 3: Chrome Flags (Desktop/Android)

Für Desktop-Testing:

Chrome starten mit Flags:

Windows:

"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
  --kiosk "https://cabinet.b2in.eu" ^
  --disable-session-crashed-bubble ^
  --disable-infobars ^
  --noerrdialogs ^
  --disable-translate ^
  --no-first-run ^
  --fast-start ^
  --disable-features=TranslateUI ^
  --disk-cache-dir=NUL ^
  --overscroll-history-navigation=0

macOS:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --kiosk "https://cabinet.b2in.eu" \
  --disable-session-crashed-bubble \
  --disable-infobars \
  --noerrdialogs

Linux:

google-chrome \
  --kiosk "https://cabinet.b2in.eu" \
  --disable-session-crashed-bubble \
  --disable-infobars \
  --noerrdialogs \
  --disable-translate \
  --no-first-run

Flags Erklärung:

  • --kiosk - Vollbild-Modus ohne UI
  • --disable-session-crashed-bubble - Keine "Chrome wurde nicht korrekt beendet" Meldung
  • --disable-infobars - Keine Info-Leisten
  • --noerrdialogs - Keine Error-Dialoge
  • --disable-translate - Keine Übersetzungs-Popups
  • --no-first-run - Kein First-Run-Dialog

🔧 Option 4: Unsere Fallback-Lösung (bereits implementiert)

Was haben wir implementiert:

1. LocalStorage-Tracking

// Beim Aktivieren merken
localStorage.setItem('cabinet_fullscreen_was_active', 'true');

// Nach Reload prüfen
if (wasFullscreen) {
    // Auffälliger Reminder anzeigen
}

2. Visueller Reminder

  • Orange pulsierender Button nach Reload
  • Text: "⚠️ Vollbild aktivieren!"
  • Automatisch sichtbar wenn Fullscreen vorher aktiv war

3. Auto-Retry (30s Delay)

// Nach 30s automatisch versuchen (falls Kiosk-Mode aktiv)
setTimeout(() => {
    enterFullscreen(); // Wird ignoriert wenn keine User-Geste
}, 30000);

4. Logging

 "Fullscreen aktiviert"
⚠️ "Fullscreen-Reminder angezeigt"
 "Fullscreen verlassen"

Vorteile:

  • Funktioniert ohne zusätzliche Apps
  • Visueller Hinweis dass Fullscreen reaktiviert werden muss
  • Nutzer wird "erinnert" nach Reload
  • Logging für Monitoring

Nachteile:

  • Erfordert manuellen Klick nach Reload
  • Nicht vollautomatisch

🎯 Empfohlenes Setup für Production

Für Android Digital Signage Displays:

Best Practice:

1. Hardware: Android Tablet/Display
   └─ Empfohlen: Android 9+ mit min 2GB RAM

2. Software: Fully Kiosk Browser (Plus)
   ├─ Start URL: https://cabinet.b2in.eu
   ├─ Kiosk Mode: ON
   ├─ Launch on Boot: ON
   ├─ Hide System UI: ON
   ├─ Keep Screen On: ON
   ├─ Reload on Network Restore: ON
   └─ Remote Management: ON

3. Network: Kabelgebunden (LAN)
   └─ Fallback: 5GHz WiFi mit statischer IP

4. Power: USV/Surge Protection
   └─ Auto Power-On nach Stromausfall

5. Monitoring: 
   ├─ Fully Kiosk Remote Admin
   └─ Unsere Logs: view-logs.php

Setup-Checklist:

  • Android-Gerät vorbereitet
  • Fully Kiosk Browser installiert
  • Kiosk-Mode konfiguriert
  • Auto-Start aktiviert
  • System-UI versteckt
  • Keep-Screen-On aktiviert
  • Remote-Management aktiviert (Optional)
  • PIN-Schutz gesetzt
  • Display-Helligkeit eingestellt
  • Netzwerk getestet (LAN bevorzugt)
  • Power-Management konfiguriert
  • Test-Lauf 24h durchgeführt
  • Monitoring aktiv (Logs checken)

🔍 Troubleshooting

Problem: Kiosk-Mode wird nicht aktiviert

Lösung 1: Developer-Optionen

Settings → Developer Options → "Stay Awake" ON

Lösung 2: App-Berechtigungen

Settings → Apps → Fully Kiosk → Permissions
- Display over other apps: ALLOW
- Auto-start: ALLOW

Lösung 3: Device Admin

Settings → Security → Device Administrators
- Fully Kiosk Browser: ENABLE

Problem: Display schaltet sich ab

Lösung:

1. Fully Kiosk Settings:
   - Keep Screen On: ON
   - Screen Saver: OFF
   - Prevent Sleep: ON

2. Android Settings:
   - Display → Sleep: NEVER
   - Display → Adaptive Brightness: OFF

Problem: Chrome Exit nach Reload

Lösung:

Nutze Fully Kiosk Browser statt Chrome!
- Fully ist speziell für Kiosk designed
- Kein ungewolltes Exit möglich
- Automatischer Neustart bei Crash

Problem: Zurück-Button verlässt App

Lösung:

Fully Kiosk Settings:
- Disable Back Button: ON
- Disable Home Button: ON (Device Admin nötig)
- Kiosk Mode: Advanced

📊 Vergleich der Optionen

Option Kosten Komplexität Zuverlässigkeit Empfehlung
Fully Kiosk €20 🥇 BEST
Chrome Kiosk (ADB) Kostenlos OK für Tech-Versierte
Kiosk Browser Free Kostenlos OK für Testing
Unsere Fallback-Lösung Kostenlos Fallback
Chrome + Custom Launcher Kostenlos Mittel

🎬 Quick Start: Fully Kiosk (Empfohlen)

5-Minuten-Setup:

1. Download: https://www.fully-kiosk.com
   └─ APK auf Android-Gerät installieren

2. App öffnen → Settings:
   Start URL: https://cabinet.b2in.eu
   
3. Advanced Settings:
   [x] Kiosk Mode
   [x] Launch on Boot  
   [x] Hide System UI
   [x] Keep Screen On
   [x] Prevent Sleep
   
4. Lock Settings (+ Button):
   └─ PIN setzen (z.B. 1234)
   
5. ✅ Fertig! Display läuft 24/7 im Kiosk-Mode

Remote-Management aktivieren:

1. Settings → Remote Administration:
   [x] Enable Remote Administration
   [x] Remote Admin from Local Network
   
2. Notiere IP-Adresse:
   z.B. http://192.168.1.100:2323
   
3. Öffne vom PC:
   http://192.168.1.100:2323
   └─ Password: (Dein PIN)
   
4. ✅ Remote-Control aktiv!
   - Screenshots
   - Reload
   - Settings ändern
   - Screen On/Off

💡 Pro-Tipps

1. Netzwerk-Stabilität

- LAN bevorzugen (kein WiFi)
- Statische IP vergeben
- Router/Switch mit QoS
- Fully Kiosk: "Reload on Network Restore" ON

2. Power-Management

- USV verwenden
- BIOS: "AC Power Recovery" → ON
- Android: "Auto Power On" → ON
- Fully Kiosk: "Restart on Crash" → ON

3. Display-Pflege

- Bildschirmschoner nach 22:00 Uhr
- Helligkeit reduzieren nachts
- Pixel-Shift aktivieren (gegen Burn-In)
- Display-Timeout: NEVER

4. Monitoring

- Fully Kiosk Remote Admin
- Unsere Logs: view-logs.php
- Ping-Monitoring (Nagios/Zabbix)
- Wöchentliche Checks

5. Security

- Fully Kiosk mit PIN schützen
- Device Administrator aktivieren
- USB-Debugging OFF (nach Setup)
- Unknown Sources OFF

📞 Support

Fully Kiosk Support:

Unsere Logs:


Empfehlung: Investiere die €20 für Fully Kiosk Browser Plus - es spart viele Stunden Troubleshooting und ist die stabilste Lösung für Digital Signage! 🎯


Last Update: 2026-01-19
Version: 1.3