Bugfix and Docs

2026-03-10 13:12:57 +00:00
parent 3516ff8486
commit ac4d77dddf
75 changed files with 3511 additions and 5142 deletions
--- a/docs/configuration/environment.md
+++ b/docs/configuration/environment.md
@@ -1,96 +1,67 @@
 # Umgebungsvariablen

-Umgebungsvariablen überschreiben die Standardwerte und eignen sich für Server-Deployments.
+Umgebungsvariablen steuern Backend/Vite außerhalb der DB-basierten UI-Settings.

 ---

-## Backend-Umgebungsvariablen
+## Backend (`backend/.env`)

-Konfigurationsdatei: `backend/.env`
+| Variable | Default (Code) | Beschreibung |
+|---------|------------------|-------------|
+| `PORT` | `3001` | Express-Port |
+| `DB_PATH` | `backend/data/ripster.db` | SQLite-Datei (relativ zu `backend/`) |
+| `LOG_DIR` | `backend/logs` | Fallback-Logverzeichnis (wenn `log_dir`-Setting nicht gesetzt/lesbar) |
+| `CORS_ORIGIN` | `*` | CORS-Origin für API |
+| `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, `error` |

-| Variable | Standard | Beschreibung |
-|---------|---------|-------------|
-| `PORT` | `3001` | Port des Express-Servers |
-| `DB_PATH` | `./data/ripster.db` | Pfad zur SQLite-Datenbankdatei |
-| `CORS_ORIGIN` | `http://localhost:5173` | Erlaubter CORS-Origin |
-| `LOG_DIR` | `./logs` | Verzeichnis für Log-Dateien |
-| `LOG_LEVEL` | `info` | Log-Level (`debug`, `info`, `warn`, `error`) |
-
-### Beispiel: backend/.env
+Beispiel:

 ```env
 PORT=3001
 DB_PATH=/var/lib/ripster/ripster.db
-CORS_ORIGIN=http://192.168.1.100:5173
 LOG_DIR=/var/log/ripster
+CORS_ORIGIN=http://192.168.1.50:5173
 LOG_LEVEL=info
 ```

+Hinweis: `backend/.env.example` enthält bewusst dev-freundliche Werte (z. B. lokaler `CORS_ORIGIN`).
+
 ---

-## Frontend-Umgebungsvariablen
+## Frontend (`frontend/.env`)

-Konfigurationsdatei: `frontend/.env`
-
-| Variable | Standard | Beschreibung |
+| Variable | Default | Beschreibung |
 |---------|---------|-------------|
-| `VITE_API_BASE` | `http://localhost:3001` | Backend-API-URL |
-| `VITE_WS_URL` | `ws://localhost:3001` | WebSocket-URL |
-| `VITE_PUBLIC_ORIGIN` | — | Öffentliche Origin-URL (für CORS) |
-| `VITE_HMR_HOST` | — | Vite HMR-Host (für Remote-Entwicklung) |
-| `VITE_HMR_PORT` | — | Vite HMR-Port |
+| `VITE_API_BASE` | `/api` | API-Basis für Fetch-Client |
+| `VITE_WS_URL` | automatisch aus `window.location` + `/ws` | Optional explizite WebSocket-URL |
+| `VITE_PUBLIC_ORIGIN` | leer | Öffentliche Vite-Origin (Remote-Dev) |
+| `VITE_ALLOWED_HOSTS` | `true` | Komma-separierte Hostliste für Vite `allowedHosts` |
+| `VITE_HMR_PROTOCOL` | abgeleitet aus `VITE_PUBLIC_ORIGIN` | HMR-Protokoll (`ws`/`wss`) |
+| `VITE_HMR_HOST` | abgeleitet aus `VITE_PUBLIC_ORIGIN` | HMR-Host |
+| `VITE_HMR_CLIENT_PORT` | abgeleitet aus `VITE_PUBLIC_ORIGIN` | HMR-Client-Port |

