ripster/docs/workflows/index.md

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.

Gemeinsame Grundlagen

Statuskette im Normalfall

Medium erkannt -> Analyse -> Metadatenauswahl -> Startbereit -> Rippen -> Mediainfo-Pruefung -> Bereit zum Encodieren -> Encodieren -> Fertig

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

Job- und Container-Typen

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

Wichtig:

• Container sind primär Ordnungs- und Statusobjekte.
• Dateien (RAW/Output) hängen an den Child-Jobs.

Workflow A: Film (Blu-ray/DVD)

1) Disc analysieren und Film-Metadaten wählen

1. Im Ripper Analyse starten.
2. Im Metadaten-Dialog Film auswählen (OMDb bzw. manuelle Film-Metadaten).
3. Auswahl übernehmen.

Wirkung:

• der Job wird als Film-Workflow geführt
• Film-Fingerprint für Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)

2) Duplikatfall entscheiden

Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:

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

Bei Multipart gilt:

• beide Discs brauchen unterschiedliche Disc-Nummer
• gleiche Disc-Nummer blockiert den Vorgang (MULTIPART_DISC_ALREADY_EXISTS)

3) RAW-Verzeichnis entsteht

Ordnername basiert auf Metadaten plus Job-ID:

• Incomplete_<Titel> (<Jahr>) - RAW - job-<id>

Zustandswechsel des RAW-Ordners:

• beim Start: Incomplete_...
• nach erfolgreichem Rip: Rip_Complete_...
• nach erfolgreichem Encode: Prefix wird entfernt (final)

4) Review und Encode

In Bereit zum Encodieren:

• Titel wählen
• Audio-/Subtitle-Spuren festlegen
• optional User-Preset
• optional Pre-/Post-Encode-Skripte oder Ketten

Beim Start:

• temporäre Ausgabe in Incomplete_job-<id>/<Datei>.<ext>
• nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template

Workflow B: Serie (Blu-ray/DVD)

1) Serienmodus aktivieren

1. Disc analysieren.
2. Im Metadaten-Dialog Serienmetadaten wählen (TMDb-basiert).
3. Disc-Nummer setzen (Pflicht, ab 1).

Wirkung:

• Workflow-Kind wird series
• Seriencontainer wird gesucht/angelegt
• aktueller Job wird als dvd_series_child darunter geführt

2) Seriencontainer und Disc-Konflikte

Beim Speichern wird geprüft:

• existiert für Serie/Staffel bereits ein Container?
• existiert in diesem Container bereits dieselbe Disc-Nummer?

Wenn ja, wird blockiert (SERIES_DISC_ALREADY_EXISTS).

3) Serien-RAW-Pfad

Für Serien wird ein eigener RAW-Pfad bevorzugt:

• Blu-ray: raw_dir_bluray_series (Fallback: raw_dir_bluray)
• DVD: raw_dir_dvd_series (Fallback: raw_dir_dvd)

RAW-Namensbasis enthält Staffel/Disc (SxDy) und wird ebenfalls mit den Prefix-Phasen geführt:

• Incomplete_... -> Rip_Complete_... -> final

4) Serien-Review und Episoden-Ausgabe

Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:

• Einzel-Episode: Episode-Template
• Multi-Episode-Titel: Multi-Episode-Template

Ausgabepfad:

• Root: series_dir_* (Fallback auf movie_dir_*)
• Dateiname/Unterordner aus Serien-Template

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

Workflow C: Multipart-Film

Wann dieser Flow gedacht ist

• gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
• Zusammengehörigkeit soll in Historie und Detailansichten sichtbar sein

Ablauf

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

Workflow D: Vorhandenes RAW / RAW-Import

Fall 1: RAW bereits vorhanden bei Metadatenübernahme

Nach Metadaten-Übernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.

Möglichkeiten:

• vorhandenes RAW weiterverwenden (kein neuer Rip)
• RAW löschen/ignorieren und neu rippen

Fall 2: Orphan-RAW aus /database

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.

Workflow E: Nachbearbeitung bestehender Jobs

In Historie (Detaildialog):

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

Wo landet was? (Artefakt-Matrix)

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

Queue-Verhalten im Alltag

Die Startfreigabe hängt an vier Settings:

• Max. parallele Film/Video Encodes
• Max. parallele Audio CD Jobs
• Max. Encodes gesamt
• Audio CDs: Queue-Reihenfolge überspringen

Praxis:

• Film/Video- und Audio/CD laufen in getrennten Lanes
• Gesamtlimit begrenzt beide gemeinsam
• Queue kann neben Jobs auch Skript, Kette, Warten enthalten