Initial commit mit MkDocs-Dokumentation

2026-03-04 14:18:33 +00:00
parent 6115090da1
commit 31d3e36597
97 changed files with 27518 additions and 1 deletions
--- a/docs/pipeline/encoding.md
+++ b/docs/pipeline/encoding.md
@@ -0,0 +1,159 @@
+# Encode-Planung
+
+`encodePlan.js` analysiert die MediaInfo-Ausgabe und erstellt einen strukturierten Encode-Plan mit Track-Auswahl.
+
+---
+
+## Ablauf
+
+```
+MediaInfo-JSON
+      ↓
+Track-Parsing (Video, Audio, Untertitel)
+      ↓
+Sprach-Normalisierung (ISO 639-1 → 639-3)
+      ↓
+Codec-Klassifizierung (copy-kompatibel / transcode)
+      ↓
+Encode-Plan generieren
+      ↓
+Benutzer-Review im Frontend
+      ↓
+HandBrake-CLI-Argumente aufbauen
+```
+
+---
+
+## Encode-Plan-Format
+
+Der generierte Plan wird als JSON im Job-Datensatz gespeichert:
+
+```json
+{
+  "inputFile": "/mnt/raw/Inception_t00.mkv",
+  "outputFile": "/mnt/movies/Inception (2010).mkv",
+  "preset": "H.265 MKV 1080p30",
+  "audioTracks": [
+    {
+      "index": 1,
+      "codec": "dts",
+      "language": "deu",
+      "channels": 6,
+      "label": "Deutsch (DTS, 5.1)",
+      "copyCompatible": false,
+      "selected": true
+    },
+    {
+      "index": 2,
+      "codec": "truehd",
+      "language": "eng",
+      "channels": 8,
+      "label": "English (TrueHD, 7.1)",
+      "copyCompatible": true,
+      "selected": true
+    }
+  ],
+  "subtitleTracks": [
+    {
+      "index": 1,
+      "language": "deu",
+      "label": "Deutsch",
+      "selected": true
+    }
+  ]
+}
+```
+
+---
+
+## Sprach-Normalisierung
+
+MediaInfo liefert Sprachcodes in verschiedenen Formaten. `encodePlan.js` normalisiert diese auf **ISO 639-3**:
+
+| MediaInfo-Output | Normalisiert |
+|----------------|-------------|
+| `de` | `deu` |
+| `German` | `deu` |
+| `en` | `eng` |
+| `English` | `eng` |
+| `fr` | `fra` |
+| `ja` | `jpn` |
+
+---
+
+## Codec-Klassifizierung
+
+HandBrake kann einige Codecs direkt kopieren (ohne Transcoding):
+
+| Codec | Copy-kompatibel | HandBrake-Encoder |
+|-------|----------------|------------------|
+| `ac3` | ✅ Ja | `copy:ac3` |
+| `aac` | ✅ Ja | `copy:aac` |
+| `mp3` | ✅ Ja | `copy:mp3` |
+| `truehd` | ✅ Ja | `copy:truehd` |
+| `eac3` | ✅ Ja | `copy:eac3` |
+| `dts` | ❌ Nein | `ffaac` (transcode) |
+| `dtshd` | ❌ Nein | `ffaac` (transcode) |
+
+!!! info "DTS-Transcoding"
+    HandBrake unterstützt kein DTS-Passthrough in den Standard-Builds. DTS-Tracks werden zu AAC transcodiert, es sei denn, du verwendest einen speziellen HandBrake-Build mit DTS-Unterstützung.
+
+---
+
+## HandBrake-CLI-Argumente
+
+Aus dem Encode-Plan generiert `commandLine.js` die HandBrake-Argumente:
+
+```bash
+HandBrakeCLI \
+  --input "/mnt/raw/Inception_t00.mkv" \
+  --output "/mnt/movies/Inception (2010).mkv" \
+  --preset "H.265 MKV 1080p30" \
+  --audio 1,2 \
+  --aencoder copy:truehd,ffaac \
+  --subtitle 1 \
+  --subtitle-default 1
+```
+
+### Zusätzliche Argumente
+
+Über die Einstellung `handbrake_extra_args` können beliebige HandBrake-Argumente ergänzt werden:
+
+```
+--crop 0:0:0:0 --loose-anamorphic
+```
+
+---
+
+## Dateiname-Template
+
+Die Ausgabedatei wird über das konfigurierte Template benannt:
+
+```
+Template: {title} ({year})
+Ergebnis: Inception (2010).mkv
+```
+
+Verfügbare Platzhalter:
+
+| Platzhalter | Wert |
+|------------|------|
+| `{title}` | Filmtitel von OMDb |
+| `{year}` | Erscheinungsjahr |
+| `{imdb_id}` | IMDb-ID (z.B. `tt1375666`) |
+| `{type}` | `movie` oder `series` |
+
+Sonderzeichen im Dateinamen werden automatisch sanitisiert (`:`, `/`, `?` etc. werden entfernt oder ersetzt).
+
+---
+
+## Re-Encoding
+
+Abgeschlossene Jobs können mit geänderten Einstellungen neu encodiert werden:
+
+1. Job in der History auswählen
+2. "Re-Encode" klicken
+3. Neue Track-Auswahl treffen (oder bestehende übernehmen)
+4. Encoding startet mit aktuellen Einstellungen
+
+Dies ist nützlich, wenn sich das HandBrake-Preset oder die Track-Auswahl geändert hat, ohne die zeitintensive Ripping-Phase zu wiederholen.