1.0.0 release snapshot
This commit is contained in:
@@ -0,0 +1,366 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user