0.16.1-1 release snapshot

docs/gui/audiobooks.md

@@ -0,0 +1,68 @@
+# Audiobooks
+
+Die Seite `Audiobooks` ist der spezialisierte AAX-Workflow.
+
+## Ablaufübersicht
+
+Die Oberfläche ist in drei Bereiche gegliedert:
+
+1. `Audiobooks Upload`
+2. `Audiobook Jobs`
+3. `Audiobook Output Explorer`
+
+## 1) Audiobooks Upload
+
+Der Upload verarbeitet ausschließlich AAX-Dateien.
+
+Direkt nach Upload passieren im Hintergrund:
+
+- Probe/Metadatenanalyse (ffprobe)
+- Anlage eines RAW-Ordners per `Audiobook RAW Template`
+- Ablage der AAX-Datei im RAW-Pfad
+- Initiale Jobkonfiguration (Format, Kapitel, Metadaten)
+
+Wichtige Parameter:
+
+- Zielformat (`m4b`, `mp3`, `flac`)
+- optionaler Sofortstart
+
+Toolabhängigkeit:
+
+- `ffprobe_command` für Metadaten/Kapitel
+- `ffmpeg_command` für Encode/Cover-Extraktion
+
+## 2) Audiobook Jobs
+
+Jobkarten zeigen Zustand, Fortschritt und verfügbare Aktionen.
+
+Typische Aktionen:
+
+- `Starten`
+- `Abbrechen`
+- `Retry`
+- `Löschen`
+- `Im Ripper` (Kontextwechsel)
+
+Die Karten werden regelmäßig aktualisiert und durch WebSocket-Ereignisse ergänzt.
+
+## 3) Audiobook Output Explorer
+
+Read-only Explorer des Audiobook-Outputpfads:
+
+- Ordner-/Dateistruktur
+- Zeitstempel/Größen
+- schnelle Ergebnisprüfung ohne Dateisystemwechsel
+
+## Pfad- und Template-Logik
+
+| Bereich | Gesteuert durch |
+|---|---|
+| RAW-Ablage | `raw_dir_audiobook` + `audiobook_raw_template` |
+| Finale Ausgabe | `movie_dir_audiobook` + `output_template_audiobook` |
+| Dateiformat | Jobkonfiguration (`m4b`, `mp3`, `flac`) |
+
+## Typische Probleme
+
+- Upload wird abgelehnt: Eingabedatei ist keine AAX-Datei.
+- Start schlägt fehl: `ffmpeg`/`ffprobe` nicht aufrufbar.
+- Unerwartete Pfade: Templates enthalten ungültige oder zu generische Platzhalter.