Encode-Planung & Track-Auswahl¶

encodePlan.js analysiert die HandBrake-Scan-Ausgabe, wählt Audio- und Untertitelspuren anhand von Regeln vor und erstellt einen vollständigen Encode-Plan für die Benutzer-Review.

Ablauf im Pipeline-Kontext¶

RIPPING abgeschlossen (oder Pre-Rip-Scan)
          ↓
HandBrake --scan (alle Titel & Tracks einlesen)
          ↓
buildTrackSelectors()     ← Regeln aus Einstellungen ableiten
          ↓
selectTrackIds()          ← Tracks anhand Regeln vorauswählen
          ↓
resolveAudioEncoderAction() ← Encoder-Aktion pro Track bestimmen
          ↓
buildDiscScanReview()     ← Vollständigen Encode-Plan erstellen
          ↓
READY_TO_ENCODE           ← Benutzer-Review im Frontend
          ↓
applyManualTrackSelectionToPlan() ← Benutzer-Auswahl anwenden
          ↓
ENCODING                  ← HandBrake-CLI mit finalem Plan starten

Phase 1: Pre-Rip Track-Scan¶

Ripster führt einen HandBrake-Scan bereits vor dem eigentlichen Ripping durch:

HandBrakeCLI --scan -i /dev/sr0 -t 0

Dieser Scan liest alle Titel und deren Tracks aus der Disc (ohne zu encodieren). So kann der Benutzer die Track-Auswahl bereits vor dem zeitintensiven Rip-Prozess bestätigen.

Phase 2: Track-Selektor-Regeln (buildTrackSelectors)¶

Die Regeln werden aus den HandBrake-Einstellungen abgeleitet. Es gibt fünf Selektionsmodi:

Der aktive Modus wird aus den handbrake_*-Einstellungen und handbrake_extra_args abgeleitet. Explizite CLI-Argumente (--audio, --audio-lang-list) überschreiben die Basis-Konfiguration.

Phase 3: Automatische Vorauswahl (selectTrackIds)¶

Audio-Tracks¶

Modus 'none'      → Keine Audio-Tracks
Modus 'all'       → Alle Tracks (oder nur erster, wenn firstOnly)
Modus 'language'  → Alle Tracks in den konfigurierten Sprachen
Modus 'explicit'  → Nur die angegebenen Track-IDs
Modus 'first'     → Nur Track 1

Jeder Audio-Track erhält das Feld selectedByRule: true/false – dieses zeigt dem Benutzer, welche Tracks automatisch vorausgewählt wurden.

Sprach-Normalisierung (normalizeLanguage):

Alle Sprachcodes werden auf ISO 639-2 (3-Buchstaben) normalisiert:

Untertitel-Tracks¶

Gleiche Modus-Logik wie Audio, aber mit zusätzlichen Flags pro Track:

Diese Flags werden im Encode-Review als Checkboxen angezeigt.

Phase 4: Encoder-Aktion bestimmen (resolveAudioEncoderAction)¶

Für jeden vorausgewählten Audio-Track bestimmt Ripster die Encoder-Aktion:

Encoder-Einstellung      Codec-Support in Copy-Mask?    Aktion
─────────────────────────────────────────────────────────────────────
Kein Encoder / 'preset-default'   →  preset-default     HandBrake-Preset entscheidet
encoder.startsWith('copy')
  UND Codec in audioCopyMask      →  copy               Direktkopie (verlustfrei)
  UND Codec NICHT in audioCopyMask→  fallback            Transcode mit Fallback-Encoder
sonstiger Encoder                 →  transcode           Transcode mit explizitem Encoder

Encoder-Aktionstypen:

Copy-kompatible Codecs (Standard Copy-Mask):

Phase 5: Encode-Plan-Struktur¶

Der vollständige Plan wird im Job-Datensatz als encode_plan_json gespeichert:

