michael/ripster
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
23acea4773cac58849c747aa7cad73d99c1ff3ad
ripster/docs/getting-started/quickstart.md

17 KiB
Raw Blame History

Schnellstart – Vollständiger Workflow

Nach der Installation und Konfiguration führt diese Seite Schritt für Schritt durch den ersten Rip – mit allen Details aus dem Code.

Übersicht: Pipeline-Zustände

●
IDLE
Warten
1
DISC_DETECTED
Disc erkannt
2
METADATA_SELECTION
Scan & Metadaten
⚠
WAITING_FOR_USER_DECISION
Playlist wählen
(nur bei Obfusk.)
3
READY_TO_START
Bereit
4
RIPPING
MakeMKV
5
MEDIAINFO_CHECK
HandBrake-Scan
6
READY_TO_ENCODE
Track-Review
7
ENCODING
HandBrake
8
POST_ENCODE_SCRIPTS
Skripte
(optional)
✓
FINISHED
Fertig

Legende: ● Warten  |  ■ Läuft automatisch  |  ■ Benutzeraktion  |  ⚠ Optional  |  ■ Encodierung  |  ✓ Fertig

??? 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

cd ripster
./start.sh

Öffne 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-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):

makemkvcon mkv disc:0 all /mnt/raw/Inception-2010/ \
  --minlength=900 -r

Was MakeMKV ausführt (Backup-Modus):

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:

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:

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 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
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
Reference in New Issue View Git Blame Copy Permalink