223 lines
4.7 KiB
Markdown
223 lines
4.7 KiB
Markdown
# Workflow & Zustände
|
|
|
|
Der Ripping-Workflow von Ripster ist als **State Machine** implementiert. Jeder Zustand hat klar definierte Übergangsbedingungen und Aktionen.
|
|
|
|
---
|
|
|
|
## Zustandsdiagramm
|
|
|
|
```mermaid
|
|
stateDiagram-v2
|
|
direction LR
|
|
[*] --> IDLE
|
|
|
|
IDLE --> ANALYZING: Disc erkannt\n(automatisch)
|
|
ANALYZING --> METADATA_SELECTION: MakeMKV-Analyse\nabgeschlossen
|
|
METADATA_SELECTION --> READY_TO_START: Benutzer wählt\nMetadaten + Playlist
|
|
|
|
READY_TO_START --> RIPPING: Benutzer startet\nden Job
|
|
|
|
RIPPING --> MEDIAINFO_CHECK: MKV/Backup\nerstellt
|
|
MEDIAINFO_CHECK --> READY_TO_ENCODE: Track-Analyse\nabgeschlossen
|
|
|
|
READY_TO_ENCODE --> ENCODING: Benutzer bestätigt\nEncode + Tracks
|
|
|
|
ENCODING --> FINISHED: HandBrake\nfertig
|
|
FINISHED --> IDLE: Disc auswerfen /\nneue Disc
|
|
|
|
RIPPING --> ERROR: Fehler
|
|
ENCODING --> ERROR: Fehler
|
|
ANALYZING --> ERROR: Fehler
|
|
ERROR --> IDLE: cancelPipeline()\noder retryJob()
|
|
```
|
|
|
|
---
|
|
|
|
## Zustandsbeschreibungen
|
|
|
|
### IDLE
|
|
|
|
**Ausgangszustand.** Ripster wartet auf eine Disc.
|
|
|
|
- `diskDetectionService` pollt das Laufwerk (Intervall konfigurierbar)
|
|
- Bei Disc-Erkennung: Automatischer Übergang zu `ANALYZING`
|
|
- WebSocket-Event: `DISC_DETECTED`
|
|
|
|
---
|
|
|
|
### ANALYZING
|
|
|
|
**MakeMKV analysiert die Disc-Struktur.**
|
|
|
|
```bash
|
|
makemkvcon -r info disc:0
|
|
```
|
|
|
|
- Liest Titel-Informationen, Playlist-Liste, Track-Details
|
|
- Fortschritt wird über WebSocket übertragen
|
|
- Bei Blu-ray: Playlist-Liste für spätere Analyse gesammelt
|
|
- Dauer: 30 Sekunden bis 5 Minuten
|
|
|
|
**Ausgabe:** JSON-Struktur mit allen Titeln und Playlists
|
|
|
|
---
|
|
|
|
### METADATA_SELECTION
|
|
|
|
**Wartet auf Benutzer-Eingabe.**
|
|
|
|
- `MetadataSelectionDialog` wird im Frontend angezeigt
|
|
- Benutzer sucht in OMDb nach dem Filmtitel
|
|
- Benutzer wählt einen Eintrag aus den Suchergebnissen
|
|
- Bei Blu-ray: Playlist-Auswahl (mit Empfehlung durch `playlistAnalysis.js`)
|
|
|
|
**Übergang:** `selectMetadata(jobId, omdbData, playlist)` aufrufen
|
|
|
|
---
|
|
|
|
### READY_TO_START
|
|
|
|
**Metadaten bestätigt, bereit zum Starten.**
|
|
|
|
- Job-Datensatz in Datenbank mit Metadaten aktualisiert
|
|
- Start-Button im Dashboard aktiv
|
|
- Benutzer kann Metadaten noch mal ändern
|
|
|
|
**Übergang:** `startJob(jobId)` aufrufen
|
|
|
|
---
|
|
|
|
### RIPPING
|
|
|
|
**MakeMKV rippt die Disc.**
|
|
|
|
=== "MKV-Modus (Standard)"
|
|
|
|
```bash
|
|
makemkvcon mkv disc:0 all /path/to/raw/ \
|
|
--minlength=900
|
|
```
|
|
|
|
Erstellt MKV-Datei(en) direkt aus den gewählten Titeln.
|
|
|
|
=== "Backup-Modus"
|
|
|
|
```bash
|
|
makemkvcon backup disc:0 /path/to/raw/backup/ \
|
|
--decrypt
|
|
```
|
|
|
|
Erstellt vollständiges Disc-Backup inkl. Menüs.
|
|
|
|
**Live-Updates:** Fortschritt wird zeilenweise aus MakeMKV-Ausgabe geparst:
|
|
|
|
```
|
|
PRGC:5012,0,2048 → Fortschritt: X%
|
|
PRGT:5011,0,"..." → Aktueller Task
|
|
```
|
|
|
|
---
|
|
|
|
### MEDIAINFO_CHECK
|
|
|
|
**MediaInfo analysiert die gerippte Datei.**
|
|
|
|
```bash
|
|
mediainfo --Output=JSON /path/to/raw/file.mkv
|
|
```
|
|
|
|
- Liest alle Audio-, Untertitel- und Video-Tracks
|
|
- Extrahiert Codec-Informationen (DTS, TrueHD, AC-3, ...)
|
|
- Bestimmt Sprachcodes (ISO 639)
|
|
- Erstellt Encode-Plan via `encodePlan.js`
|
|
|
|
---
|
|
|
|
### READY_TO_ENCODE
|
|
|
|
**Encode-Plan erstellt, wartet auf Bestätigung.**
|
|
|
|
- `MediaInfoReviewPanel` wird im Frontend angezeigt
|
|
- Benutzer kann Audio- und Untertitel-Tracks de/aktivieren
|
|
- Vorgeschlagene Tracks basierend auf Sprach-Einstellungen
|
|
|
|
**Übergang:** `confirmEncode(jobId, trackSelection)` aufrufen
|
|
|
|
---
|
|
|
|
### ENCODING
|
|
|
|
**HandBrake encodiert die Datei.**
|
|
|
|
```bash
|
|
HandBrakeCLI \
|
|
--input /path/to/raw.mkv \
|
|
--output /path/to/movies/Inception\ \(2010\).mkv \
|
|
--preset "H.265 MKV 1080p30" \
|
|
--audio 1,2 \
|
|
--subtitle 1
|
|
```
|
|
|
|
**Live-Updates:** Fortschritt wird aus HandBrake-stderr geparst:
|
|
|
|
```
|
|
Encoding: task 1 of 1, 73.50 %
|
|
```
|
|
|
|
---
|
|
|
|
### FINISHED
|
|
|
|
**Job erfolgreich abgeschlossen.**
|
|
|
|
- Ausgabedatei liegt im konfigurierten `movie_dir`
|
|
- Job-Status in Datenbank auf `FINISHED` gesetzt
|
|
- PushOver-Benachrichtigung (falls konfiguriert)
|
|
- WebSocket-Event: `JOB_COMPLETE`
|
|
|
|
---
|
|
|
|
### ERROR
|
|
|
|
**Fehler aufgetreten.**
|
|
|
|
- Fehlerdetails im Job-Datensatz gespeichert
|
|
- Fehler-Logs verfügbar in der History
|
|
- **Retry**: Job kann vom Fehlerzustand neu gestartet werden
|
|
- **Abbrechen**: Pipeline zurück zu IDLE
|
|
|
|
---
|
|
|
|
## Abbrechen & Retry
|
|
|
|
### Pipeline abbrechen
|
|
|
|
```http
|
|
POST /api/pipeline/cancel
|
|
```
|
|
|
|
- Sendet SIGINT an aktiven Prozess
|
|
- Wartet auf graceful exit (Timeout: 10 Sekunden)
|
|
- Falls kein graceful exit: SIGKILL
|
|
- Pipeline-Zustand zurück zu IDLE
|
|
|
|
### Job wiederholen
|
|
|
|
```http
|
|
POST /api/pipeline/retry/:jobId
|
|
```
|
|
|
|
- Setzt Job-Status zurück auf `READY_TO_START`
|
|
- Behält Metadaten und Playlist-Auswahl
|
|
- Pipeline neu starten mit vorhandenen Daten
|
|
|
|
### Re-Encode
|
|
|
|
```http
|
|
POST /api/pipeline/reencode/:jobId
|
|
```
|
|
|
|
- Encodiert bestehende Raw-MKV neu
|
|
- Nützlich für geänderte Encoding-Einstellungen
|
|
- Kein neues Ripping erforderlich
|