Files
ripster/docs/gui/audiobooks.md
T
michael 9b38d78042
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-rc1 Docs
2026-05-08 09:01:17 +02:00

83 lines
2.0 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 (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.