1.0.0-rc1 Docs

docs/gui/audiobooks.md

@@ -1,68 +1,82 @@
 # Audiobooks
 
-Die Seite `Audiobooks` ist der spezialisierte AAX-Workflow.
+Die Seite `Audiobooks` ist der spezialisierte Workflow für Audible-`*.aax`-Dateien.
 
-## Ablaufübersicht
+## Seitenstruktur
 
-Die Oberfläche ist in drei Bereiche gegliedert:
+Die Oberfläche besteht aus zwei Hauptbereichen:
 
 1. `Audiobooks Upload`
 2. `Audiobook Jobs`
-3. `Audiobook Output Explorer`
 
 ## 1) Audiobooks Upload
 
-Der Upload verarbeitet ausschließlich AAX-Dateien.
+Der Upload akzeptiert ausschließlich `.aax`.
 
-Direkt nach Upload passieren im Hintergrund:
+### Bedienung
 
-- Probe/Metadatenanalyse (ffprobe)
-- Anlage eines RAW-Ordners per `Audiobook RAW Template`
-- Ablage der AAX-Datei im RAW-Pfad
-- Initiale Jobkonfiguration (Format, Kapitel, Metadaten)
+- Datei auswählen (Button oder Drag-and-Drop)
+- Upload starten
+- Auswahl entfernen oder laufenden Upload abbrechen
 
-Wichtige Parameter:
+Während des Uploads zeigt die UI:
 
-- Zielformat (`m4b`, `mp3`, `flac`)
-- optionaler Sofortstart
+- Prozentfortschritt
+- übertragene/gesamte Bytes
+- Statusmeldung (z. B. „Job vorbereitet“, „in Queue eingereiht“)
 
-Toolabhängigkeit:
+### Ablauf nach erfolgreichem Upload
 
-- `ffprobe_command` für Metadaten/Kapitel
-- `ffmpeg_command` für Encode/Cover-Extraktion
+- AAX wird serverseitig geprüft
+- Audiobook-Job wird angelegt
+- Job landet je nach Pipelinezustand in `READY_TO_START`, startet direkt oder wird eingereiht
 
 ## 2) Audiobook Jobs
 
-Jobkarten zeigen Zustand, Fortschritt und verfügbare Aktionen.
+Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der `Historie`.
 
-Typische Aktionen:
+Jeder Job kann eingeklappt/ausgeklappt werden und zeigt:
 
-- `Starten`
+- Titel-/Metadatenblock (Titel, Autor, Sprecher, Jahr, Kapitel)
+- Statusbadge
+- Fortschritt/ETA
+- ggf. Kapitel-Fortschritt
+
+### Konfigurierbare Job-Parameter
+
+Im ausgeklappten Job:
+
+- Ausgabeformat (`m4b`, `mp3`, `flac`)
+- formatspezifische Optionen (dynamisch je Format)
+- Kapitelnamen bearbeiten
+- Pre-Rip-Ausführungen (Skript/Kette)
+- Post-Rip-Ausführungen (Skript/Kette)
+
+### Formatverhalten
+
+- `m4b`: eine Datei mit Kapiteln
+- `mp3`/`flac`: kapitelweise Ausgabedateien
+
+Für `mp3`/`flac` zeigt die UI während/nach dem Lauf eine Kapitel-Status-Tabelle (`Rip`/`Encode`).
+
+### Aktionen je Job
+
+- `Encode starten` (bzw. Neustart mit aktuellen Optionen)
 - `Abbrechen`
-- `Retry`
-- `Löschen`
-- `Im Ripper` (Kontextwechsel)
+- `Job löschen` (mit Bestätigung)
 
-Die Karten werden regelmäßig aktualisiert und durch WebSocket-Ereignisse ergänzt.
+## Relevante Settings
 
-## 3) Audiobook Output Explorer
+- `raw_dir_audiobook`
+- `movie_dir_audiobook`
+- `audiobook_raw_template`
+- `output_template_audiobook`
+- `output_chapter_template_audiobook`
+- `ffprobe_command`
+- `ffmpeg_command`
 
-Read-only Explorer des Audiobook-Outputpfads:
+## Typische Fehlerbilder
 
-- 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.
+- Upload wird abgelehnt: Datei ist keine gültige `*.aax`.
+- Start/Encode schlägt fehl: `ffprobe` oder `ffmpeg` nicht erreichbar.
+- Unerwartete Ausgabeorte: Templates/Pfade passen nicht zur gewünschten Struktur.