Upload

2026-03-04 14:48:56 +00:00
parent 31d3e36597
commit 3b293bb743
11 changed files with 1116 additions and 310 deletions
--- a/docs/pipeline/playlist-analysis.md
+++ b/docs/pipeline/playlist-analysis.md
@@ -1,119 +1,209 @@
 # Playlist-Analyse

-Einige Blu-rays verwenden **Playlist-Obfuskierung** als Kopierschutz-Mechanismus. Ripster erkennt dieses Muster und hilft bei der Auswahl der korrekten Playlist.
+Einige Blu-rays verwenden **Playlist-Obfuskierung** als Kopierschutz. Ripster analysiert automatisch alle MakeMKV-Titel und empfiehlt die korrekte Playlist – auf Basis eines Segment-Scoring-Algorithmus aus `playlistAnalysis.js`.

 ---

 ## Das Problem: Playlist-Obfuskierung

-Moderne Blu-rays können Hunderte von Playlists enthalten, von denen nur eine den eigentlichen Film enthält. Die anderen sind:
+Moderne Blu-rays können Dutzende bis Hunderte von Titeln/Playlists enthalten. Der eigentliche Film steckt in genau einer davon – alle anderen sind:

- **Kurze Dummy-Playlists** (wenige Sekunden bis Minuten)
- **Umgeordnete Segmente** (falsche Reihenfolge der Film-Segmente)
- **Duplizierte Inhalte** (mehrere Playlists mit gleichem Inhalt, verschiedenen Timestamps)
+- **Kurze Dummy-Titel** (wenige Sekunden bis Minuten)
+- **Titel mit verschachtelten Segmenten** (absichtlich versetzte Reihenfolge, sodass der Film falsch gerippt wird)
+- **Titel gleicher Länge** (mehrere Playlists mit identischer Laufzeit, aber unterschiedlicher Segment-Reihenfolge)

-Dies macht es schwierig, die korrekte Playlist manuell zu identifizieren.
+Das Ziel der Obfuskierung: Ein einfacher Ripper wählt den erstbesten langen Titel – und bekommt ein zerstückeltes, unbrauchbares Video.

 ---

-## Ripsters Analyse-Algorithmus
+## Wann wird die Analyse ausgelöst?

-`playlistAnalysis.js` analysiert alle von MakeMKV erkannten Playlists nach mehreren Kriterien:
-
-### 1. Laufzeit-Matching
-
-Die erwartete Laufzeit (aus OMDb-Metadaten) wird mit der Playlist-Laufzeit verglichen:
+Die Playlist-Analyse wird automatisch gestartet **sobald der Benutzer Metadaten bestätigt** (nach dem Metadaten-Dialog). Ripster ruft `makemkvcon` im Info-Modus auf und parst die TINFO-Ausgabe.

 ```
-Filmtitel:    Inception (2010)
-OMDb-Laufzeit: 148 Minuten
-
-Playlist 00800.mpls: 148:22 → ✅ Match
-Playlist 00801.mpls:   1:23 → ❌ Zu kurz
-Playlist 00900.mpls: 148:25 → ✅ Match (Duplikat?)
+TINFO:<titleId>,26,"<segment-list>"
 ```

-### 2. Titel-Ähnlichkeit
-
-Playlists mit Namen, die dem Filmtitel ähneln, werden bevorzugt.
-
-### 3. Segment-Validierung
-
-Die Playlist-Segmente werden auf logische Reihenfolge geprüft.
-
-### 4. Häufigkeits-Analyse
-
-Bei mehreren Kandidaten: Welche Segment-Kombination kommt am häufigsten vor?
+Feld **26** enthält die kommagetrennte Liste der Segment-Nummern in der Abspielreihenfolge des Titels.

 ---

-## Benutzer-Interface
+## Algorithmus im Detail (`playlistAnalysis.js`)

-Wenn Playlist-Obfuskierung erkannt wird, zeigt Ripster im `MetadataSelectionDialog` eine Playlist-Auswahl:
+### Schritt 1 – Segment-Nummern parsen

 ```
-┌─────────────────────────────────────────────────────┐
-│ Playlist auswählen                                  │
-├─────────────────────────────────────────────────────┤
-│ ★ 00800.mpls  2:28:05  ✓ Empfohlen (Laufzeit passt) │
-│   00801.mpls  0:01:23  Kurz (wahrscheinlich Menü)   │
-│   00900.mpls  2:28:12  Mögliche Alternative          │
-│   00901.mpls  0:00:45  Kurz                          │
-│   ...         ...      ...                           │
-├─────────────────────────────────────────────────────┤
-│ Hinweis: 847 Playlists gefunden – Analyse empfiehlt │
-│ Playlist 00800.mpls als Hauptfilm.                  │
-└─────────────────────────────────────────────────────┘
+TINFO:1,26,"00000,00001,00002,00003"  → [0, 1, 2, 3]       linearer Film
+TINFO:2,26,"00100,00050,00100,00051"  → [100, 50, 100, 51]  Fake-Playlist
 ```

