0.16.1-1 release snapshot

2026-04-29 08:35:24 +00:00
parent 6115090da1
commit 901a3b1ad7
269 changed files with 127336 additions and 1 deletions
@@ -0,0 +1,168 @@
+# Ripper
+
+Die Seite `Ripper` ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
+
+## Seitenaufbau und Betriebslogik
+
+Die Bereiche erscheinen in dieser Reihenfolge:
+
+1. `Hardware Monitoring`
+2. `Job Queue`
+3. `Skript- / Cron-Status`
+4. `Job Übersicht`
+5. `Disk-Information`
+
+## 1) Hardware Monitoring
+
+Zeigt kontinuierlich:
+
+- CPU / RAM
+- GPU (wenn verfügbar)
+- freie Speicherstände konfigurierter Pfade
+
+Nutzen im Betrieb:
+
+- 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
+
+Es gibt zwei operative Zonen:
+
+- `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`)
+
+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.
+
+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 Runtime-Aktivitäten:
+
+- laufende Skripte
+- laufende Ketten
+- Cron-Ausführungen
+- letzte abgeschlossene Aktivitäten
+
+Aktionen:
+
+- `Nächster Schritt` bei Ketten
+- `Abbrechen`
+- `Liste leeren`
+
+## 4) Job Übersicht
+
+Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick öffnet den jeweiligen `Pipeline-Status`.
+
+### Badges und Kontext
+
+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 |
+|---|---|---|
+| `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 |
+
+Zusatzaktionen je nach Zustand und Jobtyp:
+
+- `Review neu starten`
+- `Encode neu starten`
+- `RAW neu encodieren`
+- `Aus Queue löschen`
+
+### Review-Bereich (`Bereit zum Encodieren`)
+
+Hier wird die effektive Encode-Entscheidung festgelegt:
+
+- Titelwahl
+- Audio-/Subtitle-Trackselektion
+- User-Preset
+- Pre-/Post-Encode-Skripte und Ketten
+- 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 aktuelle Laufwerksdaten:
+
+- Device-Pfad
+- Modell
+- Disc-Label / Mount
+
+Aktionen:
+
+- `Laufwerk neu lesen`
+- `Disk neu analysieren`
+- Metadaten-Dialog öffnen
+
+Hinweis:
+
+- `Laufwerk neu lesen` ist nicht mehr an einen festen Pipeline-State gebunden.
+
+## Wichtige Dialoge
+
+### Metadaten auswählen
+
+Im Dialog werden Film-/Serienmetadaten bestätigt.
+
+Sonderfälle:
+
+- Film-Duplikat: `Übernahme erzwingen` oder `Multipart movie`
+- Serie: `Disc-Nummer` ist Pflicht
+
+### Vorhandenes RAW erkannt
+
+Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
+
+- vorhandenes RAW verwenden
+- RAW verwerfen/löschen und neu rippen
+
+### Queue-Eintrag einfügen
+
+Du kannst gezielt ab Position einfügen:
+
+- Skript
+- Skriptkette
+- Wartezeit