6.6 KiB
6.6 KiB
Cabinet Digital Signage - Quick Start Guide
🚀 Schnellstart nach Video-Optimierung
Was wurde geändert?
Die Display-Software wurde massiv optimiert um das Problem mit schwarzen Bildschirmen nach längerer Laufzeit zu beheben.
✅ Version 1.3 Features:
- Video-Cleanup - Speicher wird nach jedem Video freigegeben
- Watchdog - Überwacht ob Videos laufen und recovered automatisch
- Start-Timeout - Videos die nicht starten werden übersprungen
- Error Recovery - Automatischer Skip bei defekten Videos
- Memory-Monitoring - Speicherüberwachung alle 10 Minuten
- Präventiver Reload - Automatischer Neustart alle 6 Stunden
- Performance-Boost - CSS Hardware-Beschleunigung aktiviert
📱 Display Setup
1. Display aufrufen
https://cabinet.b2in.eu
2. Vollbild aktivieren
- Klicke auf "V 1.3" Button oben links
- Display wechselt in Vollbildmodus
- Button verschwindet automatisch
⚠️ WICHTIG: Bei einem Page-Reload (nach 6h oder bei Fehlern) wird der Vollbildmodus beendet. Du siehst dann einen orange pulsierenden Button mit "⚠️ Vollbild aktivieren!". Einfach erneut klicken.
💡 Besser: Nutze Fully Kiosk Browser für permanenten Vollbild ohne manuelles Klicken. Siehe KIOSK_MODE_SETUP.md
3. Laufen lassen
- Display läuft jetzt automatisch 24/7
- Automatischer Reload alle 6 Stunden
- Watchdog überwacht Video-Playback
- Bei Problemen: Automatische Self-Recovery
📊 Monitoring
Log-Viewer öffnen:
https://cabinet.b2in.eu/view-logs.php
Was solltest du sehen:
✅ Normale Logs (alles OK):
[INFO] Video started: video1.mp4
[INFO] Video cleanup durchgeführt
[INFO] Heartbeat - Display is running
[INFO] Memory Status: 45% (230MB / 512MB)
[INFO] Playlist-Loop abgeschlossen
⚠️ Warnungen (beobachten):
[WARNING] Video stalled (buffering)
[WARNING] Hohe Speicherauslastung (85%)
[WARNING] Überspringe zum nächsten Video
❌ Fehler (Action nötig):
[ERROR] Video start timeout
[ERROR] Video Error: MEDIA_ERR_NETWORK
[ERROR] Kritischer Zustand erkannt
[FATAL] JavaScript Error
🎬 Video-Upload Checklist
Beim Hochladen neuer Videos beachten:
✅ Must-Have:
- Format: MP4 (H.264 + AAC)
- Auflösung: Max 1920x1080
- Bitrate: 5-10 Mbps
- Dateigröße: Max 100 MB
- Länge: 15-60 Sekunden (optimal)
⚠️ Vermeiden:
- ❌ Zu große Dateien (>100MB)
- ❌ Zu hohe Bitrate (>10 Mbps)
- ❌ Zu lange Videos (>3 Min)
- ❌ Exotische Formate (MOV, AVI, WMV)
- ❌ 4K Videos (overkill für Display)
🔧 Video optimieren (FFmpeg):
ffmpeg -i input.mp4 \
-c:v libx264 -preset slow -crf 23 \
-c:a aac -b:a 128k \
-vf scale=1920:1080 \
-movflags +faststart \
output.mp4
🐛 Troubleshooting
Problem: Schwarzer Bildschirm
Schritt 1: Logs checken
→ Öffne view-logs.php
→ Schaue nach ERROR oder FATAL Logs
Schritt 2: Was sagt das Log?
"Video start timeout"
- Video lädt nicht → Check Video-URL
- Video zu groß → Komprimieren
- Netzwerkproblem → Check Internet
"Video Error: MEDIA_ERR_NETWORK"
- Netzwerk-Issue → Check Router/Internet
- Server down → Check b2in.eu erreichbar
"Video definitiv stuck"
- ✅ Watchdog hat recovered!
- Video wurde übersprungen
- Nächstes Video sollte laufen
"Hohe Speicherauslastung"
- Videos zu groß → Komprimieren
- Zu viele Videos → Playlist verkleinern
- Warte auf automatischen Reload (alle 6h)
Schritt 3: Manuelle Actions
Display neu laden:
// In Browser-Console (F12):
location.reload();
Display komplett neustarten:
1. Browser schließen
2. Warten 10 Sekunden
3. Browser neu öffnen
4. URL aufrufen
5. Vollbild aktivieren
Problem: Video buffert ständig
Ursachen:
- Internetverbindung zu langsam
- Video-Bitrate zu hoch
- Netzwerk überlastet
Lösung:
- Check Internet: Speedtest machen
- Videos optimieren: Bitrate reduzieren (5 Mbps)
- Playlist reduzieren: Weniger Videos = weniger Daten
- Router prüfen: Neustart? Kabel OK?
Problem: Footer läuft, Video nicht
Das war das Haupt-Problem! Jetzt gefixt durch:
- ✅ Video-Cleanup nach jedem Video
- ✅ Watchdog erkennt stuck Videos
- ✅ Automatischer Skip/Recovery
- ✅ Memory-Management
- ✅ Präventiver Reload alle 6h
Falls es DOCH noch passiert:
1. Logs checken: view-logs.php
2. Memory-Status prüfen
3. Watchdog-Logs suchen
4. Falls >3 Fehler: Display reload automatisch
5. Falls nicht: Manuell reloaden
📞 Support
Bei Problemen:
-
Logs sichern:
- Öffne view-logs.php
- Download/Screenshot der Fehler
- Besonders ERROR und FATAL Logs
-
Info sammeln:
- Welches Display (IP/Standort)?
- Wann trat Problem auf?
- Was zeigen die Logs?
- Memory-Status?
-
Kontakt:
- Mit Log-Auszug
- Screenshots
- Display-Info
🎯 Monitoring-Routine
Täglich (optional):
- Kurzer Blick auf Display (läuft es?)
- Bei Problemen: Logs checken
Wöchentlich:
- Logs checken (view-logs.php)
- Statistiken ansehen (Fatal/Error/Warning)
- Memory-Status prüfen
- Watchdog-Interventionen zählen
Monatlich:
- Alte Logs aufräumen (>30 Tage automatisch)
- Video-Performance überprüfen
- Playlist aktualisieren
- Display-Uptime checken
💡 Tipps & Tricks
Performance optimieren:
- Halte Playlist klein (5-10 Videos)
- Optimiere Videos vor Upload
- Nutze konsistente Video-Auflösung
- Vermeide sehr lange Videos (>2 Min)
Zuverlässigkeit erhöhen:
- Lass präventiven Reload aktiv (6h)
- Check Logs wöchentlich
- Halte Internet-Verbindung stabil
- Nutze kabelgebundenes Netzwerk statt WiFi
Memory sparen:
- Videos komprimieren (H.264, CRF 23)
- Playlist auf 10 Videos limitieren
- Preload='metadata' (bereits aktiv)
- Automatischer Cleanup (bereits aktiv)
✨ Neue Features nutzen
Auto-Recovery:
Display recovered jetzt automatisch von:
✅ Stuck Videos (Watchdog)
✅ Video-Ladefehlern (Skip)
✅ Start-Timeouts (Skip)
✅ Memory-Problemen (Reload nach 6h)
✅ Kritischen Fehlern (Reload)
Logging:
Alle Events werden geloggt:
📊 Video-Start/Ende
📊 Memory-Status
📊 Fehler und Warnungen
📊 Watchdog-Interventionen
📊 Heartbeats (Display läuft)
Monitoring:
Live-Überwachung möglich:
🔍 view-logs.php
🔍 Auto-Refresh alle 10s
🔍 Statistiken (Fatal/Error/Warning)
🔍 Farbcodierung nach Schwere
Version: 1.3
Release: 2026-01-19
Status: ✅ Production Ready
🎉 Viel Erfolg mit dem optimierten Display!