0.14.0-4 Merger
Deploy Docs to GitHub Pages / Build Documentation (push) Has been cancelled
Deploy Docs to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled

This commit is contained in:
2026-04-21 14:27:07 +00:00
parent caf6a638f7
commit c27a81cdb1
127 changed files with 10643 additions and 335 deletions
+60
View File
@@ -0,0 +1,60 @@
# Audiobooks
Die Seite `Audiobooks` ist die dedizierte Oberfläche für AAX- und Audiobook-Jobs.
---
## Aufbau
1. `Audiobooks Upload`
2. `Audiobook Jobs`
3. `Audiobook Output Explorer`
---
## 1) Audiobooks Upload
Hier werden AAX-Dateien hochgeladen und als Job vorbereitet.
Typische Schritte:
1. Datei auswählen
2. optional Format/Startverhalten setzen
3. Upload starten
Während des Uploads zeigt die Seite Fortschritt und Status an.
---
## 2) Audiobook Jobs
Aktive Audiobook-Jobs werden als Karten dargestellt (mit Status und Fortschritt).
Pro Job sind je nach Zustand Aktionen verfügbar:
- Starten (mit aktueller Audiobook-Konfiguration)
- Abbrechen
- Retry
- Löschen
Zusätzlich:
- `Im Ripper` springt in die Hauptansicht
- Jobs laden periodisch nach und reagieren auf WebSocket-Updates
---
## 3) Audiobook Output Explorer
Read-only Baumansicht des konfigurierten Audiobook-Ausgabeordners:
- Ordner- und Dateiansicht
- Größen-/Zeitstempelübersicht
- schnelle Kontrolle der erzeugten Ergebnisse
---
## Abgrenzung zum Converter
Audio/Video-Datei-Konvertierung läuft weiterhin auf der Seite `Converter`.
Der AAX-spezifische Flow (Upload, Start, Jobsteuerung, Output-Explorer) liegt auf `Audiobooks`.
+3 -9
View File
@@ -1,6 +1,6 @@
# Converter
Die Converter-Seite ermöglicht das Konvertieren vorhandener Audio- und Video-Dateien sowie das Verarbeiten von Audiobooks (AAX/M4B).
Die Converter-Seite ermöglicht das Konvertieren vorhandener Audio- und Video-Dateien.
---
@@ -65,15 +65,9 @@ Das Scan-Intervall wird unter `Converter > Polling-Intervall (Sekunden)` konfigu
---
## Audiobook-Verarbeitung
## Hinweis zu Audiobooks
Für AAX-Dateien (Audible) ist folgendes erforderlich:
1. AAX-Datei in den Eingangsordner hochladen
2. Job mit Medientyp `Audiobook` erstellen
3. Activation Bytes müssen verfügbar sein (werden beim ersten Mal abgefragt und gecacht)
4. Ausgabeformat wählen: M4B (empfohlen), MP3 oder FLAC
5. Kapitel-Splitting konfigurieren (optional)
Der dedizierte AAX-/Audiobook-Flow ist auf der Seite [Audiobooks](audiobooks.md) dokumentiert.
---
+26
View File
@@ -36,6 +36,9 @@ Bereiche:
- strukturierte JSON-Blöcke (OMDb/MakeMKV/MediaInfo/EncodePlan/HandBrake)
- Log-Ladefunktionen (`Tail`, `Vollständig`)
Bei Serien-Containern zeigt der Dialog statt eines globalen Log-Blocks einen `Disks`-Bereich mit einzelnen Disk-Akkordeons.
Jede Disk kann dort separat geprüft und bearbeitet werden.
## Typische Aktionen im Detaildialog
- `OMDb neu zuordnen`
@@ -46,6 +49,12 @@ Bereiche:
- `Historieneintrag löschen`
- bei Queue-Lock: `Aus Queue löschen`
Zusätzlich bei Serien-Container-Disks:
- `Im Ripper öffnen` (für `READY_TO_ENCODE`-Kinder)
- diskbezogene Löschaktionen (`RAW`, `Folgen`, `Beides`) mit Child-/Subjob-Scope
- diskbezogenes Löschen des Historieneintrags (inkl. Subjobs)
## Wann welche Aktion?
| Ziel | Aktion |
@@ -56,6 +65,23 @@ Bereiche:
| aus vorhandenem RAW erneut encodieren | `RAW neu encodieren` |
| Speicher freigeben | Dateilöschaktionen |
---
## Löschen mit Vorschau
Beim Löschen eines Historieneintrags (`Eintrag löschen`) gibt es eine Pfadvorschau:
- getrennt nach `RAW` und Ausgabe (`Movie`/`Folgen`)
- für Serien-/Multipart-Fälle mit Scope auf verknüpfte Jobs
- selektierbare Pfade vor dem finalen Löschen
Neu im RAW-Bereich:
- bei mehreren RAW-Kandidaten kann pro Pfad gewählt werden, was entfernt wird
- mindestens ein RAW-Pfad muss gewählt sein, wenn RAW-Löschung Teil der Aktion ist
Die Buttons (`Eintrag + nur RAW`, `Eintrag + nur ...`, `Eintrag + RAW + ...`) berücksichtigen die aktuelle Pfadauswahl und deaktivieren sich bei unvollständiger Auswahl.
## Logs
- `Tail laden (800)` für schnelle Fehleranalyse
+12 -8
View File
@@ -1,12 +1,14 @@
# GUI-Seiten
Ripster hat fünf Hauptseiten in der Navigation plus eine Expert-Seite.
Ripster hat sieben Hauptseiten in der Navigation plus eine Expert-Seite.
## Seitenüberblick
| Seite | Zweck |
|---|---|
| [Jobs](jobs.md) | zentrale Inbox mit allen Jobs (Ripper, Converter, Audiobooks) |
| [Ripper](ripper.md) | Live-Betrieb: Pipeline, Queue, Aktivitäten, Disc-Infos |
| [Audiobooks](audiobooks.md) | AAX-Upload, Audiobook-Jobsteuerung und Output-Explorer |
| [Settings](settings.md) | Konfiguration, Skripte, Ketten, Presets, Cronjobs |
| [Historie](history.md) | abgeschlossene/laufende Jobs durchsuchen und nachbearbeiten |
| [Converter](converter.md) | Audio/Video-Dateien konvertieren, Datei-Explorer, Upload |
@@ -15,14 +17,16 @@ Ripster hat fünf Hauptseiten in der Navigation plus eine Expert-Seite.
## Empfohlene Nutzung im Alltag
1. **Start eines neuen Disc-Jobs:** `Ripper`
2. **Dateien konvertieren oder Audiobooks verarbeiten:** `Converter`
3. **Regeln/Automatisierung anpassen:** `Settings`
4. **Ergebnisse prüfen oder Jobs nachbearbeiten:** `Historie`
5. **Dateien herunterladen:** `Downloads`
6. **Sonderfälle/Recovery:** `Database`
1. **Ersten Überblick über alle Jobs:** `Jobs`
2. **Start eines neuen Disc-Jobs:** `Ripper`
3. **Audio/Video-Dateien konvertieren:** `Converter`
4. **AAX/Audiobook-Flow:** `Audiobooks`
5. **Regeln/Automatisierung anpassen:** `Settings`
6. **Ergebnisse prüfen oder Jobs nachbearbeiten:** `Historie`
7. **Dateien herunterladen:** `Downloads`
8. **Sonderfälle/Recovery:** `Database`
## Hinweise zur Navigation
- `Ripper`, `Settings`, `Historie`, `Converter` und `Downloads` sind direkt in der Kopfnavigation.
- `Jobs`, `Ripper`, `Converter`, `Audiobooks`, `Settings`, `Historie` und `Downloads` sind direkt in der Kopfnavigation.
- `Database` ist als Expert-Route verfügbar: `/database`.
+56
View File
@@ -0,0 +1,56 @@
# Jobs
Die Seite `Jobs` ist die zentrale Inbox über alle Job-Typen.
---
## Zweck
`Jobs` zeigt denselben Datenbestand in einer einheitlichen Liste:
- Ripper-Jobs (Blu-ray/DVD/CD)
- Converter-Jobs (Audio/Video/ISO)
- Audiobook-Jobs
Die Seite eignet sich als schneller Einstieg, bevor man in den jeweiligen Fachbereich springt.
---
## Filter und Ansicht
### View-Filter
- `Alle Jobs`
- `Ripper-View`
- `Converter-View`
- `Audiobooks`
### Status-Filter
- `Alle`
- `Aktiv`
- `Fehler/Abbruch`
Zusätzlich gibt es eine Freitextsuche (Titel, Status, IMDb, Job-Kind etc.) und eine Paginierung.
---
## Was ein Eintrag zeigt
- Job-ID und Titel
- Status-Badge (inkl. Queue-Berücksichtigung)
- Job-Typ-Badge (z. B. Blu-ray, Converter Audio, Audiobook)
- Zeitstempel der letzten Aktualisierung
Die Liste aktualisiert sich zyklisch automatisch.
---
## Aktion
Pro Eintrag gibt es einen Schnellzugriff:
- `Im Ripper öffnen` für Disc-/Audiobook-orientierte Jobs
- `Im Converter öffnen` für Converter-Jobs
So gelangst du mit einem Klick in die passende Detailoberfläche.
+16
View File
@@ -65,6 +65,12 @@ Mögliche Aktionen:
Kompakte Jobliste mit Status, Fortschritt, ETA. Klick auf einen Job klappt die Detailsteuerung auf.
Zusätzliche Kennzeichnungen in der Liste:
- `Serien-Container`/`Serien-Disk` für Staffel-Workflows
- `Multipart Movie` bei zusammengeführten Film-Discs
- Untertitel mit Disc-/Container-Infos (z. B. `Disc 2 | Container #123`)
Im aufgeklappten Zustand erscheint die Karte `Pipeline-Status` mit allen zustandsabhängigen Aktionen.
### Zustandsabhängige Hauptaktionen
@@ -105,6 +111,10 @@ Aktionen:
- `Disk neu analysieren`
- `Metadaten-Modal öffnen`
Hinweis:
- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden und kann genutzt werden, solange kein Rescan-Request läuft.
---
## Wichtige Dialoge im Ripper
@@ -115,6 +125,12 @@ Aktionen:
- manuelle Eingabe als Fallback
- `Auswahl übernehmen` startet den nächsten Pipeline-Schritt
Bei Film-Duplikaten in der Historie öffnet sich ein Konfliktdialog:
- `Übernahme erzwingen`: legt trotzdem einen neuen Job mit denselben Metadaten an
- `Multipart movie`: verknüpft bestehenden und neuen Job in einem Multipart-Container (mit separaten Disc-Nummern)
- `Zurück zur Auswahl`: zurück in die Metadatenliste
### Abbruch-Bereinigung
Nach Abbruch kann Ripster optional fragen, ob erzeugte RAW- oder Movie-Dateien gelöscht werden sollen.