-### Beispiel: frontend/.env (Entwicklung)
+Beispiele:

 ```env
-VITE_API_BASE=http://localhost:3001
-VITE_WS_URL=ws://localhost:3001
+# lokal (mit Vite-Proxy)
+VITE_API_BASE=/api
 ```

-### Beispiel: frontend/.env (Netzwerk-Zugriff)
-
 ```env
-VITE_API_BASE=http://192.168.1.100:3001
-VITE_WS_URL=ws://192.168.1.100:3001
-VITE_PUBLIC_ORIGIN=http://192.168.1.100:5173
+# remote dev
+VITE_API_BASE=http://192.168.1.50:3001/api
+VITE_WS_URL=ws://192.168.1.50:3001/ws
+VITE_PUBLIC_ORIGIN=http://192.168.1.50:5173
+VITE_ALLOWED_HOSTS=192.168.1.50,ripster.local
+VITE_HMR_PROTOCOL=ws
+VITE_HMR_HOST=192.168.1.50
+VITE_HMR_CLIENT_PORT=5173
 ```

 ---

-## .env.example Dateien
+## Priorität

-Das Repository enthält Vorlagen für beide Konfigurationsdateien:
-
-```bash
-# Backend
-cp backend/.env.example backend/.env
-
-# Frontend
-cp frontend/.env.example frontend/.env
-```
-
---
-
-## Priorität der Konfiguration
-
-Einstellungen werden in folgender Reihenfolge geladen (höhere Priorität überschreibt niedrigere):
-
-```
-1. Systemumgebungsvariablen (export VAR=value)
-2. .env-Datei
-3. Hardcodierte Standardwerte in config.js
-```
-
---
-
-## LOG_LEVEL
-
-| Level | Ausgabe |
-|-------|---------|
-| `debug` | Alle Meldungen inkl. Debugging |
-| `info` | Normale Betriebsinformationen |
-| `warn` | Warnungen + Fehler |
-| `error` | Nur Fehler |
-
-!!! tip "Produktionsempfehlung"
-    Für Produktionsumgebungen `LOG_LEVEL=info` oder `LOG_LEVEL=warn` verwenden. `debug` erzeugt sehr viele Log-Einträge.
+1. Prozess-Umgebungsvariablen
+2. `.env`
+3. Code-Defaults
--- a/docs/configuration/settings-reference.md
+++ b/docs/configuration/settings-reference.md
@@ -1,180 +1,165 @@
 # Einstellungsreferenz

-Vollständige Übersicht aller Ripster-Einstellungen. Alle Einstellungen werden über die Web-Oberfläche unter **Einstellungen** verwaltet und in SQLite gespeichert.
+Alle Settings liegen in `settings_schema`/`settings_values` und werden über die UI verwaltet.

 ---

 ## Profil-System

-Ripster erkennt den Medientyp einer eingelegten Disc (Blu-ray / DVD / CD) und wählt automatisch die passenden profil-spezifischen Einstellungen. Für viele Schlüssel gibt es zusätzlich zur globalen Einstellung eine Variante pro Profil:
+Ripster arbeitet mit Media-Profilen:

-| Profil | Erkennungsmerkmale |
-|--------|--------------------|
-| `bluray` | UDF-Dateisystem, Laufwerk-Modell enthält „Blu-ray", Disc-Label wie BDMV |
-| `dvd` | ISO9660/UDF, Laufwerk-Modell enthält „DVD", VIDEO_TS-Struktur |
-| `other` | Alles andere (CD, unbekannt) |
+- `bluray`
+- `dvd`
+- `other`

-**Auflösungsreihenfolge für profil-spezifische Einstellungen:**
+Viele Tool-/Pfad-Settings existieren als Profil-Varianten (`*_bluray`, `*_dvd`, `*_other`).

