Files
hdmiviewer/README.md
2026-08-27 09:47:58 +02:00

63 lines
1.7 KiB
Markdown

# HDMI Viewer
Ein schlanker Qt6/C++ HDMI-Viewer für Arch Linux mit V4L2 (Video) und ALSA (Audio).
Gedacht als Companion zu OBS Studio: **Anzeigen ohne Aufnehmen**.
## Features
- Live-Vorschau vom HDMI-Grabber via V4L2 (YUYV und NV12)
- ALSA-Audio direkt vom Grabber-Gerät
- Gerät-Auswahl beim Start, **Audio-Gerät wird gespeichert**
- **F** → Vollbild / **F** oder **Esc** im Vollbild → Fenstermodus
- **Esc** im Fenstermodus → zurück zur Gerät-Auswahl (Device wird sauber freigegeben)
- Seitenverhältnis immer bewahrt (Letterbox/Pillarbox)
- Titelleiste zeigt tatsächliche Auflösung und FPS
- Colorspace-Konvertierung im ThreadPool (kein Ruckeln)
- FPS explizit auf 60fps gesetzt (was Grabber liefert wird in Statusbar angezeigt)
## Abhängigkeiten (Arch Linux)
```bash
sudo pacman -S qt6-base cmake alsa-lib linux-headers base-devel
```
## Bauen
```bash
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)
```
## Starten
```bash
./hdmi-viewer
```
## Tastenkürzel
| Taste | Funktion |
|--------------|---------------------------------------------|
| F | Vollbild ein/aus |
| Esc | Vollbild verlassen ODER zurück zum Dialog |
## Einstellungen
Werden gespeichert in: `~/.config/hdmi-viewer/HDMIViewer.conf`
(Standard XDG-Pfad, kein manuelles Anlegen nötig)
## Audio-Gerät finden
```bash
# Alle ALSA-Capture-Geräte auflisten
arecord -l
# Testen (hw:X,Y aus arecord -l, z.B. hw:2,0)
arecord -D hw:2,0 -f S16_LE -r 48000 -c 2 /tmp/test.wav
aplay /tmp/test.wav
```
Das Gerät dann im Dialog so eingeben: z.B. `hw:2,0` oder `plughw:2,0`
(plughw macht automatische Sample-Rate-Konvertierung, falls nötig)