Files
ripster/docs/gui/audiobooks.md
T
michael 5e24c6b9cc
Deploy Docs to GitHub Pages / Build Documentation (push) Has been cancelled
Deploy Docs to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled
1.0.0 docs
2026-06-12 10:38:45 +02:00

109 lines
2.8 KiB
Markdown

# 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