+### Schritt 2 – Metriken berechnen (`computeSegmentMetrics`)
+
+Für jedes aufeinanderfolgende Segment-Paar `[a, b]` wird `diff = b − a` berechnet:
+
+| Metrik | Bedingung | Bedeutung |
+|--------|----------|-----------|
+| `directSequenceSteps` | `diff == 1` | Aufeinanderfolgende Segmente → linearer Film |
+| `backwardJumps` | `b < a` | Rückwärtssprünge → verdächtig |
+| `largeJumps` | `\|diff\| > 20` | Große Sprünge → verdächtig |
+| `alternatingPairs` | Große Sprünge mit **wechselndem Vorzeichen** | Hin-und-her-Muster → starker Fake-Indikator |
+
+**Score-Formel:**
+
+```
+score = (directSequenceSteps × 2) − (backwardJumps × 3) − (largeJumps × 2)
+```
+
+**Konkrete Beispiele:**
+
+| Segmentfolge | directSeq | backward | large | score | Ergebnis |
+|-------------|-----------|----------|-------|-------|---------|
+| `0,1,2,3,4,5` | 5 | 0 | 0 | +10 | Echter Film |
+| `0,1,100,2,101,3` | 2 | 0 | 4 | -4 | Verdächtig |
+| `50,10,60,11,70,12` | 0 | 3 | 3 | -15 | Fake |
+
+### Schritt 3 – Bewertungslabel vergeben (`buildEvaluationLabel`)
+
+```
+alternatingRatio = alternatingPairs / largeJumps
+
+if alternatingRatio >= 0.55 AND alternatingPairs >= 3:
+  → "Fake-Struktur (alternierendes Sprungmuster)"
+
+else if backwardJumps > 0 OR largeJumps > 0:
+  → "Auffällige Segmentreihenfolge"
+
+else:
+  → "wahrscheinlich korrekt (lineare Segmentfolge)"
+```
+
+### Schritt 4 – Duplikat-Gruppen bilden (`buildSimilarityGroups`)
+
+Alle Titel werden nach **ähnlicher Laufzeit** gruppiert (±90 Sekunden Toleranz). Gibt es mehrere Kandidaten mit ähnlicher Laufzeit, ist das ein klares Zeichen für Obfuskierung:
+
+```
+8 Titel mit ~148 Minuten Laufzeit → Duplikat-Gruppe
+→ obfuscationDetected = true
+→ manualDecisionRequired = true
+```
+
+### Schritt 5 – Besten Kandidaten empfehlen (`scoreCandidates`)
+
+Innerhalb der größten Duplikat-Gruppe werden alle Kandidaten sortiert nach:
+
+1. `score` (höher = besser)
+2. `sequenceCoherence` (Anteil linearer Segmentschritte)
+3. Laufzeit (länger = besser)
+4. Dateigröße (größer = besser als Tiebreaker)
+
+Der **erste Kandidat** der sortierten Liste ist die Empfehlung.
+
 ---

