Erster Commit

README.md

@@ -0,0 +1,62 @@
+# 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)