{
  "mode": "pre_rip",
  "preRip": true,
  "encodeInputTitleId": 1,
  "encodeInputPath": "disc-track-scan://title-1",
  "selectors": {
    "audio": { "mode": "language", "languages": ["deu", "eng"], "copyMask": ["copy:ac3", "copy:eac3"] },
    "subtitle": { "mode": "none" }
  },
  "titles": [
    {
      "id": 1,
      "fileName": "Disc Title 1",
      "durationSeconds": 8885,
      "selectedByMinLength": true,
      "isEncodeInput": true,
      "audioTracks": [
        {
          "id": 1,
          "sourceTrackId": 1,
          "language": "eng",
          "languageLabel": "English",
          "title": "5.1 Surround",
          "format": "AC3",
          "codecToken": "ac3",
          "channels": "6",
          "selectedByRule": true,
          "selectedForEncode": true,
          "encodePreviewActions": [
            { "type": "copy", "encoder": "copy:ac3", "label": "Copy (ac3)" }
          ],
          "encodePreviewSummary": "Copy (ac3)"
        },
        {
          "id": 2,
          "sourceTrackId": 2,
          "language": "deu",
          "languageLabel": "Deutsch",
          "format": "DTS",
          "codecToken": "dts",
          "channels": "6",
          "selectedByRule": true,
          "selectedForEncode": true,
          "encodePreviewActions": [
            { "type": "fallback", "encoder": "av_aac", "label": "Fallback Transcode (av_aac)" }
          ],
          "encodePreviewSummary": "Fallback Transcode (av_aac)"
        },
        {
          "id": 3,
          "language": "fra",
          "languageLabel": "Français",
          "selectedByRule": false,
          "selectedForEncode": false,
          "encodePreviewSummary": "Nicht übernommen"
        }
      ],
      "subtitleTracks": [
        {
          "id": 1,
          "language": "deu",
          "selectedByRule": true,
          "selectedForEncode": true,
          "burnIn": false,
          "forced": false,
          "defaultTrack": true,
          "subtitlePreviewSummary": "Übernehmen",
          "subtitlePreviewFlags": ["default"]
        }
      ]
    }
  ]
}

Phase 6: Benutzer-Review im Frontend (MediaInfoReviewPanel)¶

Das Review-Panel zeigt:

┌─────────────────────────────────────────────────────────────────┐
│ Encode-Review                            Titel: Disc Title 1    │
│                                          Laufzeit: 2:28:05      │
├─────────────────────────────────────────────────────────────────┤
│ Audio-Spuren                                                    │
├──────┬──────────────────────────┬──────────────────────────────┤
│ [✓]  │ Track 1: English (AC3)   │ Copy (ac3)                   │
│ [✓]  │ Track 2: Deutsch (DTS)   │ Fallback Transcode (av_aac)  │
│ [ ]  │ Track 3: Français (DTS)  │ Nicht übernommen             │
├──────┴──────────────────────────┴──────────────────────────────┤
│ Untertitel-Spuren                                               │
├──────┬──────────────────────────┬────────┬────────┬────────────┤
│ [✓]  │ Track 1: Deutsch         │Einbr.[ ]│Forced[ ]│Default[✓]│
│ [ ]  │ Track 2: English         │Einbr.[ ]│Forced[ ]│Default[ ]│
├──────┴──────────────────────────┴────────┴────────┴────────────┤
│                               [Encoding starten]               │
└─────────────────────────────────────────────────────────────────┘

Der Benutzer kann: - Audio-Tracks per Checkbox aktivieren/deaktivieren - Untertitel-Flags (Einbrennen, Forced, Default) setzen - Mehrere Titel bei der Titleauswahl wechseln (für Discs mit mehreren Haupttiteln)

Phase 7: Benutzer-Auswahl anwenden (applyManualTrackSelectionToPlan)¶

Im Frontend wird die Benutzer-Auswahl beim Klick auf "Encoding starten" (ggf. automatisch) bestätigt und dann auf den Plan angewendet:

Payload: {
  "selectedEncodeTitleId": 1,
  "selectedTrackSelection": {
    "1": {
      "audioTrackIds": [1, 2],
      "subtitleTrackIds": [1]
    }
  }
}

Jeder Track erhält selectedForEncode: true/false entsprechend der Auswahl. Die Encoder-Aktionen (encodeActions) der nicht gewählten Tracks werden geleert.

Phase 8: HandBrake-CLI-Befehl¶

Aus dem finalisierten Plan baut Ripster den HandBrake-Aufruf:

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

Dateiname-Template¶

Sonderzeichen (:, /, ?, * etc.) werden automatisch aus dem Dateinamen entfernt.

Re-Encoding¶

Ein abgeschlossener Job kann ohne erneutes Ripping neu encodiert werden:

1. Job in der History öffnen
2. "Re-Encode" klicken
3. Track-Auswahl anpassen (oder bestehende übernehmen)
4. Encoding startet mit den aktuellen handbrake_*-Einstellungen

Nützlich bei geänderten Presets, anderen Sprach-Präferenzen oder nach einem Einstellungs-Update.