0.14.0-4 Docs

docs/gui/ripper.md

@@ -1,8 +1,8 @@
 # Ripper
 
-Das Ripper ist die **Betriebszentrale** für laufende Jobs.
+Die Seite `Ripper` ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
 
-## Aufbau der Seite
+## Seitenaufbau und Betriebslogik
 
 Die Bereiche erscheinen in dieser Reihenfolge:
 
@@ -12,129 +12,157 @@ Die Bereiche erscheinen in dieser Reihenfolge:
 4. `Job Übersicht`
 5. `Disk-Information`
 
----
-
 ## 1) Hardware Monitoring
 
-Zeigt live:
+Zeigt kontinuierlich:
 
-- CPU (gesamt + optional pro Kern)
-- RAM
-- GPU-Auslastung/Temperatur/VRAM
-- freien Speicher in den konfigurierten Pfaden
+- CPU / RAM
+- GPU (wenn verfügbar)
+- freie Speicherstände konfigurierter Pfade
 
-Wichtig für den Betrieb:
+Nutzen im Betrieb:
 
-- Hohe Speicherauslastung oder fast volle Zielpfade früh erkennen
-- über `Settings` aktivierbar/deaktivierbar (`Hardware Monitoring aktiviert`)
+- Engpässe vor Jobfehlern erkennen
+- Pfadfüllstände vor Start großer Batchs prüfen
+
+Gesteuert über `Settings`:
+
+- `Hardware Monitoring aktiviert`
+- `Hardware Monitoring Intervall (ms)`
 
 ## 2) Job Queue
 
-Zwei Spalten:
+Es gibt zwei operative Zonen:
 
 - `Laufende Jobs`
 - `Warteschlange`
 
-Mögliche Aktionen:
+Mögliche Queue-Einträge:
 
-- Queue per Drag-and-Drop umsortieren
-- Queue-Job entfernen (`X`)
-- zusätzliche Queue-Elemente einfügen (`+`):
-  - Skript
-  - Skriptkette
-  - Wartezeit
+- Job-Startaktionen (`Start`, `Retry Rippen`, `RAW neu encodieren`, `Encode neu starten`, `Review neu berechnen`, `Audio CD starten`)
+- Nicht-Job-Einträge (`Skript`, `Skriptkette`, `Warten`)
 
-Hinweis:
+Wichtige Regeln:
 
-- `Parallel` zeigt den Wert aus `Settings` -> `Parallele Jobs`.
+- Queue-Reihenfolge ist per Drag-and-Drop änderbar.
+- `Warten` blockiert nachfolgende Queue-Starts bis kein aktiver Prozess mehr läuft.
+- `Skript` und `Skriptkette` werden als Queue-Einträge mitgeführt.
+
+Parallelität kommt aus `Settings`:
+
+- `Max. parallele Film/Video Encodes`
+- `Max. parallele Audio CD Jobs`
+- `Max. Encodes gesamt`
+- optional `Audio CDs: Queue-Reihenfolge überspringen`
 
 ## 3) Skript- / Cron-Status
 
-Zeigt:
+Zeigt Runtime-Aktivitäten:
 
-- aktive Ausführungen (Skripte, Ketten, Cron)
-- zuletzt abgeschlossene Ausführungen
+- laufende Skripte
+- laufende Ketten
+- Cron-Ausführungen
+- letzte abgeschlossene Aktivitäten
 
-Mögliche Aktionen:
+Aktionen:
 
-- laufende Ketten: `Nächster Schritt`
-- laufende Einträge: `Abbrechen`
-- Historie der Aktivitäten: `Liste leeren`
+- `Nächster Schritt` bei Ketten
+- `Abbrechen`
+- `Liste leeren`
 
 ## 4) Job Übersicht
 
-Kompakte Jobliste mit Status, Fortschritt, ETA. Klick auf einen Job klappt die Detailsteuerung auf.
+Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick öffnet den jeweiligen `Pipeline-Status`.
 
-Zusätzliche Kennzeichnungen in der Liste:
+### Badges und Kontext
 
-- `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`)
+Neben Status/Fortschritt zeigt die Liste je nach Job:
 
-Im aufgeklappten Zustand erscheint die Karte `Pipeline-Status` mit allen zustandsabhängigen Aktionen.
+- Serienkontext (`Serien-Container`, Staffel/Disk)
+- Multipart-Kontext (`Multipart Movie`, Disc-Nr.)
+- Queue-/Subjob-Kontext bei Serien-Episoden
 
-### Zustandsabhängige Hauptaktionen
+### Zustandsabhängige Aktionen
 
