ripster/docs/gui/audiobooks.md

Audiobooks

Die Seite Audiobooks ist der spezialisierte Workflow für Audible-*.aax-Dateien.

Seitenstruktur

Die Oberfläche besteht aus zwei Hauptbereichen:

1. Audiobooks Upload
2. Audiobook Jobs

1) Audiobooks Upload

Der Upload akzeptiert ausschließlich .aax.

Bedienung

• Datei auswählen (Button oder Drag-and-Drop)
• 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“)

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

2) Audiobook Jobs

Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der Historie.

Jeder Job kann eingeklappt/ausgeklappt werden und zeigt:

• 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
• Job löschen (mit Bestätigung)

Relevante Settings

• raw_dir_audiobook
• movie_dir_audiobook
• audiobook_raw_template
• output_template_audiobook
• output_chapter_template_audiobook
• ffprobe_command
• ffmpeg_command

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.