-## Analyse-Ergebnis-Format
+## Wann greift der Benutzer ein?
+
+```
+obfuscationDetected    = duplicateDurationGroups.length > 0
+manualDecisionRequired = obfuscationDetected
+```
+
+| Ergebnis | Nächster Pipeline-Zustand | Aktion |
+|---------|--------------------------|--------|
+| Keine Duplikat-Gruppen | `READY_TO_START` | Empfehlung wird automatisch übernommen |
+| Duplikat-Gruppen gefunden | `WAITING_FOR_USER_DECISION` | Benutzer muss Playlist auswählen |
+
+---
+
+## Benutzeroberfläche: Playlist-Auswahl-Dialog
+
+Wenn `manualDecisionRequired = true`, öffnet sich der Playlist-Dialog **nach** dem Metadaten-Dialog:
+
+```
+┌───────────────────────────────────────────────────────────────────┐
+│ Playlist-Auswahl                                                  │
+├──────────┬──────────┬──────────┬────────────────────────────────┤
+│ 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)   │
+└──────────┴──────────┴──────────┴────────────────────────────────┘
+  Hinweis: 847 Playlists insgesamt. 3 relevante Kandidaten (≥ 15 min).
+  Empfehlung: 00800 (★)
+```
+
+- **★** markiert die empfohlene Playlist (vorausgewählt)
+- Nur Titel ≥ `makemkv_min_length_minutes` erscheinen in der Liste
+- Der Benutzer wählt per Radio-Button und klickt "Bestätigen"
+- Erst nach dieser Bestätigung wechselt die Pipeline zu `READY_TO_START`
+
+---
+
+## Vollständige Datenstruktur (`analyzeContext.playlistAnalysis`)

 ```json
 {
+  "titles": [
+    { "titleId": 1, "playlistId": "00800", "durationSeconds": 8885, "durationLabel": "2:28:05", "chapters": 28 }
+  ],
  "candidates": [
+    { "titleId": 1, "playlistId": "00800", "durationSeconds": 8885 },
+    { "titleId": 2, "playlistId": "00801", "durationSeconds": 8892 }
+  ],
+  "evaluatedCandidates": [
    {
-      "playlist": "00800.mpls",
-      "duration": "2:28:05",
-      "durationSeconds": 8885,
-      "score": 0.95,
-      "recommended": true,
-      "reasons": ["Laufzeit stimmt mit OMDb überein", "Häufigste Segment-Kombination"]
-    },
-    {
-      "playlist": "00900.mpls",
-      "duration": "2:28:12",
-      "durationSeconds": 8892,
-      "score": 0.72,
-      "recommended": false,
-      "reasons": ["Ähnliche Laufzeit", "Seltene Segment-Kombination"]
+      "titleId": 1,
+      "playlistId": "00800",
+      "score": 18,
+      "sequenceCoherence": 0.95,
+      "evaluationLabel": "wahrscheinlich korrekt (lineare Segmentfolge)",
+      "metrics": {
+        "directSequenceSteps": 12,
+        "backwardJumps": 0,
+        "largeJumps": 1,
+        "alternatingPairs": 0
+      }
    }
  ],
-  "totalPlaylists": 847,
-  "recommendation": "00800.mpls"
+  "duplicateDurationGroups": [
+    [
+      { "titleId": 1, "playlistId": "00800" },
+      { "titleId": 2, "playlistId": "00801" }
+    ]
+  ],
+  "recommendation": {
+    "titleId": 1,
+    "playlistId": "00800",
+    "score": 18,
+    "reason": "Höchster Segment-Score in der größten Laufzeit-Gruppe"
+  },
+  "obfuscationDetected": true,
+  "manualDecisionRequired": true
 }
 ```

 ---

-## Manuelle Auswahl
+## Konfiguration

-Falls die automatische Empfehlung nicht korrekt ist:
-
-1. Wähle eine andere Playlist aus der Liste
-2. Beachte die Laufzeit-Angabe
-3. Vergleiche mit der erwarteten Filmlänge (aus OMDb oder Disc-Hülle)
-
-!!! tip "Tipp"
-    Bei Blu-rays von bekannten Filmen kannst du die korrekte Playlist oft über Foren wie [MakeMKV-Forum](https://www.makemkv.com/forum/) verifizieren.
+| Einstellung | Standard | Wirkung |
+|------------|---------|---------|
+| `makemkv_min_length_minutes` | `15` | Titel kürzer als dieser Wert werden als Kandidaten ignoriert |

 ---

-## Konfiguration
+## Tipps bei Fehlempfehlung

-Die Playlist-Analyse ist automatisch aktiv. Einstellbar ist:
+!!! tip "Falsche Playlist gewählt?"
+    Wenn das resultierende Video zerstückelt ist:

-| Parameter | Beschreibung |
-|----------|-------------|
-| `makemkv_min_length_minutes` | Mindestlänge, um als Hauptfilm-Kandidat zu gelten (Standard: 15 Min) |
+    1. Job in der **History** öffnen
+    2. **Re-Encode** starten – diesmal eine andere Playlist wählen
+    3. Alternativ: Korrekte Playlist im [MakeMKV-Forum](https://www.makemkv.com/forum/) recherchieren
+
+!!! info "Keine Segment-Daten verfügbar"
+    Bei DVDs oder älteren Blu-rays liefert MakeMKV manchmal keine Segmentinfos (TINFO-Feld 26 fehlt). In diesem Fall entfällt die Analyse und der erste Titel über der Mindestlänge wird automatisch verwendet.