# 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