413 lines
17 KiB
Markdown
413 lines
17 KiB
Markdown
# Schnellstart – Vollständiger Workflow
|
||
|
||
Nach der [Installation](installation.md) und [Konfiguration](configuration.md) führt diese Seite Schritt für Schritt durch den ersten Rip – mit allen Details aus dem Code.
|
||
|
||
---
|
||
|
||
## Übersicht: Pipeline-Zustände
|
||
|
||
<div class="pipeline-steps">
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-idle">●</div>
|
||
<div class="pipeline-step-label">IDLE</div>
|
||
<div class="pipeline-step-sub">Warten</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-idle">1</div>
|
||
<div class="pipeline-step-label">DISC_DETECTED</div>
|
||
<div class="pipeline-step-sub">Disc erkannt</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-running">2</div>
|
||
<div class="pipeline-step-label">METADATA_SELECTION</div>
|
||
<div class="pipeline-step-sub">Scan & Metadaten</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-wait">⚠</div>
|
||
<div class="pipeline-step-label">WAITING_FOR_USER_DECISION</div>
|
||
<div class="pipeline-step-sub">Playlist wählen<br><em>(nur bei Obfusk.)</em></div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-user">3</div>
|
||
<div class="pipeline-step-label">READY_TO_START</div>
|
||
<div class="pipeline-step-sub">Bereit</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-running">4</div>
|
||
<div class="pipeline-step-label">RIPPING</div>
|
||
<div class="pipeline-step-sub">MakeMKV</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-running">5</div>
|
||
<div class="pipeline-step-label">MEDIAINFO_CHECK</div>
|
||
<div class="pipeline-step-sub">HandBrake-Scan</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-user">6</div>
|
||
<div class="pipeline-step-label">READY_TO_ENCODE</div>
|
||
<div class="pipeline-step-sub">Track-Review</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-encode">7</div>
|
||
<div class="pipeline-step-label">ENCODING</div>
|
||
<div class="pipeline-step-sub">HandBrake</div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-encode">8</div>
|
||
<div class="pipeline-step-label">POST_ENCODE_SCRIPTS</div>
|
||
<div class="pipeline-step-sub">Skripte<br><em>(optional)</em></div>
|
||
</div>
|
||
<div class="pipeline-step">
|
||
<div class="pipeline-step-badge step-done">✓</div>
|
||
<div class="pipeline-step-label">FINISHED</div>
|
||
<div class="pipeline-step-sub">Fertig</div>
|
||
</div>
|
||
</div>
|
||
|
||
**Legende:** <span style="color:#546e7a">● Warten</span> | <span style="color:#1565c0">■ Läuft automatisch</span> | <span style="color:#3949ab">■ Benutzeraktion</span> | <span style="color:#e65100">⚠ Optional</span> | <span style="color:#6a1b9a">■ Encodierung</span> | <span style="color:#2e7d32">✓ Fertig</span>
|
||
|
||
??? note "Vollständiges Zustandsdiagramm (inkl. Fehler- & Alternativpfade)"
|
||
|
||
<div class="pipeline-diagram">
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
START(( )) --> IDLE
|
||
|
||
IDLE -->|Disc erkannt| DD[DISC_DETECTED]
|
||
DD -->|Analyse starten| META[METADATA\nSELECTION]
|
||
|
||
META -->|1 Kandidat| RTS[READY_TO\nSTART]
|
||
META -->|mehrere Kandidaten| WUD[WAITING_FOR\nUSER_DECISION]
|
||
WUD -->|Playlist bestätigt| RTS
|
||
|
||
RTS -->|Raw vorhanden| MIC[MEDIAINFO\nCHECK]
|
||
RTS -->|Ripping starten| RIP[RIPPING]
|
||
RIP -->|MKV fertig| MIC
|
||
RIP -->|Fehler| ERR
|
||
|
||
MIC --> RTE[READY_TO\nENCODE]
|
||
RTE -->|bestätigt| ENC[ENCODING]
|
||
|
||
ENC -->|mit Skripten| PES[POST_ENCODE\nSCRIPTS]
|
||
ENC -->|ohne Skripte| FIN([FINISHED])
|
||
ENC -->|Fehler| ERR
|
||
|
||
PES -->|Erfolg| FIN
|
||
PES -->|Fehler| ERR
|
||
|
||
ERR([ERROR]) -->|Retry / Cancel| IDLE
|
||
|
||
style FIN fill:#e8f5e9,stroke:#66bb6a,color:#2e7d32
|
||
style ERR fill:#ffebee,stroke:#ef5350,color:#c62828
|
||
style WUD fill:#fff8e1,stroke:#ffa726,color:#e65100
|
||
style PES fill:#f3e5f5,stroke:#ab47bc,color:#6a1b9a
|
||
style ENC fill:#f3e5f5,stroke:#ab47bc,color:#6a1b9a
|
||
```
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## Schritt 1 – Ripster starten
|
||
|
||
```bash
|
||
cd ripster
|
||
./start.sh
|
||
```
|
||
|
||
Öffne [http://localhost:5173](http://localhost:5173) im Browser. Das Dashboard zeigt `IDLE`.
|
||
|
||
---
|
||
|
||
## Schritt 2 – Disc einlegen → `DISC_DETECTED`
|
||
|
||
Lege eine DVD oder Blu-ray ein. Der `diskDetectionService` pollt das Laufwerk alle `disc_poll_interval_ms` Millisekunden (Standard: 5 Sekunden).
|
||
|
||
**Was passiert im Code:**
|
||
|
||
- `diskDetectionService` emittiert `disc:inserted` mit Geräteinformationen
|
||
- `pipelineService.onDiscInserted()` wird aufgerufen
|
||
- Dashboard zeigt Badge **"Neue Disc erkannt"**
|
||
- Der **"Analyse starten"**-Button wird aktiv
|
||
|
||
!!! tip "Manuelle Auslösung"
|
||
Falls die automatische Erkennung nicht greift:
|
||
```bash
|
||
curl -X POST http://localhost:3001/api/pipeline/analyze
|
||
```
|
||
|
||
---
|
||
|
||
## Schritt 3 – Analyse starten → `METADATA_SELECTION`
|
||
|
||
Klicke auf **"Analyse starten"** oder warte auf automatischen Start.
|
||
|
||
**Was passiert im Code:**
|
||
|
||
1. Ein neuer Job-Datensatz wird in der Datenbank angelegt (`status: METADATA_SELECTION`)
|
||
2. Ripster versucht, den Titel automatisch aus dem Disc-Label/Modell zu ermitteln
|
||
3. Mit diesem erkannten Titel wird sofort eine **OMDb-Suche** ausgelöst
|
||
4. Der `MetadataSelectionDialog` öffnet sich im Frontend mit den vorgeladenen Suchergebnissen
|
||
|
||
**Erkannter Titel:** Der Disc-Label (z. B. `INCEPTION`) wird als Suchbegriff verwendet. Falls kein Label vorhanden, bleibt das Suchfeld leer.
|
||
|
||
---
|
||
|
||
## Schritt 4 – Metadaten auswählen (`MetadataSelectionDialog`)
|
||
|
||
Der Dialog zeigt vorgeladene OMDb-Suchergebnisse. Du kannst:
|
||
|
||
### 4a) OMDb-Suchergebnis wählen
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────┐
|
||
│ Suche: [Inception ] 🔍 │
|
||
├─────────────────────────────────────────────────┤
|
||
│ ▶ Inception (2010) · Movie · tt1375666 │
|
||
│ Inception: ... · Series · ... │
|
||
├─────────────────────────────────────────────────┤
|
||
│ [Auswahl übernehmen] │
|
||
└─────────────────────────────────────────────────┘
|
||
```
|
||
|
||
- Suche durch Titel anpassen und Enter drücken
|
||
- Typ-Filter: `movie` / `series` umschalten möglich
|
||
- Einen Eintrag anklicken, dann **"Auswahl übernehmen"**
|
||
|
||
### 4b) Manuelle Eingabe (ohne OMDb)
|
||
|
||
Falls kein passendes Ergebnis gefunden wird:
|
||
- Titel, Jahr und IMDb-ID manuell eingeben
|
||
- OMDb-Poster wird übersprungen
|
||
|
||
**Was passiert nach Bestätigung:**
|
||
|
||
Ripster ruft `pipelineService.selectMetadata()` auf und führt sofort eine **Playlist-Analyse** durch:
|
||
|
||
- MakeMKV wird im Info-Modus gestartet
|
||
- Alle Titel und deren Segment-Reihenfolgen werden analysiert
|
||
- Das Ergebnis entscheidet über den nächsten Zustand (→ Schritt 5)
|
||
|
||
---
|
||
|
||
## Schritt 5 – Playlist-Situation (zwei Wege)
|
||
|
||
### 5a) Keine Obfuskierung → `READY_TO_START`
|
||
|
||
Der Dialog schließt sich automatisch. Die empfohlene Playlist wird still übernommen. Weiter zu **Schritt 6**.
|
||
|
||
### 5b) Obfuskierung erkannt → `WAITING_FOR_USER_DECISION`
|
||
|
||
Der **Playlist-Auswahl-Dialog** erscheint **zusätzlich** (nach dem Metadaten-Dialog):
|
||
|
||
```
|
||
┌───────────────────────────────────────────────────────────────┐
|
||
│ Playlist-Auswahl │
|
||
│ Es wurden mehrere Titel mit ähnlicher Laufzeit gefunden. │
|
||
│ Bitte wähle die korrekte Playlist: │
|
||
├───────────┬──────────┬────────┬──────────────────────────────┤
|
||
│ Playlist │ Laufzeit │ Score │ Bewertung │
|
||
├───────────┼──────────┼────────┼──────────────────────────────┤
|
||
│ ● 00800 │ 2:28:05 │ +18 │ wahrscheinlich korrekt │
|
||
│ │ │ │ (lineare Segmentfolge) │
|
||
├───────────┼──────────┼────────┼──────────────────────────────┤
|
||
│ ○ 00801 │ 2:28:12 │ −4 │ Auffällige Segmentreihenfolge │
|
||
├───────────┼──────────┼────────┼──────────────────────────────┤
|
||
│ ○ 00900 │ 2:28:05 │ −32 │ Fake-Struktur │
|
||
│ │ │ │ (alternierendes Sprungmuster) │
|
||
└───────────┴──────────┴────────┴──────────────────────────────┘
|
||
847 Playlists insgesamt · 3 relevante Kandidaten (≥ 15 min)
|
||
Empfehlung: 00800 (vorausgewählt)
|
||
[Playlist bestätigen]
|
||
```
|
||
|
||
- Die empfohlene Playlist ist **vorausgewählt** (Radio-Button)
|
||
- Score und Bewertungslabel helfen bei der Entscheidung
|
||
- Nach Bestätigung: Pipeline wechselt zu `READY_TO_START`
|
||
|
||
!!! info "Scoring-Details"
|
||
Wie die Scores berechnet werden, erklärt die [Playlist-Analyse](../pipeline/playlist-analysis.md)-Seite.
|
||
|
||
---
|
||
|
||
## Schritt 6 – Ripping starten → `RIPPING`
|
||
|
||
**Vorher prüft Ripster:** Existiert bereits eine Raw-Datei für diesen Job?
|
||
|
||
- **Ja, Raw-Datei vorhanden** → Direkt zu Schritt 7 (Track-Review), kein erneutes Ripping
|
||
- **Nein** → MakeMKV-Ripping startet
|
||
|
||
Klicke auf **"Starten"** im Dashboard.
|
||
|
||
**Was MakeMKV ausführt (MKV-Modus):**
|
||
|
||
```bash
|
||
makemkvcon mkv disc:0 all /mnt/raw/Inception-2010/ \
|
||
--minlength=900 -r
|
||
```
|
||
|
||
**Was MakeMKV ausführt (Backup-Modus):**
|
||
|
||
```bash
|
||
makemkvcon backup disc:0 /mnt/raw/Inception-2010-backup/ \
|
||
--decrypt -r
|
||
```
|
||
|
||
**Live-Fortschritt** wird aus der MakeMKV-Ausgabe geparst:
|
||
|
||
```
|
||
PRGV:2048,0,65536 → Fortschritt wird berechnet und per WebSocket gesendet
|
||
PRGT:5011,0,"Sichern..." → Aktueller Task-Name
|
||
```
|
||
|
||
**Typische Dauer:**
|
||
- DVD: 20–45 Minuten
|
||
- Blu-ray: 45–120 Minuten
|
||
|
||
---
|
||
|
||
## Schritt 7 – Track-Review → `READY_TO_ENCODE`
|
||
|
||
Nach dem Ripping (oder direkt bei vorhandener Raw-Datei) startet der **HandBrake-Scan**:
|
||
|
||
```bash
|
||
HandBrakeCLI --scan -i <quelle> -t 0
|
||
```
|
||
|
||
Dieser Scan liest alle Tracks aus ohne zu encodieren. Ripster baut daraus den Encode-Plan mit automatischer Vorauswahl:
|
||
|
||
**Status: `MEDIAINFO_CHECK`** – läuft automatisch, kein Benutzereingriff
|
||
|
||
Danach öffnet sich das **Encode-Review-Panel** (`READY_TO_ENCODE`):
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ Encode-Review │
|
||
│ Titel: Disc Title 1 · Laufzeit: 2:28:05 · 28 Kapitel │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ Audio-Spuren │
|
||
├──────┬─────────────────────────────┬───────────────────────────┤
|
||
│ ☑ │ Track 1: English (AC3, 5.1) │ Copy (ac3) │
|
||
│ ☑ │ Track 2: Deutsch (DTS, 5.1) │ Fallback Transcode (av_aac)│
|
||
│ ☐ │ Track 3: Français (AC3, 2.0) │ Nicht übernommen │
|
||
├──────┴─────────────────────────────┴───────────────────────────┤
|
||
│ Untertitel-Spuren │
|
||
├──────┬─────────────────────────────┬────────┬──────┬──────────┤
|
||
│ ☑ │ Track 1: Deutsch │ Einbr.☐ │Forc.☐│Default☑ │
|
||
│ ☐ │ Track 2: English │ Einbr.☐ │Forc.☐│Default☐ │
|
||
├──────┴─────────────────────────────┴────────┴──────┴──────────┤
|
||
│ [Encode bestätigen] │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### Audio-Track-Aktionen verstehen
|
||
|
||
| Symbol/Text | Bedeutung |
|
||
|------------|-----------|
|
||
| `Copy (ac3)` | Track wird **verlustfrei** direkt übernommen |
|
||
| `Copy (truehd)` | TrueHD-Track wird direkt übernommen |
|
||
| `Transcode (av_aac)` | Track wird zu AAC umgewandelt |
|
||
| `Fallback Transcode (av_aac)` | Copy nicht möglich → automatisch zu AAC |
|
||
| `Preset-Default (HandBrake)` | HandBrake-Preset entscheidet |
|
||
| `Nicht übernommen` | Track ist nicht ausgewählt |
|
||
|
||
### Untertitel-Flags
|
||
|
||
| Flag | Bedeutung |
|
||
|------|-----------|
|
||
| **Einbrennen** | Untertitel werden fest ins Video gebrannt (nur ein Track möglich) |
|
||
| **Forced** | Nur erzwungene Untertitel-Einblendungen übernehmen |
|
||
| **Default** | Diese Spur wird beim Abspielen automatisch aktiviert |
|
||
|
||
### Vorauswahl-Regeln
|
||
|
||
Die Tracks mit `☑` wurden nach der Regel aus den Einstellungen automatisch vorausgewählt (`selectedByRule: true`). Die Auswahl kann frei geändert werden.
|
||
|
||
Klicke **"Encode bestätigen"** um fortzufahren.
|
||
|
||
---
|
||
|
||
## Schritt 8 – Encoding → `ENCODING`
|
||
|
||
HandBrake startet mit dem finalisierten Plan:
|
||
|
||
```bash
|
||
HandBrakeCLI \
|
||
-i /dev/sr0 \
|
||
-o "/mnt/movies/Inception (2010).mkv" \
|
||
-t 1 \
|
||
--preset "H.265 MKV 1080p30" \
|
||
-a 1,2 \
|
||
-E copy:ac3,av_aac \
|
||
-s 1 \
|
||
--subtitle-default 1
|
||
```
|
||
|
||
**Live-Fortschritt** wird aus HandBrake-stderr geparst:
|
||
|
||
```
|
||
Encoding: task 1 of 1, 73.50 % (45.23 fps, avg 44.12 fps, ETA 00h12m34s)
|
||
```
|
||
|
||
Das Dashboard zeigt:
|
||
- Fortschrittsbalken (0–100 %)
|
||
- Aktuelle Encoding-Geschwindigkeit (FPS)
|
||
- Geschätzte Restzeit (ETA)
|
||
|
||
**Typische Dauer (abhängig von CPU/GPU und Preset):**
|
||
- Schnelles Preset (`fast`): 0.5× Echtzeit
|
||
- Standard-Preset: 1–3× Echtzeit
|
||
- Langsames Preset (`slow`): 5–10× Echtzeit
|
||
|
||
---
|
||
|
||
## Schritt 9 – Fertig! → `FINISHED`
|
||
|
||
```
|
||
/mnt/nas/movies/
|
||
└── Inception (2010).mkv ✓ Encodierung abgeschlossen
|
||
```
|
||
|
||
- Job-Status in der Datenbank: `FINISHED`
|
||
- PushOver-Benachrichtigung (falls konfiguriert)
|
||
- Eintrag in der [History](http://localhost:5173/history) mit vollständigen Logs
|
||
|
||
---
|
||
|
||
## Fehlerbehandlung
|
||
|
||
### Job im Status `ERROR`
|
||
|
||
1. **Dashboard**: Details-Button → Log-Ausgabe prüfen
|
||
2. **Retry**: Job vom Fehlerzustand neu starten (behält Metadaten)
|
||
3. **History**: Vollständige Logs und Fehlerdetails
|
||
|
||
### Häufige Fehlerursachen
|
||
|
||
| Fehler | Ursache | Lösung |
|
||
|-------|---------|--------|
|
||
| MakeMKV: Lizenzfehler | Abgelaufene Beta-Lizenz | Neue Lizenz im [MakeMKV-Forum](https://www.makemkv.com/forum/viewtopic.php?t=1053) |
|
||
| HandBrake: Preset nicht gefunden | Preset-Name falsch | `HandBrakeCLI --preset-list` prüfen |
|
||
| Keine Disc erkannt | Laufwerk-Berechtigungen | `sudo chmod a+rw /dev/sr0` |
|
||
| Falsches Video (zerstückelt) | Falsche Playlist | Job re-encodieren mit anderer Playlist |
|
||
| OMDb: Keine Ergebnisse | API-Key fehlt oder Titel nicht gefunden | Einstellungen prüfen; manuell eingeben |
|
||
|
||
---
|
||
|
||
## Kurzübersicht aller Schritte
|
||
|
||
| # | Status | Benutzeraktion | Was Ripster tut |
|
||
|--|--------|---------------|----------------|
|
||
| 1 | `IDLE` | Disc einlegen | Disc-Polling erkennt Disc |
|
||
| 2 | `DISC_DETECTED` | "Analyse starten" klicken | Job anlegen, OMDb vorsuchen |
|
||
| 3 | `METADATA_SELECTION` | Film im Dialog auswählen | Playlist-Analyse durchführen |
|
||
| 4a | `READY_TO_START` | — | Empfehlung automatisch übernommen |
|
||
| 4b | `WAITING_FOR_USER_DECISION` | Playlist manuell wählen | Auf Bestätigung warten |
|
||
| 5 | `READY_TO_START` | "Starten" klicken | MakeMKV-Ripping starten |
|
||
| 6 | `RIPPING` | Warten | MakeMKV rippt, Fortschritt streamen |
|
||
| 7 | `MEDIAINFO_CHECK` | Warten | HandBrake-Scan, Encode-Plan bauen |
|
||
| 8 | `READY_TO_ENCODE` | Tracks prüfen + bestätigen | Auswahl in Plan übernehmen |
|
||
| 9 | `ENCODING` | Warten | HandBrake encodiert, Fortschritt streamen |
|
||
| 10 | `FINISHED` | — | Datei fertig, Benachrichtigung senden |
|