ripster/docs/gui/audiobooks.md

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.