-1. Profil-spezifischer Wert (`_bluray` / `_dvd`) – wenn gesetzt, hat dieser Vorrang
-2. Alternativ-Profil als Fallback (Blu-ray → DVD-Wert als Fallback und umgekehrt)
+Wichtig:

-Pfad-Einstellungen (`raw_dir`, `movie_dir`) und Besitz-Einstellungen (`raw_dir_owner`, `movie_dir_owner`) werden **ausschließlich** aus dem passenden Profil bezogen – kein Cross-Profil-Fallback.
+- Für `raw_dir`, `movie_dir` und die zugehörigen `*_owner`-Keys gibt es **kein Cross-Profil-Fallback**.
+- Für viele Tool-Keys werden profilspezifische Varianten bevorzugt.
+
+---
+
+## Template-Platzhalter
+
+Datei-/Ordner-Templates unterstützen:
+
+- `${title}`
+- `${year}`
+- `${imdbId}`
+
+Nicht gesetzte Werte werden zu `unknown`.

 ---

 ## Kategorie: Pfade

-| Schlüssel | Typ | Pflicht | Beschreibung |
-|-----------|-----|---------|-------------|
-| `raw_dir` | string | ✅ | Verzeichnis für rohe MKV-Dateien (Fallback wenn kein Profil-Wert) |
-| `raw_dir_bluray` | string | — | Raw-Verzeichnis für Blu-rays |
-| `raw_dir_dvd` | string | — | Raw-Verzeichnis für DVDs |
-| `raw_dir_other` | string | — | Raw-Verzeichnis für sonstige Medien |
-| `raw_dir_owner` | string | — | Besitzer für Raw-Verzeichnis (`user:group`, Fallback) |
-| `raw_dir_bluray_owner` | string | — | Besitzer für Raw-Verzeichnis (Blu-ray) |
-| `raw_dir_dvd_owner` | string | — | Besitzer für Raw-Verzeichnis (DVD) |
-| `raw_dir_other_owner` | string | — | Besitzer für Raw-Verzeichnis (Sonstiges) |
-| `movie_dir` | string | ✅ | Ausgabeverzeichnis für Filme (Fallback) |
-| `movie_dir_bluray` | string | — | Ausgabeverzeichnis für Blu-rays |
-| `movie_dir_dvd` | string | — | Ausgabeverzeichnis für DVDs |
-| `movie_dir_other` | string | — | Ausgabeverzeichnis für sonstige Medien |
-| `movie_dir_owner` | string | — | Besitzer für Ausgabeverzeichnis (Fallback) |
-| `movie_dir_bluray_owner` | string | — | Besitzer für Ausgabeverzeichnis (Blu-ray) |
-| `movie_dir_dvd_owner` | string | — | Besitzer für Ausgabeverzeichnis (DVD) |
-| `movie_dir_other_owner` | string | — | Besitzer für Ausgabeverzeichnis (Sonstiges) |
-| `log_dir` | string | — | Verzeichnis für Log-Dateien (Standard: `./logs`) |
+| Key | Typ | Default |
+|-----|-----|---------|
+| `raw_dir` | path | `data/output/raw` |
+| `raw_dir_bluray` | path | `null` |
+| `raw_dir_dvd` | path | `null` |
+| `raw_dir_other` | path | `null` |
+| `raw_dir_bluray_owner` | string | `null` |
+| `raw_dir_dvd_owner` | string | `null` |
+| `raw_dir_other_owner` | string | `null` |
+| `movie_dir` | path | `data/output/movies` |
+| `movie_dir_bluray` | path | `null` |
+| `movie_dir_dvd` | path | `null` |
+| `movie_dir_other` | path | `null` |
+| `movie_dir_bluray_owner` | string | `null` |
+| `movie_dir_dvd_owner` | string | `null` |
+| `movie_dir_other_owner` | string | `null` |
+| `log_dir` | path | `data/logs` |

 ---

 ## Kategorie: Laufwerk

