0.14.0-4 Docs

docs/gui/audiobooks.md

@@ -1,60 +1,68 @@
 # Audiobooks
 
-Die Seite `Audiobooks` ist die dedizierte Oberfläche für AAX- und Audiobook-Jobs.
+Die Seite `Audiobooks` ist der spezialisierte AAX-Workflow.
 
----
+## Ablaufübersicht
 
-## Aufbau
+Die Oberfläche ist in drei Bereiche gegliedert:
 
 1. `Audiobooks Upload`
 2. `Audiobook Jobs`
 3. `Audiobook Output Explorer`
 
----
-
 ## 1) Audiobooks Upload
 
-Hier werden AAX-Dateien hochgeladen und als Job vorbereitet.
+Der Upload verarbeitet ausschließlich AAX-Dateien.
 
-Typische Schritte:
+Direkt nach Upload passieren im Hintergrund:
 
-1. Datei auswählen
-2. optional Format/Startverhalten setzen
-3. Upload starten
+- Probe/Metadatenanalyse (ffprobe)
+- Anlage eines RAW-Ordners per `Audiobook RAW Template`
+- Ablage der AAX-Datei im RAW-Pfad
+- Initiale Jobkonfiguration (Format, Kapitel, Metadaten)
 
-Während des Uploads zeigt die Seite Fortschritt und Status an.
+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
 
-Aktive Audiobook-Jobs werden als Karten dargestellt (mit Status und Fortschritt).
+Jobkarten zeigen Zustand, Fortschritt und verfügbare Aktionen.
 
-Pro Job sind je nach Zustand Aktionen verfügbar:
+Typische Aktionen:
 
-- Starten (mit aktueller Audiobook-Konfiguration)
-- Abbrechen
-- Retry
-- Löschen
+- `Starten`
+- `Abbrechen`
+- `Retry`
+- `Löschen`
+- `Im Ripper` (Kontextwechsel)
 
-Zusätzlich:
-
-- `Im Ripper` springt in die Hauptansicht
-- Jobs laden periodisch nach und reagieren auf WebSocket-Updates
-
----
+Die Karten werden regelmäßig aktualisiert und durch WebSocket-Ereignisse ergänzt.
 
 ## 3) Audiobook Output Explorer
 
-Read-only Baumansicht des konfigurierten Audiobook-Ausgabeordners:
+Read-only Explorer des Audiobook-Outputpfads:
 
-- Ordner- und Dateiansicht
-- Größen-/Zeitstempelübersicht
-- schnelle Kontrolle der erzeugten Ergebnisse
+- Ordner-/Dateistruktur
+- Zeitstempel/Größen
+- schnelle Ergebnisprüfung ohne Dateisystemwechsel
 
----
+## Pfad- und Template-Logik
 
-## Abgrenzung zum Converter
+| Bereich | Gesteuert durch |
+|---|---|
+| RAW-Ablage | `raw_dir_audiobook` + `audiobook_raw_template` |
+| Finale Ausgabe | `movie_dir_audiobook` + `output_template_audiobook` |
+| Dateiformat | Jobkonfiguration (`m4b`, `mp3`, `flac`) |
 
-Audio/Video-Datei-Konvertierung läuft weiterhin auf der Seite `Converter`.
-Der AAX-spezifische Flow (Upload, Start, Jobsteuerung, Output-Explorer) liegt auf `Audiobooks`.
+## 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.