0.16.1-1 release snapshot

docs/tools/handbrake.md

@@ -0,0 +1,69 @@
+# HandBrake
+
+Ripster verwendet `HandBrakeCLI` für Scan und Encode.
+
+---
+
+## Verwendete Aufrufe
+
+### Scan (Review-Aufbau)
+
+```bash
+HandBrakeCLI --scan --json -i <input> -t 0
+```
+
+### Encode (vereinfacht)
+
+```bash
+HandBrakeCLI \
+  -i <input> \
+  -o <output> \
+  -t <titleId> \
+  -Z "<preset>" \
+  <extra-args> \
+  -a <audioTrackIds|none> \
+  -s <subtitleTrackIds|none>
+```
+
+Optional ergänzt Ripster:
+
+- `--subtitle-burned=<id>`
+- `--subtitle-default=<id>`
+- `--subtitle-forced=<id>` oder `--subtitle-forced`
+
+---
+
+## Presets auslesen
+
+Ripster liest Presets mit:
+
+```bash
+HandBrakeCLI -z
+```
+
+---
+
+## Relevante Felder in `Settings`
+
+| Feldname in der GUI | Bedeutung |
+|-----|-----------|
+| `HandBrake Kommando` | CLI-Binary |
+| `HandBrake Preset` (Blu-ray/DVD) | profilspezifisches Preset |
+| `HandBrake Extra Args` (Blu-ray/DVD) | profilspezifische Zusatzargumente |
+| `Ausgabeformat` (Blu-ray/DVD) | Dateiendung der finalen Datei |
+| `Encode-Neustart: unvollständige Ausgabe löschen` | unvollständige Ausgabe bei Neustart löschen |
+
+---
+
+## Fortschritts-Parsing
+
+Ripster parst HandBrake-Stderr (Prozent/ETA/Detail) und sendet WebSocket-Progress (`PIPELINE_PROGRESS`).
+
+---
+
+## Troubleshooting
+
+- Preset nicht gefunden: Preset-Namen mit `HandBrakeCLI -z` prüfen
+- sehr langsames Encoding: Preset/Extra-Args prüfen (z. B. `--encoder-preset`)
+
+Das Produktions-Installer-Script `install.sh` bietet eine Option zur Installation eines gebündelten HandBrakeCLI-Binaries mit NVDEC-Unterstützung (NVIDIA GPU-Dekodierung). Diese Option erscheint interaktiv während der Installation.

docs/tools/index.md

@@ -0,0 +1,31 @@
+# Anhang: Externe Tools
+
+Ripster orchestriert externe CLI-Tools. Dieser Abschnitt erklärt deren Rolle im Gesamtsystem.
+
+<div class="grid cards" markdown>
+
+-   :material-disc: **MakeMKV**
+
+    ---
+
+    Disc-Analyse und Ripping.
+
+    [:octicons-arrow-right-24: MakeMKV](makemkv.md)
+
+-   :material-film: **HandBrake**
+
+    ---
+
+    Video-Encoding inklusive Preset-Logik.
+
+    [:octicons-arrow-right-24: HandBrake](handbrake.md)
+
+-   :material-information: **MediaInfo**
+
+    ---
+
+    Track-/Containeranalyse für Review und Auswahl.
+
+    [:octicons-arrow-right-24: MediaInfo](mediainfo.md)
+
+</div>

docs/tools/makemkv.md

@@ -0,0 +1,69 @@
+# MakeMKV
+
+Ripster nutzt `makemkvcon` für Disc-Analyse und Rip.
+
+---
+
+## Verwendete Aufrufe
+
+### Analyse
+
+```bash
+makemkvcon -r info <source>
+```
+
+`<source>` ist typischerweise:
+
+- `disc:<index>` (Auto-Modus)
+- `dev:/dev/sr0` (explicit)
+- `file:<path>` (Datei/Ordner-Analyse)
+
+### Rip (MKV-Modus)
+
+```bash
+makemkvcon mkv <source> <title-or-all> <rawDir> [--minlength=...] [...extraArgs]
+```
+
+### Rip (Backup-Modus)
+
+```bash
+makemkvcon backup <source> <rawDir> --decrypt
+```
+
+---
+
+## Registrierungsschlüssel (optional)
+
+Wenn in `Settings` ein `MakeMKV Key` gesetzt ist, synchronisiert Ripster ihn nach:
+
+```bash
+~/.MakeMKV/settings.conf
+```
+
+Format:
+
+```ini
+app_Key = "product-key"
+```
+
+Zusätzlich zeigt die UI unterhalb des Feldes den aktuellen Betakey an, der per Button in das Eingabefeld übernommen werden kann.
+
+---
+
+## Relevante Felder in `Settings`
+
+| Feldname in der GUI | Bedeutung |
+|-----|-----------|
+| `MakeMKV Kommando` | CLI-Binary |
+| `MakeMKV Source Index` | Source-Index im Auto-Modus |
+| `Minimale Titellaenge (Minuten)` | Mindestlaufzeitfilter |
+| `MakeMKV Rip Modus` (Blu-ray/DVD) | `mkv` oder `backup` |
+| `MakeMKV Analyze Extra Args` (Blu-ray/DVD) | Zusatzargumente für Analyse |
+| `MakeMKV Rip Extra Args` (Blu-ray/DVD) | Zusatzargumente für Rip |
+
+---
+
+## Hinweise
+
+- Blu-ray-Backups werden oft für robuste Playlist-Analyse genutzt.
+- MakeMKV-Ausgaben werden geparst und als `makemkvInfo` im Job gespeichert.

docs/tools/mediainfo.md

@@ -0,0 +1,37 @@
+# MediaInfo
+
+Ripster nutzt `mediainfo` zur JSON-Analyse von Medien-Dateien.
+
+---
+
+## Aufruf
+
+```bash
+mediainfo --Output=JSON <input>
+```
+
+Der Input ist typischerweise eine RAW-Datei oder ein vom Workflow gewählter Inputpfad.
+
+---
+
+## Verwendung in Ripster
+
+- Track-/Codec-Metadaten für Review-Plan
+- Fallback-Informationen in bestimmten Analysepfaden
+- Persistenz als `mediainfoInfo` im Job
+
+---
+
+## Relevante Settings
+
+| Key | Bedeutung |
+|-----|-----------|
+| `mediainfo_command` | CLI-Binary |
+| `mediainfo_extra_args_bluray` / `_dvd` | profilspezifische Zusatzargumente |
+
+---
+
+## Troubleshooting
+
+- JSON-Test: `mediainfo --Output=JSON <datei>`
+- unbekannte Sprache erscheint oft als `und` (undetermined)