> For the complete documentation index, see [llms.txt](https://pekaway.gitbook.io/van-pi-dokumentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pekaway.gitbook.io/van-pi-dokumentation/displays/andere-displays/hdmi.md).

# HDMI

## HDMI

### Summary

VAN PI OS ist ein Headless-Betriebssystem und enthält standardmäßig keine Desktop-Umgebung. Es ist für den Betrieb als Serveranwendung ausgelegt.

Es gibt zwei Möglichkeiten, ein HDMI-Display mit VAN PI OS zu verwenden:

1. **Ein neues Image mit Desktop-Umgebung erstellen**
   * Erstellen Sie ein neues Image mit einer Desktop-Umgebung und installieren Sie dort den Software-Stack.
2. **Diese Anleitung verwenden**
   * Wenn Sie bereits ein HDMI-Touchdisplay besitzen und das VAN PI Dashboard darauf anzeigen möchten, können Sie die folgenden Schritte ausführen.

Da VAN PI OS als Headless-System (ohne Desktop-Umgebung) betrieben wird, verwenden wir **X.Org** für die grafische Ausgabe und **Openbox** als schlanken Fenstermanager.

### HDMI-Display einrichten

#### 1. Erforderliche Pakete installieren

Melden Sie sich per SSH am Raspberry Pi an und installieren Sie die benötigten Pakete:

```bash
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install --no-install-recommends xserver-xorg x11-xserver-utils xinit openbox
sudo apt-get install --no-install-recommends chromium-browser
```

#### 2. Konsolen-Autologin aktivieren

Führen Sie folgenden Befehl aus:

```bash
sudo raspi-config
```

Wählen Sie anschließend:

```
1 System Options → S5 Boot/Auto-Login → B2 Console Autologin
```

Sollte später ein schwarzer Rand um das Bild erscheinen, öffnen Sie:

```
2 Display Options → D2 Underscan
```

und stellen Sie die Option auf **"No"**.

#### 3. Openbox-Autostart einrichten

Bearbeiten Sie die Openbox-Autostart-Datei:

```bash
sudo nano /etc/xdg/openbox/autostart
```

Fügen Sie am Ende der Datei folgende Zeilen ein:

```bash
# Disable any form of screen saver / screen blanking / power management
xset s off
xset s noblank
# xset -dpms

# Allow quitting the X server with CTRL-ALT-Backspace
setxkbmap -option terminate:ctrl_alt_bksp

# Start Chromium in kiosk mode
sed -i 's/"exited_cleanly":false/"exited_cleanly":true/' ~/.config/chromium/'Local State'
sed -i 's/"exited_cleanly":false/"exited_cleanly":true/; s/"exit_type":"[^"]\+"/"exit_type":"Normal"/' ~/.config/chromium/Default/Preferences
chromium-browser --noerrdialogs --incognito --disable-infobars --check-for-update-interval=31536000 --kiosk 'http://127.0.0.1:1880/ui/'
```

Wenn das Display dauerhaft eingeschaltet bleiben soll, entfernen Sie das `#` vor `xset -dpms`.

Standby-Zeiten können beispielsweise mit folgendem Befehl angepasst werden:

```bash
xset -dpms 60 120
```

#### 4. X-Server automatisch starten

Erstellen oder bearbeiten Sie die Datei `.bash_profile` im Home-Verzeichnis:

```bash
nano /home/pi/.bash_profile
```

Fügen Sie folgende Zeile hinzu:

```bash
[[ -z $DISPLAY && $XDG_VTNR -eq 1 ]] && startx -- -nocursor
```

#### 5. Raspberry Pi neu starten

Starten Sie den Raspberry Pi neu, damit alle Änderungen übernommen werden:

```bash
sudo reboot now
```

#### 6. Leistung optimieren

Erhöhen Sie den GPU-Speicher in der Raspberry-Pi-Konfiguration:

```
4 Performance Options → P2 GPU Memory
```

Stellen Sie den Wert auf **256 MB**.

Öffnen Sie anschließend in Chromium die Seite:

```
chrome://flags
```

und aktivieren Sie folgende Optionen:

```
ignore-gpu-blocklist
enable-gpu-rasterization
```

Wenn Sie auf die Adressleiste von Chromium zugreifen möchten, entfernen Sie vorübergehend das Flag `--kiosk` aus der Openbox-Autostart-Datei sowie das Flag `-nocursor` aus der `.bash_profile`. Nach Abschluss der Änderungen sollten beide Optionen wieder aktiviert werden, um den Kiosk-Modus wiederherzustellen.

> **Hinweis:** Der dauerhafte Betrieb von Chromium kann die CPU-Temperatur leicht erhöhen. In unseren Tests blieben die Temperaturen jedoch auch ohne aktive Kühlung oder Kühlkörper im normalen Betriebsbereich.