# 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:

1. **Video-Cleanup** - Speicher wird nach jedem Video freigegeben
2. **Watchdog** - Überwacht ob Videos laufen und recovered automatisch
3. **Start-Timeout** - Videos die nicht starten werden übersprungen
4. **Error Recovery** - Automatischer Skip bei defekten Videos
5. **Memory-Monitoring** - Speicherüberwachung alle 10 Minuten
6. **Präventiver Reload** - Automatischer Neustart alle 6 Stunden
7. **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 200 MB**
- [ ] Länge: **15-60 Sekunden** (optimal)

### ⚠️ Vermeiden:
- ❌ Zu große Dateien (>200MB)
- ❌ Zu hohe Bitrate (>10 Mbps)
- ❌ Zu lange Videos (>3 Min)
- ❌ Exotische Formate (MOV, AVI, WMV)
- ❌ 4K Videos (overkill für Display)

### 🔧 Video optimieren (FFmpeg):
```bash
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:**
```javascript
// 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:
1. **Check Internet:** Speedtest machen
2. **Videos optimieren:** Bitrate reduzieren (5 Mbps)
3. **Playlist reduzieren:** Weniger Videos = weniger Daten
4. **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:

1. **Logs sichern:**
   - Öffne view-logs.php
   - Download/Screenshot der Fehler
   - Besonders ERROR und FATAL Logs

2. **Info sammeln:**
   - Welches Display (IP/Standort)?
   - Wann trat Problem auf?
   - Was zeigen die Logs?
   - Memory-Status?

3. **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!**