-| Zustand | Typische Aktion |
-|---|---|
-| `Medium erkannt` / `Bereit` | `Analyse starten` |
-| `Metadatenauswahl` | `Metadaten öffnen` |
-| `Warte auf Auswahl` | Playlist wählen und `Playlist übernehmen` |
-| `Startbereit` | `Job starten` |
-| `Bereit zum Encodieren` | Tracks/Skripte prüfen, dann `Encoding starten` |
-| laufend (`Analyse`/`Rippen`/`Encodieren`) | `Abbrechen` |
-| `Fehler` / `Abgebrochen` | `Retry Rippen`, `Disk-Analyse neu starten` |
+| Zustand | Hauptaktion im Ripper | Ergebnis |
+|---|---|---|
+| `Medium erkannt`, `Bereit` | `Analyse starten` | startet MakeMKV-Analyse |
+| `Metadatenauswahl` | `Metadaten öffnen` | Film/Serie auswählen, Provider festlegen |
+| `Warte auf Auswahl` | Playlist/Titel/RAW-Entscheidung bestätigen | setzt Flow fort zur Prüfung |
+| `Startbereit` | `Job starten` | startet Rip oder RAW-basierte Prüfung |
+| `Bereit zum Encodieren` | `Encoding starten` | startet HandBrake mit bestätigter Auswahl |
+| Laufend (`Analyse`, `Rippen`, `Encodieren`) | `Abbrechen` | setzt Job auf `Abgebrochen` |
+| `Fehler`, `Abgebrochen` | `Retry Rippen` | neuer Rip-Anlauf |
 
-Zusätzlich je nach Job:
+Zusatzaktionen je nach Zustand und Jobtyp:
 
 - `Review neu starten`
 - `Encode neu starten`
+- `RAW neu encodieren`
 - `Aus Queue löschen`
 
-### Titel-/Spurprüfung (`Bereit zum Encodieren`)
+### Review-Bereich (`Bereit zum Encodieren`)
 
-Im selben Block siehst du:
+Hier wird die effektive Encode-Entscheidung festgelegt:
 
-- Auswahl des Encode-Titels
-- Audio-/Subtitle-Trackauswahl
-- User-Preset-Auswahl
+- Titelwahl
+- Audio-/Subtitle-Trackselektion
+- User-Preset
 - Pre-/Post-Encode-Skripte und Ketten
-- Preview des finalen HandBrakeCLI-Befehls
+- HandBrake-Kommandovorschau
+
+Ohne Bestätigung dieses Blocks startet kein produktiver Encode.
+
+### RAW-Ordnerphasen (sichtbar über Logs/Details)
+
+Der Ripper arbeitet mit drei RAW-Zuständen:
+
+- `Incomplete_...` während unvollständigem Rip
+- `Rip_Complete_...` nach erfolgreich abgeschlossenem Rip, vor Encode
+- ohne Prefix nach erfolgreichem Encode
+
+Das ist wichtig für Recovery und Delete-Vorschau.
 
 ## 5) Disk-Information
 
-Zeigt aktuelles Laufwerk und Disc-Metadaten (`Pfad`, `Modell`, `Disc-Label`, `Mount`).
+Zeigt aktuelle Laufwerksdaten:
+
+- Device-Pfad
+- Modell
+- Disc-Label / Mount
 
 Aktionen:
 
 - `Laufwerk neu lesen`
 - `Disk neu analysieren`
-- `Metadaten-Modal öffnen`
+- Metadaten-Dialog öffnen
 
 Hinweis:
 
-- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden und kann genutzt werden, solange kein Rescan-Request läuft.
+- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden.
 
----
-
-## Wichtige Dialoge im Ripper
+## Wichtige Dialoge
 
 ### Metadaten auswählen
 
-- OMDb-Suche + Ergebnisliste
-- manuelle Eingabe als Fallback
-- `Auswahl übernehmen` startet den nächsten Pipeline-Schritt
+Im Dialog werden Film-/Serienmetadaten bestätigt.
 
-Bei Film-Duplikaten in der Historie öffnet sich ein Konfliktdialog:
+Sonderfälle:
 
-- `Ü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
+- Film-Duplikat: `Übernahme erzwingen` oder `Multipart movie`
+- Serie: `Disc-Nummer` ist Pflicht
 
-### Abbruch-Bereinigung
+### Vorhandenes RAW erkannt
 
-Nach Abbruch kann Ripster optional fragen, ob erzeugte RAW- oder Movie-Dateien gelöscht werden sollen.
+Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
+
+- vorhandenes RAW verwenden
+- RAW verwerfen/löschen und neu rippen
 
 ### Queue-Eintrag einfügen
 
-Erstellt gezielt einen Skript-, Ketten- oder Warte-Eintrag an einer bestimmten Queue-Position.
+Du kannst gezielt ab Position einfügen:
+
+- Skript
+- Skriptkette
+- Wartezeit