1.0.0 docs

docs/gui/ripper.md

@@ -1,68 +1,76 @@
 # Ripper
 
-Die Seite `Ripper` ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
+Die Seite `Ripper` ist die Live-Steuerung der Disc-Pipeline. Hier laufen Disc-Erkennung, Queue, manuelle Entscheidungen, Review und aktive Jobs zusammen.
 
-## Seitenaufbau und Betriebslogik
+## Seitenaufbau
 
-Die Bereiche erscheinen in dieser Reihenfolge:
+Die wichtigsten Bereiche:
 
-1. `Hardware Monitoring`
+1. `Hardware`
 2. `Job Queue`
 3. `Skript- / Cron-Status`
 4. `Job Übersicht`
 5. `Disk-Information`
 
-## 1) Hardware Monitoring
+## 1. Hardware
 
-Zeigt kontinuierlich:
+Die Hardware-Karte zeigt live:
 
-- CPU / RAM
-- GPU (wenn verfügbar)
-- freie Speicherstände konfigurierter Pfade
+- CPU
+- RAM
+- GPU, falls vorhanden
+- freie Speicherstände der konfigurierten Pfade
 
-Nutzen im Betrieb:
+Aktionen:
 
-- Engpässe vor Jobfehlern erkennen
-- Pfadfüllstände vor Start großer Batchs prüfen
+- Klick auf das Hardware-Symbol öffnet die Seite [Hardware](hardware.md)
 
-Gesteuert über `Settings`:
+Relevante Settings:
 
 - `Hardware Monitoring aktiviert`
 - `Hardware Monitoring Intervall (ms)`
+- `Externe Speicher`
 
-## 2) Job Queue
+## 2. Job Queue
 
 Es gibt zwei operative Zonen:
 
-- `Laufende Jobs`
-- `Warteschlange`
+- laufende Jobs
+- Warteschlange
 
 Mögliche Queue-Einträge:
 
-- Job-Startaktionen (`Start`, `Retry Rippen`, `RAW neu encodieren`, `Encode neu starten`, `Review neu berechnen`, `Audio CD starten`)
-- Nicht-Job-Einträge (`Skript`, `Skriptkette`, `Warten`)
+- normale Job-Starts
+- `Retry Rippen`
+- `RAW neu encodieren`
+- `Encode neu starten`
+- `Review neu starten`
+- `Audio CD starten`
+- `Skript`
+- `Skriptkette`
+- `Warten`
 
 Wichtige Regeln:
 
-- 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.
+- Reihenfolge ist per Drag-and-Drop änderbar
+- `Warten` blockiert nachfolgende Starts, bis keine aktive Verarbeitung mehr läuft
+- Queue-Einträge können auch ohne Medienjob existieren
 
-Parallelität kommt aus `Settings`:
+Relevante Settings:
 
-- `Max. parallele Film/Video Encodes`
+- `Parallele Jobs`
 - `Max. parallele Audio CD Jobs`
-- `Max. Encodes gesamt`
-- optional `Audio CDs: Queue-Reihenfolge überspringen`
+- `Max. Encodes gesamt (medienunabhängig)`
+- `Audio CDs: Queue-Reihenfolge überspringen`
 
-## 3) Skript- / Cron-Status
+## 3. Skript- / Cron-Status
 
 Zeigt Runtime-Aktivitäten:
 
 - laufende Skripte
 - laufende Ketten
 - Cron-Ausführungen
-- letzte abgeschlossene Aktivitäten
+- kürzlich abgeschlossene Aktivitäten
 
 Aktionen:
 
@@ -70,66 +78,103 @@ Aktionen:
 - `Abbrechen`
 - `Liste leeren`
 
-## 4) Job Übersicht
+## 4. Job Übersicht
 
 Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick öffnet den jeweiligen `Pipeline-Status`.
 
-### Badges und Kontext
+### Zustandsabhängige Hauptaktionen
 
-Neben Status/Fortschritt zeigt die Liste je nach Job:
-
-- Serienkontext (`Serien-Container`, Staffel/Disk)
-- Multipart-Kontext (`Multipart Movie`, Disc-Nr.)
-- Queue-/Subjob-Kontext bei Serien-Episoden
-
-### Zustandsabhängige Aktionen
-
-| Zustand | Hauptaktion im Ripper | Ergebnis |
+| Zustand | Typische Aktion | 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 |
+| `Medium erkannt` | `Analyse starten` | MakeMKV-Analyse beginnt |
+| `Metadatenauswahl` | `Metadaten öffnen` | TMDb-Dialog für Film/Serie |
+| `Warte auf Auswahl` | Entscheidung bestätigen | Flow geht an die passende Stelle weiter |
+| `Startbereit` | `Job starten` | Rip oder RAW-basierte Prüfung startet |
+| `Bereit zum Encodieren` | `Encoding starten` | HandBrake startet mit bestätigter Auswahl |
+| laufend | `Abbrechen` | Job wird gestoppt |
+| `Fehler` / `Abgebrochen` | `Retry Rippen` | neuer Rip-Anlauf |
 
-Zusatzaktionen je nach Zustand und Jobtyp:
+### Was `Warte auf Auswahl` heute bedeuten kann
 
-- `Review neu starten`
-- `Encode neu starten`
-- `RAW neu encodieren`
-- `Aus Queue löschen`
+Der Status ist nicht nur für eine einzige Entscheidung da. Im aktuellen Stand gibt es drei typische Fälle:
 
