1.0.0 docs
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-06-12 10:38:45 +02:00
parent b29ac935a9
commit 5e24c6b9cc
72 changed files with 1340 additions and 704 deletions
+282 -123
View File
@@ -1,207 +1,366 @@
# Workflows aus Nutzersicht
Diese Seite beschreibt die produktiven Abläufe als Handbuch: welche Entscheidung an welcher Stelle fällt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
Diese Seite beschreibt die produktiven Abläufe aus Sicht der Benutzer: welche Entscheidung wann anfällt, welche Jobs oder Container entstehen und welche Settings den Ablauf sichtbar beeinflussen.
## Gemeinsame Grundlagen
### Statuskette im Normalfall
### Typische Statuskette
`Medium erkannt` -> `Analyse` -> `Metadatenauswahl` -> `Startbereit` -> `Rippen` -> `Mediainfo-Pruefung` -> `Bereit zum Encodieren` -> `Encodieren` -> `Fertig`
`Medium erkannt` -> `Analyse` -> `Metadatenauswahl` -> `Startbereit` -> `Rippen` -> `Mediainfo-Prüfung` -> `Bereit zum Encodieren` -> `Encodieren` -> `Fertig`
Abweichungen:
Wichtige Abweichungen:
- bei Blu-ray/DVD mit nötiger Playlistwahl: `Mediainfo-Pruefung` -> `Warte auf Auswahl` -> zurück in `Mediainfo-Pruefung`
- bei vorhandenem RAW: `Startbereit` springt direkt in Review/Prüfung ohne neuen Laufwerks-Rip
- bei Fehler/Abbruch: `Fehler` oder `Abgebrochen` mit Wiederanlauf-Aktionen
- bei vorhandenem RAW: Sprung direkt in RAW-Entscheidung oder Review
- bei mehrdeutigen Blu-rays/DVDs: `Warte auf Auswahl` für Playlist- oder Titelauswahl
- bei Fehler oder Abbruch: `Fehler` oder `Abgebrochen` mit Folgeaktionen
- bei Audio-CDs und Audiobooks: eigener Spezialflow innerhalb derselben Gesamtpipeline
### Job- und Container-Typen
### Welche Settings fast überall hineinspielen
| Typ | Zweck | Was enthält der Typ? |
|---|---|---|
| Normaler Disc-Job | Einzel-Film oder einzelne Disc | RAW-Pfad, Output-Pfad, Logs, Review |
| `dvd_series_container` | logischer Serien-Container (pro Serie/Staffel) | Metadatenanker, aggregierter Status über Kinder |
| `dvd_series_child` | einzelne Serien-Disc oder Serien-Episode-Job | eigentliche RAW-/Encode-Arbeit |
| `multipart_movie_container` | logischer Multipart-Film-Container | Zusammenfassung für mehrere Film-Discs |
| `multipart_movie_child` | einzelne Disc innerhalb Multipart-Film | Disc-spezifische RAW-/Encode-Daten |
Die wichtigsten globalen Einflussfaktoren:
Wichtig:
- `Parallele Jobs`
- `Max. parallele Audio CD Jobs`
- `Max. Encodes gesamt (medienunabhängig)`
- `Audio CDs: Queue-Reihenfolge überspringen`
- `PushOver`-Ereignisse
- Pfade, Templates und Owner-Felder
- Container sind primär Ordnungs- und Statusobjekte.
- Dateien (RAW/Output) hängen an den Child-Jobs.
Für Disc-Video zusätzlich:
## Workflow A: Film (Blu-ray/DVD)
- `Minimale Titellänge (Minuten)`
- `TMDb Runtime-Abzug für Playlistfilter (%)`
- `HandBrake Preset`
- `HandBrake Extra Args`
- `Review Audio-Sprachen (...)`
- `Review UT-Sprachen (...)`
- Standard-Zuordnungen aus `Settings -> Encode-Presets`
### 1) Disc analysieren und Film-Metadaten wählen
## Workflow A: Film von Disc (Blu-ray / DVD)
1. Im `Ripper` `Analyse starten`.
2. Im Metadaten-Dialog Film auswählen (OMDb bzw. manuelle Film-Metadaten).
3. `Auswahl übernehmen`.
### 1. Disc analysieren und TMDb-Metadaten wählen
1. Im `Ripper` `Analyse starten`
2. im Metadaten-Dialog Film auswählen
3. `Auswahl übernehmen`
Wirkung:
- der Job wird als Film-Workflow geführt
- Film-Fingerprint für Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
- Film-Metadaten, Poster und Fingerprint werden gesetzt
### 2) Duplikatfall entscheiden
Relevante Settings:
Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
- `TMDb Read Access Token`
- `Film-Sprache`
- `Fallback Sprache`
1. `Übernahme erzwingen` (`allow_new`): neuer unabhängiger Film-Job
2. `Multipart movie`: neuer Job wird mit bestehendem Job in einem Multipart-Container verknüpft
### 2. Duplikatfall entscheiden
Wenn ein Film mit gleichem Fingerprint bereits existiert:
1. `Übernahme erzwingen`: neuer unabhängiger Film-Job
2. `Multipart movie`: neuer Job wird mit bestehendem Film zu einem Multipart-Container verknüpft
Bei Multipart gilt:
- beide Discs brauchen unterschiedliche `Disc-Nummer`
- gleiche Disc-Nummer blockiert den Vorgang (`MULTIPART_DISC_ALREADY_EXISTS`)
- beide Discs brauchen unterschiedliche Disc-Nummern
- gleiche Disc-Nummern blockieren den Vorgang
### 3) RAW-Verzeichnis entsteht
### 3. RAW-Verzeichnis und RAW-Entscheidung
Ordnername basiert auf Metadaten plus Job-ID:
Wenn noch kein passendes RAW vorhanden ist:
- `Incomplete_<Titel> (<Jahr>) - RAW - job-<id>`
- Ripster legt ein neues RAW-Verzeichnis an
Zustandswechsel des RAW-Ordners:
Wenn bereits ein passendes RAW gefunden wird:
- beim Start: `Incomplete_...`
- nach erfolgreichem Rip: `Rip_Complete_...`
- nach erfolgreichem Encode: Prefix wird entfernt (final)
- der Job geht in `Warte auf Auswahl`
- du entscheidest, ob das vorhandene RAW weiterverwendet oder neu gerippt wird
### 4) Review und Encode
Relevante Settings:
In `Bereit zum Encodieren`:
- `raw_dir_bluray`, `raw_dir_dvd`
- `raw_dir_bluray_owner`, `raw_dir_dvd_owner`
- Titel wählen
- Audio-/Subtitle-Spuren festlegen
- optional User-Preset
- optional Pre-/Post-Encode-Skripte oder Ketten
### 4. Playlist- oder Titelauswahl
Beim Start:
Bei bestimmten Discs ist nach der Metadatenphase eine manuelle Auswahl nötig:
- temporäre Ausgabe in `Incomplete_job-<id>/<Datei>.<ext>`
- nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
- Playlist-Auswahl
- HandBrake-Titelauswahl
- bei Serien-Grenzfällen PlayAll- oder Doppelfolgen-Entscheidung
## Workflow B: Serie (Blu-ray/DVD)
Das ist der aktuelle `playlistflow`.
### 1) Serienmodus aktivieren
Relevante Settings:
1. Disc analysieren.
2. Im Metadaten-Dialog Serienmetadaten wählen (TMDb-basiert).
3. `Disc-Nummer` setzen (Pflicht, ab 1).
- `Minimale Titellänge (Minuten)`
- `TMDb Runtime-Abzug für Playlistfilter (%)`
- `Bei manueller Auswahl senden`
Praxis:
- zu hoher Mindestwert blendet legitime Alternativfassungen aus
- ein kleiner Runtime-Abzug hilft bei Discs, deren Hauptfilm minimal unter der TMDb-Laufzeit liegt
### 5. Review und Encode
Im Zustand `Bereit zum Encodieren` entscheidest du:
- welcher Titel encodiert wird
- welche Audio-Spuren übernommen werden
- welche Untertitel übernommen, erzwungen oder eingebrannt werden
- welches Preset gilt
- welche Pre-/Post-Encode-Skripte oder Ketten mitlaufen
Relevante Settings:
- `HandBrake Preset`
- `HandBrake Extra Args`
- `Review Audio-Sprachen (Blu-ray Film)` oder `Review Audio-Sprachen (DVD Film)`
- `Review UT-Sprachen (Blu-ray Film)` oder `Review UT-Sprachen (DVD Film)`
- `Ausgabeformat`
- Standard-Userpreset für Film unter `Settings -> Encode-Presets`
### 6. Finale Ausgabe
Finale Ausgabe:
- Zielordner: `movie_dir_bluray` oder `movie_dir_dvd`
- Dateiname und Ordner: `output_template_bluray` oder `output_template_dvd`
Optional:
- `.nfo` direkt nach Encode
Relevante Settings:
- `movie_dir_bluray`, `movie_dir_dvd`
- `movie_dir_bluray_owner`, `movie_dir_dvd_owner`
- `output_template_bluray`, `output_template_dvd`
- `generate_nfo_after_encode`
## Workflow B: Serie von Disc (Blu-ray / DVD)
### 1. Serienmodus festlegen
1. Disc analysieren
2. im Metadaten-Dialog Serienmetadaten wählen
3. `Disc-Nummer` setzen
Wirkung:
- Workflow-Kind wird `series`
- Seriencontainer wird gesucht/angelegt
- aktueller Job wird als `dvd_series_child` darunter geführt
- Ripster arbeitet als Serien-Workflow
- Seriencontainer wird gesucht oder angelegt
- der Job wird als Child unter diesem Container geführt
### 2) Seriencontainer und Disc-Konflikte
### 2. Serien-RAW und Staffelkontext
Beim Speichern wird geprüft:
Für Serien bevorzugt Ripster eigene Serien-RAW-Verzeichnisse:
- existiert für Serie/Staffel bereits ein Container?
- existiert in diesem Container bereits dieselbe `Disc-Nummer`?
- `raw_dir_bluray_series`
- `raw_dir_dvd_series`
Wenn ja, wird blockiert (`SERIES_DISC_ALREADY_EXISTS`).
Falls leer:
### 3) Serien-RAW-Pfad
- Fallback auf `raw_dir_bluray` bzw. `raw_dir_dvd`
Für Serien wird ein eigener RAW-Pfad bevorzugt:
### 3. Episodenprüfung und Multi-Episode-Fälle
- Blu-ray: `raw_dir_bluray_series` (Fallback: `raw_dir_bluray`)
- DVD: `raw_dir_dvd_series` (Fallback: `raw_dir_dvd`)
In der Review werden Episoden oder Mehrfachfolgen aufgelöst.
RAW-Namensbasis enthält Staffel/Disc (`SxDy`) und wird ebenfalls mit den Prefix-Phasen geführt:
Ausgabevarianten:
- `Incomplete_...` -> `Rip_Complete_...` -> final
- Einzel-Episode
- Multi-Episode-Datei
### 4) Serien-Review und Episoden-Ausgabe
Relevante Settings:
Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
- `output_template_bluray_series_episode`
- `output_template_bluray_series_multi_episode`
- `output_template_dvd_series_episode`
- `output_template_dvd_series_multi_episode`
- `series_dir_bluray`
- `series_dir_dvd`
- Einzel-Episode: Episode-Template
- Multi-Episode-Titel: Multi-Episode-Template
### 4. Playlistflow auch bei Serien
Ausgabepfad:
Auch Serien können vor der Review in eine Playlist- oder Titelauswahl laufen.
- Root: `series_dir_*` (Fallback auf `movie_dir_*`)
- Dateiname/Unterordner aus Serien-Template
Zusätzlich wirken:
### 5) Multi-Episode-Disc als Batch
Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
- Ripster erzeugt Episode-Child-Jobs
- der ursprüngliche Disc-Job dient als Batch-Anker
- RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
- `Review Audio-Sprachen (Blu-ray Serie)` / `Review Audio-Sprachen (DVD Serie)`
- `Review UT-Sprachen (Blu-ray Serie)` / `Review UT-Sprachen (DVD Serie)`
- Serien-Default-Presets unter `Settings -> Encode-Presets`
## Workflow C: Multipart-Film
### Wann dieser Flow gedacht ist
### Wann der Flow gedacht ist
- gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
- Zusammengehörigkeit soll in Historie und Detailansichten sichtbar sein
- gleicher Film auf mehreren Discs
- die Discs sollen in Historie und Detailansichten zusammengehören
### Ablauf
1. Film-Metadaten wählen.
2. Duplikatdialog -> `Multipart movie`.
3. Disc-Nummern für bestehenden und neuen Job festlegen.
1. Film-Metadaten wählen
2. Duplikatdialog `Multipart movie`
3. Disc-Nummern für bestehenden und neuen Job festlegen
Wirkung:
- `multipart_movie_container` wird angelegt oder wiederverwendet
- beteiligte Jobs werden `multipart_movie_child`
- Container führt gemeinsame Metadaten, Kinder führen je Disc die eigentlichen Artefakte
- die Discs werden als Child-Jobs darunter geführt
- zusätzlich wird ein Merge-Job vorbereitet
## Workflow D: Vorhandenes RAW / RAW-Import
Relevante Settings:
### Fall 1: RAW bereits vorhanden bei Metadatenübernahme
- `mkvmerge_command`
- Film-Output-Templates
- Queue-Limits, falls mehrere Discs parallel weiterverarbeitet werden
Nach Metadaten-Übernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
## Workflow D: Audio-CD
Möglichkeiten:
### 1. TOC lesen und Metadaten wählen
- vorhandenes RAW weiterverwenden (kein neuer Rip)
- RAW löschen/ignorieren und neu rippen
1. Audio-CD analysieren
2. Tracks prüfen
3. Metadaten aus MusicBrainz übernehmen oder manuell anpassen
### Fall 2: Orphan-RAW aus `/database`
### 2. Trackauswahl und Format
1. In `Database` `RAW prüfen`.
2. Bei orphan RAW `Job anlegen`.
3. Job wird in Historie erzeugt und wie "Disk analysieren aus RAW" weiterverarbeitet.
Vor dem Start legst du fest:
## Workflow E: Nachbearbeitung bestehender Jobs
- welche Tracks übernommen werden
- welches Ausgabeformat gilt
- welche Formatoptionen genutzt werden
- welche Pre-/Post-Encode-Skripte oder Ketten mitlaufen
In `Historie` (Detaildialog):
### 3. Rip und Encode
| Aktion | Wirkung |
|---|---|
| `OMDb neu zuordnen` | Metadaten neu schreiben, Folder-Rename wird best effort angestoßen |
| `Review neu starten` | Titel-/Spurprüfung aus aktuellem RAW neu aufbauen |
| `RAW neu encodieren` | Encode erneut aus vorhandenem RAW starten |
| `Encode neu starten` | letzte bestätigte Review-Einstellungen wiederverwenden |
| `Retry Rippen` | Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden |
Die CD läuft anschließend als Track-für-Track-Flow:
## Wo landet was? (Artefakt-Matrix)
`CD-Metadatenauswahl` -> `CD-Startbereit` -> `CD-Rippen` -> `CD-Encodieren` -> `Fertig`
| Artefakt | Film | Serie | Multipart |
|---|---|---|---|
| RAW | `raw_dir_*` | bevorzugt `raw_dir_*_series` | pro Child-Job im normalen Film-RAW-Schema |
| Finale Ausgabe | `movie_dir_*` + Film-Template | `series_dir_*` (Fallback `movie_dir_*`) + Serien-Templates | pro Child-Job normaler Film-Output |
| Container-Datensatz | nein | ja (`dvd_series_container`) | ja (`multipart_movie_container`) |
| Löschvorschau in Historie | einzelner Job oder Related Scope | Container-/Child-bezogen mit Pfadauswahl | Container-/Child-bezogen mit Pfadauswahl |
Relevante Settings:
## Queue-Verhalten im Alltag
Die Startfreigabe hängt an vier Settings:
- `Max. parallele Film/Video Encodes`
- `raw_dir_cd`
- `movie_dir_cd`
- `raw_dir_cd_owner`
- `movie_dir_cd_owner`
- `cd_output_template`
- `cdparanoia_command`
- `Max. parallele Audio CD Jobs`
- `Max. Encodes gesamt`
- `Audio CDs: Queue-Reihenfolge überspringen`
Praxis:
## Workflow E: Converter
- Film/Video- und Audio/CD laufen in getrennten Lanes
- Gesamtlimit begrenzt beide gemeinsam
- Queue kann neben Jobs auch `Skript`, `Kette`, `Warten` enthalten
### 1. Dateien bereitstellen
Dateien gelangen in den Converter über:
- Upload
- bestehende Ordner im `converter_raw_dir`
- manuelle Dateiverwaltung im Explorer
### 2. Jobs aus Auswahl erzeugen
- Video und ISO: immer ein Job pro Datei
- Audio: ein Job pro Datei oder gemeinsamer Audio-Job
### 3. Job konfigurieren und starten
Je nach Medium:
- Video/ISO: Review mit Track- und Preset-Auswahl
- Audio: direkte Format- und Zielkonfiguration
Relevante Settings:
- `converter_scan_extensions`
- `converter_polling_enabled`
- `converter_polling_interval`
- `converter_raw_dir`
- `converter_movie_dir`
- `converter_audio_dir`
- `converter_output_template_video`
- `converter_output_template_audio`
- globale Queue-Limits
## Workflow F: Audiobooks
### 1. AAX hochladen
1. Datei hochladen
2. Metadaten und Kapitel aufbauen lassen
3. bei Bedarf Activation Bytes klären
### 2. Ausgabeformat wählen
- `m4b`: eine Datei
- `mp3`: eine Datei pro Kapitel
- `flac`: eine Datei pro Kapitel
### 3. Kapitel und Skripte prüfen
Vor dem Start anpassbar:
- Kapitelnamen
- Pre-Encode-Skripte und -Ketten
- Post-Encode-Skripte und -Ketten
Relevante Settings:
- `raw_dir_audiobook`
- `movie_dir_audiobook`
- `audiobook_raw_template`
- `output_template_audiobook`
- `output_chapter_template_audiobook`
- `ffprobe_command`
- `ffmpeg_command`
- globale Queue-Limits
## Workflow G: Nachbearbeitung in der Historie
Typische Folgeaktionen:
- `TMDb neu zuweisen`
- `Review neu starten`
- `RAW neu encodieren`
- `Encode neu starten`
- `Retry Rippen`
- `Download` als ZIP einreihen
Besonders wichtig:
- `Encode neu starten` verwendet den letzten bestätigten Plan
- `handbrake_restart_delete_incomplete_output` entscheidet, ob unvollständige Ausgaben vorher gelöscht werden
## Workflow H: Downloads und Recovery
### Downloads
Aus `Historie` können ZIPs für:
- `RAW`
- `Output`
erstellt werden.
Relevante Settings:
- `download_dir`
- `download_dir_owner`
### Database (Expert)
Die Recovery-Seite hilft bei orphan RAW:
- `RAW prüfen`
- `Job anlegen`
So lassen sich vorhandene RAW-Verzeichnisse wieder in einen normalen Workflow zurückführen.
### TMDb Migration
Für ältere Bestandsjobs gibt es die Sonderseite `/tmdb-migration`, um mehrere Jobs nacheinander auf den heutigen TMDb-Stand zu bringen.