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 oder per Drag-and-Drop ablegen
• Upload starten
• Auswahl entfernen oder laufenden Upload abbrechen

Während des Uploads zeigt die UI:

• Prozentfortschritt
• übertragene und gesamte Bytes
• Statusmeldung

Ablauf nach erfolgreichem Upload

• 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

Die Seite zeigt aktive Jobs. Abgeschlossene Jobs findest du in der Historie.

Ein Job kann eingeklappt oder ausgeklappt werden und zeigt:

• Titel, Autor, Sprecher, Jahr
• Kapitelanzahl
• Fortschritt und ETA
• bei Split-Ausgabe den Kapitelstatus

Konfigurierbare Job-Parameter

Im ausgeklappten Job kannst du setzen:

• Ausgabeformat m4b, mp3 oder flac
• formatspezifische Optionen
• Kapitelnamen
• Pre-Encode-Skripte und -Ketten
• Post-Encode-Skripte und -Ketten

Formatverhalten

• m4b: eine Datei mit Kapitelmarken
• mp3: eine Datei pro Kapitel
• flac: eine Datei pro Kapitel

Wenn du mp3 oder flac wählst, zeigt die UI zusätzlich eine Kapitel-Status-Tabelle.

Activation Bytes

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
• 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