-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `drive_mode` | select | `auto` | `auto` = automatisch erkennen, `explicit` = festes Gerät |
-| `drive_device` | string | `/dev/sr0` | Geräte-Pfad (nur bei `explicit`) |
-| `disc_poll_interval_ms` | number | `4000` | Polling-Intervall in Millisekunden (1000–60000) |
-| `makemkv_source_index` | number | `0` | Laufwerk-Index für MakeMKV (bei mehreren Laufwerken) |
-
---
-
-## Kategorie: Tools (global)
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `makemkv_command` | string | `makemkvcon` | Befehl oder absoluter Pfad zu MakeMKV |
-| `handbrake_command` | string | `HandBrakeCLI` | Befehl oder absoluter Pfad zu HandBrake |
-| `mediainfo_command` | string | `mediainfo` | Befehl oder absoluter Pfad zu MediaInfo |
-| `makemkv_min_length_minutes` | number | `15` | Mindest-Titellänge in Minuten (0–999) |
-| `pipeline_max_parallel_jobs` | number | `1` | Maximale Anzahl parallel laufender Jobs (1–12) |
-| `handbrake_restart_delete_incomplete_output` | boolean | `true` | Unvollständige Ausgabedatei beim Encode-Neustart löschen |
-
-### Kategorie: Tools – Blu-ray
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `makemkv_rip_mode_bluray` | select | `backup` | Rip-Modus: `mkv` oder `backup` |
-| `makemkv_analyze_extra_args_bluray` | string | — | Zusatz-CLI-Parameter für Analyse (Blu-ray) |
-| `makemkv_rip_extra_args_bluray` | string | — | Zusatz-CLI-Parameter für Rip (Blu-ray) |
-| `mediainfo_extra_args_bluray` | string | — | Zusatz-CLI-Parameter für mediainfo (Blu-ray) |
-| `handbrake_preset_bluray` | string | `H.264 MKV 1080p30` | HandBrake-Preset für Blu-rays |
-| `handbrake_extra_args_bluray` | string | — | Zusatz-CLI-Argumente für HandBrake (Blu-ray) |
-| `output_extension_bluray` | select | `mkv` | Ausgabeformat: `mkv` oder `mp4` |
-| `filename_template_bluray` | string | `${title} (${year})` | Dateiname-Template (Blu-ray) |
-| `output_folder_template_bluray` | string | — | Ordnername-Template (Blu-ray, leer = Dateiname-Template) |
-
-### Kategorie: Tools – DVD
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `makemkv_rip_mode_dvd` | select | `mkv` | Rip-Modus: `mkv` oder `backup` |
-| `makemkv_analyze_extra_args_dvd` | string | — | Zusatz-CLI-Parameter für Analyse (DVD) |
-| `makemkv_rip_extra_args_dvd` | string | — | Zusatz-CLI-Parameter für Rip (DVD) |
-| `mediainfo_extra_args_dvd` | string | — | Zusatz-CLI-Parameter für mediainfo (DVD) |
-| `handbrake_preset_dvd` | string | `H.264 MKV 480p30` | HandBrake-Preset für DVDs |
-| `handbrake_extra_args_dvd` | string | — | Zusatz-CLI-Argumente für HandBrake (DVD) |
-| `output_extension_dvd` | select | `mkv` | Ausgabeformat: `mkv` oder `mp4` |
-| `filename_template_dvd` | string | `${title} (${year})` | Dateiname-Template (DVD) |
-| `output_folder_template_dvd` | string | — | Ordnername-Template (DVD, leer = Dateiname-Template) |
-
-### Globale Fallback-Einstellungen für Encode
-
-Diese Werte werden verwendet, wenn kein profil-spezifischer Wert konfiguriert ist:
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `handbrake_preset` | string | `H.265 MKV 1080p30` | Fallback HandBrake-Preset |
-| `handbrake_extra_args` | string | — | Fallback Extra-Args |
-| `makemkv_rip_mode` | select | `mkv` | Fallback Rip-Modus |
-| `makemkv_analyze_extra_args` | string | — | Fallback Analyse-Args |
-| `makemkv_rip_extra_args` | string | — | Fallback Rip-Args |
-| `mediainfo_extra_args` | string | — | Fallback MediaInfo-Args |
-| `output_extension` | select | `mkv` | Fallback Ausgabeformat |
-| `filename_template` | string | `${title} (${year})` | Fallback Dateiname-Template |
-| `output_folder_template` | string | — | Fallback Ordnername-Template |
-
-### Template-Platzhalter
-
-| Platzhalter | Beispiel |
-|------------|---------|
-| `${title}` | `Inception` |
-| `${year}` | `2010` |
-| `${imdbId}` | `tt1375666` |
-
---
-
-## Kategorie: Metadaten
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `omdb_api_key` | string | — | API-Key von [omdbapi.com](https://www.omdbapi.com/) |
-| `omdb_default_type` | select | `movie` | Vorauswahl für OMDb-Suche: `movie`, `series`, `episode` |
-
---
-
-## Kategorie: Benachrichtigungen (PushOver)
-
-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `pushover_enabled` | boolean | `false` | Master-Schalter für PushOver |
-| `pushover_token` | string | — | Application-Token |
-| `pushover_user` | string | — | User-Key |
-| `pushover_device` | string | — | Optionales Ziel-Device |
-| `pushover_title_prefix` | string | `Ripster` | Präfix im Benachrichtigungstitel |
-| `pushover_priority` | number | `0` | Priorität (-2 bis 2) |
-| `pushover_timeout_ms` | number | `7000` | HTTP-Timeout für PushOver-Requests (ms) |
-
-### Granulare Event-Schalter
-
-| Schlüssel | Standard | Beschreibung |
-|-----------|---------|-------------|
-| `pushover_notify_metadata_ready` | `true` | Bei Metadaten-Auswahl benachrichtigen |
-| `pushover_notify_rip_started` | `true` | Bei MakeMKV-Rip-Start |
-| `pushover_notify_encoding_started` | `true` | Bei HandBrake-Start |
-| `pushover_notify_job_finished` | `true` | Bei erfolgreichem Abschluss |
-| `pushover_notify_job_error` | `true` | Bei Fehler |
-| `pushover_notify_job_cancelled` | `true` | Bei manuellem Abbruch |
-| `pushover_notify_reencode_started` | `true` | Bei Re-Encode-Start |
-| `pushover_notify_reencode_finished` | `true` | Bei erfolgreichem Re-Encode |
+| Key | Typ | Default | Hinweis |
+|-----|-----|---------|--------|
+| `drive_mode` | select | `auto` | `auto` oder `explicit` |
+| `drive_device` | path | `/dev/sr0` | bei `explicit` relevant |
+| `makemkv_source_index` | number | `0` | MakeMKV Source-Index |
+| `disc_poll_interval_ms` | number | `4000` | 1000..60000 |

 ---

 ## Kategorie: Monitoring

-| Schlüssel | Typ | Standard | Beschreibung |
-|-----------|-----|---------|-------------|
-| `hardware_monitoring_enabled` | boolean | `false` | Hardware-Monitoring aktivieren (CPU, RAM, Temp.) |
-| `hardware_monitoring_interval_ms` | number | `5000` | Monitoring-Polling-Intervall (ms) |
+| Key | Typ | Default |
+|-----|-----|---------|
+| `hardware_monitoring_enabled` | boolean | `true` |
+| `hardware_monitoring_interval_ms` | number | `5000` |

 ---

-## Standard-Einstellungen zurücksetzen
+## Kategorie: Tools (global)

-Einen einzelnen Wert über die Datenbank zurücksetzen:
+| Key | Typ | Default |
+|-----|-----|---------|
+| `makemkv_command` | string | `makemkvcon` |
+| `makemkv_registration_key` | string | `null` |
+| `mediainfo_command` | string | `mediainfo` |
+| `makemkv_min_length_minutes` | number | `60` |
+| `handbrake_command` | string | `HandBrakeCLI` |
+| `handbrake_restart_delete_incomplete_output` | boolean | `true` |
+| `pipeline_max_parallel_jobs` | number | `1` |

-```bash
-sqlite3 backend/data/ripster.db \
-  "DELETE FROM settings_values WHERE key = 'handbrake_preset_bluray';"
-```
+### Blu-ray-spezifisch

-Beim nächsten Laden wird der Standardwert aus `settings_schema.default_value` verwendet.
+| Key | Typ | Default |
+|-----|-----|---------|
+| `mediainfo_extra_args_bluray` | string | `null` |
+| `makemkv_rip_mode_bluray` | select | `backup` |
+| `makemkv_analyze_extra_args_bluray` | string | `null` |
+| `makemkv_rip_extra_args_bluray` | string | `null` |
+| `handbrake_preset_bluray` | string | `H.264 MKV 1080p30` |
+| `handbrake_extra_args_bluray` | string | `null` |
+| `output_extension_bluray` | select | `mkv` |
+| `filename_template_bluray` | string | `${title} (${year})` |
+| `output_folder_template_bluray` | string | `null` |
+
+### DVD-spezifisch
+
+| Key | Typ | Default |
+|-----|-----|---------|
+| `mediainfo_extra_args_dvd` | string | `null` |
+| `makemkv_rip_mode_dvd` | select | `mkv` |
+| `makemkv_analyze_extra_args_dvd` | string | `null` |
+| `makemkv_rip_extra_args_dvd` | string | `null` |
+| `handbrake_preset_dvd` | string | `H.264 MKV 480p30` |
+| `handbrake_extra_args_dvd` | string | `null` |
+| `output_extension_dvd` | select | `mkv` |
+| `filename_template_dvd` | string | `${title} (${year})` |
+| `output_folder_template_dvd` | string | `null` |
+
+---
+
+## Kategorie: Metadaten
+
+| Key | Typ | Default |
+|-----|-----|---------|
+| `omdb_api_key` | string | `null` |
+| `omdb_default_type` | select | `movie` |
+
+---
+
+## Kategorie: Benachrichtigungen (PushOver)
+
+| Key | Typ | Default |
+|-----|-----|---------|
+| `pushover_enabled` | boolean | `false` |
+| `pushover_token` | string | `null` |
+| `pushover_user` | string | `null` |
+| `pushover_device` | string | `null` |
+| `pushover_title_prefix` | string | `Ripster` |
+| `pushover_priority` | number | `0` |
+| `pushover_timeout_ms` | number | `7000` |
+| `pushover_notify_metadata_ready` | boolean | `true` |
+| `pushover_notify_rip_started` | boolean | `true` |
+| `pushover_notify_encoding_started` | boolean | `true` |
+| `pushover_notify_job_finished` | boolean | `true` |
+| `pushover_notify_job_error` | boolean | `true` |
+| `pushover_notify_job_cancelled` | boolean | `true` |
+| `pushover_notify_reencode_started` | boolean | `true` |
+| `pushover_notify_reencode_finished` | boolean | `true` |
+
+---
+
+## Entfernte Legacy-Keys
+
+Diese Legacy-Keys werden bei Migration entfernt und sollten nicht mehr genutzt werden:
+
+- `makemkv_backup_mode`
+- `mediainfo_extra_args`
+- `makemkv_rip_mode`
+- `makemkv_analyze_extra_args`
+- `makemkv_rip_extra_args`
+- `handbrake_preset`
+- `handbrake_extra_args`
+- `output_extension`
+- `filename_template`
+- `output_folder_template`
+- `pushover_notify_disc_detected`