docs
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Encode-Planung & Track-Auswahl
|
||||
|
||||
Ripster erzeugt vor dem Encode einen `encodePlan` und lässt ihn im Review-Panel bestätigen.
|
||||
Vor dem eigentlichen Encoding erstellt Ripster einen Encode-Plan und zeigt ihn im Review an.
|
||||
|
||||
---
|
||||
|
||||
@@ -10,27 +10,27 @@ Ripster erzeugt vor dem Encode einen `encodePlan` und lässt ihn im Review-Panel
|
||||
Quelle bestimmen (Disc/RAW)
|
||||
-> HandBrake-Scan (--scan --json)
|
||||
-> Plan erstellen (Titel, Audio, Untertitel)
|
||||
-> READY_TO_ENCODE
|
||||
-> Benutzer bestätigt Auswahl
|
||||
-> Status: Bereit zum Encodieren
|
||||
-> Benutzer bestaetigt Auswahl
|
||||
-> finaler HandBrake-Aufruf
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Review-Inhalt (`READY_TO_ENCODE`)
|
||||
## Review-Inhalt (Status: `Bereit zum Encodieren`)
|
||||
|
||||
- auswählbarer Encode-Titel
|
||||
- Audio-Track-Selektion
|
||||
- Untertitel-Track-Selektion inkl. Flags
|
||||
- Audio-Track-Auswahl
|
||||
- Untertitel-Track-Auswahl inkl. Flags
|
||||
- `burnIn`
|
||||
- `forced`
|
||||
- `defaultTrack`
|
||||
- optionale User-Presets (HandBrake-Preset + Extra-Args)
|
||||
- optionale User-Presets (HandBrake Preset + Extra Args)
|
||||
- optionale Pre-/Post-Skripte und Ketten
|
||||
|
||||
---
|
||||
|
||||
## Bestätigung (`confirm-encode`)
|
||||
## Bestaetigung (`confirm-encode`)
|
||||
|
||||
Typischer Payload:
|
||||
|
||||
@@ -51,7 +51,7 @@ Typischer Payload:
|
||||
}
|
||||
```
|
||||
|
||||
Ripster speichert die bestätigte Auswahl in `jobs.encode_plan_json` und markiert `encode_review_confirmed = 1`.
|
||||
Die bestätigte Auswahl wird im Job gespeichert und für Neustarts wiederverwendet.
|
||||
|
||||
---
|
||||
|
||||
@@ -83,16 +83,16 @@ Untertitel-Flags werden bei Bedarf ergänzt:
|
||||
- Pre-Encode läuft vor HandBrake
|
||||
- Post-Encode läuft nach HandBrake
|
||||
|
||||
Verhalten bei Fehlern:
|
||||
Fehlerverhalten:
|
||||
|
||||
- Pre-Encode-Fehler: Job wird als `ERROR` beendet (Encode startet nicht)
|
||||
- Post-Encode-Fehler: Job kann `FINISHED` bleiben, enthält aber Fehlerhinweis/Script-Summary
|
||||
- Pre-Encode-Fehler: Job endet mit Status `Fehler` (Encode startet nicht)
|
||||
- Post-Encode-Fehler: Job kann `Fertig` bleiben, enthält aber Fehlerhinweis/Script-Summary
|
||||
|
||||
---
|
||||
|
||||
## Dateinamen/Ordner
|
||||
|
||||
Der finale Outputpfad wird aus Settings-Templates aufgebaut.
|
||||
Der finale Outputpfad wird aus den Templates in den Settings aufgebaut.
|
||||
|
||||
Platzhalter:
|
||||
|
||||
@@ -100,4 +100,4 @@ Platzhalter:
|
||||
- `${year}`
|
||||
- `${imdbId}`
|
||||
|
||||
Ungültige Dateizeichen werden sanitisiert.
|
||||
Ungültige Dateizeichen werden bereinigt.
|
||||
|
||||
@@ -6,7 +6,7 @@ Ripster analysiert bei Blu-ray-ähnlichen Quellen Playlists und fordert bei Mehr
|
||||
|
||||
## Ziel
|
||||
|
||||
Erkennen, welche Playlist wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
|
||||
Erkennen, welche Playlist sehr wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
|
||||
|
||||
---
|
||||
|
||||
@@ -26,20 +26,15 @@ Für Kandidaten werden u. a. berücksichtigt:
|
||||
- Kohärenz linearer Segmentfolgen
|
||||
- Duplikatgruppen mit ähnlicher Laufzeit
|
||||
|
||||
Daraus entstehen:
|
||||
|
||||
- `candidates`
|
||||
- `evaluatedCandidates` (inkl. Score/Label)
|
||||
- `recommendation`
|
||||
- `manualDecisionRequired`
|
||||
Daraus entstehen intern Kandidatenlisten, Bewertungen und eine Empfehlung.
|
||||
|
||||
---
|
||||
|
||||
## Wann muss der Benutzer entscheiden?
|
||||
|
||||
Wenn nach Filterung mehr als ein relevanter Kandidat übrig bleibt, setzt Ripster `manualDecisionRequired = true` und wechselt auf:
|
||||
Wenn nach Filterung mehr als ein relevanter Kandidat übrig bleibt, wechselt der Job in der GUI auf:
|
||||
|
||||
- `WAITING_FOR_USER_DECISION`
|
||||
- `Warte auf Auswahl`
|
||||
|
||||
Dann muss eine Playlist bestätigt werden, bevor der Workflow weiterläuft.
|
||||
|
||||
@@ -47,9 +42,9 @@ Dann muss eine Playlist bestätigt werden, bevor der Workflow weiterläuft.
|
||||
|
||||
## Konfigurationseinfluss
|
||||
|
||||
| Key | Wirkung |
|
||||
|-----|---------|
|
||||
| `makemkv_min_length_minutes` | Mindestlaufzeit für Kandidaten |
|
||||
| Feld in `Settings` | Wirkung |
|
||||
|---|---|
|
||||
| `Minimale Titellaenge (Minuten)` | Mindestlaufzeit für Kandidaten |
|
||||
|
||||
Default ist aktuell `60` Minuten.
|
||||
|
||||
@@ -61,5 +56,5 @@ Bei manueller Entscheidung zeigt das Dashboard Kandidaten inkl. Score/Bewertung
|
||||
|
||||
Nach Bestätigung:
|
||||
|
||||
- mit vorhandenem RAW -> zurück zu `MEDIAINFO_CHECK`
|
||||
- ohne RAW -> Startpfad über `READY_TO_START`/`RIPPING`
|
||||
- mit vorhandenem RAW -> zurück zu `Mediainfo-Pruefung`
|
||||
- ohne RAW -> Startpfad über `Startbereit` / `Rippen`
|
||||
|
||||
@@ -7,11 +7,11 @@ Ripster kann Skripte und Skript-Ketten vor und nach dem Encode ausführen.
|
||||
## Ablauf
|
||||
|
||||
```text
|
||||
READY_TO_ENCODE
|
||||
Bereit zum Encodieren
|
||||
-> Pre-Encode Skripte/Ketten
|
||||
-> HandBrake Encoding
|
||||
-> Post-Encode Skripte/Ketten
|
||||
-> FINISHED oder ERROR
|
||||
-> Fertig oder Fehler
|
||||
```
|
||||
|
||||
---
|
||||
@@ -29,8 +29,8 @@ Im Review-Panel kannst du getrennt wählen:
|
||||
|
||||
## Fehlerverhalten
|
||||
|
||||
- Pre-Encode-Fehler stoppen die Kette und führen zu `ERROR`.
|
||||
- Post-Encode-Fehler stoppen die restlichen Post-Schritte; Job kann dennoch `FINISHED` sein (mit Fehlerzusatz im Status/Log).
|
||||
- Pre-Encode-Fehler stoppen die Kette und führen zu `Fehler`.
|
||||
- Post-Encode-Fehler stoppen die restlichen Post-Schritte; Job kann dennoch `Fertig` sein (mit Fehlerzusatz im Status/Log).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Workflow & Zustände
|
||||
|
||||
Ripster steuert den Ablauf als State-Machine im `pipelineService`.
|
||||
Ripster steuert den Ablauf als Zustandsmaschine.
|
||||
|
||||
---
|
||||
|
||||
@@ -8,41 +8,41 @@ Ripster steuert den Ablauf als State-Machine im `pipelineService`.
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
IDLE --> DISC_DETECTED
|
||||
DISC_DETECTED --> ANALYZING
|
||||
ANALYZING --> METADATA_SELECTION
|
||||
METADATA_SELECTION --> READY_TO_START
|
||||
READY_TO_START --> RIPPING
|
||||
READY_TO_START --> MEDIAINFO_CHECK
|
||||
MEDIAINFO_CHECK --> WAITING_FOR_USER_DECISION
|
||||
WAITING_FOR_USER_DECISION --> MEDIAINFO_CHECK
|
||||
MEDIAINFO_CHECK --> READY_TO_ENCODE
|
||||
READY_TO_ENCODE --> ENCODING
|
||||
ENCODING --> FINISHED
|
||||
ENCODING --> ERROR
|
||||
RIPPING --> ERROR
|
||||
RIPPING --> CANCELLED
|
||||
A[Bereit] --> B[Medium erkannt]
|
||||
B --> C[Analyse]
|
||||
C --> D[Metadatenauswahl]
|
||||
D --> E[Startbereit]
|
||||
E --> F[Rippen]
|
||||
E --> G[Mediainfo-Pruefung]
|
||||
G --> H[Warte auf Auswahl]
|
||||
H --> G
|
||||
G --> I[Bereit zum Encodieren]
|
||||
I --> J[Encodieren]
|
||||
J --> K[Fertig]
|
||||
J --> L[Fehler]
|
||||
F --> L
|
||||
F --> M[Abgebrochen]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## State-Liste
|
||||
## Statusliste (GUI-Anzeige)
|
||||
|
||||
| State | Bedeutung |
|
||||
|------|-----------|
|
||||
| `IDLE` | Wartet auf Disc |
|
||||
| `DISC_DETECTED` | Disc erkannt |
|
||||
| `ANALYZING` | MakeMKV-Analyse läuft |
|
||||
| `METADATA_SELECTION` | Benutzer wählt Metadaten |
|
||||
| `WAITING_FOR_USER_DECISION` | Playlist-Auswahl nötig |
|
||||
| `READY_TO_START` | Übergangszustand vor Start |
|
||||
| `RIPPING` | MakeMKV-Rip läuft |
|
||||
| `MEDIAINFO_CHECK` | Quelle/Tracks werden ausgewertet |
|
||||
| `READY_TO_ENCODE` | Review ist bereit |
|
||||
| `ENCODING` | HandBrake läuft |
|
||||
| `FINISHED` | erfolgreich abgeschlossen |
|
||||
| `CANCELLED` | abgebrochen |
|
||||
| `ERROR` | fehlgeschlagen |
|
||||
| Status in der GUI | Bedeutung |
|
||||
|---|---|
|
||||
| `Bereit` | Wartet auf Disc |
|
||||
| `Medium erkannt` | Disc wurde erkannt |
|
||||
| `Analyse` | MakeMKV-Analyse läuft |
|
||||
| `Metadatenauswahl` | Metadaten müssen bestätigt werden |
|
||||
| `Warte auf Auswahl` | Playlist-Auswahl ist erforderlich |
|
||||
| `Startbereit` | kurzer Übergang vor Start |
|
||||
| `Rippen` | MakeMKV-Rip läuft |
|
||||
| `Mediainfo-Pruefung` | Titel/Spuren werden ausgewertet |
|
||||
| `Bereit zum Encodieren` | Review ist bereit |
|
||||
| `Encodieren` | HandBrake läuft |
|
||||
| `Fertig` | erfolgreich abgeschlossen |
|
||||
| `Abgebrochen` | manuell oder technisch abgebrochen |
|
||||
| `Fehler` | fehlgeschlagen |
|
||||
|
||||
---
|
||||
|
||||
@@ -50,38 +50,38 @@ flowchart LR
|
||||
|
||||
### Standardfall (kein vorhandenes RAW)
|
||||
|
||||
1. Disc erkannt
|
||||
1. Medium erkannt
|
||||
2. Analyse + Metadaten
|
||||
3. `RIPPING`
|
||||
4. `MEDIAINFO_CHECK`
|
||||
5. `READY_TO_ENCODE`
|
||||
6. `ENCODING`
|
||||
7. `FINISHED`
|
||||
3. Rippen
|
||||
4. Mediainfo-Pruefung
|
||||
5. Bereit zum Encodieren
|
||||
6. Encodieren
|
||||
7. Fertig
|
||||
|
||||
### Vorhandenes RAW
|
||||
|
||||
`READY_TO_START` springt direkt zu `MEDIAINFO_CHECK` (kein neuer Rip).
|
||||
`Startbereit` springt direkt zu `Mediainfo-Pruefung` (kein neuer Rip).
|
||||
|
||||
### Mehrdeutige Blu-ray-Playlist
|
||||
|
||||
`MEDIAINFO_CHECK` -> `WAITING_FOR_USER_DECISION` bis Benutzer Playlist bestätigt.
|
||||
`Mediainfo-Pruefung` -> `Warte auf Auswahl` bis Playlist bestätigt wurde.
|
||||
|
||||
---
|
||||
|
||||
## Queue-Verhalten
|
||||
|
||||
Wenn `pipeline_max_parallel_jobs` erreicht ist:
|
||||
Wenn der Wert `Parallele Jobs` erreicht ist:
|
||||
|
||||
- Job-Aktionen werden als Queue-Einträge abgelegt
|
||||
- Queue kann zusätzlich Nicht-Job-Einträge enthalten (`script`, `chain`, `wait`)
|
||||
- Reihenfolge ist per API/UI änderbar
|
||||
- neue Starts werden als Queue-Einträge abgelegt
|
||||
- die Queue kann zusätzlich Nicht-Job-Einträge enthalten (`Skript`, `Kette`, `Warten`)
|
||||
- Reihenfolge ist per UI/API änderbar
|
||||
|
||||
---
|
||||
|
||||
## Abbruch, Retry, Restart
|
||||
## Abbruch, Wiederaufnahme, Neustart
|
||||
|
||||
- `cancel`: laufenden Job abbrechen oder Queue-Eintrag entfernen
|
||||
- `retry`: Fehler-/Abbruch-Job neu starten
|
||||
- `reencode`: aus vorhandenem RAW neu encodieren
|
||||
- `restart-review`: Review aus RAW neu aufbauen
|
||||
- `restart-encode`: Encoding mit letzter bestätigter Auswahl neu starten
|
||||
- `Abbrechen`: laufenden Job stoppen oder Queue-Eintrag entfernen
|
||||
- `Retry Rippen`: Fehler-/Abbruch-Job erneut starten
|
||||
- `RAW neu encodieren`: aus vorhandenem RAW neu encodieren
|
||||
- `Review neu starten`: Review aus RAW neu aufbauen
|
||||
- `Encode neu starten`: Encoding mit letzter bestätigter Auswahl neu starten
|
||||
|
||||
Reference in New Issue
Block a user