-### Review-Bereich (`Bereit zum Encodieren`)
+#### Vorhandenes RAW
 
-Hier wird die effektive Encode-Entscheidung festgelegt:
+Ripster hat zu den Metadaten bereits ein passendes RAW gefunden. Dann entscheidest du:
 
-- Titelwahl
-- Audio-/Subtitle-Trackselektion
-- User-Preset
-- Pre-/Post-Encode-Skripte und Ketten
-- HandBrake-Kommandovorschau
+- mit RAW weiterarbeiten
+- RAW löschen und neu rippen
+- in passenden Film-Fällen optional Multipart mit Orphan-RAW bilden
 
-Ohne Bestätigung dieses Blocks startet kein produktiver Encode.
+#### Playlist-Auswahl
 
-### RAW-Ordnerphasen (sichtbar über Logs/Details)
+Bei mehrdeutigen Blu-rays oder bestimmten DVD-Fällen musst du eine Playlist bestätigen. Die Liste zeigt unter anderem:
+
+- Playlist-Datei
+- Titel-ID
+- Laufzeit
+- Score
+- Empfehlung
+- Segment- und Audio-Vorschau
+
+Relevante Settings:
+
+- `Minimale Titellänge (Minuten)`
+- `TMDb Runtime-Abzug für Playlistfilter (%)`
+- `Bei manueller Auswahl senden` für PushOver
+
+#### Titelauswahl / PlayAll-Grenzfall
+
+Wenn Ripster mehrere HandBrake-Titel als plausibel erkannt hat, musst du einen oder mehrere Titel bestätigen. Bei Serien kann das der Grenzfall `PlayAll oder Doppelfolge?` sein.
+
+## 5. Review-Bereich (`Bereit zum Encodieren`)
+
+Hier triffst du die eigentliche Encode-Entscheidung.
+
+Du legst fest:
+
+- welchen Titel Ripster encodieren soll
+- welche Audio-Spuren übernommen werden
+- welche Untertitel übernommen, erzwungen oder eingebrannt werden
+- welches User-Preset oder HandBrake-Preset verwendet wird
+- welche Pre-/Post-Encode-Skripte oder Ketten mitlaufen
+
+Wichtig:
+
+- ohne diese Bestätigung startet kein produktiver Encode
+- bei Multipart-Locks können Einstellungen von einer Referenz-Disc übernommen und gesperrt sein
+
+### Welche Settings hier direkt sichtbar werden
+
+- `HandBrake Preset`
+- `HandBrake Extra Args`
+- `Review Audio-Sprachen (...)`
+- `Review UT-Sprachen (...)`
+- `Ausgabeformat`
+- Standard-Zuordnungen aus `Settings -> Encode-Presets`
+
+## RAW-Ordnerphasen
 
 Der Ripper arbeitet mit drei RAW-Zuständen:
 
-- `Incomplete_...` während unvollständigem Rip
-- `Rip_Complete_...` nach erfolgreich abgeschlossenem Rip, vor Encode
+- `Incomplete_...` während eines unvollständigen Rips
+- `Rip_Complete_...` nach erfolgreichem Rip, vor dem finalen Encode
 - ohne Prefix nach erfolgreichem Encode
 
-Das ist wichtig für Recovery und Delete-Vorschau.
+Das ist wichtig für:
 
-## 5) Disk-Information
+- Recovery
+- RAW-Wiederverwendung
+- Delete-Preview in `Historie`
+
+## Disk-Information
 
 Zeigt aktuelle Laufwerksdaten:
 
 - Device-Pfad
 - Modell
-- Disc-Label / Mount
+- Disc-Label
+- Mount-Informationen
 
 Aktionen:
 
@@ -139,13 +184,13 @@ Aktionen:
 
 Hinweis:
 
-- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden.
+- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden
 
 ## Wichtige Dialoge
 
 ### Metadaten auswählen
 
-Im Dialog werden Film-/Serienmetadaten bestätigt.
+Im Dialog bestätigst du Film- oder Serienmetadaten aus TMDb.
 
 Sonderfälle:
 
@@ -154,7 +199,7 @@ Sonderfälle:
 
 ### Vorhandenes RAW erkannt
 
-Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
+Wenn zu den Metadaten bereits RAW existiert, fordert Ripster eine explizite Entscheidung:
 
 - vorhandenes RAW verwenden
 - RAW verwerfen/löschen und neu rippen
@@ -169,9 +214,14 @@ Du kannst gezielt ab Position einfügen:
 
 ### Audible Activation Bytes eintragen
 
-Wenn für eine AAX-Datei keine Activation Bytes automatisch ermittelt werden können,
-öffnet Ripster einen Dialog zur manuellen Eingabe.
+Wenn für eine AAX-Datei keine Activation Bytes verfügbar sind, öffnet Ripster einen Dialog zur manuellen Eingabe.
 
-- Eingabeformat: genau 8 Hex-Zeichen (z.B. `1a2b3c4d`)
+- Format: genau 8 Hex-Zeichen, z. B. `1a2b3c4d`
 - Speicherung: lokal im Activation-Bytes-Cache
-- Wirkung: nach dem Speichern kann der Audiobook-Flow fortgesetzt werden
+- Wirkung: der Audiobook-Flow kann anschließend fortgesetzt werden
+
+## Siehe auch
+
+- [Hardware](hardware.md)
+- [Settings](settings.md)
+- [Workflows aus Nutzersicht](../workflows/index.md)