# Workflows aus Nutzersicht

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

### Typische Statuskette

`Medium erkannt` -> `Analyse` -> `Metadatenauswahl` -> `Startbereit` -> `Rippen` -> `Mediainfo-Prüfung` -> `Bereit zum Encodieren` -> `Encodieren` -> `Fertig`

Wichtige Abweichungen:

- 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

### Welche Settings fast überall hineinspielen

Die wichtigsten globalen Einflussfaktoren:

- `Parallele Jobs`
- `Max. parallele Audio CD Jobs`
- `Max. Encodes gesamt (medienunabhängig)`
- `Audio CDs: Queue-Reihenfolge überspringen`
- `PushOver`-Ereignisse
- Pfade, Templates und Owner-Felder

Für Disc-Video zusätzlich:

- `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`

## Workflow A: Film von Disc (Blu-ray / DVD)

### 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-Metadaten, Poster und Fingerprint werden gesetzt

Relevante Settings:

- `TMDb Read Access Token`
- `Film-Sprache`
- `Fallback Sprache`

### 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-Nummern
- gleiche Disc-Nummern blockieren den Vorgang

### 3. RAW-Verzeichnis und RAW-Entscheidung

Wenn noch kein passendes RAW vorhanden ist:

- Ripster legt ein neues RAW-Verzeichnis an

Wenn bereits ein passendes RAW gefunden wird:

- der Job geht in `Warte auf Auswahl`
- du entscheidest, ob das vorhandene RAW weiterverwendet oder neu gerippt wird

Relevante Settings:

- `Raw Ausgabeordner (Blu-ray)` und `Raw Ausgabeordner (DVD)`
- `Eigentümer Raw-Ordner (Blu-ray)` und `Eigentümer Raw-Ordner (DVD)`

### 4. Playlist- oder Titelauswahl

Bei bestimmten Discs ist nach der Metadatenphase eine manuelle Auswahl nötig:

- Playlist-Auswahl
- HandBrake-Titelauswahl
- bei Serien-Grenzfällen PlayAll- oder Doppelfolgen-Entscheidung

Das ist der aktuelle `playlistflow`.

Relevante Settings:

- `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: `Film Ausgabeordner (Blu-ray)` oder `Film Ausgabeordner (DVD)`
- Dateiname und Ordner: `Output Template (Blu-ray)` oder `Output Template (DVD)`

Optional:

- `.nfo` direkt nach Encode

Relevante Settings:

- `Film Ausgabeordner (Blu-ray)` und `Film Ausgabeordner (DVD)`
- `Eigentümer Film-Ordner (Blu-ray)` und `Eigentümer Film-Ordner (DVD)`
- `Output Template (Blu-ray)` und `Output Template (DVD)`
- `NFO nach Encode erzeugen`

## 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:

- Ripster arbeitet als Serien-Workflow
- Seriencontainer wird gesucht oder angelegt
- der Job wird als Child unter diesem Container geführt

### 2. Serien-RAW und Staffelkontext

Für Serien bevorzugt Ripster eigene Serien-RAW-Verzeichnisse:

- `RAW-Ordner (Blu-ray Serie)`
- `RAW-Ordner (DVD Serie)`

Falls leer:

- Fallback auf `Raw Ausgabeordner (Blu-ray)` bzw. `Raw Ausgabeordner (DVD)`

### 3. Episodenprüfung und Multi-Episode-Fälle

In der Review werden Episoden oder Mehrfachfolgen aufgelöst.

Ausgabevarianten:

- Einzel-Episode
- Multi-Episode-Datei

Relevante Settings:

- `Output Template (Blu-ray Serie, Episode)`
- `Output Template (Blu-ray Serie, Multi-Episode)`
- `Output Template (DVD Serie, Episode)`
- `Output Template (DVD Serie, Multi-Episode)`
- `Serien-Ordner (Blu-ray)`
- `Serien-Ordner (DVD)`

### 4. Playlistflow auch bei Serien

Auch Serien können vor der Review in eine Playlist- oder Titelauswahl laufen.

Zusätzlich wirken:

- `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 der Flow gedacht ist

- 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

Wirkung:

- `multipart_movie_container` wird angelegt oder wiederverwendet
- die Discs werden als Child-Jobs darunter geführt
- zusätzlich wird ein Merge-Job vorbereitet

Relevante Settings:

- `mkvmerge_command`
- Film-Output-Templates
- Queue-Limits, falls mehrere Discs parallel weiterverarbeitet werden

## Workflow D: Audio-CD

### 1. TOC lesen und Metadaten wählen

1. Audio-CD analysieren
2. Tracks prüfen
3. Metadaten aus MusicBrainz übernehmen oder manuell anpassen

### 2. Trackauswahl und Format

Vor dem Start legst du fest:

- welche Tracks übernommen werden
- welches Ausgabeformat gilt
- welche Formatoptionen genutzt werden
- welche Pre-/Post-Encode-Skripte oder Ketten mitlaufen

### 3. Rip und Encode

Die CD läuft anschließend als Track-für-Track-Flow:

`CD-Metadatenauswahl` -> `CD-Startbereit` -> `CD-Rippen` -> `CD-Encodieren` -> `Fertig`

Relevante Settings:

- `CD RAW-Ordner`
- `CD Output-Ordner`
- `Eigentümer CD RAW-Ordner`
- `Eigentümer CD Output-Ordner`
- `CD Output Template`
- `cdparanoia Kommando`
- `Max. parallele Audio CD Jobs`
- `Audio CDs: Queue-Reihenfolge überspringen`

## Workflow E: Converter

### 1. Dateien bereitstellen

Dateien gelangen in den Converter über:

- Upload
- bestehende Ordner im `Converter Raw-Ordner`
- 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:

- `Erlaubte Datei-Endungen`
- `Auto-Scan (Polling)`
- `Polling-Intervall (Sekunden)`
- `Converter Raw-Ordner`
- `Converter Ausgabe (Video)`
- `Converter Ausgabe (Audio)`
- `Output-Template (Video)`
- `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:

- `Audiobook RAW-Ordner`
- `Audiobook Output-Ordner`
- `Audiobook RAW Template`
- `Output Template (Audiobook)`
- `Kapitel Template (Audiobook)`
- `FFprobe Kommando`
- `FFmpeg Kommando`
- 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
- `Encode-Neustart: unvollständige Ausgabe löschen` 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 ZIP-Ordner`
- `Eigentümer Download ZIP-Ordner`

### 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.