1.0.0 docs

docs/gui/audiobooks.md

@@ -9,74 +9,100 @@ Die Oberfläche besteht aus zwei Hauptbereichen:
 1. `Audiobooks Upload`
 2. `Audiobook Jobs`
 
-## 1) Audiobooks Upload
+## 1. Audiobooks Upload
 
 Der Upload akzeptiert ausschließlich `.aax`.
 
 ### Bedienung
 
-- Datei auswählen (Button oder Drag-and-Drop)
+- Datei auswählen oder per Drag-and-Drop ablegen
 - Upload starten
 - Auswahl entfernen oder laufenden Upload abbrechen
 
 Während des Uploads zeigt die UI:
 
 - Prozentfortschritt
-- übertragene/gesamte Bytes
-- Statusmeldung (z. B. „Job vorbereitet“, „in Queue eingereiht“)
+- übertragene und gesamte Bytes
+- Statusmeldung
 
 ### Ablauf nach erfolgreichem Upload
 
-- AAX wird serverseitig geprüft
-- Audiobook-Job wird angelegt
-- Job landet je nach Pipelinezustand in `READY_TO_START`, startet direkt oder wird eingereiht
+- die AAX-Datei wird geprüft
+- Ripster versucht Metadata, Kapitel und Activation-Bytes-Kontext aufzubauen
+- ein Audiobook-Job wird angelegt
+- der Job startet direkt oder wird in die Queue eingereiht
 
-## 2) Audiobook Jobs
+## 2. Audiobook Jobs
 
-Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der `Historie`.
+Die Seite zeigt aktive Jobs. Abgeschlossene Jobs findest du in der `Historie`.
 
-Jeder Job kann eingeklappt/ausgeklappt werden und zeigt:
+Ein Job kann eingeklappt oder ausgeklappt werden und zeigt:
 
-- Titel-/Metadatenblock (Titel, Autor, Sprecher, Jahr, Kapitel)
-- Statusbadge
-- Fortschritt/ETA
-- ggf. Kapitel-Fortschritt
+- Titel, Autor, Sprecher, Jahr
+- Kapitelanzahl
+- Fortschritt und ETA
+- bei Split-Ausgabe den Kapitelstatus
 
-### Konfigurierbare Job-Parameter
+## Konfigurierbare Job-Parameter
 
-Im ausgeklappten Job:
+Im ausgeklappten Job kannst du setzen:
 
-- Ausgabeformat (`m4b`, `mp3`, `flac`)
-- formatspezifische Optionen (dynamisch je Format)
-- Kapitelnamen bearbeiten
-- Pre-Rip-Ausführungen (Skript/Kette)
-- Post-Rip-Ausführungen (Skript/Kette)
+- Ausgabeformat `m4b`, `mp3` oder `flac`
+- formatspezifische Optionen
+- Kapitelnamen
+- Pre-Encode-Skripte und -Ketten
+- Post-Encode-Skripte und -Ketten
 
 ### Formatverhalten
 
-- `m4b`: eine Datei mit Kapiteln
-- `mp3`/`flac`: kapitelweise Ausgabedateien
+- `m4b`: eine Datei mit Kapitelmarken
+- `mp3`: eine Datei pro Kapitel
+- `flac`: eine Datei pro Kapitel
 
-Für `mp3`/`flac` zeigt die UI während/nach dem Lauf eine Kapitel-Status-Tabelle (`Rip`/`Encode`).
+Wenn du `mp3` oder `flac` wählst, zeigt die UI zusätzlich eine Kapitel-Status-Tabelle.
 
-### Aktionen je Job
+## Activation Bytes
 
-- `Encode starten` (bzw. Neustart mit aktuellen Optionen)
-- `Abbrechen`
-- `Job löschen` (mit Bestätigung)
+Wenn Ripster für eine Datei keine Activation Bytes verwenden kann, wird im Workflow eine manuelle Eingabe nötig.
+
+Wichtig:
+
+- die Bytes werden lokal gecacht
+- derselbe AAX-Hash muss dann später nicht erneut manuell eingegeben werden
+- der Expertenblock in `Settings` zeigt bekannte Cache-Einträge an
 
 ## Relevante Settings
 
 - `raw_dir_audiobook`
 - `movie_dir_audiobook`
+- `raw_dir_audiobook_owner`
+- `movie_dir_audiobook_owner`
 - `audiobook_raw_template`
 - `output_template_audiobook`
 - `output_chapter_template_audiobook`
 - `ffprobe_command`
 - `ffmpeg_command`
 
+### So wirken die Settings im Alltag
+
+- `audiobook_raw_template` bestimmt den Namen des AAX-RAW-Ordners
+- `output_template_audiobook` bestimmt die Einzeldatei für `m4b`
+- `output_chapter_template_audiobook` bestimmt Zielstruktur und Dateinamen für `mp3`/`flac`
+- `ffprobe_command` liest Kapitel und Metadaten
+- `ffmpeg_command` erzeugt die finalen Dateien
+
+## Queue und Laufzeit
+
+Audiobook-Jobs nutzen dieselbe globale Pipeline wie die anderen Bereiche.
+
+Relevante Settings:
+
+- `Parallele Jobs`
+- `Max. Encodes gesamt (medienunabhängig)`
+
 ## Typische Fehlerbilder
 
-- 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.
+- Upload wird abgelehnt: Datei ist keine gültige `*.aax`
+- Analyse schlägt fehl: `ffprobe` ist nicht erreichbar
+- Encode schlägt fehl: `ffmpeg` ist nicht erreichbar
+- Ausgabe landet unerwartet: Templates oder Zielpfade passen nicht zur gewünschten Struktur