From 9b38d780425a7e2686060ed664e9016ac286e38c Mon Sep 17 00:00:00 2001 From: mboehmlaender Date: Fri, 8 May 2026 09:01:17 +0200 Subject: [PATCH] 1.0.0-rc1 Docs --- backend/package-lock.json | 4 +- backend/package.json | 2 +- docs/configuration/settings-reference.md | 371 ++++++++---------- docs/gui/audiobooks.md | 98 +++-- docs/gui/index.md | 5 +- docs/gui/ripper.md | 9 + docs/gui/settings.md | 176 ++++++--- frontend/package-lock.json | 4 +- frontend/package.json | 2 +- package-lock.json | 4 +- package.json | 2 +- site/404.html | 2 +- site/api/converter/index.html | 2 +- site/api/crons/index.html | 2 +- site/api/downloads/index.html | 2 +- site/api/history/index.html | 2 +- site/api/index.html | 2 +- site/api/pipeline/index.html | 2 +- site/api/runtime-activities/index.html | 2 +- site/api/settings/index.html | 2 +- site/api/websocket/index.html | 2 +- site/appendix/index.html | 2 +- site/architecture/backend/index.html | 2 +- site/architecture/database/index.html | 2 +- site/architecture/frontend/index.html | 2 +- site/architecture/index.html | 2 +- site/architecture/overview/index.html | 2 +- site/configuration/environment/index.html | 2 +- site/configuration/index.html | 2 +- .../settings-reference/index.html | 2 +- site/deployment/development/index.html | 2 +- site/deployment/index.html | 2 +- site/deployment/production/index.html | 2 +- site/getting-started/configuration/index.html | 2 +- site/getting-started/index.html | 2 +- site/getting-started/installation/index.html | 2 +- site/getting-started/prerequisites/index.html | 2 +- site/getting-started/quickstart/index.html | 2 +- site/gui/audiobooks/index.html | 2 +- site/gui/converter/index.html | 2 +- site/gui/database/index.html | 2 +- site/gui/downloads/index.html | 2 +- site/gui/history/index.html | 2 +- site/gui/index.html | 2 +- site/gui/jobs/index.html | 1 - site/gui/ripper/index.html | 2 +- site/gui/settings/index.html | 2 +- site/index.html | 2 +- site/pipeline/encoding/index.html | 2 +- site/pipeline/index.html | 2 +- site/pipeline/playlist-analysis/index.html | 2 +- site/pipeline/post-encode-scripts/index.html | 2 +- site/pipeline/workflow/index.html | 2 +- site/search/search_index.json | 2 +- site/sitemap.xml | 94 +++-- site/sitemap.xml.gz | Bin 535 -> 529 bytes site/tools/handbrake/index.html | 2 +- site/tools/index.html | 2 +- site/tools/makemkv/index.html | 7 +- site/tools/mediainfo/index.html | 2 +- site/workflows/index.html | 2 +- 61 files changed, 452 insertions(+), 419 deletions(-) delete mode 100644 site/gui/jobs/index.html diff --git a/backend/package-lock.json b/backend/package-lock.json index 1246a25..26730b0 100644 --- a/backend/package-lock.json +++ b/backend/package-lock.json @@ -1,12 +1,12 @@ { "name": "ripster-backend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ripster-backend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "dependencies": { "archiver": "^7.0.1", "cors": "^2.8.5", diff --git a/backend/package.json b/backend/package.json index afefb7c..fc906de 100644 --- a/backend/package.json +++ b/backend/package.json @@ -1,6 +1,6 @@ { "name": "ripster-backend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "private": true, "type": "commonjs", "scripts": { diff --git a/docs/configuration/settings-reference.md b/docs/configuration/settings-reference.md index 7f2dbf7..c286c2e 100644 --- a/docs/configuration/settings-reference.md +++ b/docs/configuration/settings-reference.md @@ -1,238 +1,191 @@ # Einstellungsreferenz -Diese Seite dokumentiert **alle** UI-Settings mit ihrer Wirkung auf Flows, Pfade, Queue und Automatisierung. +Diese Seite dokumentiert den aktuellen Stand der Settings auf Basis von `settings_schema` und der aktiven GUI-Logik. -## Wie Ripster Settings auflöst +## Wichtiges Verhalten in der GUI -Ripster arbeitet intern mit profilspezifischen Settings (`bluray`, `dvd`, `cd`, `audiobook`) und bildet sie auf effektive Laufzeitwerte ab. +- Speichern erfolgt gesammelt über `Änderungen speichern` (Bulk-Update). +- `ui_expert_mode` wird sofort einzeln gespeichert (nicht erst mit Bulk-Speichern). +- `*_owner`-Felder sind in der GUI erst aktiv, wenn der zugehörige Pfad gesetzt ist. +- Einige Keys sind absichtlich ausgeblendet und nur technisch (API/DB) nutzbar. +- Benachrichtigungs-Event-Toggles sind nur sichtbar, wenn `pushover_enabled=true`. -Wichtige Regeln: +## Fallbacks und Pfadauflösung -1. Für `bluray` wird bei fehlenden profilierten Toolwerten auf `dvd` zurückgefallen, und umgekehrt. -2. Für `cd` und `audiobook` gibt es nur das eigene Profil. -3. Strikt profilgebundene Pfadkeys (`raw_dir`, `movie_dir`, `series_dir` plus Owner) fallen bei leeren Werten auf Installationsdefaults zurück. - -Installationsdefaults: - -- RAW: `data/output/raw` -- Movies: `data/output/movies` -- Series: `data/output/series` -- CD: `data/output/cd` -- Audiobook RAW: `data/output/audiobook-raw` -- Audiobook Output: `data/output/audiobooks` -- Converter RAW: `data/output/converter-raw` -- Converter Video: `data/output/converted-movies` -- Converter Audio: `data/output/converted-audio` - -## Kritische Wirkungsbereiche - -### 1) Pfad- und Template-Einstellungen - -Diese Settings bestimmen direkt: - -- wo RAW landet -- wo finale Ausgaben landen -- wie Ordner/Dateinamen gerendert werden - -Relevante Besonderheiten: - -- Serien-RAW nutzt bei Serienworkflow bevorzugt `raw_dir_*_series`. -- Serien-Ausgabe nutzt `series_dir_*` und Serien-Templates (Episode/Multi-Episode). -- Film-Ausgabe nutzt `movie_dir_*` und Film-Template. -- Encode schreibt zunächst in `Incomplete_job-` und finalisiert danach in den Zielpfad. - -### 2) Queue- und Parallelitäts-Settings - -Die vier Limits greifen kombiniert: - -- `pipeline_max_parallel_jobs` (Film/Video-Lane) -- `pipeline_max_parallel_cd_encodes` (Audio/CD-Lane) -- `pipeline_max_total_encodes` (globaler Deckel) -- `pipeline_cd_bypasses_queue` (Audio-Lane darf Filmwarteschlange umgehen) - -Effekt: - -- Film und Audio haben getrennte Lane-Limits. -- Das Gesamtlimit überstimmt beide, sobald erreicht. -- Queue kann zusätzlich Nicht-Job-Einträge (`Skript`, `Kette`, `Warten`) enthalten. - -### 3) Serien-Metadaten-Settings - -Diese steuern die Serienqualität direkt: - -- TMDb-Token aktiviert TMDb-gestützte Serienmetadaten. -- Sprache/Fallback-Sprachen beeinflussen Titel- und Episodenauflösung. -- Ordnungspräferenz steuert Episode-Order. -- Disc-Profile-Reuse verbessert automatische Zuordnung über mehrere Discs. - -### 4) Tool-Settings - -Toolfelder (`makemkv_*`, `mediainfo_*`, `handbrake_*`, `ffmpeg_*`, `ffprobe_*`, `cdparanoia_*`) wirken unmittelbar auf die tatsächlich ausgeführten CLI-Aufrufe. - -Typische Auswirkungen: - -- falscher Toolpfad => früher Pipelinefehler -- geänderte Extra-Args => anderes Analyze-/Encode-Verhalten -- geänderte Presets => andere HandBrake-Ausgaben - -## Template-Platzhalter - -### Film-Templates - -- `${title}`, `${year}`, `${imdbId}` - -### Serien-Templates - -- `{seriesTitle}`, `{seasonNr}`, `{episodeNr}`, `{episodeNoStart}`, `{episodeNoEnd}` -- `{episodeRange}`, `{episodeTitle}`, `{parts}`, `{discNr}`, `{year}`, `{language}` -- führende Null möglich mit `{0:seasonNr}` etc. - -### Audiobook-Templates - -- `{author}`, `{title}`, `{year}`, `{narrator}`, `{series}`, `{part}`, `{format}` - -### Converter-Templates - -- Video: `{title}`, `{year}` -- Audio: `{artist}`, `{title}`, `{album}`, `{year}`, `{trackNr}` +- Leere profilspezifische Pfade fallen auf Installationsdefaults zurück. +- `download_dir` nutzt bei leerem Wert den Default-Downloadpfad. +- Die Konfigurationsseite zeigt im Block `Effektive Pfade` die tatsächlich verwendeten Laufzeitpfade. ## Vollständige Feldliste ## Kategorie: Benachrichtigungen -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `Expertenmodus` | `ui_expert_mode` | `boolean` | `false` | Schaltet erweiterte Einstellungen in der UI ein. | -| `PushOver aktiviert` | `pushover_enabled` | `boolean` | `false` | Master-Schalter für PushOver Versand. | -| `PushOver Token` | `pushover_token` | `string` | `leer` | Application Token für PushOver. | -| `PushOver User` | `pushover_user` | `string` | `leer` | User-Key für PushOver. | -| `PushOver Device (optional)` | `pushover_device` | `string` | `leer` | Optionales Ziel-Device in PushOver. | -| `PushOver Titel-Präfix` | `pushover_title_prefix` | `string` | `Ripster` | Prefix im PushOver Titel. | -| `PushOver Priority` | `pushover_priority` | `number` | `0` | Priorität -2 bis 2. | -| `PushOver Timeout (ms)` | `pushover_timeout_ms` | `number` | `7000` | HTTP Timeout für PushOver Requests. | -| `Bei Metadaten-Auswahl senden` | `pushover_notify_metadata_ready` | `boolean` | `true` | Sendet wenn Metadaten zur Auswahl bereitstehen. | -| `Bei Rip-Start senden` | `pushover_notify_rip_started` | `boolean` | `true` | Sendet beim Start des MakeMKV-Rips. | -| `Bei Encode-Start senden` | `pushover_notify_encoding_started` | `boolean` | `true` | Sendet beim Start von HandBrake. | -| `Bei Erfolg senden` | `pushover_notify_job_finished` | `boolean` | `true` | Sendet bei erfolgreich abgeschlossenem Job. | -| `Bei Fehler senden` | `pushover_notify_job_error` | `boolean` | `true` | Sendet bei Fehlern in der Pipeline. | -| `Bei Abbruch senden` | `pushover_notify_job_cancelled` | `boolean` | `true` | Sendet wenn Job manuell abgebrochen wurde. | -| `Bei Re-Encode Start senden` | `pushover_notify_reencode_started` | `boolean` | `true` | Sendet beim Start von RAW Re-Encode. | -| `Bei Re-Encode Erfolg senden` | `pushover_notify_reencode_finished` | `boolean` | `true` | Sendet bei erfolgreichem RAW Re-Encode. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Expertenmodus` | `ui_expert_mode` | `boolean` | `false` | Standard | Schaltet erweiterte Einstellungen in der UI ein. | +| `PushOver aktiviert` | `pushover_enabled` | `boolean` | `false` | Standard | Master-Schalter für PushOver Versand. | +| `PushOver Token` | `pushover_token` | `string` | `leer` | Standard | Application Token für PushOver. | +| `PushOver User` | `pushover_user` | `string` | `leer` | Standard | User-Key für PushOver. | +| `PushOver Device (optional)` | `pushover_device` | `string` | `leer` | Expertenmodus | Optionales Ziel-Device in PushOver. | +| `PushOver Titel-Präfix` | `pushover_title_prefix` | `string` | `Ripster` | Standard | Prefix im PushOver Titel. | +| `PushOver Priority` | `pushover_priority` | `number` | `0` | Expertenmodus | Priorität -2 bis 2. | +| `PushOver Timeout (ms)` | `pushover_timeout_ms` | `number` | `7000` | Expertenmodus | HTTP Timeout für PushOver Requests. | +| `Bei manueller Auswahl senden` | `pushover_notify_metadata_ready` | `boolean` | `true` | Standard | Sendet, wenn ein Job eine manuelle Auswahl/Entscheidung benötigt (z.B. Metadaten, Titel oder Playlist). | +| `Bei Rip-Start senden` | `pushover_notify_rip_started` | `boolean` | `true` | Standard | Sendet beim Start des MakeMKV-Rips. | +| `Bei Encode-Start senden` | `pushover_notify_encoding_started` | `boolean` | `true` | Standard | Sendet beim Start von HandBrake. | +| `Bei Erfolg senden` | `pushover_notify_job_finished` | `boolean` | `true` | Standard | Sendet bei erfolgreich abgeschlossenem Job. | +| `Bei Fehler senden` | `pushover_notify_job_error` | `boolean` | `true` | Standard | Sendet bei Fehlern in der Pipeline. | +| `Bei Abbruch senden` | `pushover_notify_job_cancelled` | `boolean` | `true` | Standard | Sendet wenn Job manuell abgebrochen wurde. | +| `Bei Re-Encode Start senden` | `pushover_notify_reencode_started` | `boolean` | `true` | Standard | Sendet beim Start von RAW Re-Encode. | +| `Bei Re-Encode Erfolg senden` | `pushover_notify_reencode_finished` | `boolean` | `true` | Standard | Sendet bei erfolgreichem RAW Re-Encode. | ## Kategorie: Converter -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `Erlaubte Datei-Endungen*` | `converter_scan_extensions` | `string` | `mkv,mp4,m2ts,iso,avi,mov,flac,mp3,wav,m4a,ogg,opus` | Erlaubte Datei-Endungen für den Converter-Scan (ohne Punkt). Wird in der UI als Checkbox-Liste gepflegt. | -| `Auto-Scan (Polling)` | `converter_polling_enabled` | `boolean` | `false` | Converter Raw-Ordner automatisch in regelmäßigen Abständen scannen. | -| `Polling-Intervall (Sekunden)` | `converter_polling_interval` | `number` | `300` | Intervall für automatischen Scan des Converter-Ordners. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Erlaubte Datei-Endungen` | `converter_scan_extensions` | `string` | `mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus` | Standard | Komma-getrennte Liste erlaubter Dateiendungen für den Scan (ohne Punkt). | +| `Auto-Scan (Polling)` | `converter_polling_enabled` | `boolean` | `false` | Standard | Converter Raw-Ordner automatisch in regelmäßigen Abständen scannen. | +| `Polling-Intervall (Sekunden)` | `converter_polling_interval` | `number` | `300` | Standard | Intervall für automatischen Scan des Converter-Ordners. | ## Kategorie: Laufwerk -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `Laufwerksmodus` | `drive_mode` | `select` | `auto` | Auto-Discovery oder explizites Device. | -| `Device Pfad` | `drive_device` | `path` | `/dev/sr0` | Nur für expliziten Modus, z.B. /dev/sr0. | -| `MakeMKV Source Index` | `makemkv_source_index` | `number` | `0` | Disc Index im Auto-Modus. | -| `Automatische Disk-Erkennung` | `disc_auto_detection_enabled` | `boolean` | `true` | Wenn deaktiviert, findet keine automatische Laufwerksprüfung statt. Neue Disks werden nur per "Laufwerk neu lesen" erkannt. | -| `Polling Intervall (ms)` | `disc_poll_interval_ms` | `number` | `4000` | Intervall für Disk-Erkennung. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Laufwerksmodus` | `drive_mode` | `select` | `auto` | Standard | Auto-Discovery oder explizites Device. | +| `Explizite Laufwerke` | `drive_devices` | `path` | `[]` | Standard | Laufwerke für den expliziten Modus als JSON-Array mit Pfad und MakeMKV-Index, z.B. [{"path":"/dev/sr0","makemkvIndex":0},{"path":"/dev/sr1","makemkvIndex":1}]. Nur relevant wenn Modus = Explizites Device. | +| `Device Pfad` | `drive_device` | `path` | `/dev/sr0` | Ausgeblendet (nur API/DB) | Nur für expliziten Modus, z.B. /dev/sr0. | +| `MakeMKV Source Index` | `makemkv_source_index` | `number` | `0` | Ausgeblendet (nur API/DB) | Disc Index im Auto-Modus. | +| `Automatische Disk-Erkennung` | `disc_auto_detection_enabled` | `boolean` | `true` | Standard | Wenn deaktiviert, findet keine automatische Laufwerksprüfung statt. Neue Disks werden nur per "Laufwerk neu lesen" erkannt. | +| `Polling Intervall (ms)` | `disc_poll_interval_ms` | `number` | `4000` | Expertenmodus | Intervall für Disk-Erkennung. | +| `Laufwerk nach Rip auswerfen` | `auto_eject_after_rip` | `boolean` | `false` | Standard | Wenn aktiv, wird das Laufwerk nach erfolgreichem Abschluss eines Rip-Vorgangs automatisch ausgeworfen (eject). | + +## Kategorie: Logging + +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Terminal-Ausgabe aktiv` | `server_console_log_output_enabled` | `boolean` | `true` | Expertenmodus | Master-Schalter für die Ausgabe der Server-Logs im Terminal (z.B. start.sh). Das Schreiben in Log-Dateien bleibt immer aktiv. | +| `HTTP-Logs im Terminal` | `server_console_log_http_enabled` | `boolean` | `true` | Expertenmodus | Steuert HTTP Request-Logs im Terminal (z.B. request:start). Dateilogs bleiben unverändert. | +| `DEBUG im Terminal` | `server_console_log_debug_enabled` | `boolean` | `true` | Expertenmodus | Steuert DEBUG-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. | +| `INFO im Terminal` | `server_console_log_info_enabled` | `boolean` | `true` | Expertenmodus | Steuert INFO-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. | +| `WARN im Terminal` | `server_console_log_warn_enabled` | `boolean` | `true` | Expertenmodus | Steuert WARN-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. | +| `ERROR im Terminal` | `server_console_log_error_enabled` | `boolean` | `true` | Expertenmodus | Steuert ERROR-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. | ## Kategorie: Metadaten -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `OMDb API Key` | `omdb_api_key` | `string` | `leer` | API Key für Metadatensuche. | -| `TMDb Read Access Token` | `tmdb_api_read_access_token` | `string` | `leer` | Read Access Token für Film- und Serien-Metadaten über TheMovieDB (TMDb). | -| `Film-Sprache` | `dvd_series_language` | `string` | `de-DE` | Bevorzugte TMDb-Sprache für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE oder en-US. | -| `Fallback Sprache` | `dvd_series_fallback_languages` | `string` | `de-DE,en-US` | Kommagetrennte TMDb-Fallback-Sprachen für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE,en-US,fr-FR. | -| `DVD Serien-Ordnung` | `dvd_series_order_preference` | `select` | `episode_group` | Bevorzugte Episodenordnung für DVD-Serien. Episode Groups nutzen TMDb Alternate Orders, falls vorhanden. | -| `DVD Disc-Profile wiederverwenden` | `dvd_series_reuse_disc_profiles` | `boolean` | `true` | Verwendet zuvor bestätigte Disc-Profile erneut, um Episoden automatischer zuzuordnen. | -| `OMDb Typ` | `omdb_default_type` | `select` | `movie` | Vorauswahl für Suche. | -| `MusicBrainz aktiviert` | `musicbrainz_enabled` | `boolean` | `true` | MusicBrainz-Metadatensuche für CDs aktivieren. | -| `Coverart-Nachladen aktiv` | `coverart_recovery_enabled` | `boolean` | `true` | Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen geprüft und nachgeladen. | -| `Coverart-Prüfintervall (Stunden)` | `coverart_recovery_interval_hours` | `number` | `6` | Intervall für automatische Prüfung fehlender Coverarts in Stunden. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `TMDb Read Access Token` | `tmdb_api_read_access_token` | `string` | `leer` | Standard | Read Access Token für Serien-Metadaten über TheMovieDB (TMDb). | +| `Film-Sprache` | `dvd_series_language` | `string` | `de-DE` | Standard | Bevorzugte TMDb-Sprache für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE oder en-US. | +| `Fallback Sprache` | `dvd_series_fallback_languages` | `string` | `de-DE,en-US` | Standard | Kommagetrennte TMDb-Fallback-Sprachen für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE,en-US,fr-FR. | +| `Coverart-Nachladen aktiv` | `coverart_recovery_enabled` | `boolean` | `true` | Standard | Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen geprüft und nachgeladen. | +| `Coverart-Prüfintervall (Stunden)` | `coverart_recovery_interval_hours` | `number` | `6` | Standard | Intervall für automatische Prüfung fehlender Coverarts in Stunden. | +| `NFO nach Encode erzeugen` | `generate_nfo_after_encode` | `boolean` | `false` | Standard | Erstellt nach erfolgreichem Encode automatisch eine .nfo-Datei neben der Ausgabedatei. | ## Kategorie: Monitoring -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `Hardware Monitoring aktiviert` | `hardware_monitoring_enabled` | `boolean` | `true` | Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). | -| `Hardware Monitoring Intervall (ms)` | `hardware_monitoring_interval_ms` | `number` | `5000` | Polling-Intervall für CPU/RAM/GPU/Storage-Metriken. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Hardware Monitoring aktiviert` | `hardware_monitoring_enabled` | `boolean` | `true` | Standard | Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). | +| `Hardware Monitoring Intervall (ms)` | `hardware_monitoring_interval_ms` | `number` | `5000` | Expertenmodus | Polling-Intervall für CPU/RAM/GPU/Storage-Metriken. | ## Kategorie: Pfade -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `Raw-Ordner (Blu-ray)` | `raw_dir_bluray` | `path` | `leer` | RAW-Zielpfad für Blu-ray. Leer = Standardpfad (data/output/raw). | -| `Raw-Ordner (DVD)` | `raw_dir_dvd` | `path` | `leer` | RAW-Zielpfad für DVD. Leer = Standardpfad (data/output/raw). | -| `CD RAW-Ordner` | `raw_dir_cd` | `path` | `leer` | Basisordner für rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). | -| `Audiobook RAW-Ordner` | `raw_dir_audiobook` | `path` | `leer` | Basisordner für hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). | -| `Serien-Ordner (Blu-ray)` | `series_dir_bluray` | `path` | `leer` | Zielordner für Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). | -| `Film-Ordner (Blu-ray)` | `movie_dir_bluray` | `path` | `leer` | Encode-Zielpfad für Blu-ray. Leer = Standardpfad (data/output/movies). | -| `Film-Ordner (DVD)` | `movie_dir_dvd` | `path` | `leer` | Encode-Zielpfad für DVD. Leer = Standardpfad (data/output/movies). | -| `Serien-Ordner (DVD)` | `series_dir_dvd` | `path` | `leer` | Zielordner für DVD-Serienfolgen. Leer = Standardpfad (data/output/series). | -| `CD Output-Ordner` | `movie_dir_cd` | `path` | `leer` | Zielordner für encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. | -| `Audiobook Output-Ordner` | `movie_dir_audiobook` | `path` | `leer` | Zielordner für encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). | -| `Externe Speicher` | `external_storage_paths` | `path` | `[]` | Wird links unter "Freie Speicher" angezeigt. | -| `Log Ordner` | `log_dir` | `path` | `data/logs` | Basisordner für Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. | -| `CD Output Template` | `cd_output_template` | `string` | `{artist} - {album} ({year})/{trackNr} {artist} - {title}` | Template für relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. | -| `Output Template (Blu-ray)` | `output_template_bluray` | `string` | `${title} (${year})/${title} (${year})` | Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. | -| `Output Template (Blu-ray Serie, Episode)` | `output_template_bluray_series_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle}` | Template für einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. | -| `Output Template (Blu-ray Serie, Multi-Episode)` | `output_template_bluray_series_multi_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts})` | Template für zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. | -| `Output Template (DVD)` | `output_template_dvd` | `string` | `${title} (${year})/${title} (${year})` | Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. | -| `Output Template (DVD Serie, Episode)` | `output_template_dvd_series_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle}` | Template für einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. | -| `Output Template (DVD Serie, Multi-Episode)` | `output_template_dvd_series_multi_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts})` | Template für zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. | -| `Output Template (Audiobook)` | `output_template_audiobook` | `string` | `{author}/{author} - {title} ({year})` | Template für relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind über "/" möglich. | -| `Audiobook RAW Template` | `audiobook_raw_template` | `string` | `{author} - {title} ({year})` | Template für relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. | -| `Converter Raw-Ordner` | `converter_raw_dir` | `path` | `leer` | Eingangsordner für den Converter (Import-Scan und Datei-Uploads). Jeder Upload erhält einen Unterordner. Leer = Standardpfad (data/output/converter-raw). | -| `Converter Ausgabe (Video)` | `converter_movie_dir` | `path` | `leer` | Ausgabepfad für konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). | -| `Converter Ausgabe (Audio)` | `converter_audio_dir` | `path` | `leer` | Ausgabepfad für konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). | -| `Output-Template (Video)` | `converter_output_template_video` | `string` | `{title}` | Dateiname-Template für konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. | -| `Output-Template (Audio)` | `converter_output_template_audio` | `string` | `{artist} - {title}` | Dateiname-Template für konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. | -| `RAW-Ordner (Blu-ray Serie)` | `raw_dir_bluray_series` | `path` | `leer` | RAW-Zielpfad für Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). | -| `Eigentümer RAW-Ordner (Blu-ray Serie)` | `raw_dir_bluray_series_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe für Blu-ray-Serien-RAW. Leer = Eigentümer Raw-Ordner (Blu-ray). | -| `Eigentümer Raw-Ordner (Blu-ray)` | `raw_dir_bluray_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `RAW-Ordner (DVD Serie)` | `raw_dir_dvd_series` | `path` | `leer` | RAW-Zielpfad für DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). | -| `Eigentümer RAW-Ordner (DVD Serie)` | `raw_dir_dvd_series_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe für DVD-Serien-RAW. Leer = Eigentümer Raw-Ordner (DVD). | -| `Eigentümer Raw-Ordner (DVD)` | `raw_dir_dvd_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer CD RAW-Ordner` | `raw_dir_cd_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Audiobook RAW-Ordner` | `raw_dir_audiobook_owner` | `string` | `leer` | Eigentümer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Serien-Ordner (Blu-ray)` | `series_dir_bluray_owner` | `string` | `leer` | Eigentümer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Film-Ordner (Blu-ray)` | `movie_dir_bluray_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Film-Ordner (DVD)` | `movie_dir_dvd_owner` | `string` | `leer` | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Serien-Ordner (DVD)` | `series_dir_dvd_owner` | `string` | `leer` | Eigentümer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer CD Output-Ordner` | `movie_dir_cd_owner` | `string` | `leer` | Eigentümer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | -| `Eigentümer Audiobook Output-Ordner` | `movie_dir_audiobook_owner` | `string` | `leer` | Eigentümer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `Raw Ausgabeordner (Blu-ray)` | `raw_dir_bluray` | `path` | `leer` | Standard | Optionaler RAW-Zielpfad nur für Blu-ray. Leer = Fallback auf "Raw Ausgabeordner". | +| `Raw Ausgabeordner (DVD)` | `raw_dir_dvd` | `path` | `leer` | Standard | Optionaler RAW-Zielpfad nur für DVD. Leer = Fallback auf "Raw Ausgabeordner". | +| `CD RAW-Ordner` | `raw_dir_cd` | `path` | `leer` | Standard | Basisordner für rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). | +| `Audiobook RAW-Ordner` | `raw_dir_audiobook` | `path` | `leer` | Standard | Basisordner für hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). | +| `Serien-Ordner (Blu-ray)` | `series_dir_bluray` | `path` | `leer` | Standard | Zielordner für Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). | +| `Film Ausgabeordner (Blu-ray)` | `movie_dir_bluray` | `path` | `leer` | Standard | Optionaler Encode-Zielpfad nur für Blu-ray. Leer = Fallback auf "Film Ausgabeordner". | +| `Film Ausgabeordner (DVD)` | `movie_dir_dvd` | `path` | `leer` | Standard | Optionaler Encode-Zielpfad nur für DVD. Leer = Fallback auf "Film Ausgabeordner". | +| `Serien-Ordner (DVD)` | `series_dir_dvd` | `path` | `leer` | Standard | Zielordner für DVD-Serienfolgen. Leer = Standardpfad (data/output/series). | +| `CD Output-Ordner` | `movie_dir_cd` | `path` | `leer` | Standard | Zielordner für encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. | +| `Audiobook Output-Ordner` | `movie_dir_audiobook` | `path` | `leer` | Standard | Zielordner für encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). | +| `Download ZIP-Ordner` | `download_dir` | `path` | `leer` | Standard | Zielordner für vorbereitete ZIP-Downloads. Leer = Standardpfad (data/downloads). | +| `Externe Speicher` | `external_storage_paths` | `path` | `[]` | Standard | Wird links unter "Freie Speicher" angezeigt. | +| `Log Ordner` | `log_dir` | `path` | `installationsabhängig` | Standard | Basisordner für Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. | +| `CD Output Template` | `cd_output_template` | `string` | `{artist} - {album} ({year})/{trackNr} {artist} - {title}` | Standard | Template für relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind über "/" möglich. Die Endung wird über das gewählte Ausgabeformat gesetzt. | +| `Output Template (Blu-ray)` | `output_template_bluray` | `string` | `${title} (${year})/${title} (${year})` | Standard | Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. | +| `Output Template (Blu-ray Serie, Episode)` | `output_template_bluray_series_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle}` | Standard | Template für einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. | +| `Output Template (Blu-ray Serie, Multi-Episode)` | `output_template_bluray_series_multi_episode` | `string` | `{seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts})` | Standard | Template für zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. | +| `Output Template (DVD)` | `output_template_dvd` | `string` | `${title} (${year})/${title} (${year})` | Standard | Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. | +| `Output Template (DVD Serie, Episode)` | `output_template_dvd_series_episode` | `string` | `{seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeNo} - {episodeTitle}` | Standard | Template für einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. | +| `Output Template (DVD Serie, Multi-Episode)` | `output_template_dvd_series_multi_episode` | `string` | `{seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeRange}` | Standard | Template für zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. | +| `Output Template (Audiobook)` | `output_template_audiobook` | `string` | `{author}/{author} - {title} ({year})` | Standard | Template für relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind über "/" möglich. | +| `Audiobook RAW Template` | `audiobook_raw_template` | `string` | `{author} - {title} ({year})` | Standard | Template für relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. | +| `Converter Raw-Ordner` | `converter_raw_dir` | `path` | `leer` | Standard | Eingangsordner für den Converter (Import-Scan und Datei-Uploads). Jeder Upload erhält einen Unterordner. Leer = Standardpfad (data/output/converter-raw). | +| `Converter Ausgabe (Video)` | `converter_movie_dir` | `path` | `leer` | Standard | Ausgabepfad für konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). | +| `Converter Ausgabe (Audio)` | `converter_audio_dir` | `path` | `leer` | Standard | Ausgabepfad für konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). | +| `Output-Template (Video)` | `converter_output_template_video` | `string` | `{title}` | Standard | Dateiname-Template für konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. | +| `Output-Template (Audio)` | `converter_output_template_audio` | `string` | `{artist} - {title}` | Standard | Dateiname-Template für konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. | +| `RAW-Ordner (Blu-ray Serie)` | `raw_dir_bluray_series` | `path` | `leer` | Standard | RAW-Zielpfad für Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). | +| `Eigentümer RAW-Ordner (Blu-ray Serie)` | `raw_dir_bluray_series_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe für Blu-ray-Serien-RAW. Leer = Eigentümer Raw-Ordner (Blu-ray). | +| `Eigentümer Raw-Ordner (Blu-ray)` | `raw_dir_bluray_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `RAW-Ordner (DVD Serie)` | `raw_dir_dvd_series` | `path` | `leer` | Standard | RAW-Zielpfad für DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). | +| `Eigentümer RAW-Ordner (DVD Serie)` | `raw_dir_dvd_series_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe für DVD-Serien-RAW. Leer = Eigentümer Raw-Ordner (DVD). | +| `Eigentümer Raw-Ordner (DVD)` | `raw_dir_dvd_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer CD RAW-Ordner` | `raw_dir_cd_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Audiobook RAW-Ordner` | `raw_dir_audiobook_owner` | `string` | `leer` | Standard | Eigentümer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Converter RAW-Ordner` | `converter_raw_dir_owner` | `string` | `leer` | Standard | Eigentümer der Converter-Eingabedateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Serien-Ordner (Blu-ray)` | `series_dir_bluray_owner` | `string` | `leer` | Standard | Eigentümer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Film-Ordner (Blu-ray)` | `movie_dir_bluray_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Film-Ordner (DVD)` | `movie_dir_dvd_owner` | `string` | `leer` | Standard | Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Serien-Ordner (DVD)` | `series_dir_dvd_owner` | `string` | `leer` | Standard | Eigentümer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer CD Output-Ordner` | `movie_dir_cd_owner` | `string` | `leer` | Standard | Eigentümer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Audiobook Output-Ordner` | `movie_dir_audiobook_owner` | `string` | `leer` | Standard | Eigentümer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Converter Video Output-Ordner` | `converter_movie_dir_owner` | `string` | `leer` | Standard | Eigentümer der konvertierten Video-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Converter Audio Output-Ordner` | `converter_audio_dir_owner` | `string` | `leer` | Standard | Eigentümer der konvertierten Audio-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Eigentümer Download ZIP-Ordner` | `download_dir_owner` | `string` | `leer` | Standard | Eigentümer der vorbereiteten ZIP-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. | +| `Kapitel Template (Audiobook)` | `output_chapter_template_audiobook` | `string` | `{author}/{author} - {title} ({year})/{chapterNr} {chapterTitle}` | Standard | Template für kapitelweise Audiobook-Ausgaben (MP3/FLAC) ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}, {chapterNr}, {chapterNo}, {chapterTitle}. Unterordner sind über "/" möglich. | ## Kategorie: Tools -| GUI-Feld | Key | Typ | Default | Wirkung im System | -|---|---|---|---|---| -| `MakeMKV Kommando` | `makemkv_command` | `string` | `makemkvcon` | Pfad oder Befehl für makemkvcon. | -| `MakeMKV Key` | `makemkv_registration_key` | `string` | `leer` | Optionaler Registrierungsschlüssel. Wird beim Speichern nach `~/.MakeMKV/settings.conf` synchronisiert. In der UI kann darunter der aktuelle Betakey geladen und übernommen werden. | -| `Mediainfo Kommando` | `mediainfo_command` | `string` | `mediainfo` | Pfad oder Befehl für mediainfo. | -| `Minimale Titellänge (Minuten)` | `makemkv_min_length_minutes` | `number` | `60` | Filtert kurze Titel beim Rip. | -| `HandBrake Kommando` | `handbrake_command` | `string` | `HandBrakeCLI` | Pfad oder Befehl für HandBrakeCLI. | -| `Encode-Neustart: unvollständige Ausgabe löschen` | `handbrake_restart_delete_incomplete_output` | `boolean` | `true` | Wenn aktiv, wird bei "Encode neu starten" der bisherige (nicht erfolgreiche) Output vor Start entfernt. | -| `Max. parallele Film/Video Encodes` | `pipeline_max_parallel_jobs` | `number` | `1` | Maximale Anzahl parallel laufender Film/Video Encode-Jobs. Gilt zusätzlich zum Gesamtlimit. | -| `Max. parallele Audio CD Jobs` | `pipeline_max_parallel_cd_encodes` | `number` | `2` | Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zusätzlich zum Gesamtlimit. | -| `Max. Encodes gesamt (medienunabhängig)` | `pipeline_max_total_encodes` | `number` | `3` | Gesamtlimit für alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. | -| `Audio CDs: Queue-Reihenfolge überspringen` | `pipeline_cd_bypasses_queue` | `boolean` | `false` | Wenn aktiv, können Audio CD Jobs unabhängig von Film-Jobs starten (überspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. | -| `Script-Test Timeout (ms)` | `script_test_timeout_ms` | `number` | `0` | Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. | -| `cdparanoia Kommando` | `cdparanoia_command` | `string` | `cdparanoia` | Pfad oder Befehl für cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. | -| `FFmpeg Kommando` | `ffmpeg_command` | `string` | `ffmpeg` | Pfad oder Befehl für ffmpeg. Wird für Audiobook-Encoding genutzt. | -| `FFprobe Kommando` | `ffprobe_command` | `string` | `ffprobe` | Pfad oder Befehl für ffprobe. Wird für Audiobook-Metadaten und Kapitel genutzt. | -| `Mediainfo Extra Args` | `mediainfo_extra_args_bluray` | `string` | `leer` | Zusätzliche CLI-Parameter für mediainfo (Blu-ray). | -| `MakeMKV Rip Modus` | `makemkv_rip_mode_bluray` | `select` | `backup` | backup: vollständige Blu-ray Struktur im RAW-Ordner (empfohlen, ermöglicht --decrypt). | -| `MakeMKV Analyze Extra Args` | `makemkv_analyze_extra_args_bluray` | `string` | `leer` | Zusätzliche CLI-Parameter für Analyze (Blu-ray). | -| `MakeMKV Rip Extra Args` | `makemkv_rip_extra_args_bluray` | `string` | `leer` | Zusätzliche CLI-Parameter für Rip (Blu-ray). | -| `HandBrake Preset` | `handbrake_preset_bluray` | `string` | `H.264 MKV 1080p30` | Preset Name für -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. | -| `HandBrake Extra Args` | `handbrake_extra_args_bluray` | `string` | `leer` | Zusätzliche CLI-Argumente (Blu-ray). | -| `Ausgabeformat` | `output_extension_bluray` | `select` | `mkv` | Dateiendung für finale Datei (Blu-ray). | -| `Mediainfo Extra Args` | `mediainfo_extra_args_dvd` | `string` | `leer` | Zusätzliche CLI-Parameter für mediainfo (DVD). | -| `MakeMKV Rip Modus` | `makemkv_rip_mode_dvd` | `select` | `backup` | backup: vollständige Disc-Struktur im RAW-Ordner (einzig gültige Option für DVDs). | -| `MakeMKV Analyze Extra Args` | `makemkv_analyze_extra_args_dvd` | `string` | `leer` | Zusätzliche CLI-Parameter für Analyze (DVD). | -| `MakeMKV Rip Extra Args` | `makemkv_rip_extra_args_dvd` | `string` | `leer` | Zusätzliche CLI-Parameter für Rip (DVD). | -| `HandBrake Preset` | `handbrake_preset_dvd` | `string` | `H.264 MKV 480p30` | Preset Name für -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. | -| `HandBrake Extra Args` | `handbrake_extra_args_dvd` | `string` | `leer` | Zusätzliche CLI-Argumente (DVD). | -| `Ausgabeformat` | `output_extension_dvd` | `select` | `mkv` | Dateiendung für finale Datei (DVD). | +| GUI-Feld | Key | Typ | Default | Sichtbarkeit | Wirkung im System | +|---|---|---|---|---|---| +| `MakeMKV Kommando` | `makemkv_command` | `string` | `makemkvcon` | Expertenmodus | Pfad oder Befehl für makemkvcon. | +| `MakeMKV Key` | `makemkv_registration_key` | `string` | `leer` | Standard | Optionaler Registrierungsschlüssel. Wird beim Speichern nach ~/.MakeMKV/settings.conf synchronisiert. Darunter kann der aktuelle Betakey per API übernommen werden. | +| `Mediainfo Kommando` | `mediainfo_command` | `string` | `mediainfo` | Expertenmodus | Pfad oder Befehl für mediainfo. | +| `Minimale Titellänge (Minuten)` | `makemkv_min_length_minutes` | `number` | `60` | Standard | Filtert kurze Titel beim Rip. | +| `HandBrake Kommando` | `handbrake_command` | `string` | `HandBrakeCLI` | Expertenmodus | Pfad oder Befehl für HandBrakeCLI. | +| `Encode-Neustart: unvollständige Ausgabe löschen` | `handbrake_restart_delete_incomplete_output` | `boolean` | `true` | Standard | Wenn aktiv, wird bei "Encode neu starten" der bisherige (nicht erfolgreiche) Output vor Start entfernt. | +| `Parallele Jobs` | `pipeline_max_parallel_jobs` | `number` | `1` | Standard | Maximale Anzahl parallel laufender Jobs. Weitere Starts landen in der Queue. | +| `Max. parallele Audio CD Jobs` | `pipeline_max_parallel_cd_encodes` | `number` | `2` | Standard | Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zusätzlich zum Gesamtlimit. | +| `Script-Test Timeout (ms)` | `script_test_timeout_ms` | `number` | `0` | Expertenmodus | Timeout für Script-Tests in den Settings. 0 = kein Timeout. | +| `Max. Encodes gesamt (medienunabhängig)` | `pipeline_max_total_encodes` | `number` | `3` | Standard | Gesamtlimit für alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. | +| `Audio CDs: Queue-Reihenfolge überspringen` | `pipeline_cd_bypasses_queue` | `boolean` | `false` | Standard | Wenn aktiv, können Audio CD Jobs unabhängig von Film-Jobs starten (überspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. | +| `cdparanoia Kommando` | `cdparanoia_command` | `string` | `cdparanoia` | Expertenmodus | Pfad oder Befehl für cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. | +| `FFmpeg Kommando` | `ffmpeg_command` | `string` | `ffmpeg` | Standard | Pfad oder Befehl für ffmpeg. Wird für Audiobook-Encoding genutzt. | +| `FFprobe Kommando` | `ffprobe_command` | `string` | `ffprobe` | Standard | Pfad oder Befehl für ffprobe. Wird für Audiobook-Metadaten und Kapitel genutzt. | +| `Serie: PlayAll Untergrenze (%)` | `series_playall_tolerance_lower_pct` | `number` | `10` | Standard | Untere Toleranz in Prozent für die Plausibilitätsprüfung von PlayAll gegen Episodensumme (DVD/Blu-ray). | +| `Serie: PlayAll Obergrenze (%)` | `series_playall_tolerance_upper_pct` | `number` | `10` | Standard | Obere Toleranz in Prozent für die Plausibilitätsprüfung von PlayAll gegen Episodensumme (DVD/Blu-ray). | +| `Mediainfo Extra Args` | `mediainfo_extra_args_bluray` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für mediainfo (Blu-ray). | +| `MakeMKV Rip Modus` | `makemkv_rip_mode_bluray` | `select` | `backup` | Ausgeblendet (nur API/DB) | mkv: direkte MKV-Dateien; backup: vollständige Blu-ray Struktur im RAW-Ordner. | +| `MakeMKV Analyze Extra Args` | `makemkv_analyze_extra_args_bluray` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für Analyze (Blu-ray). | +| `MakeMKV Rip Extra Args` | `makemkv_rip_extra_args_bluray` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für Rip (Blu-ray). | +| `HandBrake Preset` | `handbrake_preset_bluray` | `string` | `H.264 MKV 1080p30` | Standard | Preset Name für -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. | +| `HandBrake Extra Args` | `handbrake_extra_args_bluray` | `string` | `--audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au...` | Standard | Zusätzliche CLI-Argumente (Blu-ray). | +| `Ausgabeformat` | `output_extension_bluray` | `select` | `mkv` | Standard | Dateiendung für finale Datei (Blu-ray). | +| `Mediainfo Extra Args` | `mediainfo_extra_args_dvd` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für mediainfo (DVD). | +| `MakeMKV Rip Modus` | `makemkv_rip_mode_dvd` | `select` | `mkv` | Ausgeblendet (nur API/DB) | mkv: direkte MKV-Dateien; backup: vollständige Disc-Struktur im RAW-Ordner. | +| `MakeMKV Analyze Extra Args` | `makemkv_analyze_extra_args_dvd` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für Analyze (DVD). | +| `MakeMKV Rip Extra Args` | `makemkv_rip_extra_args_dvd` | `string` | `leer` | Expertenmodus | Zusätzliche CLI-Parameter für Rip (DVD). | +| `HandBrake Preset` | `handbrake_preset_dvd` | `string` | `H.264 MKV 480p30` | Standard | Preset Name für -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. | +| `HandBrake Extra Args` | `handbrake_extra_args_dvd` | `string` | `--audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au...` | Standard | Zusätzliche CLI-Argumente (DVD). | +| `Ausgabeformat` | `output_extension_dvd` | `select` | `mkv` | Standard | Dateiendung für finale Datei (DVD). | +| `mkvmerge Kommando` | `mkvmerge_command` | `string` | `mkvmerge` | Standard | Pfad oder Befehl für mkvmerge. Wird für Multipart-Movie-Merges genutzt. | + +## Beispiele für häufige Settings + +- `drive_devices`: `[{"path":"/dev/sr0","makemkvIndex":0},{"path":"/dev/sr1","makemkvIndex":1}]` +- `external_storage_paths`: `[{"name":"USB HDD","path":"/mnt/usb-hdd"}]` +- `converter_scan_extensions`: `mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus` +- `output_template_bluray`: `${title} (${year})/${title} (${year})` +- `output_template_audiobook`: `{author}/{author} - {title} ({year})` +- `output_chapter_template_audiobook`: `{author}/{author} - {title} ({year})/{chapterNr} {chapterTitle}` +- `download_dir_owner`: `ripster:media` + +## Hinweise zu ausgeblendeten Keys + +Folgende Keys liegen im Schema, sind aber im normalen Settings-Formular absichtlich ausgeblendet: `drive_device`, `makemkv_source_index`, `makemkv_rip_mode_bluray`, `makemkv_rip_mode_dvd`. +Änderungen daran erfolgen nur über API/DB oder technische Migrationen. diff --git a/docs/gui/audiobooks.md b/docs/gui/audiobooks.md index 258617c..74a1328 100644 --- a/docs/gui/audiobooks.md +++ b/docs/gui/audiobooks.md @@ -1,68 +1,82 @@ # Audiobooks -Die Seite `Audiobooks` ist der spezialisierte AAX-Workflow. +Die Seite `Audiobooks` ist der spezialisierte Workflow für Audible-`*.aax`-Dateien. -## Ablaufübersicht +## Seitenstruktur -Die Oberfläche ist in drei Bereiche gegliedert: +Die Oberfläche besteht aus zwei Hauptbereichen: 1. `Audiobooks Upload` 2. `Audiobook Jobs` -3. `Audiobook Output Explorer` ## 1) Audiobooks Upload -Der Upload verarbeitet ausschließlich AAX-Dateien. +Der Upload akzeptiert ausschließlich `.aax`. -Direkt nach Upload passieren im Hintergrund: +### Bedienung -- Probe/Metadatenanalyse (ffprobe) -- Anlage eines RAW-Ordners per `Audiobook RAW Template` -- Ablage der AAX-Datei im RAW-Pfad -- Initiale Jobkonfiguration (Format, Kapitel, Metadaten) +- Datei auswählen (Button oder Drag-and-Drop) +- Upload starten +- Auswahl entfernen oder laufenden Upload abbrechen -Wichtige Parameter: +Während des Uploads zeigt die UI: -- Zielformat (`m4b`, `mp3`, `flac`) -- optionaler Sofortstart +- Prozentfortschritt +- übertragene/gesamte Bytes +- Statusmeldung (z. B. „Job vorbereitet“, „in Queue eingereiht“) -Toolabhängigkeit: +### Ablauf nach erfolgreichem Upload -- `ffprobe_command` für Metadaten/Kapitel -- `ffmpeg_command` für Encode/Cover-Extraktion +- AAX wird serverseitig geprüft +- Audiobook-Job wird angelegt +- Job landet je nach Pipelinezustand in `READY_TO_START`, startet direkt oder wird eingereiht ## 2) Audiobook Jobs -Jobkarten zeigen Zustand, Fortschritt und verfügbare Aktionen. +Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der `Historie`. -Typische Aktionen: +Jeder Job kann eingeklappt/ausgeklappt werden und zeigt: -- `Starten` +- Titel-/Metadatenblock (Titel, Autor, Sprecher, Jahr, Kapitel) +- Statusbadge +- Fortschritt/ETA +- ggf. Kapitel-Fortschritt + +### Konfigurierbare Job-Parameter + +Im ausgeklappten Job: + +- Ausgabeformat (`m4b`, `mp3`, `flac`) +- formatspezifische Optionen (dynamisch je Format) +- Kapitelnamen bearbeiten +- Pre-Rip-Ausführungen (Skript/Kette) +- Post-Rip-Ausführungen (Skript/Kette) + +### Formatverhalten + +- `m4b`: eine Datei mit Kapiteln +- `mp3`/`flac`: kapitelweise Ausgabedateien + +Für `mp3`/`flac` zeigt die UI während/nach dem Lauf eine Kapitel-Status-Tabelle (`Rip`/`Encode`). + +### Aktionen je Job + +- `Encode starten` (bzw. Neustart mit aktuellen Optionen) - `Abbrechen` -- `Retry` -- `Löschen` -- `Im Ripper` (Kontextwechsel) +- `Job löschen` (mit Bestätigung) -Die Karten werden regelmäßig aktualisiert und durch WebSocket-Ereignisse ergänzt. +## Relevante Settings -## 3) Audiobook Output Explorer +- `raw_dir_audiobook` +- `movie_dir_audiobook` +- `audiobook_raw_template` +- `output_template_audiobook` +- `output_chapter_template_audiobook` +- `ffprobe_command` +- `ffmpeg_command` -Read-only Explorer des Audiobook-Outputpfads: +## Typische Fehlerbilder -- Ordner-/Dateistruktur -- Zeitstempel/Größen -- schnelle Ergebnisprüfung ohne Dateisystemwechsel - -## Pfad- und Template-Logik - -| Bereich | Gesteuert durch | -|---|---| -| RAW-Ablage | `raw_dir_audiobook` + `audiobook_raw_template` | -| Finale Ausgabe | `movie_dir_audiobook` + `output_template_audiobook` | -| Dateiformat | Jobkonfiguration (`m4b`, `mp3`, `flac`) | - -## Typische Probleme - -- Upload wird abgelehnt: Eingabedatei ist keine AAX-Datei. -- Start schlägt fehl: `ffmpeg`/`ffprobe` nicht aufrufbar. -- Unerwartete Pfade: Templates enthalten ungültige oder zu generische Platzhalter. +- Upload wird abgelehnt: Datei ist keine gültige `*.aax`. +- Start/Encode schlägt fehl: `ffprobe` oder `ffmpeg` nicht erreichbar. +- Unerwartete Ausgabeorte: Templates/Pfade passen nicht zur gewünschten Struktur. diff --git a/docs/gui/index.md b/docs/gui/index.md index 2d6ae92..983f25d 100644 --- a/docs/gui/index.md +++ b/docs/gui/index.md @@ -7,7 +7,7 @@ Dieses Kapitel ist das Bedienhandbuch für die Oberflächen im Alltag. | Seite | Rolle im Betrieb | Typischer Einsatz | |---|---|---| | [Ripper](ripper.md) | Live-Steuerung der Pipeline | Disc-Flow starten, Queue steuern, Review freigeben | -| [Audiobooks](audiobooks.md) | AAX-Spezialflow | Upload, Konfiguration und Encode von Audiobooks | +| [Audiobooks](audiobooks.md) | AAX-Spezialflow | Upload, Jobkonfiguration und Encode von Audiobooks | | [Settings](settings.md) | Konfiguration/Automatisierung | Pfade, Tools, Queue-Limits, Skripte, Cron | | [Historie](history.md) | Nachbearbeitung und Kontrolle | Logs, Re-Encode, Löschvorschau, Recovery-Aktionen | | [Converter](converter.md) | dateibasierte Konvertierung | Video/Audio/ISO ohne Disc-Rip verarbeiten | @@ -29,4 +29,5 @@ Direkt in der Top-Navigation: Nur per URL: -- `Database` unter `/database` +- `Database` unter `/database` (nur Expertenmodus in der Navigation sichtbar) +- `TMDb Migration` unter `/tmdb-migration` (Direktlink, nicht in der Navigation) diff --git a/docs/gui/ripper.md b/docs/gui/ripper.md index b1edc8d..ba0679d 100644 --- a/docs/gui/ripper.md +++ b/docs/gui/ripper.md @@ -166,3 +166,12 @@ Du kannst gezielt ab Position einfügen: - Skript - Skriptkette - Wartezeit + +### Audible Activation Bytes eintragen + +Wenn für eine AAX-Datei keine Activation Bytes automatisch ermittelt werden können, +öffnet Ripster einen Dialog zur manuellen Eingabe. + +- Eingabeformat: genau 8 Hex-Zeichen (z.B. `1a2b3c4d`) +- Speicherung: lokal im Activation-Bytes-Cache +- Wirkung: nach dem Speichern kann der Audiobook-Flow fortgesetzt werden diff --git a/docs/gui/settings.md b/docs/gui/settings.md index ef34b1e..add78f7 100644 --- a/docs/gui/settings.md +++ b/docs/gui/settings.md @@ -1,107 +1,167 @@ # Settings -Die Seite `Settings` steuert alle Betriebsparameter von Ripster: Pfade, Tools, Queue-Limits, Metadatenquellen, Automatisierung. +Die Seite `Settings` ist das zentrale Kontrollpanel für Laufzeitverhalten, Automatisierung und Expertenfunktionen. ## Tab-Überblick -| Tab | Hauptzweck | +| Tab | Zweck | |---|---| -| `Konfiguration` | globale und profilspezifische Laufzeitsettings | -| `Scripte` | einzelne Skripte verwalten und testen | -| `Skriptketten` | mehrstufige Abläufe aus Skript/Warten | -| `Encode-Presets` | wiederverwendbare HandBrake-Profile für Review | -| `Cronjobs` | zeitgesteuerte Ausführung von Skript/Kette | +| `Konfiguration` | Alle fachlichen Settings (Pfade, Tools, Laufwerk, Metadaten, Monitoring, Benachrichtigungen, Converter) | +| `Scripte` | Einzelne Bash-Skripte pflegen, testen und sortieren | +| `Skriptketten` | Mehrstufige Sequenzen aus `Skript` und `Warten` bauen und testen | +| `Encode-Presets` | Benutzer-Presets und Standard-Zuordnungen für Blu-ray/DVD-Workflows | +| `Cronjobs` | Zeitgesteuerte Jobs auf Basis Skript/Skriptkette | ## Tab `Konfiguration` -### Bedienprinzip +### Bedienlogik -1. Werte ändern. -2. `Änderungen speichern`. -3. erst danach sind Werte für neue Aktionen wirksam. +1. Felder ändern. +2. `Änderungen speichern` klicken. +3. Erst dann werden Änderungen persistiert und für neue Pipeline-Schritte wirksam. -Zusätzliche Bedienhilfen: +Aktionen in der Toolbar: -- `Neu laden` verwirft lokale Formzustände -- `Änderungen verwerfen` setzt auf zuletzt gespeicherten Stand -- `PushOver Test` validiert Benachrichtigungszugang sofort +- `Änderungen speichern`: schreibt nur geänderte Felder als Bulk-Update. +- `Änderungen verwerfen`: setzt den Formularzustand auf zuletzt geladen/zum Server gespeicherten Stand zurück. +- `Neu laden`: lädt Kategorien + Werte erneut vom Backend. +- `PushOver Test`: sendet eine Testnachricht mit aktuellen PushOver-Werten. +- `Coverarts prüfen`: startet die manuelle Coverart-Recovery. +- `Expertenmodus`: wird sofort gespeichert (nicht Teil des normalen Bulk-Speicherns). -### Was wirkt unmittelbar, was erst bei neuem Job? +### Wichtige UI-Verhalten -- Queue-/Parallelität wirkt auf neue Queue-Entscheidungen und Pump-Läufe. -- Tool-/Pfad-/Template-Änderungen wirken vollständig auf neu gestartete Schritte. -- Bereits laufende Prozesse übernehmen Änderungen in der Regel nicht rückwirkend. +- Jede Einstellung zeigt `Gespeichert` oder `Ungespeichert` direkt am Feld. +- Pflichtfelder sind mit `*` markiert. +- Bei Validierungsfehlern wird pro Feld ein Fehlertext angezeigt und Speichern blockiert. +- Tool-Kommandos (`makemkv_command`, `mediainfo_command`, `handbrake_command`, `ffmpeg_command`, `ffprobe_command`, `cdparanoia_command`, `mkvmerge_command`) sind im Formular schreibgeschützt markiert. +- Einige Felder sind abhängig vom Expertenmodus sichtbar. -### Welche Bereiche im Alltag kritisch sind +### Kategorie `Pfade`: Besondere Interaktion -| Bereich | Kritisch für | -|---|---| -| `Pfade` | wo RAW, finale Ausgaben, Converter/Audiobook-Dateien landen | -| `Tools` | ob Analyze/Rip/Encode ausführbar sind | -| `Metadaten` | Film-/Serienzuordnung und Episode-Mapping | -| `Queue-Limits` | Durchsatz und Reihenfolgeverhalten | -| `Monitoring` | Sichtbarkeit von Last und Speicherengpässen | -| `Benachrichtigungen` | PushOver-Ereignisse je Pipelinephase | +Die Pfad-Kategorie hat eine eigene Darstellung: + +- Tabelle `Effektive Pfade`: zeigt die aktuell tatsächlich aufgelösten Laufzeitpfade inkl. Fallbacks. +- Accordion je Bereich (`Blu-ray`, `DVD`, `CD / Audio`, `Audiobook`, `Converter`, `Downloads`, optional `Externe Speicher`, `Logs`). +- Für Pfadfelder mit Owner-Pendant (`*_owner`) erscheint direkt darunter das Feld `Eigentümer (user:gruppe)`. +- Owner-Felder sind deaktiviert, solange der zugehörige Pfad leer ist. + +### Spezial-Editoren in der Konfiguration + +- `drive_devices`: JSON-Array wird über UI-Editor gepflegt (Pfad + MakeMKV-Index je Laufwerk). +- `external_storage_paths`: Liste aus `Name` + `Pfad` (für Anzeige freier externer Speicher). +- `converter_scan_extensions`: Checkbox-Raster der erlaubten Endungen; mindestens eine Endung muss aktiv bleiben. +- `makemkv_registration_key`: zusätzlicher Betakey-Hinweis mit `übernehmen`-Button. + +### Laufwerks-Infobox innerhalb `Laufwerk` + +In der Kategorie `Laufwerk` wird eine Live-Tabelle erkannter optischer Laufwerke angezeigt: + +- `Neu einlesen` lädt Laufwerksinfos neu. +- Im Expertenmodus: `Freigeben` pro Laufwerk und `Alle Laufwerke freigeben`. ## Tab `Scripte` Funktionen: -- anlegen, bearbeiten, löschen -- testen (`Test`) -- sortieren +- Skript anlegen (Inline-Editor) +- Skript bearbeiten (Dialog) +- Skript löschen (mit Bestätigung) +- Skript testen +- Reihenfolge per Drag-and-Drop ändern -Testausführung liefert: +Testergebnis enthält: +- Erfolg/Fehler - Exit-Code +- Timeout-Info - Dauer - stdout/stderr -Wichtig: - -- Nur erfolgreiche Skripte sollten in produktive Pre-/Post-Listen übernommen werden. - ## Tab `Skriptketten` -Ketten bestehen aus Schritten: +Skriptketten bestehen aus Schritten: - `Skript` -- `Warten` +- `Warten (Sekunden)` -Typischer Einsatz: +Funktionen: -- externe Hooks vor/nach Encode -- gestaffelte Abläufe mit Pausen +- Ketten anlegen/bearbeiten/löschen +- Reihenfolge der Ketten per Drag-and-Drop +- Kette testen +- Schritte in der Kette per Drag-and-Drop neu anordnen -In der Queue erscheinen Ketten als eigene Einträge und werden dort ausgeführt. +Im Ketteneditor: + +- linke Palette (`Systemblöcke`, `Scripte`) +- rechte Canvas mit Drop-Zonen +- pro Warte-Schritt konfigurierbare Sekunden ## Tab `Encode-Presets` -Ein Preset bündelt: +Bereiche: -- optionales HandBrake-Preset (`-Z`) -- optionale Extra-Args -- Medienziel (Universell/Blu-ray/DVD/Sonstiges) +1. `Standard-Zuordnungen` (Slots) +2. `Preset-Liste` (CRUD) -Im Ripper-Review kannst du Presets pro Job auswählen, statt Parameter jedes Mal neu zu setzen. +### Standard-Zuordnungen + +Es gibt vier persistente Slots: + +- `bluray_movie` +- `bluray_series` +- `dvd_movie` +- `dvd_series` + +Die Auswahl ist medientyp-kompatibel gefiltert. Nicht kompatible oder fehlende bereits gespeicherte IDs werden weiterhin sichtbar gemacht, damit bestehende Zuordnungen nachvollziehbar bleiben. + +### Preset-Inhalt + +Ein Preset umfasst: + +- Name +- Medientyp (`all`, `bluray`, `dvd`) +- HandBrake-Preset (`-Z`) +- Extra Args +- optionale Beschreibung ## Tab `Cronjobs` Funktionen: -- Cronjob anlegen und bearbeiten -- Quelle wählen (`Skript` oder `Skriptkette`) -- Cron-Ausdruck prüfen +- Cronjob erstellen/bearbeiten/löschen +- Debounced Validierung des Cron-Ausdrucks +- Quelle wählen: `Skript` oder `Skriptkette` +- Aktiv- und PushOver-Toggle je Job - `Jetzt ausführen` -- Job-Logs ansehen -- Aktivierung/Pushover toggeln +- Lauf-Logs öffnen -Empfehlung: +Die Seite zeigt zusätzlich Live-Status laufender Cron-Aktivitäten (Runtime Activities). -1. Skript/Kette manuell testen. -2. Dann Cron aktivieren. -3. Erste automatische Läufe aktiv im Runtime-Status kontrollieren. +## Expertenbereich: Activation Bytes Cache -## Verbindung zur Einstellungsreferenz +Der Activation-Bytes-Block wird nur im Expertenmodus angezeigt und nur wenn Einträge vorhanden sind. -Die vollständige Wirkung jeder einzelnen Einstellung steht in [Einstellungsreferenz](../configuration/settings-reference.md). +Er zeigt: + +- AAX-Checksum +- Activation Bytes +- Speicherzeitpunkt + +## Validierungshinweise für Template-Felder + +Template-Felder akzeptieren nur: + +- Buchstaben/Ziffern +- Leerzeichen +- `_` und `-` +- Platzhalter in `{...}` bzw. `${...}` +- `/` für Ordnertrennung + +Nicht erlaubt sind z. B. unvollständige geschweifte Klammern oder sonstige Sonderzeichen. + +## Siehe auch + +- [Einstellungsreferenz](../configuration/settings-reference.md) +- [Ripper](ripper.md) diff --git a/frontend/package-lock.json b/frontend/package-lock.json index 8bed059..b306d96 100644 --- a/frontend/package-lock.json +++ b/frontend/package-lock.json @@ -1,12 +1,12 @@ { "name": "ripster-frontend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ripster-frontend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "dependencies": { "primeicons": "^7.0.0", "primereact": "^10.9.2", diff --git a/frontend/package.json b/frontend/package.json index cfcbe40..1612314 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "ripster-frontend", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "private": true, "type": "module", "scripts": { diff --git a/package-lock.json b/package-lock.json index 3b9e9b0..37caf62 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "ripster", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ripster", - "version": "0.16.1-7", + "version": "1.0.0-rc1", "devDependencies": { "concurrently": "^9.1.2" } diff --git a/package.json b/package.json index effde56..49a50ac 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "ripster", "private": true, - "version": "0.16.1-7", + "version": "1.0.0-rc1", "scripts": { "dev": "concurrently \"npm run dev --prefix backend\" \"npm run dev --prefix frontend\"", "dev:backend": "npm run dev --prefix backend", diff --git a/site/404.html b/site/404.html index 517ff7a..6c7520c 100644 --- a/site/404.html +++ b/site/404.html @@ -1 +1 @@ - Ripster

404 - Not found

\ No newline at end of file + Ripster

404 - Not found

\ No newline at end of file diff --git a/site/api/converter/index.html b/site/api/converter/index.html index 8c37677..2a2fd17 100644 --- a/site/api/converter/index.html +++ b/site/api/converter/index.html @@ -1,4 +1,4 @@ - Converter API - Ripster
Zum Inhalt

Converter API

Endpunkte für den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.

Basis-Pfad: /api/converter

Scan & Explorer

GET /api/converter/tree

Vollständiger Verzeichnisbaum des converter_raw_dir (FS-basiert, keine DB).

Response:

{
+ Converter API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Converter API
 
Endpunkte für den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.
 
Basis-Pfad: /api/converter
 
 
Scan & Explorer
 
GET /api/converter/tree
 
Vollständiger Verzeichnisbaum des converter_raw_dir (FS-basiert, keine DB).
 
Response:
 
{
   "tree": [
     {
       "name": "filme",
diff --git a/site/api/crons/index.html b/site/api/crons/index.html
index 16a46be..9f58677 100644
--- a/site/api/crons/index.html
+++ b/site/api/crons/index.html
@@ -1,4 +1,4 @@
- Cron API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Cron API
 
Ripster enthält ein eingebautes Cron-System für Skripte und Skript-Ketten (sourceType: script|chain).
 
 
GET /api/crons
 
Listet alle Cron-Jobs.
 
{
+ Cron API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Cron API
 
Ripster enthält ein eingebautes Cron-System für Skripte und Skript-Ketten (sourceType: script|chain).
 
 
GET /api/crons
 
Listet alle Cron-Jobs.
 
{
   "jobs": [
     {
       "id": 1,
diff --git a/site/api/downloads/index.html b/site/api/downloads/index.html
index 8c1ccaa..fe44682 100644
--- a/site/api/downloads/index.html
+++ b/site/api/downloads/index.html
@@ -1,4 +1,4 @@
- Downloads API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Downloads API
 
Endpunkte für die Download-Queue. Ausgabedateien aus der Job-Historie können als ZIP heruntergeladen werden.
 
Basis-Pfad: /api/downloads
 
 
GET /api/downloads
 
Liste aller Download-Einträge plus Zusammenfassung.
 
Response:
 
{
+ Downloads API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Downloads API
 
Endpunkte für die Download-Queue. Ausgabedateien aus der Job-Historie können als ZIP heruntergeladen werden.
 
Basis-Pfad: /api/downloads
 
 
GET /api/downloads
 
Liste aller Download-Einträge plus Zusammenfassung.
 
Response:
 
{
   "items": [
     {
       "id": "dl-42-raw",
diff --git a/site/api/history/index.html b/site/api/history/index.html
index a07e824..c22e255 100644
--- a/site/api/history/index.html
+++ b/site/api/history/index.html
@@ -1,4 +1,4 @@
- History API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
History API
 
Endpunkte für Job-Historie, Metadaten-Nachpflege, Orphan-Import und Löschoperationen.
 
 
GET /api/history
 
Liefert Jobs mit optionalen Filtern.
 
Query-Parameter:
 
  
 Parameter Typ Beschreibung 
   
 status string Einzelstatus-Filter (legacy-kompatibel). 
 
 statuses string Mehrfachstatus als CSV, z. B. FINISHED,ERROR. 
 
 search string Suche in Titel-/IMDb-Feldern. 
 
 limit number Maximale Anzahl Ergebnisse. 
 
 lite bool Ohne Dateisystem-Checks (schneller). 
 
 includeChildren bool Child-Jobs (z. B. Serien-/Multipart-Kinder) explizit einbeziehen. 
  
 
Beispiel:
 
GET /api/history?statuses=FINISHED,ERROR&search=Inception&limit=50&lite=1
+ History API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
History API
 
Endpunkte für Job-Historie, Metadaten-Nachpflege, Orphan-Import und Löschoperationen.
 
 
GET /api/history
 
Liefert Jobs mit optionalen Filtern.
 
Query-Parameter:
 
  
 Parameter Typ Beschreibung 
   
 status string Einzelstatus-Filter (legacy-kompatibel). 
 
 statuses string Mehrfachstatus als CSV, z. B. FINISHED,ERROR. 
 
 search string Suche in Titel-/IMDb-Feldern. 
 
 limit number Maximale Anzahl Ergebnisse. 
 
 lite bool Ohne Dateisystem-Checks (schneller). 
 
 includeChildren bool Child-Jobs (z. B. Serien-/Multipart-Kinder) explizit einbeziehen. 
  
 
Beispiel:
 
GET /api/history?statuses=FINISHED,ERROR&search=Inception&limit=50&lite=1
 
 
Response (Beispiel):
 
{
   "jobs": [
     {
diff --git a/site/api/index.html b/site/api/index.html
index f17fd5f..3325262 100644
--- a/site/api/index.html
+++ b/site/api/index.html
@@ -1,2 +1,2 @@
- Anhang: API-Referenz - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: API-Referenz
 
REST- und WebSocket-Schnittstellen für Integration, Automatisierung und Debugging.
 
Basis-URL
 
http://localhost:3001
+ Anhang: API-Referenz - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: API-Referenz
 
REST- und WebSocket-Schnittstellen für Integration, Automatisierung und Debugging.
 
Basis-URL
 
http://localhost:3001
 
 
API-Prefix: /api
 
API-Gruppen
 
 
     
  •  
     Health
     
     
    Service-Liveness.
     
    GET /api/health
     
    •  
  •  
     Pipeline API
     
     
    Analyse, Start/Retry/Cancel, Queue, Re-Encode.
     
     Pipeline API
     
    •  
  •  
     Settings API
     
     
    Einstellungen, Skripte/Ketten, User-Presets.
     
     Settings API
     
    •  
  •  
     History API
     
     
    Job-Historie, Orphan-Import, Löschoperationen.
     
     History API
     
    •  
  •  
     Cron API
     
     
    Zeitgesteuerte Skript-/Kettenausführung.
     
     Cron API
     
    •  
  •  
     Converter API
     
     
    Datei-Explorer, Upload, Job-Verwaltung für den Converter.
     
     Converter API
     
    •  
  •  
     Downloads API
     
     
    Download-Queue für Ausgabedateien aus der Job-Historie.
     
     Downloads API
     
    •  
  •  
     Runtime Activities API
     
     
    Laufende und abgeschlossene Aktivitäten (Skripte, Ketten, Cron, Tasks).
     
     Runtime Activities
     
    •  
  •  
    :material-websocket: WebSocket Events
     
     
    Pipeline-, Queue-, Disk-, Settings-, Cron-, Converter- und Download-Events.
     
     WebSocket
     
    •  
 
 
Hinweis
 
Ripster hat keine eingebaute Authentifizierung und ist für lokalen, geschützten Betrieb gedacht.
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/api/pipeline/index.html b/site/api/pipeline/index.html
index 72da9f4..1c751ea 100644
--- a/site/api/pipeline/index.html
+++ b/site/api/pipeline/index.html
@@ -1,4 +1,4 @@
- Pipeline API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Pipeline API
 
Endpunkte zur Steuerung des Pipeline-Workflows.
 
 
GET /api/pipeline/state
 
Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.
 
Response (Beispiel):
 
{
+ Pipeline API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Pipeline API
 
Endpunkte zur Steuerung des Pipeline-Workflows.
 
 
GET /api/pipeline/state
 
Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.
 
Response (Beispiel):
 
{
   "pipeline": {
     "state": "READY_TO_ENCODE",
     "activeJobId": 42,
diff --git a/site/api/runtime-activities/index.html b/site/api/runtime-activities/index.html
index 8b902ca..e8b4297 100644
--- a/site/api/runtime-activities/index.html
+++ b/site/api/runtime-activities/index.html
@@ -1,4 +1,4 @@
- Runtime Activities API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Runtime Activities API
 
Ripster verfolgt alle laufenden und kürzlich abgeschlossenen Aktivitäten (Skripte, Skript-Ketten, Cron-Jobs, interne Tasks) in Echtzeit über den RuntimeActivityService.
 
 
Übersicht
 
Aktivitäten entstehen, wenn Ripster intern Aktionen ausführt – z. B. beim Start eines Cron-Jobs, beim Ausführen einer Skript-Kette oder beim Durchlaufen von Pipeline-Schritten. Sie sind nicht persistent (kein DB-Speicher) und werden nur im Arbeitsspeicher gehalten.
 
     
  • Aktive Aktivitäten (active): Laufen gerade.
    •  
  • Letzte Aktivitäten (recent): Abgeschlossen, max. 120 Einträge.
    •  
 
Änderungen werden über WebSocket (RUNTIME_ACTIVITY_CHANGED) in Echtzeit gesendet.
 
 
Aktivitäts-Objekt
 
{
+ Runtime Activities API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Runtime Activities API
 
Ripster verfolgt alle laufenden und kürzlich abgeschlossenen Aktivitäten (Skripte, Skript-Ketten, Cron-Jobs, interne Tasks) in Echtzeit über den RuntimeActivityService.
 
 
Übersicht
 
Aktivitäten entstehen, wenn Ripster intern Aktionen ausführt – z. B. beim Start eines Cron-Jobs, beim Ausführen einer Skript-Kette oder beim Durchlaufen von Pipeline-Schritten. Sie sind nicht persistent (kein DB-Speicher) und werden nur im Arbeitsspeicher gehalten.
 
     
  • Aktive Aktivitäten (active): Laufen gerade.
    •  
  • Letzte Aktivitäten (recent): Abgeschlossen, max. 120 Einträge.
    •  
 
Änderungen werden über WebSocket (RUNTIME_ACTIVITY_CHANGED) in Echtzeit gesendet.
 
 
Aktivitäts-Objekt
 
{
   "id": 7,
   "type": "chain",
   "name": "Post-Encode Aufräumen",
diff --git a/site/api/settings/index.html b/site/api/settings/index.html
index 01d70dd..e3c0a87 100644
--- a/site/api/settings/index.html
+++ b/site/api/settings/index.html
@@ -1,4 +1,4 @@
- Settings API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Settings API
 
Endpunkte für Einstellungen, Skripte, Skript-Ketten und User-Presets.
 
 
GET /api/settings
 
Liefert alle Einstellungen kategorisiert.
 
Response (Struktur):
 
{
+ Settings API - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Settings API
 
Endpunkte für Einstellungen, Skripte, Skript-Ketten und User-Presets.
 
 
GET /api/settings
 
Liefert alle Einstellungen kategorisiert.
 
Response (Struktur):
 
{
   "categories": [
     {
       "category": "Pfade",
diff --git a/site/api/websocket/index.html b/site/api/websocket/index.html
index d1caff2..fff50b7 100644
--- a/site/api/websocket/index.html
+++ b/site/api/websocket/index.html
@@ -1,4 +1,4 @@
- WebSocket Events - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
WebSocket Events
 
Ripster sendet Echtzeit-Updates über /ws.
 
 
Verbindung
 
const ws = new WebSocket('ws://localhost:3001/ws');
+ WebSocket Events - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
WebSocket Events
 
Ripster sendet Echtzeit-Updates über /ws.
 
 
Verbindung
 
const ws = new WebSocket('ws://localhost:3001/ws');
 
 ws.onmessage = (event) => {
   const msg = JSON.parse(event.data);
diff --git a/site/appendix/index.html b/site/appendix/index.html
index 824b69d..04a2b40 100644
--- a/site/appendix/index.html
+++ b/site/appendix/index.html
@@ -1 +1 @@
- Technischer Anhang - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Technischer Anhang
 
Dieser Bereich enthält die technische Referenz hinter dem Benutzerhandbuch.
 
Inhalt
 
     
  • Konfiguration
    •  
  • komplette Feldreferenz
    •  
  • Umgebungsvariablen
    •  
  • Pipeline intern
    •  
  • Zustandsmodell
    •  
  • Encode-Planung
    •  
  • Playlist-Analyse
    •  
  • Pre-/Post-Encode-Ausführungen
    •  
  • API-Referenz
    •  
  • REST-Endpunkte
    •  
  • WebSocket-Events
    •  
  • Architektur
    •  
  • Backend-/Frontend-Aufbau
    •  
  • Datenbank
    •  
  • Deployment
    •  
  • Betrieb in Entwicklung und Produktion
    •  
  • Externe Tools
    •  
  • MakeMKV, HandBrake, MediaInfo
    •  
 
Wann du in den Anhang wechselst
 
     
  • du integrierst Ripster mit anderen Systemen
    •  
  • du betreibst mehrere Instanzen oder willst tiefer debuggen
    •  
  • du brauchst Feld-/API-/Schema-Details für Automatisierung
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Technischer Anhang - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Technischer Anhang
 
Dieser Bereich enthält die technische Referenz hinter dem Benutzerhandbuch.
 
Inhalt
 
     
  • Konfiguration
    •  
  • komplette Feldreferenz
    •  
  • Umgebungsvariablen
    •  
  • Pipeline intern
    •  
  • Zustandsmodell
    •  
  • Encode-Planung
    •  
  • Playlist-Analyse
    •  
  • Pre-/Post-Encode-Ausführungen
    •  
  • API-Referenz
    •  
  • REST-Endpunkte
    •  
  • WebSocket-Events
    •  
  • Architektur
    •  
  • Backend-/Frontend-Aufbau
    •  
  • Datenbank
    •  
  • Deployment
    •  
  • Betrieb in Entwicklung und Produktion
    •  
  • Externe Tools
    •  
  • MakeMKV, HandBrake, MediaInfo
    •  
 
Wann du in den Anhang wechselst
 
     
  • du integrierst Ripster mit anderen Systemen
    •  
  • du betreibst mehrere Instanzen oder willst tiefer debuggen
    •  
  • du brauchst Feld-/API-/Schema-Details für Automatisierung
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/architecture/backend/index.html b/site/architecture/backend/index.html
index b46e420..57f0b9e 100644
--- a/site/architecture/backend/index.html
+++ b/site/architecture/backend/index.html
@@ -1 +1 @@
- Backend-Services - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Backend-Services
 
Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung über ein Plugin-System.
 
 
Plugin-System (src/plugins/)
 
Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
 
Basisklassen
 
     
  • PluginBase.js — Abstrakte Basisklasse SourcePlugin mit Lifecycle-Methoden
    •  
  • PluginRegistry.js — Dynamische Plugin-Erkennung, prioritätsbasierte Auswahl, Settings-Schema-Aggregation
    •  
  • PluginContext.js — Ausführungskontext (Logger, Callbacks, Signals) für Plugin-Aufrufe
    •  
 
Plugin-Lifecycle
 
Jedes Plugin implementiert die folgenden Methoden:
 
  
 Methode Beschreibung 
   
 detect(discInfo) Medientyp-Erkennung 
 
 analyze(devicePath, job, ctx) Analyse / Metadaten-Extraktion 
 
 rip(job, ctx) Rohdaten-Extraktion 
 
 review(job, ctx) Optionale Vorschau-Vorbereitung 
 
 encode(job, ctx) Finales Encoding/Konvertierung 
 
 finalize(job, ctx) Nachbearbeitung 
 
 onCancel(job, ctx) Bereinigung bei Abbruch 
 
 onRetry(job, ctx) Zustand-Reset vor Retry 
  
 
Implementierte Plugins
 
     
  • BluRayPlugin.js — Blu-ray via MakeMKV (Backup-Modus)
    •  
  • DVDPlugin.js — DVD via MakeMKV (MKV-Modus)
    •  
  • CdPlugin.js — Audio-CD via cdparanoia + FFmpeg (experimentell)
    •  
  • AudiobookPlugin.js — AAX/M4B via FFmpeg mit Kapitel-Splitting
    •  
  • ConverterPlugin.js — Generische Audio/Video-Konvertierung via FFmpeg
    •  
  • VideoDiscPlugin.js — Gemeinsame Basis für Blu-ray/DVD (MediaInfo-Parsing)
    •  
 
 
pipelineService.js
 
Zentrale Workflow-Orchestrierung.
 
Aufgaben:
 
     
  • Pipeline-State-Machine + Persistenz (pipeline_state)
    •  
  • Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
    •  
  • Queue-Management (Jobs + script|chain|wait Einträge)
    •  
  • Retry/Re-Encode/Restart-Flows
    •  
  • WebSocket-Broadcasts für State/Progress/Queue
    •  
  • Converter-Job-Verwaltung (createConverterJobFromEntry, uploadConverterFiles, startConverterJob)
    •  
 
Wichtige Methoden:
 
     
  • analyzeDisc()
    •  
  • selectMetadata()
    •  
  • startPreparedJob()
    •  
  • confirmEncodeReview()
    •  
  • cancel()
    •  
  • retry()
    •  
  • reencodeFromRaw()
    •  
  • restartReviewFromRaw()
    •  
  • restartEncodeWithLastSettings()
    •  
  • resumeReadyToEncodeJob()
    •  
  • enqueueNonJobEntry(), reorderQueue(), removeQueueEntry()
    •  
  • createConverterJobFromEntry(), createConverterJobsFromSelection()
    •  
  • uploadConverterFiles(), startConverterJob()
    •  
 
 
diskDetectionService.js
 
Pollt Laufwerk(e) und emittiert:
 
     
  • discInserted
    •  
  • discRemoved
    •  
  • error
    •  
 
Zusatz:
 
     
  • Modus auto oder explicit
    •  
  • heuristische mediaProfile-Erkennung (bluray/dvd/other)
    •  
  • rescanAndEmit() für manuellen Trigger
    •  
 
 
settingsService.js
 
Settings-Layer mit Validation/Serialisierung.
 
Features:
 
     
  • getCategorizedSettings() für UI-Form
    •  
  • setSettingValue() / setSettingsBulk()
    •  
  • profilspezifische Auflösung (resolveEffectiveToolSettings)
    •  
  • CLI-Config-Building für MakeMKV/HandBrake/MediaInfo/FFmpeg
    •  
  • HandBrake-Preset-Liste via HandBrakeCLI -z
    •  
  • MakeMKV-Registration-Command aus makemkv_registration_key
    •  
  • Pfadauflösung für alle Medienprofile inkl. Audiobook und Converter
    •  
 
 
historyService.js
 
Historie + Dateioperationen.
 
Features:
 
     
  • Job-Liste/Detail inkl. Log-Tail
    •  
  • Orphan-RAW-Erkennung und Import
    •  
  • OMDb-Nachzuweisung
    •  
  • Dateilöschung (raw|movie|both)
    •  
  • Job-Löschung (none|raw|movie|both)
    •  
 
 
audiobookService.js
 
Audiobook-Verarbeitung (AAX/M4B).
 
Features:
 
     
  • FFprobe-basierte Analyse (Kapitel, Metadaten)
    •  
  • FFmpeg-basiertes Encoding mit Kapitel-Splitting
    •  
  • Ausgabeformate: M4B, MP3, FLAC
    •  
  • Template-basierte Pfade ({author}, {title}, {year}, {narrator}, {series}, {part})
    •  
 
 
activationBytesService.js
 
Verwaltung von Audible-Activation-Bytes für AAX-DRM-Handling.
 
Features:
 
     
  • SHA-1-Prüfsumme der AAX-Datei berechnen
    •  
  • Activation Bytes in aax_activation_bytes-Tabelle cachen
    •  
  • Lookup via audnexService (wenn konfiguriert)
    •  
 
 
converterScanService.js
 
Dateisystem-Überwachung des Converter-Eingangsordners.
 
Features:
 
     
  • Vollständiger FS-Baum (getTree())
    •  
  • DB-basierter Datei-Explorer (getEntries())
    •  
  • Manueller und automatischer Scan (Polling)
    •  
  • Pfad-Normalisierung mit Traversal-Schutz
    •  
  • WebSocket-Broadcast: CONVERTER_SCAN_UPDATE
    •  
 
 
downloadService.js
 
Download-Queue für Ausgabedateien aus der Historie.
 
Features:
 
     
  • Job in Download-Queue einreihen (enqueueHistoryJob)
    •  
  • ZIP-Archiv aus Ausgabedateien erstellen (archiver)
    •  
  • Datei-Streaming via res.download()
    •  
  • WebSocket-Broadcast: DOWNLOADS_UPDATED bei Status-Änderungen
    •  
  • Download-Item löschen
    •  
 
 
cronService.js
 
Integriertes Cron-System ohne externe Parser-Library.
 
Features:
 
     
  • 5-Feld-Cron-Parser + nextRun-Berechnung
    •  
  • Quellen: script oder chain
    •  
  • Laufzeitlogs (cron_run_logs)
    •  
  • manuelles Triggern
    •  
  • WebSocket-Events: CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
 
 
runtimeActivityService.js
 
In-Memory-Tracking aller laufenden und kürzlich abgeschlossenen Aktivitäten (Skripte, Ketten, Cron-Jobs, Tasks).
 
Features:
 
     
  • startActivity(type, payload) → Aktivität registrieren, ID zurückgeben
    •  
  • updateActivity(id, patch) → Laufende Aktivität aktualisieren
    •  
  • completeActivity(id, payload) → Aktivität abschließen und in recent verschieben
    •  
  • setControls(id, { cancel, nextStep }) → Steuer-Handler registrieren (für canCancel/canNextStep)
    •  
  • requestCancel(id) / requestNextStep(id) → Steuer-Handler aufrufen
    •  
  • clearRecent() → Abgeschlossene Aktivitäten löschen
    •  
  • getSnapshot() → Snapshot mit active + recent + updatedAt
    •  
  • Broadcasts RUNTIME_ACTIVITY_CHANGED über WebSocket bei jeder Änderung
    •  
 
Limits:
 
     
  • recent max. 120 Einträge
    •  
  • stdout/stderr/output max. 12.000 Zeichen
    •  
  • message/errorMessage max. 2.000 Zeichen
    •  
 
Vollständige API-Dokumentation: Runtime Activities API
 
 
Weitere Services
 
     
  • scriptService.js (CRUD + Test + Wrapper-Ausführung)
    •  
  • scriptChainService.js (CRUD + Step-Execution)
    •  
  • userPresetService.js (HandBrake User-Presets)
    •  
  • hardwareMonitorService.js (CPU/RAM/GPU/Storage)
    •  
  • websocketService.js (Client-Registry + Broadcast)
    •  
  • notificationService.js (PushOver)
    •  
  • cdRipService.js (CD-Ripping mit cdparanoia)
    •  
  • musicBrainzService.js (MusicBrainz-Metadaten-Lookup)
    •  
  • audnexService.js (Audnex-API für Audiobook-Metadaten)
    •  
  • coverArtRecoveryService.js (Cover-Art-Wiederherstellung)
    •  
  • thumbnailService.js (Vorschaubild-Generierung)
    •  
  • omdbService.js (OMDb-Metadaten-Suche)
    •  
  • logger.js (rotierende Datei-Logs)
    •  
 
 
Bootstrapping (src/index.js)
 
Beim Start:
 
     
  1. DB init/migrate
    2.  
  2. Pipeline-Init (inkl. Plugin-Registry)
    3.  
  3. Cron-Init
    4.  
  4. Express-Routes + Error-Handler
    5.  
  5. WebSocket-Server auf /ws
    6.  
  6. Hardware-Monitoring-Init
    7.  
  7. Disk-Detection-Start
    8.  
  8. Converter-Scan-Service-Init (Polling falls aktiviert)
    9.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Backend-Services - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Backend-Services
 
Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung über ein Plugin-System.
 
 
Plugin-System (src/plugins/)
 
Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
 
Basisklassen
 
     
  • PluginBase.js — Abstrakte Basisklasse SourcePlugin mit Lifecycle-Methoden
    •  
  • PluginRegistry.js — Dynamische Plugin-Erkennung, prioritätsbasierte Auswahl, Settings-Schema-Aggregation
    •  
  • PluginContext.js — Ausführungskontext (Logger, Callbacks, Signals) für Plugin-Aufrufe
    •  
 
Plugin-Lifecycle
 
Jedes Plugin implementiert die folgenden Methoden:
 
  
 Methode Beschreibung 
   
 detect(discInfo) Medientyp-Erkennung 
 
 analyze(devicePath, job, ctx) Analyse / Metadaten-Extraktion 
 
 rip(job, ctx) Rohdaten-Extraktion 
 
 review(job, ctx) Optionale Vorschau-Vorbereitung 
 
 encode(job, ctx) Finales Encoding/Konvertierung 
 
 finalize(job, ctx) Nachbearbeitung 
 
 onCancel(job, ctx) Bereinigung bei Abbruch 
 
 onRetry(job, ctx) Zustand-Reset vor Retry 
  
 
Implementierte Plugins
 
     
  • BluRayPlugin.js — Blu-ray via MakeMKV (Backup-Modus)
    •  
  • DVDPlugin.js — DVD via MakeMKV (MKV-Modus)
    •  
  • CdPlugin.js — Audio-CD via cdparanoia + FFmpeg (experimentell)
    •  
  • AudiobookPlugin.js — AAX/M4B via FFmpeg mit Kapitel-Splitting
    •  
  • ConverterPlugin.js — Generische Audio/Video-Konvertierung via FFmpeg
    •  
  • VideoDiscPlugin.js — Gemeinsame Basis für Blu-ray/DVD (MediaInfo-Parsing)
    •  
 
 
pipelineService.js
 
Zentrale Workflow-Orchestrierung.
 
Aufgaben:
 
     
  • Pipeline-State-Machine + Persistenz (pipeline_state)
    •  
  • Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
    •  
  • Queue-Management (Jobs + script|chain|wait Einträge)
    •  
  • Retry/Re-Encode/Restart-Flows
    •  
  • WebSocket-Broadcasts für State/Progress/Queue
    •  
  • Converter-Job-Verwaltung (createConverterJobFromEntry, uploadConverterFiles, startConverterJob)
    •  
 
Wichtige Methoden:
 
     
  • analyzeDisc()
    •  
  • selectMetadata()
    •  
  • startPreparedJob()
    •  
  • confirmEncodeReview()
    •  
  • cancel()
    •  
  • retry()
    •  
  • reencodeFromRaw()
    •  
  • restartReviewFromRaw()
    •  
  • restartEncodeWithLastSettings()
    •  
  • resumeReadyToEncodeJob()
    •  
  • enqueueNonJobEntry(), reorderQueue(), removeQueueEntry()
    •  
  • createConverterJobFromEntry(), createConverterJobsFromSelection()
    •  
  • uploadConverterFiles(), startConverterJob()
    •  
 
 
diskDetectionService.js
 
Pollt Laufwerk(e) und emittiert:
 
     
  • discInserted
    •  
  • discRemoved
    •  
  • error
    •  
 
Zusatz:
 
     
  • Modus auto oder explicit
    •  
  • heuristische mediaProfile-Erkennung (bluray/dvd/other)
    •  
  • rescanAndEmit() für manuellen Trigger
    •  
 
 
settingsService.js
 
Settings-Layer mit Validation/Serialisierung.
 
Features:
 
     
  • getCategorizedSettings() für UI-Form
    •  
  • setSettingValue() / setSettingsBulk()
    •  
  • profilspezifische Auflösung (resolveEffectiveToolSettings)
    •  
  • CLI-Config-Building für MakeMKV/HandBrake/MediaInfo/FFmpeg
    •  
  • HandBrake-Preset-Liste via HandBrakeCLI -z
    •  
  • MakeMKV-Key-Synchronisation aus makemkv_registration_key nach ~/.MakeMKV/settings.conf
    •  
  • Pfadauflösung für alle Medienprofile inkl. Audiobook und Converter
    •  
 
 
historyService.js
 
Historie + Dateioperationen.
 
Features:
 
     
  • Job-Liste/Detail inkl. Log-Tail
    •  
  • Orphan-RAW-Erkennung und Import
    •  
  • OMDb-Nachzuweisung
    •  
  • Dateilöschung (raw|movie|both)
    •  
  • Job-Löschung (none|raw|movie|both)
    •  
 
 
audiobookService.js
 
Audiobook-Verarbeitung (AAX/M4B).
 
Features:
 
     
  • FFprobe-basierte Analyse (Kapitel, Metadaten)
    •  
  • FFmpeg-basiertes Encoding mit Kapitel-Splitting
    •  
  • Ausgabeformate: M4B, MP3, FLAC
    •  
  • Template-basierte Pfade ({author}, {title}, {year}, {narrator}, {series}, {part})
    •  
 
 
activationBytesService.js
 
Verwaltung von Audible-Activation-Bytes für AAX-DRM-Handling.
 
Features:
 
     
  • SHA-1-Prüfsumme der AAX-Datei berechnen
    •  
  • Activation Bytes in aax_activation_bytes-Tabelle cachen
    •  
  • Lookup via audnexService (wenn konfiguriert)
    •  
 
 
converterScanService.js
 
Dateisystem-Überwachung des Converter-Eingangsordners.
 
Features:
 
     
  • Vollständiger FS-Baum (getTree())
    •  
  • DB-basierter Datei-Explorer (getEntries())
    •  
  • Manueller und automatischer Scan (Polling)
    •  
  • Pfad-Normalisierung mit Traversal-Schutz
    •  
  • WebSocket-Broadcast: CONVERTER_SCAN_UPDATE
    •  
 
 
downloadService.js
 
Download-Queue für Ausgabedateien aus der Historie.
 
Features:
 
     
  • Job in Download-Queue einreihen (enqueueHistoryJob)
    •  
  • ZIP-Archiv aus Ausgabedateien erstellen (archiver)
    •  
  • Datei-Streaming via res.download()
    •  
  • WebSocket-Broadcast: DOWNLOADS_UPDATED bei Status-Änderungen
    •  
  • Download-Item löschen
    •  
 
 
cronService.js
 
Integriertes Cron-System ohne externe Parser-Library.
 
Features:
 
     
  • 5-Feld-Cron-Parser + nextRun-Berechnung
    •  
  • Quellen: script oder chain
    •  
  • Laufzeitlogs (cron_run_logs)
    •  
  • manuelles Triggern
    •  
  • WebSocket-Events: CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
 
 
runtimeActivityService.js
 
In-Memory-Tracking aller laufenden und kürzlich abgeschlossenen Aktivitäten (Skripte, Ketten, Cron-Jobs, Tasks).
 
Features:
 
     
  • startActivity(type, payload) → Aktivität registrieren, ID zurückgeben
    •  
  • updateActivity(id, patch) → Laufende Aktivität aktualisieren
    •  
  • completeActivity(id, payload) → Aktivität abschließen und in recent verschieben
    •  
  • setControls(id, { cancel, nextStep }) → Steuer-Handler registrieren (für canCancel/canNextStep)
    •  
  • requestCancel(id) / requestNextStep(id) → Steuer-Handler aufrufen
    •  
  • clearRecent() → Abgeschlossene Aktivitäten löschen
    •  
  • getSnapshot() → Snapshot mit active + recent + updatedAt
    •  
  • Broadcasts RUNTIME_ACTIVITY_CHANGED über WebSocket bei jeder Änderung
    •  
 
Limits:
 
     
  • recent max. 120 Einträge
    •  
  • stdout/stderr/output max. 12.000 Zeichen
    •  
  • message/errorMessage max. 2.000 Zeichen
    •  
 
Vollständige API-Dokumentation: Runtime Activities API
 
 
Weitere Services
 
     
  • scriptService.js (CRUD + Test + Wrapper-Ausführung)
    •  
  • scriptChainService.js (CRUD + Step-Execution)
    •  
  • userPresetService.js (HandBrake User-Presets)
    •  
  • hardwareMonitorService.js (CPU/RAM/GPU/Storage)
    •  
  • websocketService.js (Client-Registry + Broadcast)
    •  
  • notificationService.js (PushOver)
    •  
  • cdRipService.js (CD-Ripping mit cdparanoia)
    •  
  • musicBrainzService.js (MusicBrainz-Metadaten-Lookup)
    •  
  • audnexService.js (Audnex-API für Audiobook-Metadaten)
    •  
  • coverArtRecoveryService.js (Cover-Art-Wiederherstellung)
    •  
  • thumbnailService.js (Vorschaubild-Generierung)
    •  
  • omdbService.js (OMDb-Metadaten-Suche)
    •  
  • logger.js (rotierende Datei-Logs)
    •  
 
 
Bootstrapping (src/index.js)
 
Beim Start:
 
     
  1. DB init/migrate
    2.  
  2. Pipeline-Init (inkl. Plugin-Registry)
    3.  
  3. Cron-Init
    4.  
  4. Express-Routes + Error-Handler
    5.  
  5. WebSocket-Server auf /ws
    6.  
  6. Hardware-Monitoring-Init
    7.  
  7. Disk-Detection-Start
    8.  
  8. Converter-Scan-Service-Init (Polling falls aktiviert)
    9.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/architecture/database/index.html b/site/architecture/database/index.html
index 2daa0a6..c5d4aec 100644
--- a/site/architecture/database/index.html
+++ b/site/architecture/database/index.html
@@ -1,4 +1,4 @@
- Datenbank - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Datenbank
 
Ripster verwendet SQLite (backend/data/ripster.db).
 
 
Tabellen
 
settings_schema
+ Datenbank - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Datenbank
 
Ripster verwendet SQLite (backend/data/ripster.db).
 
 
Tabellen
 
settings_schema
 settings_values
 jobs
 job_lineage_artifacts
diff --git a/site/architecture/frontend/index.html b/site/architecture/frontend/index.html
index d7d2991..c07cf6c 100644
--- a/site/architecture/frontend/index.html
+++ b/site/architecture/frontend/index.html
@@ -1,4 +1,4 @@
- Frontend-Komponenten - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Frontend-Komponenten
 
Frontend: React + PrimeReact + Vite.
 
 
Hauptseiten
 
JobsInboxPage.jsx
 
Zentrale Job-Inbox:
 
     
  • einheitliche Liste über Ripper-, Converter- und Audiobook-Jobs
    •  
  • View-/Status-Filter, Suche, Paginierung
    •  
  • Schnellsprung in passende Detailseite (Ripper/Converter)
    •  
 
RipperPage.jsx
 
Pipeline-Steuerung:
 
     
  • Status/Progress/ETA
    •  
  • Metadaten-Dialog
    •  
  • Playlist-Entscheidung
    •  
  • Review-Panel (Track-Auswahl)
    •  
  • Queue-Interaktion (reorder/add/remove)
    •  
  • Job-Aktionen (Start/Cancel/Retry/Re-Encode)
    •  
  • Hardware-Monitoring-Anzeige
    •  
  • Aktivitäts-Tracking (Skripte, Ketten, Cron)
    •  
 
SettingsPage.jsx
 
Konfiguration:
 
     
  • dynamisches Settings-Formular (DynamicSettingsForm)
    •  
  • Skripte/Ketten inkl. Reorder/Test
    •  
  • User-Presets
    •  
  • Cron-Jobs (CronJobsTab)
    •  
 
HistoryPage.jsx
 
Historie:
 
     
  • Job-Liste/Filter
    •  
  • Job-Details + Logs
    •  
  • OMDb-Nachzuweisung
    •  
  • Re-Encode/Restart-Workflows
    •  
 
ConverterPage.jsx
 
Datei-Converter:
 
     
  • Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
    •  
  • Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
    •  
  • Dateiverwaltung: Umbenennen, Verschieben, Löschen, Ordner erstellen
    •  
  • Jobs aus Dateiauswahl erstellen
    •  
  • Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
    •  
  • Job-Start, Abbruch, Löschung
    •  
  • Automatischer Scan-Status
    •  
 
AudiobooksPage.jsx
 
Dedizierter AAX-/Audiobook-Flow:
 
     
  • Upload-Panel für AAX-Dateien
    •  
  • aktive Audiobook-Jobkarten mit Start/Cancel/Retry/Delete
    •  
  • Audiobook-Konfigurationspanel und Output-Explorer
    •  
 
DownloadsPage.jsx
 
Download-Queue:
 
     
  • Ausgabedateien aus der Job-Historie in die Queue einreihen
    •  
  • Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
    •  
  • Dateien als ZIP herunterladen
    •  
  • Download-Einträge löschen
    •  
 
DatabasePage.jsx
 
Expert-Modus:
 
     
  • Tabellarische Rohsicht der Job-Datenbank
    •  
  • Orphan-RAW-Import
    •  
 
 
Wichtige Komponenten
 
     
  • PipelineStatusCard.jsx — Pipeline-Status-Anzeige mit Progress
    •  
  • MetadataSelectionDialog.jsx — OMDb-Metadaten-Auswahl
    •  
  • MediaInfoReviewPanel.jsx — Track-Auswahl-Interface (Video/Audio/Untertitel)
    •  
  • JobDetailDialog.jsx — Job-Detailansicht mit Logs
    •  
  • CronJobsTab.jsx — Cron-Job-Verwaltung
    •  
  • DynamicSettingsForm.jsx — Schema-gesteuertes Einstellungsformular
    •  
  • ConverterJobCard.jsx — Converter-Job-Darstellung
    •  
  • CdRipConfigPanel.jsx — Konfiguration für Audio-CD-Ripping
    •  
 
 
API-Client (api/client.js)
 
     
  • zentraler request() mit JSON-Handling
    •  
  • Fehlerobjekt aus API wird auf Error(message) gemappt
    •  
  • VITE_API_BASE default /api
    •  
 
 
WebSocket (hooks/useWebSocket.js)
 
     
  • URL: VITE_WS_URL oder automatisch ws(s)://<host>/ws
    •  
  • Auto-Reconnect mit 1500ms Intervall
    •  
 
In App.jsx werden u. a. verarbeitet:
 
     
  • PIPELINE_STATE_CHANGED
    •  
  • PIPELINE_PROGRESS
    •  
  • PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt / Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • DOWNLOADS_UPDATED
    •  
  • CONVERTER_SCAN_UPDATE
    •  
  • RUNTIME_ACTIVITY_CHANGED
    •  
 
 
Build/Run
 
# dev
+ Frontend-Komponenten - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Frontend-Komponenten
 
Frontend: React + PrimeReact + Vite.
 
 
Hauptseiten
 
RipperPage.jsx
 
Pipeline-Steuerung:
 
     
  • Status/Progress/ETA
    •  
  • Metadaten-Dialog
    •  
  • Playlist-Entscheidung
    •  
  • Review-Panel (Track-Auswahl)
    •  
  • Queue-Interaktion (reorder/add/remove)
    •  
  • Job-Aktionen (Start/Cancel/Retry/Re-Encode)
    •  
  • Hardware-Monitoring-Anzeige
    •  
  • Aktivitäts-Tracking (Skripte, Ketten, Cron)
    •  
 
SettingsPage.jsx
 
Konfiguration:
 
     
  • dynamisches Settings-Formular (DynamicSettingsForm)
    •  
  • Skripte/Ketten inkl. Reorder/Test
    •  
  • User-Presets
    •  
  • Cron-Jobs (CronJobsTab)
    •  
 
HistoryPage.jsx
 
Historie:
 
     
  • Job-Liste/Filter
    •  
  • Job-Details + Logs
    •  
  • OMDb-Nachzuweisung
    •  
  • Re-Encode/Restart-Workflows
    •  
 
ConverterPage.jsx
 
Datei-Converter:
 
     
  • Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
    •  
  • Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
    •  
  • Dateiverwaltung: Umbenennen, Verschieben, Löschen, Ordner erstellen
    •  
  • Jobs aus Dateiauswahl erstellen
    •  
  • Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
    •  
  • Job-Start, Abbruch, Löschung
    •  
  • Automatischer Scan-Status
    •  
 
AudiobooksPage.jsx
 
Dedizierter AAX-/Audiobook-Flow:
 
     
  • Upload-Panel für AAX-Dateien
    •  
  • aktive Audiobook-Jobkarten mit Start/Cancel/Retry/Delete
    •  
  • Audiobook-Konfigurationspanel und Output-Explorer
    •  
 
DownloadsPage.jsx
 
Download-Queue:
 
     
  • Ausgabedateien aus der Job-Historie in die Queue einreihen
    •  
  • Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
    •  
  • Dateien als ZIP herunterladen
    •  
  • Download-Einträge löschen
    •  
 
DatabasePage.jsx
 
Expert-Modus:
 
     
  • Tabellarische Rohsicht der Job-Datenbank
    •  
  • Orphan-RAW-Import
    •  
 
 
Wichtige Komponenten
 
     
  • PipelineStatusCard.jsx — Pipeline-Status-Anzeige mit Progress
    •  
  • MetadataSelectionDialog.jsx — OMDb-Metadaten-Auswahl
    •  
  • MediaInfoReviewPanel.jsx — Track-Auswahl-Interface (Video/Audio/Untertitel)
    •  
  • JobDetailDialog.jsx — Job-Detailansicht mit Logs
    •  
  • CronJobsTab.jsx — Cron-Job-Verwaltung
    •  
  • DynamicSettingsForm.jsx — Schema-gesteuertes Einstellungsformular
    •  
  • ConverterJobCard.jsx — Converter-Job-Darstellung
    •  
  • CdRipConfigPanel.jsx — Konfiguration für Audio-CD-Ripping
    •  
 
 
API-Client (api/client.js)
 
     
  • zentraler request() mit JSON-Handling
    •  
  • Fehlerobjekt aus API wird auf Error(message) gemappt
    •  
  • VITE_API_BASE default /api
    •  
 
 
WebSocket (hooks/useWebSocket.js)
 
     
  • URL: VITE_WS_URL oder automatisch ws(s)://<host>/ws
    •  
  • Auto-Reconnect mit 1500ms Intervall
    •  
 
In App.jsx werden u. a. verarbeitet:
 
     
  • PIPELINE_STATE_CHANGED
    •  
  • PIPELINE_PROGRESS
    •  
  • PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt / Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • DOWNLOADS_UPDATED
    •  
  • CONVERTER_SCAN_UPDATE
    •  
  • RUNTIME_ACTIVITY_CHANGED
    •  
 
 
Build/Run
 
# dev
 npm run dev --prefix frontend
 
 # prod build
diff --git a/site/architecture/index.html b/site/architecture/index.html
index fe955e0..a777f96 100644
--- a/site/architecture/index.html
+++ b/site/architecture/index.html
@@ -1,4 +1,4 @@
- Anhang: Architektur - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Architektur
 
Ripster ist eine Client-Server-Anwendung mit REST + WebSocket und externen CLI-Tools.
 
 
Systemüberblick
 
graph TB
+ Anhang: Architektur - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Architektur
 
Ripster ist eine Client-Server-Anwendung mit REST + WebSocket und externen CLI-Tools.
 
 
Systemüberblick
 
graph TB
     subgraph Browser["Browser (React)"]
         Ripper[Ripper]
         Settings[Einstellungen]
diff --git a/site/architecture/overview/index.html b/site/architecture/overview/index.html
index c526f6e..916a908 100644
--- a/site/architecture/overview/index.html
+++ b/site/architecture/overview/index.html
@@ -1,4 +1,4 @@
- Übersicht - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Architektur-Übersicht
 
 
Kernprinzipien
 
Event-getriebene Pipeline
 
pipelineService hält einen Snapshot der State-Machine und broadcastet Änderungen sofort via WebSocket.
 
State-Änderung -> PIPELINE_STATE_CHANGED/PIPELINE_PROGRESS -> Frontend-Update
+ Übersicht - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Architektur-Übersicht
 
 
Kernprinzipien
 
Event-getriebene Pipeline
 
pipelineService hält einen Snapshot der State-Machine und broadcastet Änderungen sofort via WebSocket.
 
State-Änderung -> PIPELINE_STATE_CHANGED/PIPELINE_PROGRESS -> Frontend-Update
 
 
Service-Layer
 
Route -> Service -> DB/Tool-Execution
 
 
Routes enthalten kaum Business-Logik.
 
Schema-getriebene Settings
 
Settings sind DB-schema-getrieben (settings_schema + settings_values), UI rendert dynamisch aus diesen Daten.
 
 
Echtzeit-Kommunikation
 
WebSocket läuft auf /ws.
 
Wichtige Events:
 
     
  • PIPELINE_STATE_CHANGED, PIPELINE_PROGRESS, PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt, Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • SETTINGS_UPDATED, SETTINGS_BULK_UPDATED
    •  
  • SETTINGS_SCRIPTS_UPDATED, SETTINGS_SCRIPT_CHAINS_UPDATED, USER_PRESETS_UPDATED
    •  
  • CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
  • PIPELINE_ERROR, DISK_DETECTION_ERROR
    •  
 
 
Prozessausführung
 
Externe Tools werden als Child-Processes gestartet (processRunner):
 
     
  • Streaming von stdout/stderr
    •  
  • Progress-Parsing (progressParsers.js)
    •  
  • kontrollierter Abbruch (SIGINT/SIGKILL-Fallback)
    •  
 
 
Persistenz
 
SQLite-Datei: backend/data/ripster.db
 
Kern-Tabellen:
 
     
  • jobs, pipeline_state
    •  
  • settings_schema, settings_values
    •  
  • scripts, script_chains, script_chain_steps
    •  
  • user_presets
    •  
  • cron_jobs, cron_run_logs
    •  
 
Beim Start werden Schema und Settings-Migrationen automatisch ausgeführt.
 
 
Fehlerbehandlung
 
Zentrales Error-Handling liefert:
 
{
   "error": {
diff --git a/site/configuration/environment/index.html b/site/configuration/environment/index.html
index ebf5467..e7798f5 100644
--- a/site/configuration/environment/index.html
+++ b/site/configuration/environment/index.html
@@ -1,4 +1,4 @@
- Umgebungsvariablen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Umgebungsvariablen
 
Umgebungsvariablen steuern Backend/Vite außerhalb der DB-basierten UI-Settings.
 
 
Backend (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 
  
 
Beispiel:
 
PORT=3001
+ Umgebungsvariablen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Umgebungsvariablen
 
Umgebungsvariablen steuern Backend/Vite außerhalb der DB-basierten UI-Settings.
 
 
Backend (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 
  
 
Beispiel:
 
PORT=3001
 DB_PATH=/var/lib/ripster/ripster.db
 LOG_DIR=/var/log/ripster
 CORS_ORIGIN=http://192.168.1.50:5173
diff --git a/site/configuration/index.html b/site/configuration/index.html
index b96c859..8dbe12a 100644
--- a/site/configuration/index.html
+++ b/site/configuration/index.html
@@ -1 +1 @@
- Anhang: Konfiguration - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Konfiguration
 
Dieser Abschnitt ist die technische Referenz zu allen Konfigurationsarten in Ripster.
 
Inhalte
 
  
 
Zurück zum Handbuch
  
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Anhang: Konfiguration - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Konfiguration
 
Dieser Abschnitt ist die technische Referenz zu allen Konfigurationsarten in Ripster.
 
Inhalte
 
  
 
Zurück zum Handbuch
  
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/configuration/settings-reference/index.html b/site/configuration/settings-reference/index.html
index 5cfd72c..20b4146 100644
--- a/site/configuration/settings-reference/index.html
+++ b/site/configuration/settings-reference/index.html
@@ -1 +1 @@
- Alle Einstellungen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Einstellungsreferenz
 
Diese Seite dokumentiert alle UI-Settings mit ihrer Wirkung auf Flows, Pfade, Queue und Automatisierung.
 
Wie Ripster Settings auflöst
 
Ripster arbeitet intern mit profilspezifischen Settings (bluray, dvd, cd, audiobook) und bildet sie auf effektive Laufzeitwerte ab.
 
Wichtige Regeln:
 
     
  1. Für bluray wird bei fehlenden profilierten Toolwerten auf dvd zurückgefallen, und umgekehrt.
    2.  
  2. Für cd und audiobook gibt es nur das eigene Profil.
    3.  
  3. Strikt profilgebundene Pfadkeys (raw_dir, movie_dir, series_dir plus Owner) fallen bei leeren Werten auf Installationsdefaults zurück.
    4.  
 
Installationsdefaults:
 
     
  • RAW: data/output/raw
    •  
  • Movies: data/output/movies
    •  
  • Series: data/output/series
    •  
  • CD: data/output/cd
    •  
  • Audiobook RAW: data/output/audiobook-raw
    •  
  • Audiobook Output: data/output/audiobooks
    •  
  • Converter RAW: data/output/converter-raw
    •  
  • Converter Video: data/output/converted-movies
    •  
  • Converter Audio: data/output/converted-audio
    •  
 
Kritische Wirkungsbereiche
 
1) Pfad- und Template-Einstellungen
 
Diese Settings bestimmen direkt:
 
     
  • wo RAW landet
    •  
  • wo finale Ausgaben landen
    •  
  • wie Ordner/Dateinamen gerendert werden
    •  
 
Relevante Besonderheiten:
 
     
  • Serien-RAW nutzt bei Serienworkflow bevorzugt raw_dir_*_series.
    •  
  • Serien-Ausgabe nutzt series_dir_* und Serien-Templates (Episode/Multi-Episode).
    •  
  • Film-Ausgabe nutzt movie_dir_* und Film-Template.
    •  
  • Encode schreibt zunächst in Incomplete_job-<id> und finalisiert danach in den Zielpfad.
    •  
 
2) Queue- und Parallelitäts-Settings
 
Die vier Limits greifen kombiniert:
 
     
  • pipeline_max_parallel_jobs (Film/Video-Lane)
    •  
  • pipeline_max_parallel_cd_encodes (Audio/CD-Lane)
    •  
  • pipeline_max_total_encodes (globaler Deckel)
    •  
  • pipeline_cd_bypasses_queue (Audio-Lane darf Filmwarteschlange umgehen)
    •  
 
Effekt:
 
     
  • Film und Audio haben getrennte Lane-Limits.
    •  
  • Das Gesamtlimit überstimmt beide, sobald erreicht.
    •  
  • Queue kann zusätzlich Nicht-Job-Einträge (Skript, Kette, Warten) enthalten.
    •  
 
3) Serien-Metadaten-Settings
 
Diese steuern die Serienqualität direkt:
 
     
  • TMDb-Token aktiviert TMDb-gestützte Serienmetadaten.
    •  
  • Sprache/Fallback-Sprachen beeinflussen Titel- und Episodenauflösung.
    •  
  • Ordnungspräferenz steuert Episode-Order.
    •  
  • Disc-Profile-Reuse verbessert automatische Zuordnung über mehrere Discs.
    •  
 
4) Tool-Settings
 
Toolfelder (makemkv_*, mediainfo_*, handbrake_*, ffmpeg_*, ffprobe_*, cdparanoia_*) wirken unmittelbar auf die tatsächlich ausgeführten CLI-Aufrufe.
 
Typische Auswirkungen:
 
     
  • falscher Toolpfad => früher Pipelinefehler
    •  
  • geänderte Extra-Args => anderes Analyze-/Encode-Verhalten
    •  
  • geänderte Presets => andere HandBrake-Ausgaben
    •  
 
Template-Platzhalter
 
Film-Templates
 
     
  • ${title}, ${year}, ${imdbId}
    •  
 
Serien-Templates
 
     
  • {seriesTitle}, {seasonNr}, {episodeNr}, {episodeNoStart}, {episodeNoEnd}
    •  
  • {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}
    •  
  • führende Null möglich mit {0:seasonNr} etc.
    •  
 
Audiobook-Templates
 
     
  • {author}, {title}, {year}, {narrator}, {series}, {part}, {format}
    •  
 
Converter-Templates
 
     
  • Video: {title}, {year}
    •  
  • Audio: {artist}, {title}, {album}, {year}, {trackNr}
    •  
 
Vollständige Feldliste
 
Kategorie: Benachrichtigungen
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 Expertenmodus ui_expert_mode boolean false Schaltet erweiterte Einstellungen in der UI ein. 
 
 PushOver aktiviert pushover_enabled boolean false Master-Schalter für PushOver Versand. 
 
 PushOver Token pushover_token string leer Application Token für PushOver. 
 
 PushOver User pushover_user string leer User-Key für PushOver. 
 
 PushOver Device (optional) pushover_device string leer Optionales Ziel-Device in PushOver. 
 
 PushOver Titel-Präfix pushover_title_prefix string Ripster Prefix im PushOver Titel. 
 
 PushOver Priority pushover_priority number 0 Priorität -2 bis 2. 
 
 PushOver Timeout (ms) pushover_timeout_ms number 7000 HTTP Timeout für PushOver Requests. 
 
 Bei Metadaten-Auswahl senden pushover_notify_metadata_ready boolean true Sendet wenn Metadaten zur Auswahl bereitstehen. 
 
 Bei Rip-Start senden pushover_notify_rip_started boolean true Sendet beim Start des MakeMKV-Rips. 
 
 Bei Encode-Start senden pushover_notify_encoding_started boolean true Sendet beim Start von HandBrake. 
 
 Bei Erfolg senden pushover_notify_job_finished boolean true Sendet bei erfolgreich abgeschlossenem Job. 
 
 Bei Fehler senden pushover_notify_job_error boolean true Sendet bei Fehlern in der Pipeline. 
 
 Bei Abbruch senden pushover_notify_job_cancelled boolean true Sendet wenn Job manuell abgebrochen wurde. 
 
 Bei Re-Encode Start senden pushover_notify_reencode_started boolean true Sendet beim Start von RAW Re-Encode. 
 
 Bei Re-Encode Erfolg senden pushover_notify_reencode_finished boolean true Sendet bei erfolgreichem RAW Re-Encode. 
  
 
Kategorie: Converter
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 Erlaubte Datei-Endungen* converter_scan_extensions string mkv,mp4,m2ts,iso,avi,mov,flac,mp3,wav,m4a,ogg,opus Erlaubte Datei-Endungen für den Converter-Scan (ohne Punkt). Wird in der UI als Checkbox-Liste gepflegt. 
 
 Auto-Scan (Polling) converter_polling_enabled boolean false Converter Raw-Ordner automatisch in regelmäßigen Abständen scannen. 
 
 Polling-Intervall (Sekunden) converter_polling_interval number 300 Intervall für automatischen Scan des Converter-Ordners. 
  
 
Kategorie: Laufwerk
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 Laufwerksmodus drive_mode select auto Auto-Discovery oder explizites Device. 
 
 Device Pfad drive_device path /dev/sr0 Nur für expliziten Modus, z.B. /dev/sr0. 
 
 MakeMKV Source Index makemkv_source_index number 0 Disc Index im Auto-Modus. 
 
 Automatische Disk-Erkennung disc_auto_detection_enabled boolean true Wenn deaktiviert, findet keine automatische Laufwerksprüfung statt. Neue Disks werden nur per "Laufwerk neu lesen" erkannt. 
 
 Polling Intervall (ms) disc_poll_interval_ms number 4000 Intervall für Disk-Erkennung. 
  
 
Kategorie: Metadaten
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 OMDb API Key omdb_api_key string leer API Key für Metadatensuche. 
 
 TMDb Read Access Token tmdb_api_read_access_token string leer Read Access Token für Serien-Metadaten über TheMovieDB (TMDb). 
 
 DVD Serien-Sprache dvd_series_language string de-DE Bevorzugte Sprache für Serien-Metadaten im TMDb-Format, z.B. de-DE oder en-US. 
 
 DVD Serien-Fallback-Sprachen dvd_series_fallback_languages string de-DE,en-US Kommagetrennte TMDb-Sprachen für Fallback-Titel, z.B. de-DE,en-US,fr-FR. 
 
 DVD Serien-Ordnung dvd_series_order_preference select episode_group Bevorzugte Episodenordnung für DVD-Serien. Episode Groups nutzen TMDb Alternate Orders, falls vorhanden. 
 
 DVD Disc-Profile wiederverwenden dvd_series_reuse_disc_profiles boolean true Verwendet zuvor bestätigte Disc-Profile erneut, um Episoden automatischer zuzuordnen. 
 
 OMDb Typ omdb_default_type select movie Vorauswahl für Suche. 
 
 MusicBrainz aktiviert musicbrainz_enabled boolean true MusicBrainz-Metadatensuche für CDs aktivieren. 
 
 Coverart-Nachladen aktiv coverart_recovery_enabled boolean true Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen geprüft und nachgeladen. 
 
 Coverart-Prüfintervall (Stunden) coverart_recovery_interval_hours number 6 Intervall für automatische Prüfung fehlender Coverarts in Stunden. 
  
 
Kategorie: Monitoring
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 Hardware Monitoring aktiviert hardware_monitoring_enabled boolean true Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). 
 
 Hardware Monitoring Intervall (ms) hardware_monitoring_interval_ms number 5000 Polling-Intervall für CPU/RAM/GPU/Storage-Metriken. 
  
 
Kategorie: Pfade
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 Raw-Ordner (Blu-ray) raw_dir_bluray path leer RAW-Zielpfad für Blu-ray. Leer = Standardpfad (data/output/raw). 
 
 Raw-Ordner (DVD) raw_dir_dvd path leer RAW-Zielpfad für DVD. Leer = Standardpfad (data/output/raw). 
 
 CD RAW-Ordner raw_dir_cd path leer Basisordner für rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). 
 
 Audiobook RAW-Ordner raw_dir_audiobook path leer Basisordner für hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). 
 
 Serien-Ordner (Blu-ray) series_dir_bluray path leer Zielordner für Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). 
 
 Film-Ordner (Blu-ray) movie_dir_bluray path leer Encode-Zielpfad für Blu-ray. Leer = Standardpfad (data/output/movies). 
 
 Film-Ordner (DVD) movie_dir_dvd path leer Encode-Zielpfad für DVD. Leer = Standardpfad (data/output/movies). 
 
 Serien-Ordner (DVD) series_dir_dvd path leer Zielordner für DVD-Serienfolgen. Leer = Standardpfad (data/output/series). 
 
 CD Output-Ordner movie_dir_cd path leer Zielordner für encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. 
 
 Audiobook Output-Ordner movie_dir_audiobook path leer Zielordner für encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). 
 
 Externe Speicher external_storage_paths path [] Wird links unter "Freie Speicher" angezeigt. 
 
 Log Ordner log_dir path data/logs Basisordner für Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. 
 
 CD Output Template cd_output_template string {artist} - {album} ({year})/{trackNr} {artist} - {title} Template für relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (Blu-ray) output_template_bluray string ${title} (${year})/${title} (${year}) Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (Blu-ray Serie, Episode) output_template_bluray_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Template für einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. 
 
 Output Template (Blu-ray Serie, Multi-Episode) output_template_bluray_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Template für zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. 
 
 Output Template (DVD) output_template_dvd string ${title} (${year})/${title} (${year}) Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (DVD Serie, Episode) output_template_dvd_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Template für einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. 
 
 Output Template (DVD Serie, Multi-Episode) output_template_dvd_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Template für zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. 
 
 Output Template (Audiobook) output_template_audiobook string {author}/{author} - {title} ({year}) Template für relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind über "/" möglich. 
 
 Audiobook RAW Template audiobook_raw_template string {author} - {title} ({year}) Template für relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. 
 
 Converter Raw-Ordner converter_raw_dir path leer Eingangsordner für den Converter (Import-Scan und Datei-Uploads). Jeder Upload erhält einen Unterordner. Leer = Standardpfad (data/output/converter-raw). 
 
 Converter Ausgabe (Video) converter_movie_dir path leer Ausgabepfad für konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). 
 
 Converter Ausgabe (Audio) converter_audio_dir path leer Ausgabepfad für konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). 
 
 Output-Template (Video) converter_output_template_video string {title} Dateiname-Template für konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. 
 
 Output-Template (Audio) converter_output_template_audio string {artist} - {title} Dateiname-Template für konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. 
 
 RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series path leer RAW-Zielpfad für Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). 
 
 Eigentümer RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series_owner string leer Eigentümer der Dateien im Format user:gruppe für Blu-ray-Serien-RAW. Leer = Eigentümer Raw-Ordner (Blu-ray). 
 
 Eigentümer Raw-Ordner (Blu-ray) raw_dir_bluray_owner string leer Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 RAW-Ordner (DVD Serie) raw_dir_dvd_series path leer RAW-Zielpfad für DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). 
 
 Eigentümer RAW-Ordner (DVD Serie) raw_dir_dvd_series_owner string leer Eigentümer der Dateien im Format user:gruppe für DVD-Serien-RAW. Leer = Eigentümer Raw-Ordner (DVD). 
 
 Eigentümer Raw-Ordner (DVD) raw_dir_dvd_owner string leer Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer CD RAW-Ordner raw_dir_cd_owner string leer Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Audiobook RAW-Ordner raw_dir_audiobook_owner string leer Eigentümer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Serien-Ordner (Blu-ray) series_dir_bluray_owner string leer Eigentümer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Film-Ordner (Blu-ray) movie_dir_bluray_owner string leer Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Film-Ordner (DVD) movie_dir_dvd_owner string leer Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Serien-Ordner (DVD) series_dir_dvd_owner string leer Eigentümer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer CD Output-Ordner movie_dir_cd_owner string leer Eigentümer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Audiobook Output-Ordner movie_dir_audiobook_owner string leer Eigentümer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
  
 
Kategorie: Tools
 
  
 GUI-Feld Key Typ Default Wirkung im System 
   
 MakeMKV Kommando makemkv_command string makemkvcon Pfad oder Befehl für makemkvcon. 
 
 MakeMKV Key makemkv_registration_key string leer Optionaler Registrierungsschlüssel. Wird vor Analyze/Rip automatisch per "makemkvcon reg" gesetzt. 
 
 Mediainfo Kommando mediainfo_command string mediainfo Pfad oder Befehl für mediainfo. 
 
 Minimale Titellänge (Minuten) makemkv_min_length_minutes number 60 Filtert kurze Titel beim Rip. 
 
 HandBrake Kommando handbrake_command string HandBrakeCLI Pfad oder Befehl für HandBrakeCLI. 
 
 Encode-Neustart: unvollständige Ausgabe löschen handbrake_restart_delete_incomplete_output boolean true Wenn aktiv, wird bei "Encode neu starten" der bisherige (nicht erfolgreiche) Output vor Start entfernt. 
 
 Max. parallele Film/Video Encodes pipeline_max_parallel_jobs number 1 Maximale Anzahl parallel laufender Film/Video Encode-Jobs. Gilt zusätzlich zum Gesamtlimit. 
 
 Max. parallele Audio CD Jobs pipeline_max_parallel_cd_encodes number 2 Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zusätzlich zum Gesamtlimit. 
 
 Max. Encodes gesamt (medienunabhängig) pipeline_max_total_encodes number 3 Gesamtlimit für alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. 
 
 Audio CDs: Queue-Reihenfolge überspringen pipeline_cd_bypasses_queue boolean false Wenn aktiv, können Audio CD Jobs unabhängig von Film-Jobs starten (überspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. 
 
 Script-Test Timeout (ms) script_test_timeout_ms number 0 Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. 
 
 cdparanoia Kommando cdparanoia_command string cdparanoia Pfad oder Befehl für cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. 
 
 FFmpeg Kommando ffmpeg_command string ffmpeg Pfad oder Befehl für ffmpeg. Wird für Audiobook-Encoding genutzt. 
 
 FFprobe Kommando ffprobe_command string ffprobe Pfad oder Befehl für ffprobe. Wird für Audiobook-Metadaten und Kapitel genutzt. 
 
 Mediainfo Extra Args mediainfo_extra_args_bluray string leer Zusätzliche CLI-Parameter für mediainfo (Blu-ray). 
 
 MakeMKV Rip Modus makemkv_rip_mode_bluray select backup backup: vollständige Blu-ray Struktur im RAW-Ordner (empfohlen, ermöglicht --decrypt). 
 
 MakeMKV Analyze Extra Args makemkv_analyze_extra_args_bluray string leer Zusätzliche CLI-Parameter für Analyze (Blu-ray). 
 
 MakeMKV Rip Extra Args makemkv_rip_extra_args_bluray string leer Zusätzliche CLI-Parameter für Rip (Blu-ray). 
 
 HandBrake Preset handbrake_preset_bluray string H.264 MKV 1080p30 Preset Name für -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. 
 
 HandBrake Extra Args handbrake_extra_args_bluray string leer Zusätzliche CLI-Argumente (Blu-ray). 
 
 Ausgabeformat output_extension_bluray select mkv Dateiendung für finale Datei (Blu-ray). 
 
 Mediainfo Extra Args mediainfo_extra_args_dvd string leer Zusätzliche CLI-Parameter für mediainfo (DVD). 
 
 MakeMKV Rip Modus makemkv_rip_mode_dvd select backup backup: vollständige Disc-Struktur im RAW-Ordner (einzig gültige Option für DVDs). 
 
 MakeMKV Analyze Extra Args makemkv_analyze_extra_args_dvd string leer Zusätzliche CLI-Parameter für Analyze (DVD). 
 
 MakeMKV Rip Extra Args makemkv_rip_extra_args_dvd string leer Zusätzliche CLI-Parameter für Rip (DVD). 
 
 HandBrake Preset handbrake_preset_dvd string H.264 MKV 480p30 Preset Name für -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. 
 
 HandBrake Extra Args handbrake_extra_args_dvd string leer Zusätzliche CLI-Argumente (DVD). 
 
 Ausgabeformat output_extension_dvd select mkv Dateiendung für finale Datei (DVD). 
  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Alle Einstellungen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Einstellungsreferenz
 
Diese Seite dokumentiert den aktuellen Stand der Settings auf Basis von settings_schema und der aktiven GUI-Logik.
 
Wichtiges Verhalten in der GUI
 
     
  • Speichern erfolgt gesammelt ueber Aenderungen speichern (Bulk-Update).
    •  
  • ui_expert_mode wird sofort einzeln gespeichert (nicht erst mit Bulk-Speichern).
    •  
  • *_owner-Felder sind in der GUI erst aktiv, wenn der zugehoerige Pfad gesetzt ist.
    •  
  • Einige Keys sind absichtlich ausgeblendet und nur technisch (API/DB) nutzbar.
    •  
  • Benachrichtigungs-Event-Toggles sind nur sichtbar, wenn pushover_enabled=true.
    •  
 
Fallbacks und Pfadaufloesung
 
     
  • Leere profilspezifische Pfade fallen auf Installationsdefaults zurueck.
    •  
  • download_dir nutzt bei leerem Wert den Default-Downloadpfad.
    •  
  • Die Konfigurationsseite zeigt im Block Effektive Pfade die tatsaechlich verwendeten Laufzeitpfade.
    •  
 
Vollstaendige Feldliste
 
Kategorie: Benachrichtigungen
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Expertenmodus ui_expert_mode boolean false Standard Schaltet erweiterte Einstellungen in der UI ein. 
 
 PushOver aktiviert pushover_enabled boolean false Standard Master-Schalter für PushOver Versand. 
 
 PushOver Token pushover_token string leer Standard Application Token für PushOver. 
 
 PushOver User pushover_user string leer Standard User-Key für PushOver. 
 
 PushOver Device (optional) pushover_device string leer Expertenmodus Optionales Ziel-Device in PushOver. 
 
 PushOver Titel-Präfix pushover_title_prefix string Ripster Standard Prefix im PushOver Titel. 
 
 PushOver Priority pushover_priority number 0 Expertenmodus Priorität -2 bis 2. 
 
 PushOver Timeout (ms) pushover_timeout_ms number 7000 Expertenmodus HTTP Timeout für PushOver Requests. 
 
 Bei manueller Auswahl senden pushover_notify_metadata_ready boolean true Standard Sendet, wenn ein Job eine manuelle Auswahl/Entscheidung benötigt (z.B. Metadaten, Titel oder Playlist). 
 
 Bei Rip-Start senden pushover_notify_rip_started boolean true Standard Sendet beim Start des MakeMKV-Rips. 
 
 Bei Encode-Start senden pushover_notify_encoding_started boolean true Standard Sendet beim Start von HandBrake. 
 
 Bei Erfolg senden pushover_notify_job_finished boolean true Standard Sendet bei erfolgreich abgeschlossenem Job. 
 
 Bei Fehler senden pushover_notify_job_error boolean true Standard Sendet bei Fehlern in der Pipeline. 
 
 Bei Abbruch senden pushover_notify_job_cancelled boolean true Standard Sendet wenn Job manuell abgebrochen wurde. 
 
 Bei Re-Encode Start senden pushover_notify_reencode_started boolean true Standard Sendet beim Start von RAW Re-Encode. 
 
 Bei Re-Encode Erfolg senden pushover_notify_reencode_finished boolean true Standard Sendet bei erfolgreichem RAW Re-Encode. 
  
 
Kategorie: Converter
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Erlaubte Datei-Endungen converter_scan_extensions string mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus Standard Komma-getrennte Liste erlaubter Dateiendungen für den Scan (ohne Punkt). 
 
 Auto-Scan (Polling) converter_polling_enabled boolean false Standard Converter Raw-Ordner automatisch in regelmäßigen Abständen scannen. 
 
 Polling-Intervall (Sekunden) converter_polling_interval number 300 Standard Intervall für automatischen Scan des Converter-Ordners. 
  
 
Kategorie: Laufwerk
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Laufwerksmodus drive_mode select auto Standard Auto-Discovery oder explizites Device. 
 
 Explizite Laufwerke drive_devices path [] Standard Laufwerke für den expliziten Modus als JSON-Array mit Pfad und MakeMKV-Index, z.B. [{"path":"/dev/sr0","makemkvIndex":0},{"path":"/dev/sr1","makemkvIndex":1}]. Nur relevant wenn Modus = Explizites Device. 
 
 Device Pfad drive_device path /dev/sr0 Ausgeblendet (nur API/DB) Nur für expliziten Modus, z.B. /dev/sr0. 
 
 MakeMKV Source Index makemkv_source_index number 0 Ausgeblendet (nur API/DB) Disc Index im Auto-Modus. 
 
 Automatische Disk-Erkennung disc_auto_detection_enabled boolean true Standard Wenn deaktiviert, findet keine automatische Laufwerksprüfung statt. Neue Disks werden nur per "Laufwerk neu lesen" erkannt. 
 
 Polling Intervall (ms) disc_poll_interval_ms number 4000 Expertenmodus Intervall für Disk-Erkennung. 
 
 Laufwerk nach Rip auswerfen auto_eject_after_rip boolean false Standard Wenn aktiv, wird das Laufwerk nach erfolgreichem Abschluss eines Rip-Vorgangs automatisch ausgeworfen (eject). 
  
 
Kategorie: Logging
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Terminal-Ausgabe aktiv server_console_log_output_enabled boolean true Expertenmodus Master-Schalter für die Ausgabe der Server-Logs im Terminal (z.B. start.sh). Das Schreiben in Log-Dateien bleibt immer aktiv. 
 
 HTTP-Logs im Terminal server_console_log_http_enabled boolean true Expertenmodus Steuert HTTP Request-Logs im Terminal (z.B. request:start). Dateilogs bleiben unverändert. 
 
 DEBUG im Terminal server_console_log_debug_enabled boolean true Expertenmodus Steuert DEBUG-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. 
 
 INFO im Terminal server_console_log_info_enabled boolean true Expertenmodus Steuert INFO-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. 
 
 WARN im Terminal server_console_log_warn_enabled boolean true Expertenmodus Steuert WARN-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. 
 
 ERROR im Terminal server_console_log_error_enabled boolean true Expertenmodus Steuert ERROR-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. 
  
 
Kategorie: Metadaten
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 TMDb Read Access Token tmdb_api_read_access_token string leer Standard Read Access Token für Serien-Metadaten über TheMovieDB (TMDb). 
 
 Film-Sprache dvd_series_language string de-DE Standard Bevorzugte TMDb-Sprache für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE oder en-US. 
 
 Fallback Sprache dvd_series_fallback_languages string de-DE,en-US Standard Kommagetrennte TMDb-Fallback-Sprachen für Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE,en-US,fr-FR. 
 
 Coverart-Nachladen aktiv coverart_recovery_enabled boolean true Standard Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen geprüft und nachgeladen. 
 
 Coverart-Prüfintervall (Stunden) coverart_recovery_interval_hours number 6 Standard Intervall für automatische Prüfung fehlender Coverarts in Stunden. 
 
 NFO nach Encode erzeugen generate_nfo_after_encode boolean false Standard Erstellt nach erfolgreichem Encode automatisch eine .nfo-Datei neben der Ausgabedatei. 
  
 
Kategorie: Monitoring
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Hardware Monitoring aktiviert hardware_monitoring_enabled boolean true Standard Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). 
 
 Hardware Monitoring Intervall (ms) hardware_monitoring_interval_ms number 5000 Expertenmodus Polling-Intervall für CPU/RAM/GPU/Storage-Metriken. 
  
 
Kategorie: Pfade
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 Raw Ausgabeordner (Blu-ray) raw_dir_bluray path leer Standard Optionaler RAW-Zielpfad nur für Blu-ray. Leer = Fallback auf "Raw Ausgabeordner". 
 
 Raw Ausgabeordner (DVD) raw_dir_dvd path leer Standard Optionaler RAW-Zielpfad nur für DVD. Leer = Fallback auf "Raw Ausgabeordner". 
 
 CD RAW-Ordner raw_dir_cd path leer Standard Basisordner für rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). 
 
 Audiobook RAW-Ordner raw_dir_audiobook path leer Standard Basisordner für hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). 
 
 Serien-Ordner (Blu-ray) series_dir_bluray path leer Standard Zielordner für Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). 
 
 Film Ausgabeordner (Blu-ray) movie_dir_bluray path leer Standard Optionaler Encode-Zielpfad nur für Blu-ray. Leer = Fallback auf "Film Ausgabeordner". 
 
 Film Ausgabeordner (DVD) movie_dir_dvd path leer Standard Optionaler Encode-Zielpfad nur für DVD. Leer = Fallback auf "Film Ausgabeordner". 
 
 Serien-Ordner (DVD) series_dir_dvd path leer Standard Zielordner für DVD-Serienfolgen. Leer = Standardpfad (data/output/series). 
 
 CD Output-Ordner movie_dir_cd path leer Standard Zielordner für encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. 
 
 Audiobook Output-Ordner movie_dir_audiobook path leer Standard Zielordner für encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). 
 
 Download ZIP-Ordner download_dir path leer Standard Zielordner für vorbereitete ZIP-Downloads. Leer = Standardpfad (data/downloads). 
 
 Externe Speicher external_storage_paths path [] Standard Wird links unter "Freie Speicher" angezeigt. 
 
 Log Ordner log_dir path installationsabhaengig Standard Basisordner für Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. 
 
 CD Output Template cd_output_template string {artist} - {album} ({year})/{trackNr} {artist} - {title} Standard Template für relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind über "/" möglich. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (Blu-ray) output_template_bluray string ${title} (${year})/${title} (${year}) Standard Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (Blu-ray Serie, Episode) output_template_bluray_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Standard Template für einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. 
 
 Output Template (Blu-ray Serie, Multi-Episode) output_template_bluray_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Standard Template für zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. 
 
 Output Template (DVD) output_template_dvd string ${title} (${year})/${title} (${year}) Standard Template für Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner über "/" möglich – alles nach dem letzten "/" ist der Dateiname. Die Endung wird über das gewählte Ausgabeformat gesetzt. 
 
 Output Template (DVD Serie, Episode) output_template_dvd_series_episode string {seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeNo} - {episodeTitle} Standard Template für einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNr}. 
 
 Output Template (DVD Serie, Multi-Episode) output_template_dvd_series_multi_episode string {seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeRange} Standard Template für zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit führender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. 
 
 Output Template (Audiobook) output_template_audiobook string {author}/{author} - {title} ({year}) Standard Template für relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind über "/" möglich. 
 
 Audiobook RAW Template audiobook_raw_template string {author} - {title} ({year}) Standard Template für relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. 
 
 Converter Raw-Ordner converter_raw_dir path leer Standard Eingangsordner für den Converter (Import-Scan und Datei-Uploads). Jeder Upload erhält einen Unterordner. Leer = Standardpfad (data/output/converter-raw). 
 
 Converter Ausgabe (Video) converter_movie_dir path leer Standard Ausgabepfad für konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). 
 
 Converter Ausgabe (Audio) converter_audio_dir path leer Standard Ausgabepfad für konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). 
 
 Output-Template (Video) converter_output_template_video string {title} Standard Dateiname-Template für konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. 
 
 Output-Template (Audio) converter_output_template_audio string {artist} - {title} Standard Dateiname-Template für konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. 
 
 RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series path leer Standard RAW-Zielpfad für Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). 
 
 Eigentümer RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series_owner string leer Standard Eigentümer der Dateien im Format user:gruppe für Blu-ray-Serien-RAW. Leer = Eigentümer Raw-Ordner (Blu-ray). 
 
 Eigentümer Raw-Ordner (Blu-ray) raw_dir_bluray_owner string leer Standard Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 RAW-Ordner (DVD Serie) raw_dir_dvd_series path leer Standard RAW-Zielpfad für DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). 
 
 Eigentümer RAW-Ordner (DVD Serie) raw_dir_dvd_series_owner string leer Standard Eigentümer der Dateien im Format user:gruppe für DVD-Serien-RAW. Leer = Eigentümer Raw-Ordner (DVD). 
 
 Eigentümer Raw-Ordner (DVD) raw_dir_dvd_owner string leer Standard Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer CD RAW-Ordner raw_dir_cd_owner string leer Standard Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Audiobook RAW-Ordner raw_dir_audiobook_owner string leer Standard Eigentümer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Converter RAW-Ordner converter_raw_dir_owner string leer Standard Eigentümer der Converter-Eingabedateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Serien-Ordner (Blu-ray) series_dir_bluray_owner string leer Standard Eigentümer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Film-Ordner (Blu-ray) movie_dir_bluray_owner string leer Standard Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Film-Ordner (DVD) movie_dir_dvd_owner string leer Standard Eigentümer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Serien-Ordner (DVD) series_dir_dvd_owner string leer Standard Eigentümer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer CD Output-Ordner movie_dir_cd_owner string leer Standard Eigentümer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Audiobook Output-Ordner movie_dir_audiobook_owner string leer Standard Eigentümer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Converter Video Output-Ordner converter_movie_dir_owner string leer Standard Eigentümer der konvertierten Video-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Converter Audio Output-Ordner converter_audio_dir_owner string leer Standard Eigentümer der konvertierten Audio-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Eigentümer Download ZIP-Ordner download_dir_owner string leer Standard Eigentümer der vorbereiteten ZIP-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. 
 
 Kapitel Template (Audiobook) output_chapter_template_audiobook string {author}/{author} - {title} ({year})/{chapterNr} {chapterTitle} Standard Template für kapitelweise Audiobook-Ausgaben (MP3/FLAC) ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}, {chapterNr}, {chapterNo}, {chapterTitle}. Unterordner sind über "/" möglich. 
  
 
Kategorie: Tools
 
  
 GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System 
   
 MakeMKV Kommando makemkv_command string makemkvcon Expertenmodus Pfad oder Befehl für makemkvcon. 
 
 MakeMKV Key makemkv_registration_key string leer Standard Optionaler Registrierungsschlüssel. Wird beim Speichern nach ~/.MakeMKV/settings.conf synchronisiert. Darunter kann der aktuelle Betakey per API übernommen werden. 
 
 Mediainfo Kommando mediainfo_command string mediainfo Expertenmodus Pfad oder Befehl für mediainfo. 
 
 Minimale Titellänge (Minuten) makemkv_min_length_minutes number 60 Standard Filtert kurze Titel beim Rip. 
 
 HandBrake Kommando handbrake_command string HandBrakeCLI Expertenmodus Pfad oder Befehl für HandBrakeCLI. 
 
 Encode-Neustart: unvollständige Ausgabe löschen handbrake_restart_delete_incomplete_output boolean true Standard Wenn aktiv, wird bei "Encode neu starten" der bisherige (nicht erfolgreiche) Output vor Start entfernt. 
 
 Parallele Jobs pipeline_max_parallel_jobs number 1 Standard Maximale Anzahl parallel laufender Jobs. Weitere Starts landen in der Queue. 
 
 Max. parallele Audio CD Jobs pipeline_max_parallel_cd_encodes number 2 Standard Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zusätzlich zum Gesamtlimit. 
 
 Script-Test Timeout (ms) script_test_timeout_ms number 0 Expertenmodus Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. 
 
 Max. Encodes gesamt (medienunabhängig) pipeline_max_total_encodes number 3 Standard Gesamtlimit für alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. 
 
 Audio CDs: Queue-Reihenfolge überspringen pipeline_cd_bypasses_queue boolean false Standard Wenn aktiv, können Audio CD Jobs unabhängig von Film-Jobs starten (überspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. 
 
 cdparanoia Kommando cdparanoia_command string cdparanoia Expertenmodus Pfad oder Befehl für cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. 
 
 FFmpeg Kommando ffmpeg_command string ffmpeg Standard Pfad oder Befehl für ffmpeg. Wird für Audiobook-Encoding genutzt. 
 
 FFprobe Kommando ffprobe_command string ffprobe Standard Pfad oder Befehl für ffprobe. Wird für Audiobook-Metadaten und Kapitel genutzt. 
 
 Serie: PlayAll Untergrenze (%) series_playall_tolerance_lower_pct number 10 Standard Untere Toleranz in Prozent für die Plausibilitätsprüfung von PlayAll gegen Episodensumme (DVD/Blu-ray). 
 
 Serie: PlayAll Obergrenze (%) series_playall_tolerance_upper_pct number 10 Standard Obere Toleranz in Prozent für die Plausibilitätsprüfung von PlayAll gegen Episodensumme (DVD/Blu-ray). 
 
 Mediainfo Extra Args mediainfo_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für mediainfo (Blu-ray). 
 
 MakeMKV Rip Modus makemkv_rip_mode_bluray select backup Ausgeblendet (nur API/DB) mkv: direkte MKV-Dateien; backup: vollständige Blu-ray Struktur im RAW-Ordner. 
 
 MakeMKV Analyze Extra Args makemkv_analyze_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für Analyze (Blu-ray). 
 
 MakeMKV Rip Extra Args makemkv_rip_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für Rip (Blu-ray). 
 
 HandBrake Preset handbrake_preset_bluray string H.264 MKV 1080p30 Standard Preset Name für -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. 
 
 HandBrake Extra Args handbrake_extra_args_bluray string --audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au... Standard Zusätzliche CLI-Argumente (Blu-ray). 
 
 Ausgabeformat output_extension_bluray select mkv Standard Dateiendung für finale Datei (Blu-ray). 
 
 Mediainfo Extra Args mediainfo_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für mediainfo (DVD). 
 
 MakeMKV Rip Modus makemkv_rip_mode_dvd select mkv Ausgeblendet (nur API/DB) mkv: direkte MKV-Dateien; backup: vollständige Disc-Struktur im RAW-Ordner. 
 
 MakeMKV Analyze Extra Args makemkv_analyze_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für Analyze (DVD). 
 
 MakeMKV Rip Extra Args makemkv_rip_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für Rip (DVD). 
 
 HandBrake Preset handbrake_preset_dvd string H.264 MKV 480p30 Standard Preset Name für -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. 
 
 HandBrake Extra Args handbrake_extra_args_dvd string --audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au... Standard Zusätzliche CLI-Argumente (DVD). 
 
 Ausgabeformat output_extension_dvd select mkv Standard Dateiendung für finale Datei (DVD). 
 
 mkvmerge Kommando mkvmerge_command string mkvmerge Standard Pfad oder Befehl für mkvmerge. Wird für Multipart-Movie-Merges genutzt. 
  
 
Beispiele fuer haeufige Settings
 
     
  • drive_devices: [{"path":"/dev/sr0","makemkvIndex":0},{"path":"/dev/sr1","makemkvIndex":1}]
    •  
  • external_storage_paths: [{"name":"USB HDD","path":"/mnt/usb-hdd"}]
    •  
  • converter_scan_extensions: mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus
    •  
  • output_template_bluray: ${title} (${year})/${title} (${year})
    •  
  • output_template_audiobook: {author}/{author} - {title} ({year})
    •  
  • output_chapter_template_audiobook: {author}/{author} - {title} ({year})/{chapterNr} {chapterTitle}
    •  
  • download_dir_owner: ripster:media
    •  
 
Hinweise zu ausgeblendeten Keys
 
Folgende Keys liegen im Schema, sind aber im normalen Settings-Formular absichtlich ausgeblendet: drive_device, makemkv_source_index, makemkv_rip_mode_bluray, makemkv_rip_mode_dvd. Aenderungen daran erfolgen nur ueber API/DB oder technische Migrationen.
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/deployment/development/index.html b/site/deployment/development/index.html
index 5c0356e..2f3f3c2 100644
--- a/site/deployment/development/index.html
+++ b/site/deployment/development/index.html
@@ -1,4 +1,4 @@
- Entwicklungsumgebung - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Entwicklungsumgebung
 
 
Voraussetzungen
 
     
  • Node.js >= 20.19.0
    •  
  • externe Tools installiert (makemkvcon, HandBrakeCLI, mediainfo)
    •  
 
 
Schnellstart
 
./start.sh
+ Entwicklungsumgebung - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Entwicklungsumgebung
 
 
Voraussetzungen
 
     
  • Node.js >= 20.19.0
    •  
  • externe Tools installiert (makemkvcon, HandBrakeCLI, mediainfo)
    •  
 
 
Schnellstart
 
./start.sh
 
 
Startet:
 
     
  • Backend (http://localhost:3001, mit nodemon)
    •  
  • Frontend (http://localhost:5173, mit Vite HMR)
    •  
 
Stoppen: Ctrl+C.
 
 
Manuell
 
Backend
 
cd backend
 npm install
 npm run dev
diff --git a/site/deployment/index.html b/site/deployment/index.html
index e8a63aa..03051e5 100644
--- a/site/deployment/index.html
+++ b/site/deployment/index.html
@@ -1 +1 @@
- Anhang: Deployment - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Deployment
 
Technische Betriebsdokumentation für Entwicklung und Produktion.
 
 
     
  •  
     Entwicklungsumgebung
     
     
    Lokale Entwicklung mit Hot-Reload.
     
     Entwicklung
     
    •  
  •  
     Produktion
     
     
    Installation und Betrieb auf Servern.
     
     Produktion
     
    •  
 
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Anhang: Deployment - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Deployment
 
Technische Betriebsdokumentation für Entwicklung und Produktion.
 
 
     
  •  
     Entwicklungsumgebung
     
     
    Lokale Entwicklung mit Hot-Reload.
     
     Entwicklung
     
    •  
  •  
     Produktion
     
     
    Installation und Betrieb auf Servern.
     
     Produktion
     
    •  
 
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/deployment/production/index.html b/site/deployment/production/index.html
index b0eaa0b..1eb8db2 100644
--- a/site/deployment/production/index.html
+++ b/site/deployment/production/index.html
@@ -1,4 +1,4 @@
- Produktion - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Produktions-Deployment
 
 
Automatische Installation (empfohlen)
 
Das mitgelieferte install.sh richtet Ripster vollautomatisch ein – inklusive Node.js, MakeMKV, HandBrake, nginx und systemd-Dienst.
 
Unterstützte Systeme laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS Voraussetzung: root-Rechte, Internetzugang
 
Schnellstart via curl
 
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash
+ Produktion - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Produktions-Deployment
 
 
Automatische Installation (empfohlen)
 
Das mitgelieferte install.sh richtet Ripster vollautomatisch ein – inklusive Node.js, MakeMKV, HandBrake, nginx und systemd-Dienst.
 
Unterstützte Systeme laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS Voraussetzung: root-Rechte, Internetzugang
 
Schnellstart via curl
 
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash
 
 
Oder mit wget:
 
wget -qO- https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash
 
 
 
Optionen nur via Datei
 
Beim Pipen von curl/wget können keine Argumente übergeben werden. Für benutzerdefinierte Optionen zuerst herunterladen und dann mit sudo bash install.sh [Optionen] ausführen.
 
 
Optionen
 
  
 Option Standard Beschreibung 
   
 --branch <branch> dev Git-Branch für die Installation 
 
 --dir <pfad> /opt/ripster Installationsverzeichnis 
 
 --user <benutzer> ripster Systembenutzer für den Dienst 
 
 --port <port> 3001 Backend-Port 
 
 --host <hostname> Auto (Maschinen-IP) Hostname/IP für die Weboberfläche 
 
 --no-makemkv – MakeMKV-Installation überspringen 
 
 --no-handbrake – HandBrake-Installation überspringen 
 
 --no-nginx – nginx-Einrichtung überspringen 
 
 --reinstall – Bestehende Installation aktualisieren (Daten bleiben erhalten) 
 
 -h, --help – Hilfe anzeigen 
  
 
Beispiele
 
# Standard-Installation
 sudo bash install.sh
diff --git a/site/getting-started/configuration/index.html b/site/getting-started/configuration/index.html
index 29f600a..9001a9b 100644
--- a/site/getting-started/configuration/index.html
+++ b/site/getting-started/configuration/index.html
@@ -1 +1 @@
- Ersteinrichtung - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ersteinrichtung
 
Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
 
Ziel der Ersteinrichtung
 
Vor dem ersten Job müssen drei Dinge stabil sein:
 
     
  1. Pfade stimmen (RAW, Output, Logs)
    2.  
  2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
    3.  
  3. Metadatenzugänge funktionieren (OMDb, optional TMDb/MusicBrainz)
    4.  
 
Empfohlene Reihenfolge
 
1) Basis in Settings -> Konfiguration
 
Setze zuerst:
 
     
  • Raw-Ordner und Film-/Serien-Ordner
    •  
  • Log Ordner
    •  
  • MakeMKV Kommando, HandBrake Kommando, Mediainfo Kommando
    •  
  • OMDb API Key
    •  
 
Dann speichern.
 
2) Profile pro Medium festziehen
 
Ripster löst viele Werte profilspezifisch auf (bluray, dvd, cd, audiobook).
 
Pflichtprüfung:
 
     
  • RAW-Pfade je Profil
    •  
  • Output-Pfade je Profil
    •  
  • HandBrake-Preset je Profil
    •  
  • Output-Templates je Profil
    •  
 
Für Serien zusätzlich:
 
     
  • RAW-Ordner (Blu-ray/DVD Serie)
    •  
  • Serien-Ordner (Blu-ray/DVD)
    •  
  • Serien-Templates (Episode/Multi-Episode)
    •  
 
3) Queue-Verhalten definieren
 
Stelle ein:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge überspringen
    •  
 
Damit steuerst du Durchsatz, Priorität und Lastverteilung.
 
4) Metadatenquellen absichern
 
Film:
 
     
  • OMDb-Key prüfen
    •  
 
Serien:
 
     
  • TMDb Read Access Token setzen
    •  
  • Sprache/Fallback-Sprachen festlegen
    •  
 
CD/Audiodaten:
 
     
  • MusicBrainz aktiviert nach Bedarf
    •  
 
5) Optional: Benachrichtigungen
 
     
  • PushOver-Zugangsdaten setzen
    •  
  • PushOver Test ausführen
    •  
  • Event-Toggles pro Phase prüfen
    •  
 
6) Optional: Automatisierung
 
     
  1. Skripte testen
    2.  
  2. Skriptketten bauen/testen
    3.  
  3. Cronjobs erst danach aktivieren
    4.  
 
Funktionsprüfung (Kurztest)
 
     
  1. Disc in Ripper erkennen lassen.
    2.  
  2. Analyse starten.
    3.  
  3. Metadaten übernehmen.
    4.  
  4. Bis Bereit zum Encodieren laufen.
    5.  
  5. Encode starten und Abschluss in Historie prüfen.
    6.  
 
Typische Konfigurationsfehler
 
  
 Symptom Häufige Ursache 
   
 Job bleibt früh auf Fehler Toolkommando falsch oder nicht im PATH 
 
 RAW/Output landet am falschen Ort Profilpfade nicht gesetzt, Fallback greift 
 
 Serienausgabe landet bei Filmen Serienpfade/Serientemplates fehlen 
 
 Queue verhält sich unerwartet Gesamtlimit und Lane-Limits widersprechen sich 
  
 
Weiter
  
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Ersteinrichtung - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ersteinrichtung
 
Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
 
Ziel der Ersteinrichtung
 
Vor dem ersten Job müssen drei Dinge stabil sein:
 
     
  1. Pfade stimmen (RAW, Output, Logs)
    2.  
  2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
    3.  
  3. Metadatenzugänge funktionieren (OMDb, optional TMDb/MusicBrainz)
    4.  
 
Empfohlene Reihenfolge
 
1) Basis in Settings -> Konfiguration
 
Setze zuerst:
 
     
  • Raw-Ordner und Film-/Serien-Ordner
    •  
  • Log Ordner
    •  
  • MakeMKV Kommando, HandBrake Kommando, Mediainfo Kommando
    •  
  • OMDb API Key
    •  
 
Dann speichern.
 
2) Profile pro Medium festziehen
 
Ripster löst viele Werte profilspezifisch auf (bluray, dvd, cd, audiobook).
 
Pflichtprüfung:
 
     
  • RAW-Pfade je Profil
    •  
  • Output-Pfade je Profil
    •  
  • HandBrake-Preset je Profil
    •  
  • Output-Templates je Profil
    •  
 
Für Serien zusätzlich:
 
     
  • RAW-Ordner (Blu-ray/DVD Serie)
    •  
  • Serien-Ordner (Blu-ray/DVD)
    •  
  • Serien-Templates (Episode/Multi-Episode)
    •  
 
3) Queue-Verhalten definieren
 
Stelle ein:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge überspringen
    •  
 
Damit steuerst du Durchsatz, Priorität und Lastverteilung.
 
4) Metadatenquellen absichern
 
Film:
 
     
  • OMDb-Key prüfen
    •  
 
Serien:
 
     
  • TMDb Read Access Token setzen
    •  
  • Sprache/Fallback-Sprachen festlegen
    •  
 
CD/Audiodaten:
 
     
  • MusicBrainz aktiviert nach Bedarf
    •  
 
5) Optional: Benachrichtigungen
 
     
  • PushOver-Zugangsdaten setzen
    •  
  • PushOver Test ausführen
    •  
  • Event-Toggles pro Phase prüfen
    •  
 
6) Optional: Automatisierung
 
     
  1. Skripte testen
    2.  
  2. Skriptketten bauen/testen
    3.  
  3. Cronjobs erst danach aktivieren
    4.  
 
Funktionsprüfung (Kurztest)
 
     
  1. Disc in Ripper erkennen lassen.
    2.  
  2. Analyse starten.
    3.  
  3. Metadaten übernehmen.
    4.  
  4. Bis Bereit zum Encodieren laufen.
    5.  
  5. Encode starten und Abschluss in Historie prüfen.
    6.  
 
Typische Konfigurationsfehler
 
  
 Symptom Häufige Ursache 
   
 Job bleibt früh auf Fehler Toolkommando falsch oder nicht im PATH 
 
 RAW/Output landet am falschen Ort Profilpfade nicht gesetzt, Fallback greift 
 
 Serienausgabe landet bei Filmen Serienpfade/Serientemplates fehlen 
 
 Queue verhält sich unerwartet Gesamtlimit und Lane-Limits widersprechen sich 
  
 
Weiter
  
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/getting-started/index.html b/site/getting-started/index.html
index 7128644..92d2b07 100644
--- a/site/getting-started/index.html
+++ b/site/getting-started/index.html
@@ -1 +1 @@
- Benutzerhandbuch Überblick - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Benutzerhandbuch Überblick
 
Dieses Kapitel ist für den Betrieb von Ripster im Alltag geschrieben.
 
Zielgruppe
 
     
  • Anwender, die Discs verarbeiten wollen
    •  
  • Betreiber, die den täglichen Ablauf stabil fahren möchten
    •  
  • Power-User, die Queue/Skripte/Cron im UI steuern möchten
    •  
 
Kapitelstruktur
 
  
 Kapitel Zweck 
   
 Voraussetzungen Produktions- vs. Dev-Voraussetzungen klar trennen 
 
 Installation Ripster aufsetzen und starten 
 
 Ersteinrichtung Pfade, Tools und Metadaten korrekt setzen 
 
 Erster Lauf Ein kompletter Job von Disc bis Datei 
 
 GUI-Seiten Alle Ansichten und Aktionen im Detail 
 
 Workflows Typische Abläufe und Entscheidungen aus User-Sicht 
  
 
Wenn du neu startest
 
     
  1. Voraussetzungen
    2.  
  2. Installation
    3.  
  3. Ersteinrichtung
    4.  
  4. Erster Lauf
    5.  
 
Wenn Ripster bereits läuft
 
     
  1. GUI-Seiten
    2.  
  2. Workflows
    3.  
  3. Bei Detailfragen: Technischer Anhang
    4.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Benutzerhandbuch Überblick - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Benutzerhandbuch Überblick
 
Dieses Kapitel ist für den Betrieb von Ripster im Alltag geschrieben.
 
Zielgruppe
 
     
  • Anwender, die Discs verarbeiten wollen
    •  
  • Betreiber, die den täglichen Ablauf stabil fahren möchten
    •  
  • Power-User, die Queue/Skripte/Cron im UI steuern möchten
    •  
 
Kapitelstruktur
 
  
 Kapitel Zweck 
   
 Voraussetzungen Produktions- vs. Dev-Voraussetzungen klar trennen 
 
 Installation Ripster aufsetzen und starten 
 
 Ersteinrichtung Pfade, Tools und Metadaten korrekt setzen 
 
 Erster Lauf Ein kompletter Job von Disc bis Datei 
 
 GUI-Seiten Alle Ansichten und Aktionen im Detail 
 
 Workflows Typische Abläufe und Entscheidungen aus User-Sicht 
  
 
Wenn du neu startest
 
     
  1. Voraussetzungen
    2.  
  2. Installation
    3.  
  3. Ersteinrichtung
    4.  
  4. Erster Lauf
    5.  
 
Wenn Ripster bereits läuft
 
     
  1. GUI-Seiten
    2.  
  2. Workflows
    3.  
  3. Bei Detailfragen: Technischer Anhang
    4.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/getting-started/installation/index.html b/site/getting-started/installation/index.html
index 49afbf4..71fc39d 100644
--- a/site/getting-started/installation/index.html
+++ b/site/getting-started/installation/index.html
@@ -1,4 +1,4 @@
- Installation - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Installation
 
Die empfohlene Installation läuft über install.sh und richtet Ripster vollständig ein.
 
Du musst dafür keine Tools manuell vorinstallieren. Das Skript installiert die benötigten Abhängigkeiten automatisch, sofern sie nicht explizit mit --no-* übersprungen werden.
 
Unterstützte Systeme und Anforderungen
 
     
  • unterstützt laut Script: debian, ubuntu, linuxmint, pop
    •  
  • Ausführung als root (oder via sudo)
    •  
  • Internetzugang während der Installation
    •  
 
Schritt-für-Schritt
 
1. Installationsskript herunterladen
 
wget -qO install.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh
+ Installation - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Installation
 
Die empfohlene Installation läuft über install.sh und richtet Ripster vollständig ein.
 
Du musst dafür keine Tools manuell vorinstallieren. Das Skript installiert die benötigten Abhängigkeiten automatisch, sofern sie nicht explizit mit --no-* übersprungen werden.
 
Unterstützte Systeme und Anforderungen
 
     
  • unterstützt laut Script: debian, ubuntu, linuxmint, pop
    •  
  • Ausführung als root (oder via sudo)
    •  
  • Internetzugang während der Installation
    •  
 
Schritt-für-Schritt
 
1. Installationsskript herunterladen
 
wget -qO install.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh
 
 
2. Installation ausführen
 
sudo bash install.sh
 
 
Während der Installation wählst du den HandBrake-Modus:
 
     
  • 1 Standard (Paketinstallation)
    •  
  • 2 GPU/NVDEC (gebündeltes Binary)
    •  
 
3. Dienststatus prüfen
 
sudo systemctl status ripster-backend
 
 
4. Weboberfläche öffnen
 
     
  • mit nginx (Standard): http://<Server-IP>
    •  
  • ohne nginx (--no-nginx): API auf http://<Server-IP>:3001/api
    •  
 
Was install.sh konkret einrichtet
 
     
  1. prüft Betriebssystem, Root-Rechte und ermittelt Host/IP
    2.  
  2. aktualisiert Paketquellen und installiert Basispakete (curl, wget, git, mediainfo, udev ...)
    3.  
  3. installiert Node.js 20 (falls nicht passend vorhanden)
    4.  
  4. installiert optional MakeMKV (Build aus den offiziellen Quellen)
    5.  
  5. installiert optional HandBrakeCLI (Standard oder GPU/NVDEC)
    6.  
  6. installiert optional nginx
    7.  
  7. legt den Systembenutzer ripster an (ohne Login-Shell, ohne Home) und ergänzt Gruppen (cdrom, optical, disk, video, render, falls vorhanden)
    8.  
  8. klont das Repository nach /opt/ripster (oder aktualisiert bei --reinstall)
    9.  
  9. legt Verzeichnisse an:
    10.  
  10. /opt/ripster/backend/data
    11.  
  11. /opt/ripster/backend/logs
    12.  
  12. /opt/ripster/backend/data/output/raw
    13.  
  13. /opt/ripster/backend/data/output/movies
    14.  
  14. /opt/ripster/backend/data/logs
    15.  
  15. installiert npm-Abhängigkeiten (Root, Backend, Frontend) und baut das Frontend
    16.  
  16. erzeugt backend/.env (bei --reinstall bleibt bestehende .env erhalten)
    17.  
  17. setzt Rechte/Besitz und erstellt bei sudo-Installation zusätzlich ~/.MakeMKV für den aufrufenden Benutzer
    18.  
  18. erzeugt und startet ripster-backend.service
    19.  
  19. konfiguriert und startet nginx (falls nicht übersprungen)
    20.  
 
Wichtige Optionen
 
  
 Option Default laut Script Zweck 
   
 --branch <branch> dev Branch für die Installation 
 
 --dir <pfad> /opt/ripster Installationsverzeichnis 
 
 --user <benutzer> ripster Service-Benutzer 
 
 --port <port> 3001 Backend-Port 
 
 --host <hostname> automatisch ermittelte Host-IP Hostname/IP für Webzugriff/CORS 
 
 --no-makemkv aus MakeMKV-Installation überspringen 
 
 --no-handbrake aus HandBrake-Installation überspringen 
 
 --no-nginx aus nginx-Setup überspringen 
 
 --reinstall aus bestehende Installation aktualisieren 
  
 
Beispiele:
 
sudo bash install.sh --branch dev
diff --git a/site/getting-started/prerequisites/index.html b/site/getting-started/prerequisites/index.html
index 1e22d60..838b386 100644
--- a/site/getting-started/prerequisites/index.html
+++ b/site/getting-started/prerequisites/index.html
@@ -1,4 +1,4 @@
- Voraussetzungen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Voraussetzungen
 
Die Voraussetzungen hängen davon ab, wie du Ripster betreibst.
 
Produktionsbetrieb mit install.sh (Standard)
 
Für den normalen Betrieb sind nur wenige Punkte vorab nötig.
 
Pflicht
 
     
  • unterstütztes Linux-System (laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS)
    •  
  • root-Rechte
    •  
  • Internetzugang während der Installation
    •  
  • optisches Laufwerk für Disc-Betrieb
    •  
 
install.sh installiert die benötigten Tools selbst (u. a. Node.js, MakeMKV, HandBrakeCLI, MediaInfo), sofern sie nicht explizit per --no-* übersprungen werden.
 
Laufwerk kurz prüfen
 
ls /dev/sr*
+ Voraussetzungen - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Voraussetzungen
 
Die Voraussetzungen hängen davon ab, wie du Ripster betreibst.
 
Produktionsbetrieb mit install.sh (Standard)
 
Für den normalen Betrieb sind nur wenige Punkte vorab nötig.
 
Pflicht
 
     
  • unterstütztes Linux-System (laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS)
    •  
  • root-Rechte
    •  
  • Internetzugang während der Installation
    •  
  • optisches Laufwerk für Disc-Betrieb
    •  
 
install.sh installiert die benötigten Tools selbst (u. a. Node.js, MakeMKV, HandBrakeCLI, MediaInfo), sofern sie nicht explizit per --no-* übersprungen werden.
 
Laufwerk kurz prüfen
 
ls /dev/sr*
 lsblk | grep rom
 
 
Wenn nötig Rechte setzen (Beispiel):
 
sudo chmod a+rw /dev/sr0
 
 
Optional vorab
 
     
  • OMDb API-Key (kann auch nach Installation in den Settings gesetzt werden)
    •  
  • PushOver-Zugangsdaten (optional)
    •  
 
Entwicklungsmodus (nur für Dev)
 
Wenn du lokal entwickelst (./start.sh, npm run dev), gelten zusätzliche Voraussetzungen:
 
     
  • Node.js >= 20.19.0
    •  
  • makemkvcon, HandBrakeCLI, mediainfo im PATH
    •  
 
Details: Entwicklungsumgebung
 
Abschluss-Checkliste
 
     
  • [ ] Produktionsbetrieb: Linux + root + Internet + Laufwerk vorhanden
    •  
  • [ ] Dev-Modus (nur falls benötigt): Node.js und CLI-Tools verfügbar
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/getting-started/quickstart/index.html b/site/getting-started/quickstart/index.html
index 0ce5b80..6cdc02f 100644
--- a/site/getting-started/quickstart/index.html
+++ b/site/getting-started/quickstart/index.html
@@ -1 +1 @@
- Erster Lauf - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Erster Lauf
 
Dieser Ablauf führt einen vollständigen Disc-Job von Erkennung bis fertiger Datei durch.
 
1) Disc erkennen
 
     
  1. Ripper öffnen.
    2.  
  2. Disc einlegen.
    3.  
  3. Auf Medium erkannt warten.
    4.  
 
Prüfen:
 
     
  • Disk-Information zeigt Device/Label.
    •  
  • Falls nicht: Laufwerk neu lesen.
    •  
 
2) Analyse starten
 
Aktion:
 
     
  • Analyse starten
    •  
 
Erwartung:
 
     
  • Status Analyse
    •  
  • danach Metadaten-Dialog
    •  
 
3) Metadaten bestätigen
 
Im Dialog:
 
     
  1. Treffer suchen/auswählen.
    2.  
  2. Bei Serie zusätzlich Disc-Nummer setzen.
    3.  
  3. Auswahl übernehmen.
    4.  
 
Mögliche Abzweigungen:
 
     
  • Duplikatfilm -> Übernahme erzwingen oder Multipart movie
    •  
  • vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
    •  
 
4) Rip/Review-Phase
 
Normalfall:
 
     
  • Startbereit -> Rippen -> Mediainfo-Pruefung
    •  
 
Mögliche Alternativen:
 
     
  • vorhandenes RAW: direkter Sprung in Prüfung
    •  
  • Blu-ray/DVD-Entscheidung nötig: Warte auf Auswahl für Playlist/Titel
    •  
 
5) Encode-Review abschließen
 
Bei Bereit zum Encodieren:
 
     
  • Titel festlegen
    •  
  • Audio-/Subtitle-Spuren prüfen
    •  
  • optional Preset auswählen
    •  
  • optional Pre-/Post-Skripte wählen
    •  
 
Dann:
 
     
  • Encoding starten
    •  
 
6) Encoding überwachen
 
Während Encodieren:
 
     
  • Fortschritt/ETA im Ripper
    •  
  • Queue- und Runtime-Status beobachten
    •  
  • optional Logkontrolle in Historie
    •  
 
7) Ergebnis verifizieren
 
Nach Fertig:
 
     
  1. Historie öffnen.
    2.  
  2. Jobdetail prüfen.
    3.  
  3. Output-Pfad und Log plausibilisieren.
    4.  
 
Kontrollpunkte:
 
     
  • finale Datei am erwarteten Template-Pfad
    •  
  • RAW-Ordnerzustand finalisiert (kein Incomplete_)
    •  
 
8) Typische Folgeaktionen
 
     
  • falsche Metadaten: OMDb neu zuordnen
    •  
  • andere Trackauswahl: Review neu starten
    •  
  • erneuter Encode aus RAW: RAW neu encodieren
    •  
  • gleicher Plan erneut: Encode neu starten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Erster Lauf - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Erster Lauf
 
Dieser Ablauf führt einen vollständigen Disc-Job von Erkennung bis fertiger Datei durch.
 
1) Disc erkennen
 
     
  1. Ripper öffnen.
    2.  
  2. Disc einlegen.
    3.  
  3. Auf Medium erkannt warten.
    4.  
 
Prüfen:
 
     
  • Disk-Information zeigt Device/Label.
    •  
  • Falls nicht: Laufwerk neu lesen.
    •  
 
2) Analyse starten
 
Aktion:
 
     
  • Analyse starten
    •  
 
Erwartung:
 
     
  • Status Analyse
    •  
  • danach Metadaten-Dialog
    •  
 
3) Metadaten bestätigen
 
Im Dialog:
 
     
  1. Treffer suchen/auswählen.
    2.  
  2. Bei Serie zusätzlich Disc-Nummer setzen.
    3.  
  3. Auswahl übernehmen.
    4.  
 
Mögliche Abzweigungen:
 
     
  • Duplikatfilm -> Übernahme erzwingen oder Multipart movie
    •  
  • vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
    •  
 
4) Rip/Review-Phase
 
Normalfall:
 
     
  • Startbereit -> Rippen -> Mediainfo-Pruefung
    •  
 
Mögliche Alternativen:
 
     
  • vorhandenes RAW: direkter Sprung in Prüfung
    •  
  • Blu-ray/DVD-Entscheidung nötig: Warte auf Auswahl für Playlist/Titel
    •  
 
5) Encode-Review abschließen
 
Bei Bereit zum Encodieren:
 
     
  • Titel festlegen
    •  
  • Audio-/Subtitle-Spuren prüfen
    •  
  • optional Preset auswählen
    •  
  • optional Pre-/Post-Skripte wählen
    •  
 
Dann:
 
     
  • Encoding starten
    •  
 
6) Encoding überwachen
 
Während Encodieren:
 
     
  • Fortschritt/ETA im Ripper
    •  
  • Queue- und Runtime-Status beobachten
    •  
  • optional Logkontrolle in Historie
    •  
 
7) Ergebnis verifizieren
 
Nach Fertig:
 
     
  1. Historie öffnen.
    2.  
  2. Jobdetail prüfen.
    3.  
  3. Output-Pfad und Log plausibilisieren.
    4.  
 
Kontrollpunkte:
 
     
  • finale Datei am erwarteten Template-Pfad
    •  
  • RAW-Ordnerzustand finalisiert (kein Incomplete_)
    •  
 
8) Typische Folgeaktionen
 
     
  • falsche Metadaten: OMDb neu zuordnen
    •  
  • andere Trackauswahl: Review neu starten
    •  
  • erneuter Encode aus RAW: RAW neu encodieren
    •  
  • gleicher Plan erneut: Encode neu starten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/audiobooks/index.html b/site/gui/audiobooks/index.html
index 054e646..f083639 100644
--- a/site/gui/audiobooks/index.html
+++ b/site/gui/audiobooks/index.html
@@ -1 +1 @@
- Audiobooks - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Audiobooks
 
Die Seite Audiobooks ist der spezialisierte AAX-Workflow.
 
Ablaufübersicht
 
Die Oberfläche ist in drei Bereiche gegliedert:
 
     
  1. Audiobooks Upload
    2.  
  2. Audiobook Jobs
    3.  
  3. Audiobook Output Explorer
    4.  
 
1) Audiobooks Upload
 
Der Upload verarbeitet ausschließlich AAX-Dateien.
 
Direkt nach Upload passieren im Hintergrund:
 
     
  • Probe/Metadatenanalyse (ffprobe)
    •  
  • Anlage eines RAW-Ordners per Audiobook RAW Template
    •  
  • Ablage der AAX-Datei im RAW-Pfad
    •  
  • Initiale Jobkonfiguration (Format, Kapitel, Metadaten)
    •  
 
Wichtige Parameter:
 
     
  • Zielformat (m4b, mp3, flac)
    •  
  • optionaler Sofortstart
    •  
 
Toolabhängigkeit:
 
     
  • ffprobe_command für Metadaten/Kapitel
    •  
  • ffmpeg_command für Encode/Cover-Extraktion
    •  
 
2) Audiobook Jobs
 
Jobkarten zeigen Zustand, Fortschritt und verfügbare Aktionen.
 
Typische Aktionen:
 
     
  • Starten
    •  
  • Abbrechen
    •  
  • Retry
    •  
  • Löschen
    •  
  • Im Ripper (Kontextwechsel)
    •  
 
Die Karten werden regelmäßig aktualisiert und durch WebSocket-Ereignisse ergänzt.
 
3) Audiobook Output Explorer
 
Read-only Explorer des Audiobook-Outputpfads:
 
     
  • Ordner-/Dateistruktur
    •  
  • Zeitstempel/Größen
    •  
  • schnelle Ergebnisprüfung ohne Dateisystemwechsel
    •  
 
Pfad- und Template-Logik
 
  
 Bereich Gesteuert durch 
   
 RAW-Ablage raw_dir_audiobook + audiobook_raw_template 
 
 Finale Ausgabe movie_dir_audiobook + output_template_audiobook 
 
 Dateiformat Jobkonfiguration (m4b, mp3, flac) 
  
 
Typische Probleme
 
     
  • Upload wird abgelehnt: Eingabedatei ist keine AAX-Datei.
    •  
  • Start schlägt fehl: ffmpeg/ffprobe nicht aufrufbar.
    •  
  • Unerwartete Pfade: Templates enthalten ungültige oder zu generische Platzhalter.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Audiobooks - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Audiobooks
 
Die Seite Audiobooks ist der spezialisierte Workflow für Audible-*.aax-Dateien.
 
Seitenstruktur
 
Die Oberfläche besteht aus zwei Hauptbereichen:
 
     
  1. Audiobooks Upload
    2.  
  2. Audiobook Jobs
    3.  
 
1) Audiobooks Upload
 
Der Upload akzeptiert ausschließlich .aax.
 
Bedienung
 
     
  • Datei auswählen (Button oder Drag-and-Drop)
    •  
  • Upload starten
    •  
  • Auswahl entfernen oder laufenden Upload abbrechen
    •  
 
Während des Uploads zeigt die UI:
 
     
  • Prozentfortschritt
    •  
  • übertragene/gesamte Bytes
    •  
  • Statusmeldung (z. B. „Job vorbereitet“, „in Queue eingereiht“)
    •  
 
Ablauf nach erfolgreichem Upload
 
     
  • AAX wird serverseitig geprüft
    •  
  • Audiobook-Job wird angelegt
    •  
  • Job landet je nach Pipelinezustand in READY_TO_START, startet direkt oder wird eingereiht
    •  
 
2) Audiobook Jobs
 
Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der Historie.
 
Jeder Job kann eingeklappt/ausgeklappt werden und zeigt:
 
     
  • Titel-/Metadatenblock (Titel, Autor, Sprecher, Jahr, Kapitel)
    •  
  • Statusbadge
    •  
  • Fortschritt/ETA
    •  
  • ggf. Kapitel-Fortschritt
    •  
 
Konfigurierbare Job-Parameter
 
Im ausgeklappten Job:
 
     
  • Ausgabeformat (m4b, mp3, flac)
    •  
  • formatspezifische Optionen (dynamisch je Format)
    •  
  • Kapitelnamen bearbeiten
    •  
  • Pre-Rip-Ausführungen (Skript/Kette)
    •  
  • Post-Rip-Ausführungen (Skript/Kette)
    •  
 
Formatverhalten
 
     
  • m4b: eine Datei mit Kapiteln
    •  
  • mp3/flac: kapitelweise Ausgabedateien
    •  
 
Für mp3/flac zeigt die UI während/nach dem Lauf eine Kapitel-Status-Tabelle (Rip/Encode).
 
Aktionen je Job
 
     
  • Encode starten (bzw. Neustart mit aktuellen Optionen)
    •  
  • Abbrechen
    •  
  • Job löschen (mit Bestätigung)
    •  
 
Relevante Settings
 
     
  • raw_dir_audiobook
    •  
  • movie_dir_audiobook
    •  
  • audiobook_raw_template
    •  
  • output_template_audiobook
    •  
  • output_chapter_template_audiobook
    •  
  • ffprobe_command
    •  
  • ffmpeg_command
    •  
 
Typische Fehlerbilder
 
     
  • Upload wird abgelehnt: Datei ist keine gültige *.aax.
    •  
  • Start/Encode schlägt fehl: ffprobe oder ffmpeg nicht erreichbar.
    •  
  • Unerwartete Ausgabeorte: Templates/Pfade passen nicht zur gewünschten Struktur.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/converter/index.html b/site/gui/converter/index.html
index 224e05f..fdf1204 100644
--- a/site/gui/converter/index.html
+++ b/site/gui/converter/index.html
@@ -1 +1 @@
- Converter - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Converter
 
Die Seite Converter verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
 
Betriebsmodell
 
Der Converter arbeitet auf dem Eingangspfad converter_raw_dir:
 
     
  • Uploads landen dort
    •  
  • Explorer-Aktionen arbeiten dort
    •  
  • daraus werden Converter-Jobs erstellt
    •  
 
Wichtig:
 
     
  • Upload erzeugt nicht automatisch einen Job.
    •  
  • Joberstellung erfolgt explizit über Auswahl im Explorer.
    •  
 
Datei-Explorer
 
Der Explorer zeigt den kompletten Baum unter converter_raw_dir.
 
Aktionen:
 
  
 Aktion Wirkung 
   
 Upload Dateien werden in den Raw-Baum geschrieben 
 
 Ordner erstellen legt Unterordner im Raw-Baum an 
 
 Umbenennen benennt Datei/Ordner im Raw-Baum um 
 
 Verschieben verschiebt innerhalb des Raw-Baums 
 
 Löschen entfernt Datei/Ordner dauerhaft 
 
 Scannen synchronisiert Explorer und DB-Zuordnungen 
  
 
Upload-Regeln:
 
     
  • Dateiendung muss in Erlaubte Datei-Endungen* enthalten sein
    •  
  • bei Verstoß wird der Upload abgelehnt
    •  
 
Joberstellung aus Explorer-Auswahl
 
Es gibt zwei Audio-Strategien:
 
     
  1. Ein Job pro Datei
    2.  
  2. Gemeinsamer Job (Audio)
    3.  
 
Verhalten:
 
     
  • Video/ISO werden grundsätzlich als Einzeljobs angelegt.
    •  
  • Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
    •  
 
Shared-Audio-Job:
 
     
  • hält mehrere inputPaths
    •  
  • kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
    •  
 
Job-Konfiguration
 
Vor Start je Job einstellbar:
 
     
  • converterMediaType (video, audio, iso)
    •  
  • outputFormat
    •  
  • Metadaten
    •  
  • Track-/Titelwahl (bei video/iso)
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
 
Spezifika:
 
     
  • Video/ISO laufen durch Mediainfo/Review ähnlich zum Disc-Flow.
    •  
  • Audio kann direkt mit Formatoptionen konfiguriert werden.
    •  
 
Ausgabe-Pfade
 
Video/ISO
 
     
  • Root: converter_movie_dir
    •  
  • Dateiname: Output-Template (Video)
    •  
  • Endung: aus gewähltem Output-Format
    •  
 
Audio
 
     
  • Root: converter_audio_dir
    •  
  • Dateiname/Ordner: Output-Template (Audio)
    •  
  • bei Shared-/Folder-Job: Ausgabe als Ordnerstruktur mit Trackdateien
    •  
 
Queue und Start
 
Converter-Jobs laufen über dieselbe Pipeline-/Queue-Logik:
 
     
  • sofortiger Start wenn Limits frei
    •  
  • sonst Queue-Eintrag
    •  
 
Parallelität richtet sich nach den globalen Encode-Limits in Settings.
 
Auto-Scan (Polling)
 
Mit aktiviertem Polling:
 
     
  • converter_raw_dir wird zyklisch gescannt
    •  
  • neue Dateien erscheinen automatisch im Explorer
    •  
 
Relevante Settings:
 
     
  • Auto-Scan (Polling)
    •  
  • Polling-Intervall (Sekunden)
    •  
 
Abgrenzung zu Audiobooks
 
     
  • Converter: beliebige Audio/Video/ISO-Dateien
    •  
  • Audiobooks: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Converter - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Converter
 
Die Seite Converter verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
 
Betriebsmodell
 
Der Converter arbeitet auf dem Eingangspfad converter_raw_dir:
 
     
  • Uploads landen dort
    •  
  • Explorer-Aktionen arbeiten dort
    •  
  • daraus werden Converter-Jobs erstellt
    •  
 
Wichtig:
 
     
  • Upload erzeugt nicht automatisch einen Job.
    •  
  • Joberstellung erfolgt explizit über Auswahl im Explorer.
    •  
 
Datei-Explorer
 
Der Explorer zeigt den kompletten Baum unter converter_raw_dir.
 
Aktionen:
 
  
 Aktion Wirkung 
   
 Upload Dateien werden in den Raw-Baum geschrieben 
 
 Ordner erstellen legt Unterordner im Raw-Baum an 
 
 Umbenennen benennt Datei/Ordner im Raw-Baum um 
 
 Verschieben verschiebt innerhalb des Raw-Baums 
 
 Löschen entfernt Datei/Ordner dauerhaft 
 
 Scannen synchronisiert Explorer und DB-Zuordnungen 
  
 
Upload-Regeln:
 
     
  • Dateiendung muss in Erlaubte Datei-Endungen* enthalten sein
    •  
  • bei Verstoß wird der Upload abgelehnt
    •  
 
Joberstellung aus Explorer-Auswahl
 
Es gibt zwei Audio-Strategien:
 
     
  1. Ein Job pro Datei
    2.  
  2. Gemeinsamer Job (Audio)
    3.  
 
Verhalten:
 
     
  • Video/ISO werden grundsätzlich als Einzeljobs angelegt.
    •  
  • Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
    •  
 
Shared-Audio-Job:
 
     
  • hält mehrere inputPaths
    •  
  • kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
    •  
 
Job-Konfiguration
 
Vor Start je Job einstellbar:
 
     
  • converterMediaType (video, audio, iso)
    •  
  • outputFormat
    •  
  • Metadaten
    •  
  • Track-/Titelwahl (bei video/iso)
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
 
Spezifika:
 
     
  • Video/ISO laufen durch Mediainfo/Review ähnlich zum Disc-Flow.
    •  
  • Audio kann direkt mit Formatoptionen konfiguriert werden.
    •  
 
Ausgabe-Pfade
 
Video/ISO
 
     
  • Root: converter_movie_dir
    •  
  • Dateiname: Output-Template (Video)
    •  
  • Endung: aus gewähltem Output-Format
    •  
 
Audio
 
     
  • Root: converter_audio_dir
    •  
  • Dateiname/Ordner: Output-Template (Audio)
    •  
  • bei Shared-/Folder-Job: Ausgabe als Ordnerstruktur mit Trackdateien
    •  
 
Queue und Start
 
Converter-Jobs laufen über dieselbe Pipeline-/Queue-Logik:
 
     
  • sofortiger Start wenn Limits frei
    •  
  • sonst Queue-Eintrag
    •  
 
Parallelität richtet sich nach den globalen Encode-Limits in Settings.
 
Auto-Scan (Polling)
 
Mit aktiviertem Polling:
 
     
  • converter_raw_dir wird zyklisch gescannt
    •  
  • neue Dateien erscheinen automatisch im Explorer
    •  
 
Relevante Settings:
 
     
  • Auto-Scan (Polling)
    •  
  • Polling-Intervall (Sekunden)
    •  
 
Abgrenzung zu Audiobooks
 
     
  • Converter: beliebige Audio/Video/ISO-Dateien
    •  
  • Audiobooks: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/database/index.html b/site/gui/database/index.html
index e20db40..4166772 100644
--- a/site/gui/database/index.html
+++ b/site/gui/database/index.html
@@ -1 +1 @@
- Database (Expert) - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Database (Expert)
 
/database ist die Recovery- und Expertensicht für Fälle, in denen Dateisystem und Historie nicht mehr sauber zusammenpassen.
 
Zugriff
 
     
  • direkte Route: /database
    •  
  • nicht Teil der Standardnavigation
    •  
 
Bereich Gefundene RAW-Einträge
 
Dieser Bereich listet RAW-Verzeichnisse ohne zugeordneten Historie-Job.
 
Aktionen:
 
     
  • RAW prüfen: scannt konfigurierte RAW-Wurzeln
    •  
  • Job anlegen: erstellt aus einem orphan RAW einen neuen Historie-Job
    •  
 
Was bei Job anlegen passiert
 
     
  • RAW-Pfad wird als Importquelle registriert
    •  
  • Job wird in die Historie geschrieben
    •  
  • anschließende Analyse läuft als RAW-basierter Einstieg (ohne klassischen Disc-Read)
    •  
 
Typischer Einsatz:
 
     
  • manuelle Dateioperationen außerhalb der UI
    •  
  • Migrationen
    •  
  • Wiederherstellung nach abgebrochenen Läufen
    •  
 
Sicherheits- und Betriebsregeln
 
     
  • Aktionen wirken direkt auf produktive Historie/Dateipfade.
    •  
  • Vor Import oder Löschung immer Pfad und Ziel prüfen.
    •  
  • Diese Seite nur für Recovery-Szenarien nutzen, nicht für normalen Tagesbetrieb.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Database (Expert) - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Database (Expert)
 
/database ist die Recovery- und Expertensicht für Fälle, in denen Dateisystem und Historie nicht mehr sauber zusammenpassen.
 
Zugriff
 
     
  • direkte Route: /database
    •  
  • nicht Teil der Standardnavigation
    •  
 
Bereich Gefundene RAW-Einträge
 
Dieser Bereich listet RAW-Verzeichnisse ohne zugeordneten Historie-Job.
 
Aktionen:
 
     
  • RAW prüfen: scannt konfigurierte RAW-Wurzeln
    •  
  • Job anlegen: erstellt aus einem orphan RAW einen neuen Historie-Job
    •  
 
Was bei Job anlegen passiert
 
     
  • RAW-Pfad wird als Importquelle registriert
    •  
  • Job wird in die Historie geschrieben
    •  
  • anschließende Analyse läuft als RAW-basierter Einstieg (ohne klassischen Disc-Read)
    •  
 
Typischer Einsatz:
 
     
  • manuelle Dateioperationen außerhalb der UI
    •  
  • Migrationen
    •  
  • Wiederherstellung nach abgebrochenen Läufen
    •  
 
Sicherheits- und Betriebsregeln
 
     
  • Aktionen wirken direkt auf produktive Historie/Dateipfade.
    •  
  • Vor Import oder Löschung immer Pfad und Ziel prüfen.
    •  
  • Diese Seite nur für Recovery-Szenarien nutzen, nicht für normalen Tagesbetrieb.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/downloads/index.html b/site/gui/downloads/index.html
index cbe158f..6c96860 100644
--- a/site/gui/downloads/index.html
+++ b/site/gui/downloads/index.html
@@ -1 +1 @@
- Downloads - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Downloads
 
Auf Downloads werden ZIP-Archive für Historie-Artefakte erstellt und bereitgestellt.
 
Was heruntergeladen werden kann
 
Ein Download-Eintrag referenziert immer einen Historie-Job und genau ein Ziel:
 
     
  • RAW
    •  
  • Output
    •  
 
Erzeugt wird ein ZIP-Archiv im Download-Verzeichnis des Backends.
 
Statusmodell
 
  
 Status Bedeutung 
   
 queued Eintrag erstellt, wartet auf Verarbeitung 
 
 processing ZIP wird gerade gebaut 
 
 ready Archiv fertig, Download-Link aktiv 
 
 failed Erzeugung oder Zugriff fehlgeschlagen 
  
 
Eintrag anlegen
 
Startpunkt ist die Historie:
 
     
  1. Job öffnen.
    2.  
  2. Download einreihen.
    3.  
  3. Ziel (RAW oder Output) wählen.
    4.  
  4. Status in Downloads verfolgen.
    5.  
 
Wichtige Laufzeitdetails
 
     
  • Wenn bereits ein passendes, aktuelles Archiv existiert, kann der Eintrag wiederverwendet werden.
    •  
  • Nach Backend-Neustart werden unterbrochene queued/processing-Einträge geprüft und fortgesetzt.
    •  
  • Fehlt eine erwartete ZIP-Datei bei ready, wird der Eintrag auf failed gesetzt.
    •  
 
Download auslösen
 
Bei Status ready:
 
     
  • Download-Button lädt die ZIP direkt aus /api/downloads/:id/file.
    •  
 
Einträge entfernen
 
Löschen entfernt:
 
     
  • Queue-Metadaten
    •  
  • zugehörige Archivdatei
    •  
 
Nicht erlaubt:
 
     
  • Löschen während queued/processing
    •  
 
Echtzeitaktualisierung
 
Die Seite reagiert auf DOWNLOADS_UPDATED per WebSocket. Dadurch sind Statuswechsel ohne Reload sichtbar.
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Downloads - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Downloads
 
Auf Downloads werden ZIP-Archive für Historie-Artefakte erstellt und bereitgestellt.
 
Was heruntergeladen werden kann
 
Ein Download-Eintrag referenziert immer einen Historie-Job und genau ein Ziel:
 
     
  • RAW
    •  
  • Output
    •  
 
Erzeugt wird ein ZIP-Archiv im Download-Verzeichnis des Backends.
 
Statusmodell
 
  
 Status Bedeutung 
   
 queued Eintrag erstellt, wartet auf Verarbeitung 
 
 processing ZIP wird gerade gebaut 
 
 ready Archiv fertig, Download-Link aktiv 
 
 failed Erzeugung oder Zugriff fehlgeschlagen 
  
 
Eintrag anlegen
 
Startpunkt ist die Historie:
 
     
  1. Job öffnen.
    2.  
  2. Download einreihen.
    3.  
  3. Ziel (RAW oder Output) wählen.
    4.  
  4. Status in Downloads verfolgen.
    5.  
 
Wichtige Laufzeitdetails
 
     
  • Wenn bereits ein passendes, aktuelles Archiv existiert, kann der Eintrag wiederverwendet werden.
    •  
  • Nach Backend-Neustart werden unterbrochene queued/processing-Einträge geprüft und fortgesetzt.
    •  
  • Fehlt eine erwartete ZIP-Datei bei ready, wird der Eintrag auf failed gesetzt.
    •  
 
Download auslösen
 
Bei Status ready:
 
     
  • Download-Button lädt die ZIP direkt aus /api/downloads/:id/file.
    •  
 
Einträge entfernen
 
Löschen entfernt:
 
     
  • Queue-Metadaten
    •  
  • zugehörige Archivdatei
    •  
 
Nicht erlaubt:
 
     
  • Löschen während queued/processing
    •  
 
Echtzeitaktualisierung
 
Die Seite reagiert auf DOWNLOADS_UPDATED per WebSocket. Dadurch sind Statuswechsel ohne Reload sichtbar.
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/history/index.html b/site/gui/history/index.html
index 21a9bfe..6e415a0 100644
--- a/site/gui/history/index.html
+++ b/site/gui/history/index.html
@@ -1 +1 @@
- Historie - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Historie
 
Historie ist die Kontroll- und Nachbearbeitungsoberfläche für alle bereits angelegten Jobs.
 
Hauptansicht
 
Filter und Arbeitsmittel:
 
     
  • Suche (Titel, IMDb, Kontextbegriffe)
    •  
  • Statusfilter
    •  
  • Mediumfilter
    •  
  • Sortierung
    •  
  • Listen-/Grid-Layout
    •  
 
Jeder Eintrag zeigt auf einen Blick:
 
     
  • Titel, Jahr, Poster
    •  
  • Status und Zeitstempel
    •  
  • RAW-/Output-Verfügbarkeit
    •  
  • Medien- und ggf. Containerhinweise
    •  
 
Detaildialog: Was dort zusammenläuft
 
Der Detaildialog bündelt:
 
     
  • Metadaten (Film oder Serie)
    •  
  • Jobstatus und Fehlertexte
    •  
  • RAW-/Output-Pfade
    •  
  • Encode-Plan und Trackauswahl
    •  
  • ausgeführte Kommandodetails
    •  
  • Prozesslog (Tail oder vollständig)
    •  
 
Bei Seriencontainern wird disk-/child-orientiert dargestellt, nicht nur als Einzeljob.
 
Nachbearbeitungsaktionen und Wirkung
 
  
 Aktion Typischer Einsatz Technische Wirkung 
   
 OMDb neu zuordnen falsches Match, Titel/Jahr korrigieren Metadatenfelder werden neu geschrieben; Folder-Rename wird best effort angestoßen 
 
 Review neu starten neue Track-/Titelbewertung nötig Mediainfo/Review wird aus RAW neu aufgebaut 
 
 RAW neu encodieren neuer Encode aus vorhandenem RAW startet Encode ohne neuen Laufwerks-Rip 
 
 Encode neu starten gleiche bestätigte Auswahl erneut fahren letzter bestätigter Plan wird geladen, optional mit Bereinigung unvollständiger Ausgabe 
 
 Retry Rippen Rip/Analyse neu anstoßen neuer Rip-Lauf, inkl. erneuter RAW-Phase 
  
 
Löschaktionen im Dialog:
 
     
  • RAW löschen
    •  
  • Movie löschen
    •  
  • Beides löschen
    •  
  • Historieneintrag löschen
    •  
 
Löschvorschau und selektives Löschen
 
Vor endgültigem Löschen zeigt Ripster eine Vorschau mit:
 
     
  • RAW-Kandidaten
    •  
  • Movie-/Episoden-Kandidaten
    •  
  • Related-Scope (Container/Kinder/verbundene Jobs)
    •  
 
Wichtige Punkte:
 
     
  • Pfade sind selektierbar.
    •  
  • Für RAW-Löschung muss bei Mehrfachkandidaten mindestens ein RAW-Pfad gewählt werden.
    •  
  • Schutzlogik verhindert Löschungen außerhalb erlaubter Root-Verzeichnisse.
    •  
 
Serien- und Multipart-Sicht in der Historie
 
Serien
 
     
  • Container zeigt aggregierten Zustand aus Child-Jobs.
    •  
  • Disk-/Episode-Aktionen können child-spezifisch ausgeführt werden.
    •  
  • Im Ripper öffnen hilft bei Bereit zum Encodieren-Kindern.
    •  
 
Multipart
 
     
  • gemeinsamer Container mit Disc-Childs
    •  
  • Disc-Nummern bleiben pro Child nachvollziehbar
    •  
  • Delete-Preview kann Related-Pfade gemeinsam auflösen
    •  
 
Logs sinnvoll nutzen
 
     
  • Tail laden (800) für schnellen Fehlerkontext
    •  
  • Vollständiges Log laden für forensische Analyse
    •  
 
Empfehlung:
 
     
  1. Erst Tail prüfen.
    2.  
  2. Bei Pfad-/Toolproblemen vollständiges Log laden.
    3.  
  3. Danach passende Wiederanlauf-Aktion wählen.
    4.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Historie - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Historie
 
Historie ist die Kontroll- und Nachbearbeitungsoberfläche für alle bereits angelegten Jobs.
 
Hauptansicht
 
Filter und Arbeitsmittel:
 
     
  • Suche (Titel, IMDb, Kontextbegriffe)
    •  
  • Statusfilter
    •  
  • Mediumfilter
    •  
  • Sortierung
    •  
  • Listen-/Grid-Layout
    •  
 
Jeder Eintrag zeigt auf einen Blick:
 
     
  • Titel, Jahr, Poster
    •  
  • Status und Zeitstempel
    •  
  • RAW-/Output-Verfügbarkeit
    •  
  • Medien- und ggf. Containerhinweise
    •  
 
Detaildialog: Was dort zusammenläuft
 
Der Detaildialog bündelt:
 
     
  • Metadaten (Film oder Serie)
    •  
  • Jobstatus und Fehlertexte
    •  
  • RAW-/Output-Pfade
    •  
  • Encode-Plan und Trackauswahl
    •  
  • ausgeführte Kommandodetails
    •  
  • Prozesslog (Tail oder vollständig)
    •  
 
Bei Seriencontainern wird disk-/child-orientiert dargestellt, nicht nur als Einzeljob.
 
Nachbearbeitungsaktionen und Wirkung
 
  
 Aktion Typischer Einsatz Technische Wirkung 
   
 OMDb neu zuordnen falsches Match, Titel/Jahr korrigieren Metadatenfelder werden neu geschrieben; Folder-Rename wird best effort angestoßen 
 
 Review neu starten neue Track-/Titelbewertung nötig Mediainfo/Review wird aus RAW neu aufgebaut 
 
 RAW neu encodieren neuer Encode aus vorhandenem RAW startet Encode ohne neuen Laufwerks-Rip 
 
 Encode neu starten gleiche bestätigte Auswahl erneut fahren letzter bestätigter Plan wird geladen, optional mit Bereinigung unvollständiger Ausgabe 
 
 Retry Rippen Rip/Analyse neu anstoßen neuer Rip-Lauf, inkl. erneuter RAW-Phase 
  
 
Löschaktionen im Dialog:
 
     
  • RAW löschen
    •  
  • Movie löschen
    •  
  • Beides löschen
    •  
  • Historieneintrag löschen
    •  
 
Löschvorschau und selektives Löschen
 
Vor endgültigem Löschen zeigt Ripster eine Vorschau mit:
 
     
  • RAW-Kandidaten
    •  
  • Movie-/Episoden-Kandidaten
    •  
  • Related-Scope (Container/Kinder/verbundene Jobs)
    •  
 
Wichtige Punkte:
 
     
  • Pfade sind selektierbar.
    •  
  • Für RAW-Löschung muss bei Mehrfachkandidaten mindestens ein RAW-Pfad gewählt werden.
    •  
  • Schutzlogik verhindert Löschungen außerhalb erlaubter Root-Verzeichnisse.
    •  
 
Serien- und Multipart-Sicht in der Historie
 
Serien
 
     
  • Container zeigt aggregierten Zustand aus Child-Jobs.
    •  
  • Disk-/Episode-Aktionen können child-spezifisch ausgeführt werden.
    •  
  • Im Ripper öffnen hilft bei Bereit zum Encodieren-Kindern.
    •  
 
Multipart
 
     
  • gemeinsamer Container mit Disc-Childs
    •  
  • Disc-Nummern bleiben pro Child nachvollziehbar
    •  
  • Delete-Preview kann Related-Pfade gemeinsam auflösen
    •  
 
Logs sinnvoll nutzen
 
     
  • Tail laden (800) für schnellen Fehlerkontext
    •  
  • Vollständiges Log laden für forensische Analyse
    •  
 
Empfehlung:
 
     
  1. Erst Tail prüfen.
    2.  
  2. Bei Pfad-/Toolproblemen vollständiges Log laden.
    3.  
  3. Danach passende Wiederanlauf-Aktion wählen.
    4.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/index.html b/site/gui/index.html
index d2adea0..7009d69 100644
--- a/site/gui/index.html
+++ b/site/gui/index.html
@@ -1 +1 @@
- GUI-Seiten - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
GUI-Seiten
 
Dieses Kapitel ist das Bedienhandbuch für die Oberflächen im Alltag.
 
Seitenüberblick
 
  
 Seite Rolle im Betrieb Typischer Einsatz 
   
 Jobs zentrale Inbox Gesamtlage prüfen und in Fachseite springen 
 
 Ripper Live-Steuerung der Pipeline Disc-Flow starten, Queue steuern, Review freigeben 
 
 Audiobooks AAX-Spezialflow Upload, Konfiguration und Encode von Audiobooks 
 
 Settings Konfiguration/Automatisierung Pfade, Tools, Queue-Limits, Skripte, Cron 
 
 Historie Nachbearbeitung und Kontrolle Logs, Re-Encode, Löschvorschau, Recovery-Aktionen 
 
 Converter dateibasierte Konvertierung Video/Audio/ISO ohne Disc-Rip verarbeiten 
 
 Downloads ZIP-Exports RAW/Output aus Historie bereitstellen 
 
 Database (Expert) Recovery-Sicht orphan RAW finden und importieren 
  
 
Empfohlener Tagesablauf
 
     
  1. Jobs: Statuslage und Auffälligkeiten prüfen.
    2.  
  2. Ripper oder Converter/Audiobooks: neue Arbeit starten.
    3.  
  3. Historie: Ergebnisse validieren und ggf. nachbearbeiten.
    4.  
  4. Downloads: Exporte für externe Übergabe erzeugen.
    5.  
  5. Settings: Regeln und Limits nur kontrolliert anpassen.
    6.  
  
Direkt in der Top-Navigation:
 
     
  • Jobs, Ripper, Converter, Audiobooks, Settings, Historie, Downloads
    •  
 
Nur per URL:
 
     
  • Database unter /database
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ GUI-Seiten - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
GUI-Seiten
 
Dieses Kapitel ist das Bedienhandbuch für die Oberflächen im Alltag.
 
Seitenüberblick
 
  
 Seite Rolle im Betrieb Typischer Einsatz 
   
 Ripper Live-Steuerung der Pipeline Disc-Flow starten, Queue steuern, Review freigeben 
 
 Audiobooks AAX-Spezialflow Upload, Jobkonfiguration und Encode von Audiobooks 
 
 Settings Konfiguration/Automatisierung Pfade, Tools, Queue-Limits, Skripte, Cron 
 
 Historie Nachbearbeitung und Kontrolle Logs, Re-Encode, Löschvorschau, Recovery-Aktionen 
 
 Converter dateibasierte Konvertierung Video/Audio/ISO ohne Disc-Rip verarbeiten 
 
 Downloads ZIP-Exports RAW/Output aus Historie bereitstellen 
 
 Database (Expert) Recovery-Sicht orphan RAW finden und importieren 
  
 
Empfohlener Tagesablauf
 
     
  1. Ripper oder Converter/Audiobooks: neue Arbeit starten.
    2.  
  2. Historie: Ergebnisse validieren und ggf. nachbearbeiten.
    3.  
  3. Downloads: Exporte für externe Übergabe erzeugen.
    4.  
  4. Settings: Regeln und Limits nur kontrolliert anpassen.
    5.  
  
Direkt in der Top-Navigation:
 
     
  • Ripper, Converter, Audiobooks, Settings, Historie, Downloads
    •  
 
Nur per URL:
 
     
  • Database unter /database (nur Expertenmodus in der Navigation sichtbar)
    •  
  • TMDb Migration unter /tmdb-migration (Direktlink, nicht in der Navigation)
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/jobs/index.html b/site/gui/jobs/index.html
deleted file mode 100644
index 7c6f266..0000000
--- a/site/gui/jobs/index.html
+++ /dev/null
@@ -1 +0,0 @@
- Jobs - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Jobs
 
Jobs ist die zentrale Inbox über alle Jobarten und dient als schneller Einstieg in den Tagesbetrieb.
 
Zweck der Seite
 
Die Liste vereinheitlicht:
 
     
  • Disc-/Ripper-Jobs
    •  
  • Converter-Jobs
    •  
  • Audiobook-Jobs
    •  
 
Dadurch kannst du unabhängig von der Fachseite zuerst den Gesamtzustand prüfen.
 
Filterlogik
 
View-Filter
 
     
  • Alle Jobs
    •  
  • Ripper-View
    •  
  • Converter-View
    •  
  • Audiobooks
    •  
 
Status-Filter
 
     
  • Alle
    •  
  • Aktiv
    •  
  • Fehler/Abbruch
    •  
 
Zusätzlich:
 
     
  • Freitextsuche
    •  
  • Paginierung
    •  
 
Was ein Jobeintrag zeigt
 
     
  • Job-ID und Titel
    •  
  • Statusbadge
    •  
  • Jobtypbadge (z. B. Blu-ray, DVD, Converter Audio, Audiobook)
    •  
  • Aktualisierungszeit
    •  
 
Die Ansicht wird periodisch aktualisiert und ergänzt sich mit WebSocket-Events.
 
Schnellaktion pro Zeile
 
     
  • Im Ripper öffnen für Disc-/Audiobook-nahe Jobs
    •  
  • Im Converter öffnen für Converter-Jobs
    •  
 
So kommst du ohne Umwege in die Oberfläche mit den passenden Detailaktionen.
 
Empfohlener Einsatz
 
     
  1. In Jobs Störungen und Auslastung identifizieren.
    2.  
  2. Danach gezielt in Ripper, Converter oder Historie springen.
    3.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/ripper/index.html b/site/gui/ripper/index.html
index 7b5d1bd..f7c0192 100644
--- a/site/gui/ripper/index.html
+++ b/site/gui/ripper/index.html
@@ -1 +1 @@
- Ripper - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ripper
 
Die Seite Ripper ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
 
Seitenaufbau und Betriebslogik
 
Die Bereiche erscheinen in dieser Reihenfolge:
 
     
  1. Hardware Monitoring
    2.  
  2. Job Queue
    3.  
  3. Skript- / Cron-Status
    4.  
  4. Job Übersicht
    5.  
  5. Disk-Information
    6.  
 
1) Hardware Monitoring
 
Zeigt kontinuierlich:
 
     
  • CPU / RAM
    •  
  • GPU (wenn verfügbar)
    •  
  • freie Speicherstände konfigurierter Pfade
    •  
 
Nutzen im Betrieb:
 
     
  • Engpässe vor Jobfehlern erkennen
    •  
  • Pfadfüllstände vor Start großer Batchs prüfen
    •  
 
Gesteuert über Settings:
 
     
  • Hardware Monitoring aktiviert
    •  
  • Hardware Monitoring Intervall (ms)
    •  
 
2) Job Queue
 
Es gibt zwei operative Zonen:
 
     
  • Laufende Jobs
    •  
  • Warteschlange
    •  
 
Mögliche Queue-Einträge:
 
     
  • Job-Startaktionen (Start, Retry Rippen, RAW neu encodieren, Encode neu starten, Review neu berechnen, Audio CD starten)
    •  
  • Nicht-Job-Einträge (Skript, Skriptkette, Warten)
    •  
 
Wichtige Regeln:
 
     
  • Queue-Reihenfolge ist per Drag-and-Drop änderbar.
    •  
  • Warten blockiert nachfolgende Queue-Starts bis kein aktiver Prozess mehr läuft.
    •  
  • Skript und Skriptkette werden als Queue-Einträge mitgeführt.
    •  
 
Parallelität kommt aus Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge überspringen
    •  
 
3) Skript- / Cron-Status
 
Zeigt Runtime-Aktivitäten:
 
     
  • laufende Skripte
    •  
  • laufende Ketten
    •  
  • Cron-Ausführungen
    •  
  • letzte abgeschlossene Aktivitäten
    •  
 
Aktionen:
 
     
  • Nächster Schritt bei Ketten
    •  
  • Abbrechen
    •  
  • Liste leeren
    •  
 
4) Job Übersicht
 
Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick öffnet den jeweiligen Pipeline-Status.
 
Badges und Kontext
 
Neben Status/Fortschritt zeigt die Liste je nach Job:
 
     
  • Serienkontext (Serien-Container, Staffel/Disk)
    •  
  • Multipart-Kontext (Multipart Movie, Disc-Nr.)
    •  
  • Queue-/Subjob-Kontext bei Serien-Episoden
    •  
 
Zustandsabhängige Aktionen
 
  
 Zustand Hauptaktion im Ripper Ergebnis 
   
 Medium erkannt, Bereit Analyse starten startet MakeMKV-Analyse 
 
 Metadatenauswahl Metadaten öffnen Film/Serie auswählen, Provider festlegen 
 
 Warte auf Auswahl Playlist/Titel/RAW-Entscheidung bestätigen setzt Flow fort zur Prüfung 
 
 Startbereit Job starten startet Rip oder RAW-basierte Prüfung 
 
 Bereit zum Encodieren Encoding starten startet HandBrake mit bestätigter Auswahl 
 
 Laufend (Analyse, Rippen, Encodieren) Abbrechen setzt Job auf Abgebrochen 
 
 Fehler, Abgebrochen Retry Rippen neuer Rip-Anlauf 
  
 
Zusatzaktionen je nach Zustand und Jobtyp:
 
     
  • Review neu starten
    •  
  • Encode neu starten
    •  
  • RAW neu encodieren
    •  
  • Aus Queue löschen
    •  
 
Review-Bereich (Bereit zum Encodieren)
 
Hier wird die effektive Encode-Entscheidung festgelegt:
 
     
  • Titelwahl
    •  
  • Audio-/Subtitle-Trackselektion
    •  
  • User-Preset
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
  • HandBrake-Kommandovorschau
    •  
 
Ohne Bestätigung dieses Blocks startet kein produktiver Encode.
 
RAW-Ordnerphasen (sichtbar über Logs/Details)
 
Der Ripper arbeitet mit drei RAW-Zuständen:
 
     
  • Incomplete_... während unvollständigem Rip
    •  
  • Rip_Complete_... nach erfolgreich abgeschlossenem Rip, vor Encode
    •  
  • ohne Prefix nach erfolgreichem Encode
    •  
 
Das ist wichtig für Recovery und Delete-Vorschau.
 
5) Disk-Information
 
Zeigt aktuelle Laufwerksdaten:
 
     
  • Device-Pfad
    •  
  • Modell
    •  
  • Disc-Label / Mount
    •  
 
Aktionen:
 
     
  • Laufwerk neu lesen
    •  
  • Disk neu analysieren
    •  
  • Metadaten-Dialog öffnen
    •  
 
Hinweis:
 
     
  • Laufwerk neu lesen ist nicht mehr an einen festen Pipeline-State gebunden.
    •  
 
Wichtige Dialoge
 
Metadaten auswählen
 
Im Dialog werden Film-/Serienmetadaten bestätigt.
 
Sonderfälle:
 
     
  • Film-Duplikat: Übernahme erzwingen oder Multipart movie
    •  
  • Serie: Disc-Nummer ist Pflicht
    •  
 
Vorhandenes RAW erkannt
 
Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
 
     
  • vorhandenes RAW verwenden
    •  
  • RAW verwerfen/löschen und neu rippen
    •  
 
Queue-Eintrag einfügen
 
Du kannst gezielt ab Position einfügen:
 
     
  • Skript
    •  
  • Skriptkette
    •  
  • Wartezeit
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Ripper - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ripper
 
Die Seite Ripper ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
 
Seitenaufbau und Betriebslogik
 
Die Bereiche erscheinen in dieser Reihenfolge:
 
     
  1. Hardware Monitoring
    2.  
  2. Job Queue
    3.  
  3. Skript- / Cron-Status
    4.  
  4. Job Übersicht
    5.  
  5. Disk-Information
    6.  
 
1) Hardware Monitoring
 
Zeigt kontinuierlich:
 
     
  • CPU / RAM
    •  
  • GPU (wenn verfügbar)
    •  
  • freie Speicherstände konfigurierter Pfade
    •  
 
Nutzen im Betrieb:
 
     
  • Engpässe vor Jobfehlern erkennen
    •  
  • Pfadfüllstände vor Start großer Batchs prüfen
    •  
 
Gesteuert über Settings:
 
     
  • Hardware Monitoring aktiviert
    •  
  • Hardware Monitoring Intervall (ms)
    •  
 
2) Job Queue
 
Es gibt zwei operative Zonen:
 
     
  • Laufende Jobs
    •  
  • Warteschlange
    •  
 
Mögliche Queue-Einträge:
 
     
  • Job-Startaktionen (Start, Retry Rippen, RAW neu encodieren, Encode neu starten, Review neu berechnen, Audio CD starten)
    •  
  • Nicht-Job-Einträge (Skript, Skriptkette, Warten)
    •  
 
Wichtige Regeln:
 
     
  • Queue-Reihenfolge ist per Drag-and-Drop änderbar.
    •  
  • Warten blockiert nachfolgende Queue-Starts bis kein aktiver Prozess mehr läuft.
    •  
  • Skript und Skriptkette werden als Queue-Einträge mitgeführt.
    •  
 
Parallelität kommt aus Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge überspringen
    •  
 
3) Skript- / Cron-Status
 
Zeigt Runtime-Aktivitäten:
 
     
  • laufende Skripte
    •  
  • laufende Ketten
    •  
  • Cron-Ausführungen
    •  
  • letzte abgeschlossene Aktivitäten
    •  
 
Aktionen:
 
     
  • Nächster Schritt bei Ketten
    •  
  • Abbrechen
    •  
  • Liste leeren
    •  
 
4) Job Übersicht
 
Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick öffnet den jeweiligen Pipeline-Status.
 
Badges und Kontext
 
Neben Status/Fortschritt zeigt die Liste je nach Job:
 
     
  • Serienkontext (Serien-Container, Staffel/Disk)
    •  
  • Multipart-Kontext (Multipart Movie, Disc-Nr.)
    •  
  • Queue-/Subjob-Kontext bei Serien-Episoden
    •  
 
Zustandsabhängige Aktionen
 
  
 Zustand Hauptaktion im Ripper Ergebnis 
   
 Medium erkannt, Bereit Analyse starten startet MakeMKV-Analyse 
 
 Metadatenauswahl Metadaten öffnen Film/Serie auswählen, Provider festlegen 
 
 Warte auf Auswahl Playlist/Titel/RAW-Entscheidung bestätigen setzt Flow fort zur Prüfung 
 
 Startbereit Job starten startet Rip oder RAW-basierte Prüfung 
 
 Bereit zum Encodieren Encoding starten startet HandBrake mit bestätigter Auswahl 
 
 Laufend (Analyse, Rippen, Encodieren) Abbrechen setzt Job auf Abgebrochen 
 
 Fehler, Abgebrochen Retry Rippen neuer Rip-Anlauf 
  
 
Zusatzaktionen je nach Zustand und Jobtyp:
 
     
  • Review neu starten
    •  
  • Encode neu starten
    •  
  • RAW neu encodieren
    •  
  • Aus Queue löschen
    •  
 
Review-Bereich (Bereit zum Encodieren)
 
Hier wird die effektive Encode-Entscheidung festgelegt:
 
     
  • Titelwahl
    •  
  • Audio-/Subtitle-Trackselektion
    •  
  • User-Preset
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
  • HandBrake-Kommandovorschau
    •  
 
Ohne Bestätigung dieses Blocks startet kein produktiver Encode.
 
RAW-Ordnerphasen (sichtbar über Logs/Details)
 
Der Ripper arbeitet mit drei RAW-Zuständen:
 
     
  • Incomplete_... während unvollständigem Rip
    •  
  • Rip_Complete_... nach erfolgreich abgeschlossenem Rip, vor Encode
    •  
  • ohne Prefix nach erfolgreichem Encode
    •  
 
Das ist wichtig für Recovery und Delete-Vorschau.
 
5) Disk-Information
 
Zeigt aktuelle Laufwerksdaten:
 
     
  • Device-Pfad
    •  
  • Modell
    •  
  • Disc-Label / Mount
    •  
 
Aktionen:
 
     
  • Laufwerk neu lesen
    •  
  • Disk neu analysieren
    •  
  • Metadaten-Dialog öffnen
    •  
 
Hinweis:
 
     
  • Laufwerk neu lesen ist nicht mehr an einen festen Pipeline-State gebunden.
    •  
 
Wichtige Dialoge
 
Metadaten auswählen
 
Im Dialog werden Film-/Serienmetadaten bestätigt.
 
Sonderfälle:
 
     
  • Film-Duplikat: Übernahme erzwingen oder Multipart movie
    •  
  • Serie: Disc-Nummer ist Pflicht
    •  
 
Vorhandenes RAW erkannt
 
Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
 
     
  • vorhandenes RAW verwenden
    •  
  • RAW verwerfen/löschen und neu rippen
    •  
 
Queue-Eintrag einfügen
 
Du kannst gezielt ab Position einfügen:
 
     
  • Skript
    •  
  • Skriptkette
    •  
  • Wartezeit
    •  
 
Audible Activation Bytes eintragen
 
Wenn für eine AAX-Datei keine Activation Bytes automatisch ermittelt werden können, öffnet Ripster einen Dialog zur manuellen Eingabe.
 
     
  • Eingabeformat: genau 8 Hex-Zeichen (z.B. 1a2b3c4d)
    •  
  • Speicherung: lokal im Activation-Bytes-Cache
    •  
  • Wirkung: nach dem Speichern kann der Audiobook-Flow fortgesetzt werden
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/gui/settings/index.html b/site/gui/settings/index.html
index 03f24ac..d4b2843 100644
--- a/site/gui/settings/index.html
+++ b/site/gui/settings/index.html
@@ -1 +1 @@
- Settings - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Settings
 
Die Seite Settings steuert alle Betriebsparameter von Ripster: Pfade, Tools, Queue-Limits, Metadatenquellen, Automatisierung.
 
Tab-Überblick
 
  
 Tab Hauptzweck 
   
 Konfiguration globale und profilspezifische Laufzeitsettings 
 
 Scripte einzelne Skripte verwalten und testen 
 
 Skriptketten mehrstufige Abläufe aus Skript/Warten 
 
 Encode-Presets wiederverwendbare HandBrake-Profile für Review 
 
 Cronjobs zeitgesteuerte Ausführung von Skript/Kette 
  
 
Tab Konfiguration
 
Bedienprinzip
 
     
  1. Werte ändern.
    2.  
  2. Änderungen speichern.
    3.  
  3. erst danach sind Werte für neue Aktionen wirksam.
    4.  
 
Zusätzliche Bedienhilfen:
 
     
  • Neu laden verwirft lokale Formzustände
    •  
  • Änderungen verwerfen setzt auf zuletzt gespeicherten Stand
    •  
  • PushOver Test validiert Benachrichtigungszugang sofort
    •  
 
Was wirkt unmittelbar, was erst bei neuem Job?
 
     
  • Queue-/Parallelität wirkt auf neue Queue-Entscheidungen und Pump-Läufe.
    •  
  • Tool-/Pfad-/Template-Änderungen wirken vollständig auf neu gestartete Schritte.
    •  
  • Bereits laufende Prozesse übernehmen Änderungen in der Regel nicht rückwirkend.
    •  
 
Welche Bereiche im Alltag kritisch sind
 
  
 Bereich Kritisch für 
   
 Pfade wo RAW, finale Ausgaben, Converter/Audiobook-Dateien landen 
 
 Tools ob Analyze/Rip/Encode ausführbar sind 
 
 Metadaten Film-/Serienzuordnung und Episode-Mapping 
 
 Queue-Limits Durchsatz und Reihenfolgeverhalten 
 
 Monitoring Sichtbarkeit von Last und Speicherengpässen 
 
 Benachrichtigungen PushOver-Ereignisse je Pipelinephase 
  
 
Tab Scripte
 
Funktionen:
 
     
  • anlegen, bearbeiten, löschen
    •  
  • testen (Test)
    •  
  • sortieren
    •  
 
Testausführung liefert:
 
     
  • Exit-Code
    •  
  • Dauer
    •  
  • stdout/stderr
    •  
 
Wichtig:
 
     
  • Nur erfolgreiche Skripte sollten in produktive Pre-/Post-Listen übernommen werden.
    •  
 
Tab Skriptketten
 
Ketten bestehen aus Schritten:
 
     
  • Skript
    •  
  • Warten
    •  
 
Typischer Einsatz:
 
     
  • externe Hooks vor/nach Encode
    •  
  • gestaffelte Abläufe mit Pausen
    •  
 
In der Queue erscheinen Ketten als eigene Einträge und werden dort ausgeführt.
 
Tab Encode-Presets
 
Ein Preset bündelt:
 
     
  • optionales HandBrake-Preset (-Z)
    •  
  • optionale Extra-Args
    •  
  • Medienziel (Universell/Blu-ray/DVD/Sonstiges)
    •  
 
Im Ripper-Review kannst du Presets pro Job auswählen, statt Parameter jedes Mal neu zu setzen.
 
Tab Cronjobs
 
Funktionen:
 
     
  • Cronjob anlegen und bearbeiten
    •  
  • Quelle wählen (Skript oder Skriptkette)
    •  
  • Cron-Ausdruck prüfen
    •  
  • Jetzt ausführen
    •  
  • Job-Logs ansehen
    •  
  • Aktivierung/Pushover toggeln
    •  
 
Empfehlung:
 
     
  1. Skript/Kette manuell testen.
    2.  
  2. Dann Cron aktivieren.
    3.  
  3. Erste automatische Läufe aktiv im Runtime-Status kontrollieren.
    4.  
 
Verbindung zur Einstellungsreferenz
 
Die vollständige Wirkung jeder einzelnen Einstellung steht in Einstellungsreferenz.
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Settings - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Settings
 
Die Seite Settings ist das zentrale Kontrollpanel für Laufzeitverhalten, Automatisierung und Expertenfunktionen.
 
Tab-Überblick
 
  
 Tab Zweck 
   
 Konfiguration Alle fachlichen Settings (Pfade, Tools, Laufwerk, Metadaten, Monitoring, Benachrichtigungen, Converter) 
 
 Scripte Einzelne Bash-Skripte pflegen, testen und sortieren 
 
 Skriptketten Mehrstufige Sequenzen aus Skript und Warten bauen und testen 
 
 Encode-Presets Benutzer-Presets und Standard-Zuordnungen für Blu-ray/DVD-Workflows 
 
 Cronjobs Zeitgesteuerte Jobs auf Basis Skript/Skriptkette 
  
 
Tab Konfiguration
 
Bedienlogik
 
     
  1. Felder ändern.
    2.  
  2. Änderungen speichern klicken.
    3.  
  3. Erst dann werden Änderungen persistiert und für neue Pipeline-Schritte wirksam.
    4.  
 
Aktionen in der Toolbar:
 
     
  • Änderungen speichern: schreibt nur geänderte Felder als Bulk-Update.
    •  
  • Änderungen verwerfen: setzt den Formularzustand auf zuletzt geladen/zum Server gespeicherten Stand zurück.
    •  
  • Neu laden: lädt Kategorien + Werte erneut vom Backend.
    •  
  • PushOver Test: sendet eine Testnachricht mit aktuellen PushOver-Werten.
    •  
  • Coverarts prüfen: startet die manuelle Coverart-Recovery.
    •  
  • Expertenmodus: wird sofort gespeichert (nicht Teil des normalen Bulk-Speicherns).
    •  
 
Wichtige UI-Verhalten
 
     
  • Jede Einstellung zeigt Gespeichert oder Ungespeichert direkt am Feld.
    •  
  • Pflichtfelder sind mit * markiert.
    •  
  • Bei Validierungsfehlern wird pro Feld ein Fehlertext angezeigt und Speichern blockiert.
    •  
  • Tool-Kommandos (makemkv_command, mediainfo_command, handbrake_command, ffmpeg_command, ffprobe_command, cdparanoia_command, mkvmerge_command) sind im Formular schreibgeschützt markiert.
    •  
  • Einige Felder sind abhängig vom Expertenmodus sichtbar.
    •  
 
Kategorie Pfade: Besondere Interaktion
 
Die Pfad-Kategorie hat eine eigene Darstellung:
 
     
  • Tabelle Effektive Pfade: zeigt die aktuell tatsächlich aufgelösten Laufzeitpfade inkl. Fallbacks.
    •  
  • Accordion je Bereich (Blu-ray, DVD, CD / Audio, Audiobook, Converter, Downloads, optional Externe Speicher, Logs).
    •  
  • Für Pfadfelder mit Owner-Pendant (*_owner) erscheint direkt darunter das Feld Eigentümer (user:gruppe).
    •  
  • Owner-Felder sind deaktiviert, solange der zugehörige Pfad leer ist.
    •  
 
Spezial-Editoren in der Konfiguration
 
     
  • drive_devices: JSON-Array wird über UI-Editor gepflegt (Pfad + MakeMKV-Index je Laufwerk).
    •  
  • external_storage_paths: Liste aus Name + Pfad (für Anzeige freier externer Speicher).
    •  
  • converter_scan_extensions: Checkbox-Raster der erlaubten Endungen; mindestens eine Endung muss aktiv bleiben.
    •  
  • makemkv_registration_key: zusätzlicher Betakey-Hinweis mit übernehmen-Button.
    •  
 
Laufwerks-Infobox innerhalb Laufwerk
 
In der Kategorie Laufwerk wird eine Live-Tabelle erkannter optischer Laufwerke angezeigt:
 
     
  • Neu einlesen lädt Laufwerksinfos neu.
    •  
  • Im Expertenmodus: Freigeben pro Laufwerk und Alle Laufwerke freigeben.
    •  
 
Tab Scripte
 
Funktionen:
 
     
  • Skript anlegen (Inline-Editor)
    •  
  • Skript bearbeiten (Dialog)
    •  
  • Skript löschen (mit Bestätigung)
    •  
  • Skript testen
    •  
  • Reihenfolge per Drag-and-Drop ändern
    •  
 
Testergebnis enthält:
 
     
  • Erfolg/Fehler
    •  
  • Exit-Code
    •  
  • Timeout-Info
    •  
  • Dauer
    •  
  • stdout/stderr
    •  
 
Tab Skriptketten
 
Skriptketten bestehen aus Schritten:
 
     
  • Skript
    •  
  • Warten (Sekunden)
    •  
 
Funktionen:
 
     
  • Ketten anlegen/bearbeiten/löschen
    •  
  • Reihenfolge der Ketten per Drag-and-Drop
    •  
  • Kette testen
    •  
  • Schritte in der Kette per Drag-and-Drop neu anordnen
    •  
 
Im Ketteneditor:
 
     
  • linke Palette (Systemblöcke, Scripte)
    •  
  • rechte Canvas mit Drop-Zonen
    •  
  • pro Warte-Schritt konfigurierbare Sekunden
    •  
 
Tab Encode-Presets
 
Bereiche:
 
     
  1. Standard-Zuordnungen (Slots)
    2.  
  2. Preset-Liste (CRUD)
    3.  
 
Standard-Zuordnungen
 
Es gibt vier persistente Slots:
 
     
  • bluray_movie
    •  
  • bluray_series
    •  
  • dvd_movie
    •  
  • dvd_series
    •  
 
Die Auswahl ist medientyp-kompatibel gefiltert. Nicht kompatible oder fehlende bereits gespeicherte IDs werden weiterhin sichtbar gemacht, damit bestehende Zuordnungen nachvollziehbar bleiben.
 
Preset-Inhalt
 
Ein Preset umfasst:
 
     
  • Name
    •  
  • Medientyp (all, bluray, dvd)
    •  
  • HandBrake-Preset (-Z)
    •  
  • Extra Args
    •  
  • optionale Beschreibung
    •  
 
Tab Cronjobs
 
Funktionen:
 
     
  • Cronjob erstellen/bearbeiten/löschen
    •  
  • Debounced Validierung des Cron-Ausdrucks
    •  
  • Quelle wählen: Skript oder Skriptkette
    •  
  • Aktiv- und PushOver-Toggle je Job
    •  
  • Jetzt ausführen
    •  
  • Lauf-Logs öffnen
    •  
 
Die Seite zeigt zusätzlich Live-Status laufender Cron-Aktivitäten (Runtime Activities).
 
Expertenbereich: Activation Bytes Cache
 
Der Activation-Bytes-Block wird nur im Expertenmodus angezeigt und nur wenn Einträge vorhanden sind.
 
Er zeigt:
 
     
  • AAX-Checksum
    •  
  • Activation Bytes
    •  
  • Speicherzeitpunkt
    •  
 
Validierungshinweise für Template-Felder
 
Template-Felder akzeptieren nur:
 
     
  • Buchstaben/Ziffern
    •  
  • Leerzeichen
    •  
  • _ und -
    •  
  • Platzhalter in {...} bzw. ${...}
    •  
  • / für Ordnertrennung
    •  
 
Nicht erlaubt sind z. B. unvollständige geschweifte Klammern oder sonstige Sonderzeichen.
 
Siehe auch
  
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/index.html b/site/index.html
index 2919169..98ac41c 100644
--- a/site/index.html
+++ b/site/index.html
@@ -1 +1 @@
- Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ripster Handbuch
 
Diese Dokumentation ist als vollständiges Benutzerhandbuch aufgebaut: tägliche Bedienung zuerst, technische Referenz danach.
 
Einstieg in 3 Schritten
 
     
  1. Installation: Installation
    2.  
  2. Betriebskonfiguration: Ersteinrichtung
    3.  
  3. erster End-to-End-Lauf: Erster Lauf
    4.  
 
Was das Handbuch abdeckt
 
     
  • alle GUI-Seiten mit Aktionen und Wirkung
    •  
  • vollständige Workflows für Film, Serie und Multipart
    •  
  • Queue-, Job-, Container- und Recovery-Verhalten
    •  
  • detaillierte Settings-Wirkung inklusive Fallbacks
    •  
 
Empfohlene Lesereihenfolge
 
     
  1. Benutzerhandbuch Überblick
    2.  
  2. GUI-Seiten
    3.  
  3. Workflows aus Nutzersicht
    4.  
  4. Einstellungsreferenz
    5.  
  5. bei Bedarf technischer Tiefgang im Anhang
    6.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Ripster Handbuch
 
Diese Dokumentation ist als vollständiges Benutzerhandbuch aufgebaut: tägliche Bedienung zuerst, technische Referenz danach.
 
Einstieg in 3 Schritten
 
     
  1. Installation: Installation
    2.  
  2. Betriebskonfiguration: Ersteinrichtung
    3.  
  3. erster End-to-End-Lauf: Erster Lauf
    4.  
 
Was das Handbuch abdeckt
 
     
  • alle GUI-Seiten mit Aktionen und Wirkung
    •  
  • vollständige Workflows für Film, Serie und Multipart
    •  
  • Queue-, Job-, Container- und Recovery-Verhalten
    •  
  • detaillierte Settings-Wirkung inklusive Fallbacks
    •  
 
Empfohlene Lesereihenfolge
 
     
  1. Benutzerhandbuch Überblick
    2.  
  2. GUI-Seiten
    3.  
  3. Workflows aus Nutzersicht
    4.  
  4. Einstellungsreferenz
    5.  
  5. bei Bedarf technischer Tiefgang im Anhang
    6.  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/pipeline/encoding/index.html b/site/pipeline/encoding/index.html
index 43e21c9..86662fa 100644
--- a/site/pipeline/encoding/index.html
+++ b/site/pipeline/encoding/index.html
@@ -1,4 +1,4 @@
- Encode-Planung & Track-Auswahl - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Encode-Planung & Track-Auswahl
 
Vor dem eigentlichen Encoding erstellt Ripster einen Encode-Plan und zeigt ihn im Review an.
 
 
Ablauf
 
Quelle bestimmen (Disc/RAW)
+ Encode-Planung & Track-Auswahl - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Encode-Planung & Track-Auswahl
 
Vor dem eigentlichen Encoding erstellt Ripster einen Encode-Plan und zeigt ihn im Review an.
 
 
Ablauf
 
Quelle bestimmen (Disc/RAW)
   -> HandBrake-Scan (--scan --json)
   -> Plan erstellen (Titel, Audio, Untertitel)
   -> Status: Bereit zum Encodieren
diff --git a/site/pipeline/index.html b/site/pipeline/index.html
index f907d6a..5d9798e 100644
--- a/site/pipeline/index.html
+++ b/site/pipeline/index.html
@@ -1 +1 @@
- Anhang: Pipeline intern - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Pipeline intern
 
Dieser Abschnitt beschreibt die technische Pipeline-Logik hinter den UI-Workflows.
 
 
     
  •  
     Workflow & Zustände
     
     
    Zustandsmodell, Übergänge, Queue-Verhalten.
     
     Workflow
     
    •  
  •  
     Encode-Planung
     
     
    Aufbereitung von Titeln/Tracks und Bestätigungslogik.
     
     Encoding
     
    •  
  •  
     Playlist-Analyse
     
     
    Bewertung mehrdeutiger Blu-ray-Playlists.
     
     Playlist-Analyse
     
    •  
  •  
     Pre-/Post-Encode-Ausführungen
     
     
    Skript- und Kettenlauf vor/nach dem Encoding.
     
     Encode-Skripte
     
    •  
 
 
Zurück zum Handbuch
  
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Anhang: Pipeline intern - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Pipeline intern
 
Dieser Abschnitt beschreibt die technische Pipeline-Logik hinter den UI-Workflows.
 
 
     
  •  
     Workflow & Zustände
     
     
    Zustandsmodell, Übergänge, Queue-Verhalten.
     
     Workflow
     
    •  
  •  
     Encode-Planung
     
     
    Aufbereitung von Titeln/Tracks und Bestätigungslogik.
     
     Encoding
     
    •  
  •  
     Playlist-Analyse
     
     
    Bewertung mehrdeutiger Blu-ray-Playlists.
     
     Playlist-Analyse
     
    •  
  •  
     Pre-/Post-Encode-Ausführungen
     
     
    Skript- und Kettenlauf vor/nach dem Encoding.
     
     Encode-Skripte
     
    •  
 
 
Zurück zum Handbuch
  
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/pipeline/playlist-analysis/index.html b/site/pipeline/playlist-analysis/index.html
index aa2c3f4..ab64e35 100644
--- a/site/pipeline/playlist-analysis/index.html
+++ b/site/pipeline/playlist-analysis/index.html
@@ -1 +1 @@
- Playlist-Analyse - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Playlist-Analyse
 
Ripster analysiert bei Blu-ray-ähnlichen Quellen Playlists und fordert bei Mehrdeutigkeit eine manuelle Auswahl an.
 
 
Ziel
 
Erkennen, welche Playlist sehr wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
 
 
Eingabedaten
 
Die Analyse basiert auf MakeMKV-Infos (u. a. Playlist-/Segment-Struktur, Laufzeiten, Titelzuordnung).
 
 
Auswertung (vereinfacht)
 
Für Kandidaten werden u. a. berücksichtigt:
 
     
  • Laufzeit
    •  
  • Segment-Reihenfolge
    •  
  • Rückwärtssprünge/große Sprünge
    •  
  • Kohärenz linearer Segmentfolgen
    •  
  • Duplikatgruppen mit ähnlicher Laufzeit
    •  
 
Daraus entstehen intern Kandidatenlisten, Bewertungen und eine Empfehlung.
 
 
Wann muss der Benutzer entscheiden?
 
Wenn nach Filterung mehr als ein relevanter Kandidat übrig bleibt, wechselt der Job in der GUI auf:
 
     
  • Warte auf Auswahl
    •  
 
Dann muss eine Playlist bestätigt werden, bevor der Workflow weiterläuft.
 
 
Konfigurationseinfluss
 
  
 Feld in Settings Wirkung 
   
 Minimale Titellaenge (Minuten) Mindestlaufzeit für Kandidaten 
  
 
Default ist aktuell 60 Minuten.
 
 
UI-Verhalten
 
Bei manueller Entscheidung zeigt das Ripper Kandidaten inkl. Score/Bewertung und markiert eine Empfehlung.
 
Nach Bestätigung:
 
     
  • mit vorhandenem RAW -> zurück zu Mediainfo-Pruefung
    •  
  • ohne RAW -> Startpfad über Startbereit / Rippen
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Playlist-Analyse - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Playlist-Analyse
 
Ripster analysiert bei Blu-ray-ähnlichen Quellen Playlists und fordert bei Mehrdeutigkeit eine manuelle Auswahl an.
 
 
Ziel
 
Erkennen, welche Playlist sehr wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
 
 
Eingabedaten
 
Die Analyse basiert auf MakeMKV-Infos (u. a. Playlist-/Segment-Struktur, Laufzeiten, Titelzuordnung).
 
 
Auswertung (vereinfacht)
 
Für Kandidaten werden u. a. berücksichtigt:
 
     
  • Laufzeit
    •  
  • Segment-Reihenfolge
    •  
  • Rückwärtssprünge/große Sprünge
    •  
  • Kohärenz linearer Segmentfolgen
    •  
  • Duplikatgruppen mit ähnlicher Laufzeit
    •  
 
Daraus entstehen intern Kandidatenlisten, Bewertungen und eine Empfehlung.
 
 
Wann muss der Benutzer entscheiden?
 
Wenn nach Filterung mehr als ein relevanter Kandidat übrig bleibt, wechselt der Job in der GUI auf:
 
     
  • Warte auf Auswahl
    •  
 
Dann muss eine Playlist bestätigt werden, bevor der Workflow weiterläuft.
 
 
Konfigurationseinfluss
 
  
 Feld in Settings Wirkung 
   
 Minimale Titellaenge (Minuten) Mindestlaufzeit für Kandidaten 
  
 
Default ist aktuell 60 Minuten.
 
 
UI-Verhalten
 
Bei manueller Entscheidung zeigt das Ripper Kandidaten inkl. Score/Bewertung und markiert eine Empfehlung.
 
Nach Bestätigung:
 
     
  • mit vorhandenem RAW -> zurück zu Mediainfo-Pruefung
    •  
  • ohne RAW -> Startpfad über Startbereit / Rippen
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/pipeline/post-encode-scripts/index.html b/site/pipeline/post-encode-scripts/index.html
index a75961a..eef65b4 100644
--- a/site/pipeline/post-encode-scripts/index.html
+++ b/site/pipeline/post-encode-scripts/index.html
@@ -1,4 +1,4 @@
- Encode-Skripte (Pre & Post) - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Encode-Skripte (Pre & Post)
 
Ripster kann Skripte und Skript-Ketten vor und nach dem Encode ausführen.
 
 
Ablauf
 
Bereit zum Encodieren
+ Encode-Skripte (Pre & Post) - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Encode-Skripte (Pre & Post)
 
Ripster kann Skripte und Skript-Ketten vor und nach dem Encode ausführen.
 
 
Ablauf
 
Bereit zum Encodieren
   -> Pre-Encode Skripte/Ketten
   -> HandBrake Encoding
   -> Post-Encode Skripte/Ketten
diff --git a/site/pipeline/workflow/index.html b/site/pipeline/workflow/index.html
index 471035a..6d10e6c 100644
--- a/site/pipeline/workflow/index.html
+++ b/site/pipeline/workflow/index.html
@@ -1,4 +1,4 @@
- Workflow & Zustände - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Workflow & Zustände
 
Ripster steuert den Ablauf als Zustandsmaschine.
 
 
Zustandsdiagramm (vereinfacht)
 
flowchart LR
+ Workflow & Zustände - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Workflow & Zustände
 
Ripster steuert den Ablauf als Zustandsmaschine.
 
 
Zustandsdiagramm (vereinfacht)
 
flowchart LR
     A[Bereit] --> B[Medium erkannt]
     B --> C[Analyse]
     C --> D[Metadatenauswahl]
diff --git a/site/search/search_index.json b/site/search/search_index.json
index 154378a..5828d82 100644
--- a/site/search/search_index.json
+++ b/site/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["de"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Ripster Handbuch","text":"
Diese Dokumentation ist als vollst\u00e4ndiges Benutzerhandbuch aufgebaut: t\u00e4gliche Bedienung zuerst, technische Referenz danach.
"},{"location":"#einstieg-in-3-schritten","title":"Einstieg in 3 Schritten","text":"
     
  1. Installation: Installation
    2.  
  2. Betriebskonfiguration: Ersteinrichtung
    3.  
  3. erster End-to-End-Lauf: Erster Lauf
    4.  
"},{"location":"#was-das-handbuch-abdeckt","title":"Was das Handbuch abdeckt","text":"
     
  • alle GUI-Seiten mit Aktionen und Wirkung
    •  
  • vollst\u00e4ndige Workflows f\u00fcr Film, Serie und Multipart
    •  
  • Queue-, Job-, Container- und Recovery-Verhalten
    •  
  • detaillierte Settings-Wirkung inklusive Fallbacks
    •  
"},{"location":"#empfohlene-lesereihenfolge","title":"Empfohlene Lesereihenfolge","text":"
     
  1. Benutzerhandbuch \u00dcberblick
    2.  
  2. GUI-Seiten
    3.  
  3. Workflows aus Nutzersicht
    4.  
  4. Einstellungsreferenz
    5.  
  5. bei Bedarf technischer Tiefgang im Anhang
    6.  
"},{"location":"api/","title":"Anhang: API-Referenz","text":"
REST- und WebSocket-Schnittstellen f\u00fcr Integration, Automatisierung und Debugging.
"},{"location":"api/#basis-url","title":"Basis-URL","text":"
http://localhost:3001\n
 
API-Prefix: /api
"},{"location":"api/#api-gruppen","title":"API-Gruppen","text":"
     
  •  
     Health
     
    Service-Liveness.
     
    GET /api/health
     
    •  
  •  
     Pipeline API
     
    Analyse, Start/Retry/Cancel, Queue, Re-Encode.
     
     Pipeline API
     
    •  
  •  
     Settings API
     
    Einstellungen, Skripte/Ketten, User-Presets.
     
     Settings API
     
    •  
  •  
     History API
     
    Job-Historie, Orphan-Import, L\u00f6schoperationen.
     
     History API
     
    •  
  •  
     Cron API
     
    Zeitgesteuerte Skript-/Kettenausf\u00fchrung.
     
     Cron API
     
    •  
  •  
     Converter API
     
    Datei-Explorer, Upload, Job-Verwaltung f\u00fcr den Converter.
     
     Converter API
     
    •  
  •  
     Downloads API
     
    Download-Queue f\u00fcr Ausgabedateien aus der Job-Historie.
     
     Downloads API
     
    •  
  •  
     Runtime Activities API
     
    Laufende und abgeschlossene Aktivit\u00e4ten (Skripte, Ketten, Cron, Tasks).
     
     Runtime Activities
     
    •  
  •  
    :material-websocket: WebSocket Events
     
    Pipeline-, Queue-, Disk-, Settings-, Cron-, Converter- und Download-Events.
     
     WebSocket
     
    •  
"},{"location":"api/#hinweis","title":"Hinweis","text":"
Ripster hat keine eingebaute Authentifizierung und ist f\u00fcr lokalen, gesch\u00fctzten Betrieb gedacht.
"},{"location":"api/converter/","title":"Converter API","text":"
Endpunkte f\u00fcr den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.
 
Basis-Pfad: /api/converter
"},{"location":"api/converter/#scan-explorer","title":"Scan & Explorer","text":""},{"location":"api/converter/#get-apiconvertertree","title":"GET /api/converter/tree","text":"
Vollst\u00e4ndiger Verzeichnisbaum des converter_raw_dir (FS-basiert, keine DB).
 
Response:
 
{\n  \"tree\": [\n    {\n      \"name\": \"filme\",\n      \"relPath\": \"filme\",\n      \"isDir\": true,\n      \"children\": [\n        {\n          \"name\": \"film.mkv\",\n          \"relPath\": \"filme/film.mkv\",\n          \"isDir\": false,\n          \"size\": 10485760\n        }\n      ]\n    }\n  ]\n}\n
"},{"location":"api/converter/#get-apiconverterbrowseparentrelpath","title":"GET /api/converter/browse?parent=relPath","text":"
DB-basierter Datei-Explorer. Gibt Eintr\u00e4ge f\u00fcr einen Unterordner zur\u00fcck.
 
Query-Parameter:
 Parameter Typ Beschreibung parent string Relativer Pfad zum Unterordner (leer = Root) 
Response:
 
{\n  \"entries\": [\n    {\n      \"id\": 1,\n      \"rel_path\": \"filme/film.mkv\",\n      \"is_dir\": false,\n      \"size\": 10485760,\n      \"job_id\": null\n    }\n  ],\n  \"rawDir\": \"/data/output/converter-raw\"\n}\n
"},{"location":"api/converter/#post-apiconverterscan","title":"POST /api/converter/scan","text":"
Manuellen Scan des converter_raw_dir ausl\u00f6sen. Aktualisiert converter_scan_entries in der DB.
 
Response:
 
{ \"result\": { \"added\": 3, \"removed\": 1 } }\n
"},{"location":"api/converter/#jobs-erstellen","title":"Jobs erstellen","text":""},{"location":"api/converter/#post-apiconverterjobsfrom-selection","title":"POST /api/converter/jobs/from-selection","text":"
Jobs aus im Datei-Explorer ausgew\u00e4hlten Dateien erstellen.
 
Body:
 
{\n  \"relPaths\": [\"filme/film.mkv\", \"musik/track.flac\"],\n  \"audioMode\": \"individual\"\n}\n
 Feld Typ Beschreibung relPaths string[] Relative Pfade der ausgew\u00e4hlten Dateien audioMode string individual (ein Job pro Datei) oder shared (ein gemeinsamer Job) 
Response:
 
{ \"jobs\": [{ \"id\": 42, \"status\": \"READY_TO_START\" }] }\n
"},{"location":"api/converter/#post-apiconvertercreate-jobs","title":"POST /api/converter/create-jobs","text":"
Jobs aus DB-Scan-Eintr\u00e4gen erstellen.
 
Body:
 
{\n  \"entries\": [\n    { \"relPath\": \"filme/film.mkv\", \"converterMediaType\": \"video\" }\n  ]\n}\n
"},{"location":"api/converter/#post-apiconverterupload","title":"POST /api/converter/upload","text":"
Dateien hochladen (Multipart, max. 50 Dateien).
 
Form-Felder:
 Feld Typ Beschreibung files File[] Hochzuladende Dateien folderName string (Optional) Ziel-Unterordner 
Response:
 
{\n  \"folders\": [{ \"folderRelPath\": \"upload-2026-03-30\", \"fileCount\": 2 }]\n}\n
"},{"location":"api/converter/#job-verwaltung","title":"Job-Verwaltung","text":""},{"location":"api/converter/#get-apiconverterjobs","title":"GET /api/converter/jobs","text":"
Alle Converter-Jobs zur\u00fcckgeben.
 
Response:
 
{ \"jobs\": [{ \"id\": 42, \"status\": \"READY_TO_START\", \"title\": \"film.mkv\" }] }\n
"},{"location":"api/converter/#get-apiconverterjobsjobid","title":"GET /api/converter/jobs/:jobId","text":"
Einzelnen Converter-Job abrufen.
"},{"location":"api/converter/#post-apiconverterjobsjobidconfig","title":"POST /api/converter/jobs/:jobId/config","text":"
Konfigurationsentwurf f\u00fcr einen Job speichern (persistiert in encode_plan_json).
 
Body: Partielles Konfig-Objekt (Ausgabeformat, Presets, Metadaten, Track-Auswahl).
"},{"location":"api/converter/#post-apiconverterjobsjobidassign-files","title":"POST /api/converter/jobs/:jobId/assign-files","text":"
Dateien einem bestehenden (noch nicht gestarteten) Job hinzuf\u00fcgen.
 
Body:
 
{ \"relPaths\": [\"musik/track2.flac\"] }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidremove-file","title":"POST /api/converter/jobs/:jobId/remove-file","text":"
Datei aus einem Job entfernen (per relativer Pfad).
 
Body:
 
{ \"relPath\": \"musik/track2.flac\" }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidremove-input","title":"POST /api/converter/jobs/:jobId/remove-input","text":"
Datei aus einem Job entfernen (per absolutem Eingabepfad).
 
Body:
 
{ \"inputPath\": \"/data/output/converter-raw/musik/track2.flac\" }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidstart","title":"POST /api/converter/jobs/:jobId/start","text":"
Job mit finaler Konfiguration starten.
 
Body:
 
{\n  \"converterMediaType\": \"video\",\n  \"outputFormat\": \"mkv\",\n  \"userPreset\": \"H.264 MKV 1080p30\",\n  \"trackSelection\": {},\n  \"handBrakeTitleId\": 1,\n  \"audioFormatOptions\": {}\n}\n
"},{"location":"api/converter/#post-apiconverterjobsjobidcancel","title":"POST /api/converter/jobs/:jobId/cancel","text":"
Laufenden Job abbrechen.
"},{"location":"api/converter/#delete-apiconverterjobsjobid","title":"DELETE /api/converter/jobs/:jobId","text":"
Job aus der DB l\u00f6schen.
"},{"location":"api/converter/#datei-operationen","title":"Datei-Operationen","text":"
Alle Datei-Operationen arbeiten direkt auf dem Dateisystem (ohne DB-Aktualisierung). Ein anschlie\u00dfender Scan-Aufruf synchronisiert die DB.
"},{"location":"api/converter/#delete-apiconverterfiles","title":"DELETE /api/converter/files","text":"
Datei oder Ordner l\u00f6schen.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\" }\n
"},{"location":"api/converter/#post-apiconverterfilesrename","title":"POST /api/converter/files/rename","text":"
Datei oder Ordner umbenennen.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\", \"newName\": \"film-neu.mkv\" }\n
"},{"location":"api/converter/#post-apiconverterfilesmove","title":"POST /api/converter/files/move","text":"
Datei oder Ordner verschieben.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\", \"targetParentRelPath\": \"archiv\" }\n
 
targetParentRelPath = \"\" verschiebt in das Root-Verzeichnis.
"},{"location":"api/converter/#post-apiconverterfilesfolder","title":"POST /api/converter/files/folder","text":"
Neuen Ordner anlegen.
 
Body:
 
{ \"parentRelPath\": \"filme\", \"name\": \"neu\" }\n
"},{"location":"api/crons/","title":"Cron API","text":"
Ripster enth\u00e4lt ein eingebautes Cron-System f\u00fcr Skripte und Skript-Ketten (sourceType: script|chain).
"},{"location":"api/crons/#get-apicrons","title":"GET /api/crons","text":"
Listet alle Cron-Jobs.
 
{\n  \"jobs\": [\n    {\n      \"id\": 1,\n      \"name\": \"Nachtlauf Backup\",\n      \"cronExpression\": \"0 2 * * *\",\n      \"sourceType\": \"script\",\n      \"sourceId\": 3,\n      \"sourceName\": \"Backup-Skript\",\n      \"enabled\": true,\n      \"pushoverEnabled\": true,\n      \"lastRunAt\": \"2026-03-10T02:00:00.000Z\",\n      \"lastRunStatus\": \"success\",\n      \"nextRunAt\": \"2026-03-11T02:00:00.000Z\",\n      \"createdAt\": \"2026-03-01T10:00:00.000Z\",\n      \"updatedAt\": \"2026-03-10T02:00:05.000Z\"\n    }\n  ]\n}\n
"},{"location":"api/crons/#post-apicrons","title":"POST /api/crons","text":"
Erstellt Cron-Job.
 
{\n  \"name\": \"Nachtlauf Backup\",\n  \"cronExpression\": \"0 2 * * *\",\n  \"sourceType\": \"script\",\n  \"sourceId\": 3,\n  \"enabled\": true,\n  \"pushoverEnabled\": true\n}\n
 
Response: 201 mit { \"job\": { ... } }
"},{"location":"api/crons/#get-apicronsid","title":"GET /api/crons/:id","text":"
Response:
 
{ \"job\": { \"id\": 1, \"name\": \"...\" } }\n
"},{"location":"api/crons/#put-apicronsid","title":"PUT /api/crons/:id","text":"
Aktualisiert Cron-Job. Felder wie bei POST.
 
Response:
 
{ \"job\": { ... } }\n
"},{"location":"api/crons/#delete-apicronsid","title":"DELETE /api/crons/:id","text":"
Response:
 
{ \"removed\": { \"id\": 1, \"name\": \"Nachtlauf Backup\" } }\n
"},{"location":"api/crons/#get-apicronsidlogs","title":"GET /api/crons/:id/logs","text":"
Liefert Ausf\u00fchrungs-Logs.
 
Query-Parameter:
 Parameter Typ Default Beschreibung limit number 20 Anzahl Eintr\u00e4ge, max. 100 
Response:
 
{\n  \"logs\": [\n    {\n      \"id\": 42,\n      \"cronJobId\": 1,\n      \"startedAt\": \"2026-03-10T02:00:01.000Z\",\n      \"finishedAt\": \"2026-03-10T02:00:05.000Z\",\n      \"status\": \"success\",\n      \"output\": \"Backup abgeschlossen.\",\n      \"errorMessage\": null\n    }\n  ]\n}\n
 
status: running | success | error
"},{"location":"api/crons/#post-apicronsidrun","title":"POST /api/crons/:id/run","text":"
Triggert Job manuell (asynchron).
 
Response:
 
{ \"triggered\": true, \"cronJobId\": 1 }\n
 
Wenn Job bereits l\u00e4uft: 409.
"},{"location":"api/crons/#post-apicronsvalidate-expression","title":"POST /api/crons/validate-expression","text":"
Validiert 5-Felder-Cron-Ausdruck und berechnet n\u00e4chsten Lauf.
 
Request:
 
{ \"cronExpression\": \"*/15 * * * *\" }\n
 
G\u00fcltige Response:
 
{\n  \"valid\": true,\n  \"nextRunAt\": \"2026-03-10T14:15:00.000Z\"\n}\n
 
Ung\u00fcltige Response:
 
{\n  \"valid\": false,\n  \"error\": \"Cron-Ausdruck muss genau 5 Felder haben (Minute Stunde Tag Monat Wochentag).\",\n  \"nextRunAt\": null\n}\n
"},{"location":"api/crons/#cron-format","title":"Cron-Format","text":"
Ripster unterst\u00fctzt 5 Felder:
 
Minute Stunde Tag Monat Wochentag\n
 
Beispiele:
 
     
  • 0 2 * * * t\u00e4glich 02:00
    •  
  • */15 * * * * alle 15 Minuten
    •  
  • 0 6 * * 1-5 Mo-Fr 06:00
    •  
"},{"location":"api/crons/#websocket-events-zu-cron","title":"WebSocket-Events zu Cron","text":"
     
  • CRON_JOBS_UPDATED bei Create/Update/Delete
    •  
  • CRON_JOB_UPDATED bei Laufzeitstatus (running -> success|error)
    •  
"},{"location":"api/downloads/","title":"Downloads API","text":"
Endpunkte f\u00fcr die Download-Queue. Ausgabedateien aus der Job-Historie k\u00f6nnen als ZIP heruntergeladen werden.
 
Basis-Pfad: /api/downloads
"},{"location":"api/downloads/#get-apidownloads","title":"GET /api/downloads","text":"
Liste aller Download-Eintr\u00e4ge plus Zusammenfassung.
 
Response:
 
{\n  \"items\": [\n    {\n      \"id\": \"dl-42-raw\",\n      \"jobId\": 42,\n      \"target\": \"raw\",\n      \"status\": \"ready\",\n      \"archiveName\": \"Job_42_raw.zip\",\n      \"outputPath\": null,\n      \"createdAt\": \"2026-03-30T10:00:00.000Z\",\n      \"updatedAt\": \"2026-03-30T10:01:00.000Z\",\n      \"errorMessage\": null\n    }\n  ],\n  \"summary\": {\n    \"total\": 3,\n    \"pending\": 1,\n    \"processing\": 0,\n    \"ready\": 1,\n    \"failed\": 1\n  }\n}\n
 
Status-Werte:
 Status Beschreibung pending In der Queue, noch nicht gestartet processing ZIP wird gerade erstellt ready ZIP fertig, Download verf\u00fcgbar failed Fehler bei der Erstellung"},{"location":"api/downloads/#get-apidownloadssummary","title":"GET /api/downloads/summary","text":"
Nur die Zusammenfassung der Download-Queue (ohne Item-Liste).
 
Response:
 
{\n  \"summary\": {\n    \"total\": 3,\n    \"pending\": 1,\n    \"processing\": 0,\n    \"ready\": 1,\n    \"failed\": 1\n  }\n}\n
"},{"location":"api/downloads/#post-apidownloadshistoryjobid","title":"POST /api/downloads/history/:jobId","text":"
Job-Ausgabe in die Download-Queue einreihen.
 
Parameter:
 Parameter Typ Beschreibung jobId number ID des Jobs in der Historie 
Body:
 
{\n  \"target\": \"raw\",\n  \"outputPath\": null\n}\n
 Feld Typ Default Beschreibung target string raw raw (RAW-Dateien) oder movie (Ausgabedateien) outputPath string null Optionaler expliziter Ausgabepfad 
Response (201 Created):
 
{\n  \"created\": true,\n  \"id\": \"dl-42-raw\",\n  \"status\": \"pending\",\n  \"summary\": { \"total\": 1, \"pending\": 1, \"processing\": 0, \"ready\": 0, \"failed\": 0 }\n}\n
 
Ist der Eintrag bereits vorhanden, wird 201 durch 200 ersetzt und created: false zur\u00fcckgegeben.
"},{"location":"api/downloads/#get-apidownloadsidfile","title":"GET /api/downloads/:id/file","text":"
Fertige ZIP-Datei herunterladen.
 
Parameter:
 Parameter Typ Beschreibung id string Download-ID (z. B. dl-42-raw) 
Response: Datei-Download (Content-Disposition: attachment).
 
Schl\u00e4gt fehl mit 404, wenn kein Download-Eintrag mit dieser ID existiert oder die Datei noch nicht bereit ist.
"},{"location":"api/downloads/#delete-apidownloadsid","title":"DELETE /api/downloads/:id","text":"
Download-Eintrag l\u00f6schen (auch fertige ZIP-Dateien werden vom Dateisystem entfernt).
 
Response:
 
{\n  \"ok\": true,\n  \"summary\": { \"total\": 2, \"pending\": 0, \"processing\": 0, \"ready\": 2, \"failed\": 0 }\n}\n
"},{"location":"api/downloads/#websocket","title":"WebSocket","text":"
Status\u00e4nderungen werden \u00fcber DOWNLOADS_UPDATED in Echtzeit gemeldet. Vollst\u00e4ndige Dokumentation: WebSocket Events.
"},{"location":"api/history/","title":"History API","text":"
Endpunkte f\u00fcr Job-Historie, Metadaten-Nachpflege, Orphan-Import und L\u00f6schoperationen.
"},{"location":"api/history/#get-apihistory","title":"GET /api/history","text":"
Liefert Jobs mit optionalen Filtern.
 
Query-Parameter:
 Parameter Typ Beschreibung status string Einzelstatus-Filter (legacy-kompatibel). statuses string Mehrfachstatus als CSV, z. B. FINISHED,ERROR. search string Suche in Titel-/IMDb-Feldern. limit number Maximale Anzahl Ergebnisse. lite bool Ohne Dateisystem-Checks (schneller). includeChildren bool Child-Jobs (z. B. Serien-/Multipart-Kinder) explizit einbeziehen. 
Beispiel:
 
GET /api/history?statuses=FINISHED,ERROR&search=Inception&limit=50&lite=1\n
 
Response (Beispiel):
 
{\n  \"jobs\": [\n    {\n      \"id\": 42,\n      \"status\": \"FINISHED\",\n      \"title\": \"Inception\",\n      \"job_kind\": \"bluray\",\n      \"raw_path\": \"/mnt/raw/Inception - RAW - job-42\",\n      \"output_path\": \"/mnt/movies/Inception (2010)/Inception (2010).mkv\",\n      \"mediaType\": \"bluray\",\n      \"ripSuccessful\": true,\n      \"encodeSuccess\": true,\n      \"created_at\": \"2026-03-10T08:00:00.000Z\",\n      \"updated_at\": \"2026-03-10T10:00:00.000Z\"\n    }\n  ]\n}\n
"},{"location":"api/history/#get-apihistoryid","title":"GET /api/history/:id","text":"
Liefert Job-Detail.
 
Query-Parameter:
 Parameter Typ Standard Beschreibung includeLogs bool false Prozesslog laden. includeLiveLog bool false Live-/Tail-Log laden. includeAllLogs bool false vollst\u00e4ndiges Log statt Tail. logTailLines number 800 Tail-L\u00e4nge falls nicht includeAllLogs. lite bool false Detailantwort ohne FS-Checks. 
Response (Beispiel):
 
{\n  \"job\": {\n    \"id\": 42,\n    \"status\": \"FINISHED\",\n    \"makemkvInfo\": {},\n    \"mediainfoInfo\": {},\n    \"handbrakeInfo\": {},\n    \"encodePlan\": {},\n    \"log\": \"...\",\n    \"log_count\": 1,\n    \"logMeta\": {\n      \"loaded\": true,\n      \"total\": 800,\n      \"returned\": 800,\n      \"truncated\": true\n    }\n  }\n}\n
"},{"location":"api/history/#get-apihistoryorphan-raw","title":"GET /api/history/orphan-raw","text":"
Sucht RAW-Ordner ohne zugeh\u00f6rigen Job.
"},{"location":"api/history/#post-apihistoryorphan-rawimport","title":"POST /api/history/orphan-raw/import","text":"
Importiert einen RAW-Ordner als Job und triggert optional die Analyse des Imports.
 
Request:
 
{ \"rawPath\": \"/mnt/raw/Inception (2010) [tt1375666] - RAW - job-99\" }\n
 
Response (Beispiel):
 
{\n  \"job\": { \"id\": 77, \"status\": \"FINISHED\" },\n  \"activation\": { \"started\": true },\n  \"activationError\": null\n}\n
"},{"location":"api/history/#post-apihistoryidomdbassign","title":"POST /api/history/:id/omdb/assign","text":"
Weist OMDb-/Filmdaten nachtr\u00e4glich zu.
"},{"location":"api/history/#post-apihistoryidcdassign","title":"POST /api/history/:id/cd/assign","text":"
Weist CD-Metadaten (z. B. MusicBrainz) nachtr\u00e4glich zu.
"},{"location":"api/history/#post-apihistoryiderrorack","title":"POST /api/history/:id/error/ack","text":"
Quittiert einen Fehlerzustand im Historieneintrag.
"},{"location":"api/history/#get-apihistoryiddelete-preview","title":"GET /api/history/:id/delete-preview","text":"
Liefert eine Vorschau der l\u00f6schbaren Pfade (inkl. Scope auf verkn\u00fcpfte Jobs).
 
Query-Parameter:
 Parameter Typ Standard Beschreibung includeRelated bool true Verkn\u00fcpfte Jobs in die Vorschau einbeziehen. 
Response (Beispiel):
 
{\n  \"preview\": {\n    \"jobId\": 42,\n    \"relatedJobs\": [{ \"id\": 42 }, { \"id\": 73 }],\n    \"pathCandidates\": {\n      \"raw\": [{ \"path\": \"/mnt/raw/...\", \"exists\": true, \"isDirectory\": true }],\n      \"movie\": [{ \"path\": \"/mnt/movies/...\", \"exists\": true, \"isDirectory\": true }]\n    }\n  }\n}\n
"},{"location":"api/history/#post-apihistoryiddelete-files","title":"POST /api/history/:id/delete-files","text":"
L\u00f6scht Dateien eines Jobs, beh\u00e4lt DB-Eintrag.
 
Request:
 
{\n  \"target\": \"both\",\n  \"includeRelated\": true,\n  \"selectedRawPaths\": [\"/mnt/raw/Inception - RAW - Disc1\"],\n  \"selectedMoviePaths\": [\"/mnt/movies/Inception (2010)\"]\n}\n
 
target: raw | movie | both
 
selectedRawPaths / selectedMoviePaths sind optional und begrenzen die L\u00f6schung auf ausgew\u00e4hlte Pfade aus der Vorschau.
"},{"location":"api/history/#post-apihistoryiddelete","title":"POST /api/history/:id/delete","text":"
L\u00f6scht Job aus DB; optional auch Dateien.
 
Request:
 
{\n  \"target\": \"both\",\n  \"includeRelated\": true,\n  \"resetDriveState\": false,\n  \"keepDetectedDevice\": true,\n  \"preserveRawForImportJobs\": false,\n  \"selectedRawPaths\": [\"/mnt/raw/Inception - RAW - Disc1\"],\n  \"selectedMoviePaths\": [\"/mnt/movies/Inception (2010)\"]\n}\n
 
target: none | raw | movie | both
 
Response (Beispiel):
 
{\n  \"deleted\": true,\n  \"jobId\": 42,\n  \"fileTarget\": \"both\",\n  \"fileSummary\": {\n    \"target\": \"both\",\n    \"raw\": { \"filesDeleted\": 10 },\n    \"movie\": { \"filesDeleted\": 1 }\n  },\n  \"uiReset\": {\n    \"reset\": true,\n    \"state\": \"IDLE\"\n  },\n  \"safeguards\": {\n    \"containsOrphanRawImportJob\": false,\n    \"resetDriveStateApplied\": false,\n    \"keepDetectedDeviceApplied\": true\n  }\n}\n
"},{"location":"api/history/#hinweise","title":"Hinweise","text":"
     
  • Ein aktiver Pipeline-Job kann nicht gel\u00f6scht werden (409).
    •  
  • L\u00f6schoperationen sind irreversibel.
    •  
  • Bei Serien-/Multipart-Containern steuern includeRelated und Pfadselektionen den genauen Scope.
    •  
"},{"location":"api/pipeline/","title":"Pipeline API","text":"
Endpunkte zur Steuerung des Pipeline-Workflows.
"},{"location":"api/pipeline/#get-apipipelinestate","title":"GET /api/pipeline/state","text":"
Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.
 
Response (Beispiel):
 
{\n  \"pipeline\": {\n    \"state\": \"READY_TO_ENCODE\",\n    \"activeJobId\": 42,\n    \"progress\": 0,\n    \"eta\": null,\n    \"statusText\": \"Mediainfo best\u00e4tigt - Encode manuell starten\",\n    \"context\": {\n      \"jobId\": 42\n    },\n    \"jobProgress\": {\n      \"42\": {\n        \"state\": \"MEDIAINFO_CHECK\",\n        \"progress\": 68.5,\n        \"eta\": null,\n        \"statusText\": \"MEDIAINFO_CHECK 68.50%\"\n      }\n    },\n    \"queue\": {\n      \"maxParallelJobs\": 1,\n      \"runningCount\": 1,\n      \"queuedCount\": 2,\n      \"runningJobs\": [],\n      \"queuedJobs\": []\n    }\n  },\n  \"hardwareMonitoring\": {\n    \"enabled\": true,\n    \"intervalMs\": 5000,\n    \"updatedAt\": \"2026-03-10T09:00:00.000Z\",\n    \"sample\": {\n      \"cpu\": {},\n      \"memory\": {},\n      \"gpu\": {},\n      \"storage\": {}\n    },\n    \"error\": null\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelineanalyze","title":"POST /api/pipeline/analyze","text":"
Startet Disc-Analyse und legt Job an.
 
Response:
 
{\n  \"result\": {\n    \"jobId\": 42,\n    \"detectedTitle\": \"INCEPTION\",\n    \"omdbCandidates\": []\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinerescan-disc","title":"POST /api/pipeline/rescan-disc","text":"
Erzwingt erneute Laufwerkspr\u00fcfung.
 
Response (Beispiel):
 
{\n  \"result\": {\n    \"present\": true,\n    \"changed\": true,\n    \"emitted\": \"discInserted\",\n    \"device\": {\n      \"path\": \"/dev/sr0\",\n      \"discLabel\": \"INCEPTION\",\n      \"mediaProfile\": \"bluray\"\n    }\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinerescan-drive","title":"POST /api/pipeline/rescan-drive","text":"
Erzwingt Rescan f\u00fcr ein konkretes Laufwerk.
 
Request:
 
{ \"devicePath\": \"/dev/sr0\" }\n
"},{"location":"api/pipeline/#get-apipipelineomdbsearchq","title":"GET /api/pipeline/omdb/search?q= 
OMDb-Titelsuche.
 
Response:
 
{\n  \"results\": [\n    {\n      \"imdbId\": \"tt1375666\",\n      \"title\": \"Inception\",\n      \"year\": \"2010\",\n      \"type\": \"movie\",\n      \"poster\": \"https://...\"\n    }\n  ]\n}\n
","text":""},{"location":"api/pipeline/#get-apipipelinetmdbseriessearchqseason","title":"GET /api/pipeline/tmdb/series/search?q=&season= 
TMDb-Seriensuche (f\u00fcr Serien-Workflow bei DVD/Blu-ray).
","text":""},{"location":"api/pipeline/#get-apipipelinecddrives","title":"GET /api/pipeline/cd/drives 
Liefert Snapshot der aktuell bekannten CD-Laufwerke.
","text":""},{"location":"api/pipeline/#get-apipipelinecdmusicbrainzsearchq","title":"GET /api/pipeline/cd/musicbrainz/search?q= 
MusicBrainz-Suche f\u00fcr CD-Metadaten.
","text":""},{"location":"api/pipeline/#get-apipipelinecdmusicbrainzreleasembid","title":"GET /api/pipeline/cd/musicbrainz/release/:mbId 
L\u00e4dt Release-Details zu einer MusicBrainz-ID.
","text":""},{"location":"api/pipeline/#post-apipipelinecdselect-metadata","title":"POST /api/pipeline/cd/select-metadata 
\u00dcbernimmt CD-Metadaten f\u00fcr einen Job.
 
Request (Beispiel):
 
{\n  \"jobId\": 91,\n  \"title\": \"Album\",\n  \"artist\": \"Artist\",\n  \"year\": 2020,\n  \"mbId\": \"f5093c06-23e3-404f-aeaa-40f72885ee3a\",\n  \"coverUrl\": \"https://...\",\n  \"tracks\": []\n}\n
","text":""},{"location":"api/pipeline/#post-apipipelinecdstartjobid","title":"POST /api/pipeline/cd/start/:jobId 
Startet/queued CD-Rip mit Format-/Script-/Chain-Konfiguration.
","text":""},{"location":"api/pipeline/#post-apipipelineaudiobookupload","title":"POST /api/pipeline/audiobook/upload 
Upload von AAX-Datei (Multipart/FormData).
 
FormData-Felder:
 
     
  • file (Pflicht)
    •  
  • format (optional)
    •  
  • startImmediately (optional)
    •  
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookpending-activation","title":"GET /api/pipeline/audiobook/pending-activation 
Zeigt AAX-Jobs mit fehlenden Activation-Bytes.
","text":""},{"location":"api/pipeline/#post-apipipelineaudiobookstartjobid","title":"POST /api/pipeline/audiobook/start/:jobId 
Startet Audiobook-Job mit optionaler Konfiguration.
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookjobs","title":"GET /api/pipeline/audiobook/jobs 
Liefert Audiobook-Jobliste.
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookoutput-tree","title":"GET /api/pipeline/audiobook/output-tree 
Read-only Baumansicht des Audiobook-Ausgabeordners.
","text":""},{"location":"api/pipeline/#post-apipipelineselect-metadata","title":"POST /api/pipeline/select-metadata 
Setzt Metadaten (und optional Playlist) f\u00fcr einen Job.
 
Request:
 
{\n  \"jobId\": 42,\n  \"title\": \"Inception\",\n  \"year\": 2010,\n  \"imdbId\": \"tt1375666\",\n  \"poster\": \"https://...\",\n  \"fromOmdb\": true,\n  \"selectedPlaylist\": \"00800\"\n}\n
 
Wichtige optionale Felder:
 
     
  • selectedHandBrakeTitleId / selectedHandBrakeTitleIds: Titel-Auswahl f\u00fcr Review/MediaInfo.
    •  
  • metadataProvider: omdb oder tmdb.
    •  
  • workflowKind: bei Disc-Jobs typischerweise film oder series.
    •  
  • discNumber: Pflicht f\u00fcr Serien-Disc-Zuordnung (workflowKind=series).
    •  
  • duplicateAction: Duplikatverhalten bei Film-Metadaten (allow_new oder multipart_movie).
    •  
  • existingJobId: optionaler Referenzjob f\u00fcr multipart_movie.
    •  
  • existingDiscNumber: Disc-Nummer des bestehenden Jobs f\u00fcr multipart_movie.
    •  
 
Response:
 
{ \"job\": { \"id\": 42, \"status\": \"READY_TO_START\" } }\n
 
Konflikt-Response (Beispiel, HTTP 409):
 
{\n  \"message\": \"Metadaten bereits in der Historie gefunden. Bitte Auswahl \u00fcbernehmen oder Multipart movie w\u00e4hlen.\",\n  \"details\": [\n    {\n      \"code\": \"METADATA_DUPLICATE_FOUND\",\n      \"mediaProfile\": \"bluray\",\n      \"existingJob\": {\n        \"id\": 17,\n        \"title\": \"Inception\",\n        \"year\": 2010,\n        \"status\": \"FINISHED\",\n        \"jobKind\": \"bluray\",\n        \"discNumber\": 1,\n        \"isMultipartMovie\": false\n      }\n    }\n  ]\n}\n
 
Relevante Fehlercodes (POST /api/pipeline/select-metadata):
    Code Bedeutung     METADATA_DUPLICATE_FOUND Film-Metadaten existieren bereits in der Historie (Konfliktdialog im UI).   MULTIPART_DISC_REQUIRED F\u00fcr Multipart fehlen Disc-Nummern (discNumber/existingDiscNumber).   MULTIPART_DISC_ALREADY_EXISTS Disc-Nummer im Multipart-Container bereits vergeben oder doppelt.   MULTIPART_MEDIA_MISMATCH Multipart nur bei gleichem Medientyp (DVD oder Blu-ray).   MULTIPART_SERIES_NOT_ALLOWED Multipart ist nur f\u00fcr Film-Jobs erlaubt, nicht f\u00fcr Serien-Workflow.   MULTIPART_METADATA_MISMATCH Ausgew\u00e4hlter bestehender Job passt nicht zu den Film-Metadaten.   SERIES_DISC_ALREADY_EXISTS Serien-Disc-Nummer innerhalb einer Staffel bereits vorhanden.","text":""},{"location":"api/pipeline/#post-apipipelinejobsjobidraw-decision","title":"POST /api/pipeline/jobs/:jobId/raw-decision 
Trifft Entscheidung bei vorhandenem RAW (continue oder restart je nach Dialogfluss).
 
Request:
 
{ \"decision\": \"continue\" }\n
","text":""},{"location":"api/pipeline/#post-apipipelinestartjobid","title":"POST /api/pipeline/start/:jobId 
Startet vorbereiteten Job oder queued ihn (je nach Parallel-Limit).
 
M\u00f6gliche Responses:
 
{ \"result\": { \"started\": true, \"stage\": \"RIPPING\" } }\n
 
{ \"result\": { \"queued\": true, \"started\": false, \"queuePosition\": 2, \"action\": \"START_PREPARED\" } }\n
","text":""},{"location":"api/pipeline/#post-apipipelineconfirm-encodejobid","title":"POST /api/pipeline/confirm-encode/:jobId 
Best\u00e4tigt Review-Auswahl (Tracks, Pre/Post-Skripte/Ketten, User-Preset).
 
Request (typisch):
 
{\n  \"selectedEncodeTitleId\": 1,\n  \"selectedTrackSelection\": {\n    \"1\": {\n      \"audioTrackIds\": [1, 2],\n      \"subtitleTrackIds\": [3]\n    }\n  },\n  \"selectedPreEncodeScriptIds\": [1],\n  \"selectedPostEncodeScriptIds\": [2, 7],\n  \"selectedPreEncodeChainIds\": [3],\n  \"selectedPostEncodeChainIds\": [4],\n  \"selectedUserPresetId\": 5,\n  \"skipPipelineStateUpdate\": false\n}\n
 
Response:
 
{ \"job\": { \"id\": 42, \"encode_review_confirmed\": 1 } }\n
","text":""},{"location":"api/pipeline/#post-apipipelinecancel","title":"POST /api/pipeline/cancel 
Bricht laufenden Job ab oder entfernt Queue-Eintrag.
 
Request (optional):
 
{ \"jobId\": 42 }\n
 
M\u00f6gliche Responses:
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": true, \"jobId\": 42 } }\n
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": false, \"jobId\": 42 } }\n
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": false, \"pending\": true, \"jobId\": 42 } }\n
","text":""},{"location":"api/pipeline/#post-apipipelineretryjobid","title":"POST /api/pipeline/retry/:jobId 
Retry f\u00fcr ERROR/CANCELLED-Jobs (oder Queue-Einreihung).
","text":""},{"location":"api/pipeline/#post-apipipelinereencodejobid","title":"POST /api/pipeline/reencode/:jobId 
Startet Re-Encode aus bestehendem RAW.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-reviewjobid","title":"POST /api/pipeline/restart-review/:jobId 
Berechnet Review aus RAW neu.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-encodejobid","title":"POST /api/pipeline/restart-encode/:jobId 
Startet Encoding mit letzter best\u00e4tigter Review neu.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-cd-reviewjobid","title":"POST /api/pipeline/restart-cd-review/:jobId 
Berechnet CD-Review aus vorhandenem RAW neu.
","text":""},{"location":"api/pipeline/#post-apipipelineresume-readyjobid","title":"POST /api/pipeline/resume-ready/:jobId 
L\u00e4dt READY_TO_ENCODE-Job nach Neustart wieder in aktive Session.
","text":""},{"location":"api/pipeline/#get-apipipelineoutput-foldersjobid","title":"GET /api/pipeline/output-folders/:jobId 
Liefert bekannte Output-Ordner entlang der Job-Lineage.
","text":""},{"location":"api/pipeline/#post-apipipelinedelete-output-foldersjobid","title":"POST /api/pipeline/delete-output-folders/:jobId 
L\u00f6scht ausgew\u00e4hlte Output-Ordner.
 
Request:
 
{ \"folderPaths\": [\"/mnt/movies/Inception (2010)\"] }\n
 
Alle Endpunkte liefern { result: ... } bzw. { job: ... }.
","text":""},{"location":"api/pipeline/#queue-endpunkte","title":"Queue-Endpunkte","text":""},{"location":"api/pipeline/#get-apipipelinequeue","title":"GET /api/pipeline/queue","text":"
Liefert Queue-Snapshot.
 
{\n  \"queue\": {\n    \"maxParallelJobs\": 1,\n    \"runningCount\": 1,\n    \"queuedCount\": 3,\n    \"runningJobs\": [\n      {\n        \"jobId\": 41,\n        \"title\": \"Inception\",\n        \"status\": \"ENCODING\",\n        \"lastState\": \"ENCODING\"\n      }\n    ],\n    \"queuedJobs\": [\n      {\n        \"entryId\": 11,\n        \"position\": 1,\n        \"type\": \"job\",\n        \"jobId\": 42,\n        \"action\": \"START_PREPARED\",\n        \"actionLabel\": \"Start\",\n        \"title\": \"Matrix\",\n        \"status\": \"READY_TO_ENCODE\",\n        \"lastState\": \"READY_TO_ENCODE\",\n        \"hasScripts\": true,\n        \"hasChains\": false,\n        \"enqueuedAt\": \"2026-03-10T09:00:00.000Z\"\n      },\n      {\n        \"entryId\": 12,\n        \"position\": 2,\n        \"type\": \"wait\",\n        \"waitSeconds\": 30,\n        \"title\": \"Warten 30s\",\n        \"status\": \"QUEUED\",\n        \"enqueuedAt\": \"2026-03-10T09:01:00.000Z\"\n      }\n    ],\n    \"updatedAt\": \"2026-03-10T09:01:02.000Z\"\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinequeuereorder","title":"POST /api/pipeline/queue/reorder","text":"
Sortiert Queue-Eintr\u00e4ge neu.
 
Request:
 
{\n  \"orderedEntryIds\": [12, 11]\n}\n
 
Legacy fallback wird akzeptiert:
 
{\n  \"orderedJobIds\": [42, 43]\n}\n
"},{"location":"api/pipeline/#post-apipipelinequeueentry","title":"POST /api/pipeline/queue/entry","text":"
F\u00fcgt Nicht-Job-Queue-Eintrag hinzu (script, chain, wait).
 
Request-Beispiele:
 
{ \"type\": \"script\", \"scriptId\": 3 }\n
 
{ \"type\": \"chain\", \"chainId\": 2, \"insertAfterEntryId\": 11 }\n
 
{ \"type\": \"wait\", \"waitSeconds\": 45 }\n
 
Response:
 
{\n  \"result\": { \"entryId\": 12, \"type\": \"wait\", \"position\": 2 },\n  \"queue\": { \"...\": \"...\" }\n}\n
"},{"location":"api/pipeline/#delete-apipipelinequeueentryentryid","title":"DELETE /api/pipeline/queue/entry/:entryId","text":"
Entfernt Queue-Eintrag.
 
Response:
 
{ \"queue\": { \"...\": \"...\" } }\n
"},{"location":"api/pipeline/#pipeline-zustande","title":"Pipeline-Zust\u00e4nde    State Bedeutung     IDLE Wartet auf Medium   DISC_DETECTED Medium erkannt   ANALYZING MakeMKV-Analyse l\u00e4uft   METADATA_SELECTION Metadaten-Auswahl   WAITING_FOR_USER_DECISION Nutzerentscheidung erforderlich (Playlist-Auswahl oder RAW-Entscheidung)   READY_TO_START \u00dcbergang vor Start   RIPPING MakeMKV-Rip l\u00e4uft   MEDIAINFO_CHECK Titel-/Track-Auswertung   READY_TO_ENCODE Review bereit   ENCODING HandBrake-Encoding l\u00e4uft   CD_METADATA_SELECTION CD-Metadatenauswahl aktiv   CD_READY_TO_RIP CD-Job ist startbereit   CD_ANALYZING CD-Struktur/Tracks werden vorbereitet   CD_RIPPING CD-Ripping l\u00e4uft   CD_ENCODING CD-Encode l\u00e4uft   FINISHED Abgeschlossen   DONE Abgeschlossen (v. a. Audiobook/Converter/CD-Varianten)   CANCELLED Abgebrochen   ERROR Fehler","text":""},{"location":"api/runtime-activities/","title":"Runtime Activities API","text":"
Ripster verfolgt alle laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten (Skripte, Skript-Ketten, Cron-Jobs, interne Tasks) in Echtzeit \u00fcber den RuntimeActivityService.
"},{"location":"api/runtime-activities/#ubersicht","title":"\u00dcbersicht","text":"
Aktivit\u00e4ten entstehen, wenn Ripster intern Aktionen ausf\u00fchrt \u2013 z. B. beim Start eines Cron-Jobs, beim Ausf\u00fchren einer Skript-Kette oder beim Durchlaufen von Pipeline-Schritten. Sie sind nicht persistent (kein DB-Speicher) und werden nur im Arbeitsspeicher gehalten.
 
     
  • Aktive Aktivit\u00e4ten (active): Laufen gerade.
    •  
  • Letzte Aktivit\u00e4ten (recent): Abgeschlossen, max. 120 Eintr\u00e4ge.
    •  
 
\u00c4nderungen werden \u00fcber WebSocket (RUNTIME_ACTIVITY_CHANGED) in Echtzeit gesendet.
"},{"location":"api/runtime-activities/#aktivitats-objekt","title":"Aktivit\u00e4ts-Objekt","text":"
{\n  \"id\": 7,\n  \"type\": \"chain\",\n  \"name\": \"Post-Encode Aufr\u00e4umen\",\n  \"status\": \"running\",\n  \"source\": \"cron\",\n  \"message\": \"Schritt 2 von 3\",\n  \"currentStep\": \"cleanup.sh\",\n  \"currentStepType\": \"script\",\n  \"currentScriptName\": \"cleanup.sh\",\n  \"stepIndex\": 2,\n  \"stepTotal\": 3,\n  \"parentActivityId\": null,\n  \"jobId\": 42,\n  \"cronJobId\": 3,\n  \"chainId\": 5,\n  \"scriptId\": null,\n  \"canCancel\": true,\n  \"canNextStep\": false,\n  \"outcome\": \"running\",\n  \"errorMessage\": null,\n  \"output\": null,\n  \"stdout\": null,\n  \"stderr\": null,\n  \"stdoutTruncated\": false,\n  \"stderrTruncated\": false,\n  \"startedAt\": \"2026-03-10T10:00:00.000Z\",\n  \"finishedAt\": null,\n  \"durationMs\": null,\n  \"exitCode\": null,\n  \"success\": null\n}\n
"},{"location":"api/runtime-activities/#felder","title":"Felder","text":"Feld Typ Beschreibung id number Eindeutige ID (Laufz\u00e4hler, nicht persistent) type string Art der Aktivit\u00e4t: script | chain | cron | task name string \\| null Anzeigename der Aktivit\u00e4t status string Aktueller Status: running | success | error source string \\| null Ausl\u00f6ser (z. B. cron, pipeline, manual) message string \\| null Kurztext zum aktuellen Zustand currentStep string \\| null Name des aktuell ausgef\u00fchrten Schritts currentStepType string \\| null Typ des Schritts (z. B. script, wait) currentScriptName string \\| null Name des Skripts im aktuellen Schritt stepIndex number \\| null Aktueller Schritt (1-basiert) stepTotal number \\| null Gesamtanzahl Schritte parentActivityId number \\| null ID der \u00fcbergeordneten Aktivit\u00e4t jobId number \\| null Verkn\u00fcpfte Job-ID cronJobId number \\| null Verkn\u00fcpfte Cron-Job-ID chainId number \\| null Verkn\u00fcpfte Skript-Ketten-ID scriptId number \\| null Verkn\u00fcpfte Skript-ID canCancel boolean Abbrechen \u00fcber API m\u00f6glich canNextStep boolean N\u00e4chster Schritt \u00fcber API ausl\u00f6sbar outcome string \\| null Abschluss-Ergebnis: success | error | cancelled | skipped | running errorMessage string \\| null Fehlermeldung (max. 2.000 Zeichen) output string \\| null Allgemeine Ausgabe (max. 12.000 Zeichen) stdout string \\| null Standardausgabe des Prozesses (max. 12.000 Zeichen) stderr string \\| null Fehlerausgabe des Prozesses (max. 12.000 Zeichen) stdoutTruncated boolean true, wenn stdout gek\u00fcrzt wurde stderrTruncated boolean true, wenn stderr gek\u00fcrzt wurde startedAt string ISO-8601-Zeitstempel des Starts finishedAt string \\| null ISO-8601-Zeitstempel des Endes durationMs number \\| null Laufzeit in Millisekunden exitCode number \\| null Exit-Code des Prozesses success boolean \\| null Erfolgsstatus (null bei laufender Aktivit\u00e4t)"},{"location":"api/runtime-activities/#snapshot-objekt","title":"Snapshot-Objekt","text":"
Alle Aktivit\u00e4ts-Endpunkte geben einen Snapshot zur\u00fcck:
 
{\n  \"active\": [ /* laufende Aktivit\u00e4ten, nach startedAt absteigend */ ],\n  \"recent\": [ /* abgeschlossene Aktivit\u00e4ten, nach finishedAt absteigend, max. 120 */ ],\n  \"updatedAt\": \"2026-03-10T10:05:00.000Z\"\n}\n
"},{"location":"api/runtime-activities/#endpunkte","title":"Endpunkte","text":""},{"location":"api/runtime-activities/#get-apiruntimeactivities","title":"GET /api/runtime/activities","text":"
Aktuellen Aktivit\u00e4ts-Snapshot abrufen.
 
Antwort:
 
{\n  \"active\": [],\n  \"recent\": [\n    {\n      \"id\": 5,\n      \"type\": \"script\",\n      \"name\": \"notify.sh\",\n      \"status\": \"success\",\n      \"outcome\": \"success\",\n      \"startedAt\": \"2026-03-10T09:58:00.000Z\",\n      \"finishedAt\": \"2026-03-10T09:58:02.000Z\",\n      \"durationMs\": 2100,\n      \"exitCode\": 0,\n      \"success\": true,\n      \"canCancel\": false,\n      \"canNextStep\": false\n    }\n  ],\n  \"updatedAt\": \"2026-03-10T10:05:00.000Z\"\n}\n
"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesidcancel","title":"POST /api/runtime/activities/:id/cancel","text":"
Aktive Aktivit\u00e4t abbrechen (nur wenn canCancel: true).
 
Parameter:
 Name In Typ Beschreibung id path number Aktivit\u00e4ts-ID reason body string Optionaler Abbruchgrund 
Request Body:
 
{ \"reason\": \"Manueller Abbruch durch Benutzer\" }\n
 
Antwort (Erfolg):
 
{\n  \"ok\": true,\n  \"action\": null,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
 
Fehlercodes:
 HTTP Bedeutung 404 Aktivit\u00e4t nicht gefunden oder bereits abgeschlossen 409 Abbrechen wird von dieser Aktivit\u00e4t nicht unterst\u00fctzt"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesidnext-step","title":"POST /api/runtime/activities/:id/next-step","text":"
N\u00e4chsten Schritt einer Aktivit\u00e4t ausl\u00f6sen (nur wenn canNextStep: true).
 
Parameter:
 Name In Typ Beschreibung id path number Aktivit\u00e4ts-ID 
Antwort (Erfolg):
 
{\n  \"ok\": true,\n  \"action\": null,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
 
Fehlercodes:
 HTTP Bedeutung 404 Aktivit\u00e4t nicht gefunden 409 N\u00e4chster Schritt wird von dieser Aktivit\u00e4t nicht unterst\u00fctzt"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesclear-recent","title":"POST /api/runtime/activities/clear-recent","text":"
Alle abgeschlossenen Aktivit\u00e4ten aus recent l\u00f6schen.
 
Antwort:
 
{\n  \"ok\": true,\n  \"removed\": 14,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
"},{"location":"api/runtime-activities/#grenzwerte","title":"Grenzwerte","text":"Wert Limit Maximale recent-Eintr\u00e4ge 120 Maximale L\u00e4nge stdout / stderr / output 12.000 Zeichen Maximale L\u00e4nge errorMessage / message 2.000 Zeichen Maximale L\u00e4nge outcome 40 Zeichen 
Gek\u00fcrzte Ausgaben erhalten den Suffix ...[gek\u00fcrzt] (bei Inline-Text) bzw. \\n...[gek\u00fcrzt] (bei mehrzeiligem Output).
"},{"location":"api/runtime-activities/#echtzeit-updates","title":"Echtzeit-Updates","text":"
\u00c4nderungen werden automatisch als RUNTIME_ACTIVITY_CHANGED WebSocket-Event gesendet. Die Frontend-Komponente braucht GET /api/runtime/activities nur beim initialen Laden aufzurufen.
"},{"location":"api/settings/","title":"Settings API","text":"
Endpunkte f\u00fcr Einstellungen, Skripte, Skript-Ketten und User-Presets.
"},{"location":"api/settings/#get-apisettings","title":"GET /api/settings","text":"
Liefert alle Einstellungen kategorisiert.
 
Response (Struktur):
 
{\n  \"categories\": [\n    {\n      \"category\": \"Pfade\",\n      \"settings\": [\n        {\n          \"key\": \"raw_dir\",\n          \"label\": \"Raw Ausgabeordner\",\n          \"type\": \"path\",\n          \"required\": true,\n          \"description\": \"...\",\n          \"defaultValue\": \"data/output/raw\",\n          \"options\": [],\n          \"validation\": { \"minLength\": 1 },\n          \"value\": \"data/output/raw\",\n          \"orderIndex\": 100\n        }\n      ]\n    }\n  ]\n}\n
"},{"location":"api/settings/#put-apisettingskey","title":"PUT /api/settings/:key","text":"
Aktualisiert eine einzelne Einstellung.
 
Request:
 
{ \"value\": \"/mnt/storage/raw\" }\n
 
Response:
 
{\n  \"setting\": {\n    \"key\": \"raw_dir\",\n    \"value\": \"/mnt/storage/raw\"\n  },\n  \"reviewRefresh\": {\n    \"triggered\": false,\n    \"reason\": \"not_ready\"\n  }\n}\n
 
reviewRefresh ist null oder ein Objekt mit Status der optionalen Review-Neuberechnung.
"},{"location":"api/settings/#put-apisettings","title":"PUT /api/settings","text":"
Aktualisiert mehrere Einstellungen atomar.
 
Request:
 
{\n  \"settings\": {\n    \"raw_dir\": \"/mnt/storage/raw\",\n    \"movie_dir\": \"/mnt/storage/movies\",\n    \"handbrake_preset_bluray\": \"H.264 MKV 1080p30\"\n  }\n}\n
 
Response:
 
{\n  \"changes\": [\n    { \"key\": \"raw_dir\", \"value\": \"/mnt/storage/raw\" },\n    { \"key\": \"movie_dir\", \"value\": \"/mnt/storage/movies\" }\n  ],\n  \"reviewRefresh\": {\n    \"triggered\": true,\n    \"jobId\": 42,\n    \"relevantKeys\": [\"handbrake_preset_bluray\"]\n  }\n}\n
 
Bei Validierungsfehlern kommt 400 mit error.details[].
"},{"location":"api/settings/#get-apisettingshandbrake-presets","title":"GET /api/settings/handbrake-presets","text":"
Liest Preset-Liste via HandBrakeCLI -z (mit Fallback auf konfigurierte Presets).
 
Response (Beispiel):
 
{\n  \"source\": \"handbrake-cli\",\n  \"message\": null,\n  \"options\": [\n    { \"label\": \"General/\", \"value\": \"__group__general\", \"disabled\": true, \"category\": \"General\" },\n    { \"label\": \"   Fast 1080p30\", \"value\": \"Fast 1080p30\", \"category\": \"General\" }\n  ]\n}\n
"},{"location":"api/settings/#post-apisettingspushovertest","title":"POST /api/settings/pushover/test","text":"
Sendet Testnachricht \u00fcber aktuelle PushOver-Settings.
 
Request (optional):
 
{\n  \"title\": \"Test\",\n  \"message\": \"Ripster Test\"\n}\n
 
Response:
 
{\n  \"result\": {\n    \"sent\": true,\n    \"eventKey\": \"test\",\n    \"requestId\": \"...\"\n  }\n}\n
 
Wenn PushOver deaktiviert ist oder Credentials fehlen, kommt i. d. R. ebenfalls 200 mit sent: false + reason.
"},{"location":"api/settings/#skripte","title":"Skripte","text":"
Basis: /api/settings/scripts
"},{"location":"api/settings/#get-apisettingsscripts","title":"GET /api/settings/scripts","text":"
{ \"scripts\": [ { \"id\": 1, \"name\": \"...\", \"scriptBody\": \"...\", \"orderIndex\": 1, \"createdAt\": \"...\", \"updatedAt\": \"...\" } ] }\n
"},{"location":"api/settings/#post-apisettingsscripts","title":"POST /api/settings/scripts","text":"
{ \"name\": \"Move\", \"scriptBody\": \"mv \\\"$RIPSTER_OUTPUT_PATH\\\" /mnt/movies/\" }\n
 
Response: 201 mit { \"script\": { ... } }
"},{"location":"api/settings/#put-apisettingsscriptsid","title":"PUT /api/settings/scripts/:id","text":"
Body wie POST, Response { \"script\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsscriptsid","title":"DELETE /api/settings/scripts/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscriptsreorder","title":"POST /api/settings/scripts/reorder","text":"
{ \"orderedScriptIds\": [3, 1, 2] }\n
 
Response { \"scripts\": [ ... ] }.
"},{"location":"api/settings/#post-apisettingsscriptsidtest","title":"POST /api/settings/scripts/:id/test","text":"
F\u00fchrt Skript als Testlauf aus.
 
{\n  \"result\": {\n    \"scriptId\": 1,\n    \"scriptName\": \"Move\",\n    \"success\": true,\n    \"exitCode\": 0,\n    \"signal\": null,\n    \"timedOut\": false,\n    \"durationMs\": 120,\n    \"stdout\": \"...\",\n    \"stderr\": \"...\",\n    \"stdoutTruncated\": false,\n    \"stderrTruncated\": false\n  }\n}\n
"},{"location":"api/settings/#umgebungsvariablen-fur-skripte","title":"Umgebungsvariablen f\u00fcr Skripte","text":"
Diese Variablen werden beim Ausf\u00fchren gesetzt:
 
     
  • RIPSTER_SCRIPT_RUN_AT
    •  
  • RIPSTER_JOB_ID
    •  
  • RIPSTER_JOB_TITLE
    •  
  • RIPSTER_MODE
    •  
  • RIPSTER_INPUT_PATH
    •  
  • RIPSTER_OUTPUT_PATH
    •  
  • RIPSTER_RAW_PATH
    •  
  • RIPSTER_SCRIPT_ID
    •  
  • RIPSTER_SCRIPT_NAME
    •  
  • RIPSTER_SCRIPT_SOURCE
    •  
"},{"location":"api/settings/#skript-ketten","title":"Skript-Ketten","text":"
Basis: /api/settings/script-chains
 
Eine Kette hat Schritte vom Typ:
 
     
  • script (scriptId erforderlich)
    •  
  • wait (waitSeconds 1..3600)
    •  
"},{"location":"api/settings/#get-apisettingsscript-chains","title":"GET /api/settings/script-chains","text":"
Response { \"chains\": [ ... ] } (inkl. steps[]).
"},{"location":"api/settings/#get-apisettingsscript-chainsid","title":"GET /api/settings/script-chains/:id","text":"
Response { \"chain\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscript-chains","title":"POST /api/settings/script-chains","text":"
{\n  \"name\": \"After Encode\",\n  \"steps\": [\n    { \"stepType\": \"script\", \"scriptId\": 1 },\n    { \"stepType\": \"wait\", \"waitSeconds\": 15 },\n    { \"stepType\": \"script\", \"scriptId\": 2 }\n  ]\n}\n
 
Response: 201 mit { \"chain\": { ... } }
"},{"location":"api/settings/#put-apisettingsscript-chainsid","title":"PUT /api/settings/script-chains/:id","text":"
Body wie POST, Response { \"chain\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsscript-chainsid","title":"DELETE /api/settings/script-chains/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscript-chainsreorder","title":"POST /api/settings/script-chains/reorder","text":"
{ \"orderedChainIds\": [2, 1, 3] }\n
 
Response { \"chains\": [ ... ] }.
"},{"location":"api/settings/#post-apisettingsscript-chainsidtest","title":"POST /api/settings/script-chains/:id/test","text":"
Response:
 
{\n  \"result\": {\n    \"chainId\": 2,\n    \"chainName\": \"After Encode\",\n    \"steps\": 3,\n    \"succeeded\": 3,\n    \"failed\": 0,\n    \"aborted\": false,\n    \"results\": []\n  }\n}\n
"},{"location":"api/settings/#user-presets","title":"User-Presets","text":"
Basis: /api/settings/user-presets
"},{"location":"api/settings/#get-apisettingsuser-presets","title":"GET /api/settings/user-presets","text":"
Optionaler Query-Parameter: media_type=bluray|dvd|other|all
 
{\n  \"presets\": [\n    {\n      \"id\": 1,\n      \"name\": \"Blu-ray HQ\",\n      \"mediaType\": \"bluray\",\n      \"handbrakePreset\": \"H.264 MKV 1080p30\",\n      \"extraArgs\": \"--encoder-preset slow\",\n      \"description\": \"...\",\n      \"createdAt\": \"...\",\n      \"updatedAt\": \"...\"\n    }\n  ]\n}\n
"},{"location":"api/settings/#post-apisettingsuser-presets","title":"POST /api/settings/user-presets","text":"
{\n  \"name\": \"Blu-ray HQ\",\n  \"mediaType\": \"bluray\",\n  \"handbrakePreset\": \"H.264 MKV 1080p30\",\n  \"extraArgs\": \"--encoder-preset slow\",\n  \"description\": \"optional\"\n}\n
 
Response: 201 mit { \"preset\": { ... } }
"},{"location":"api/settings/#put-apisettingsuser-presetsid","title":"PUT /api/settings/user-presets/:id","text":"
Body mit beliebigen Feldern aus POST, Response { \"preset\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsuser-presetsid","title":"DELETE /api/settings/user-presets/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#weitere-endpunkte","title":"Weitere Endpunkte","text":""},{"location":"api/settings/#get-apisettingseffective-paths","title":"GET /api/settings/effective-paths","text":"
Liefert aufgel\u00f6ste, effektiv genutzte Pfade aus den Settings (f\u00fcr UI- und Diagnosezwecke).
"},{"location":"api/settings/#post-apisettingscoverartrecover","title":"POST /api/settings/coverart/recover","text":"
Startet eine manuelle Coverart-Recovery.
 
Response (Beispiel):
 
{\n  \"result\": { \"started\": true },\n  \"scheduler\": { \"enabled\": true }\n}\n
"},{"location":"api/settings/#activation-bytes-aax","title":"Activation Bytes (AAX)","text":""},{"location":"api/settings/#get-apisettingsactivation-bytes","title":"GET /api/settings/activation-bytes","text":"
Liest gecachte AAX-Activation-Bytes.
"},{"location":"api/settings/#post-apisettingsactivation-bytes","title":"POST /api/settings/activation-bytes","text":"
Speichert Activation-Bytes.
 
Request:
 
{\n  \"checksum\": \"abc123...\",\n  \"activationBytes\": \"1a2b3c4d\"\n}\n
"},{"location":"api/settings/#laufwerke","title":"Laufwerke","text":""},{"location":"api/settings/#get-apisettingsdrives","title":"GET /api/settings/drives","text":"
Liefert erkannte optische Laufwerke (/dev/...) inkl. MakeMKV-Disc-Index.
"},{"location":"api/settings/#post-apisettingsdrivesforce-unlock","title":"POST /api/settings/drives/force-unlock","text":"
Erzwingt Entsperren aktiver Laufwerkslocks.
 
Hinweis: Expertenmodus (ui_expert_mode) ist erforderlich, sonst 403.
 
Request (ein Laufwerk):
 
{ \"devicePath\": \"/dev/sr0\" }\n
 
Request (alle):
 
{ \"all\": true }\n
"},{"location":"api/settings/#ui-preferences","title":"UI Preferences","text":""},{"location":"api/settings/#get-apisettingsprefskey","title":"GET /api/settings/prefs/:key","text":"
Liest einen persistierten UI-Preference-Wert.
"},{"location":"api/settings/#put-apisettingsprefskey","title":"PUT /api/settings/prefs/:key","text":"
Speichert einen persistierten UI-Preference-Wert.
 
Request:
 
{ \"value\": \"{\\\"columns\\\":[\\\"id\\\",\\\"status\\\"]}\" }\n
"},{"location":"api/websocket/","title":"WebSocket Events","text":"
Ripster sendet Echtzeit-Updates \u00fcber /ws.
"},{"location":"api/websocket/#verbindung","title":"Verbindung","text":"
const ws = new WebSocket('ws://localhost:3001/ws');\n\nws.onmessage = (event) => {\n  const msg = JSON.parse(event.data);\n  console.log(msg.type, msg.payload);\n};\n
"},{"location":"api/websocket/#nachrichtenformat","title":"Nachrichtenformat","text":"
Die meisten Broadcasts haben dieses Schema:
 
{\n  \"type\": \"EVENT_TYPE\",\n  \"payload\": {},\n  \"timestamp\": \"2026-03-10T09:00:00.000Z\"\n}\n
 
Ausnahme: WS_CONNECTED beim Verbindungsaufbau enth\u00e4lt kein timestamp.
"},{"location":"api/websocket/#event-typen","title":"Event-Typen","text":""},{"location":"api/websocket/#ws_connected","title":"WS_CONNECTED","text":"
Sofort nach erfolgreicher Verbindung.
 
{\n  \"type\": \"WS_CONNECTED\",\n  \"payload\": {\n    \"connectedAt\": \"2026-03-10T09:00:00.000Z\"\n  }\n}\n
"},{"location":"api/websocket/#pipeline_state_changed","title":"PIPELINE_STATE_CHANGED","text":"
Neuer Pipeline-Snapshot.
 
{\n  \"type\": \"PIPELINE_STATE_CHANGED\",\n  \"payload\": {\n    \"state\": \"ENCODING\",\n    \"activeJobId\": 42,\n    \"progress\": 62.5,\n    \"eta\": \"00:12:34\",\n    \"statusText\": \"ENCODING 62.50%\",\n    \"context\": {},\n    \"jobProgress\": {\n      \"42\": {\n        \"state\": \"ENCODING\",\n        \"progress\": 62.5,\n        \"eta\": \"00:12:34\",\n        \"statusText\": \"ENCODING 62.50%\"\n      }\n    },\n    \"queue\": {\n      \"maxParallelJobs\": 1,\n      \"runningCount\": 1,\n      \"queuedCount\": 2,\n      \"runningJobs\": [],\n      \"queuedJobs\": []\n    }\n  }\n}\n
"},{"location":"api/websocket/#pipeline_progress","title":"PIPELINE_PROGRESS","text":"
Laufende Fortschrittsupdates.
 
{\n  \"type\": \"PIPELINE_PROGRESS\",\n  \"payload\": {\n    \"state\": \"ENCODING\",\n    \"activeJobId\": 42,\n    \"progress\": 62.5,\n    \"eta\": \"00:12:34\",\n    \"statusText\": \"ENCODING 62.50%\"\n  }\n}\n
"},{"location":"api/websocket/#pipeline_queue_changed","title":"PIPELINE_QUEUE_CHANGED","text":"
Queue-Snapshot aktualisiert.
"},{"location":"api/websocket/#disc_detected-disc_removed","title":"DISC_DETECTED / DISC_REMOVED","text":"
Disc-Insertion/-Removal.
 
{\n  \"type\": \"DISC_DETECTED\",\n  \"payload\": {\n    \"device\": {\n      \"path\": \"/dev/sr0\",\n      \"discLabel\": \"INCEPTION\",\n      \"model\": \"ASUS BW-16D1HT\",\n      \"fstype\": \"udf\",\n      \"mountpoint\": null,\n      \"mediaProfile\": \"bluray\"\n    }\n  }\n}\n
 
mediaProfile: bluray | dvd | other | null
"},{"location":"api/websocket/#hardware_monitor_update","title":"HARDWARE_MONITOR_UPDATE","text":"
Snapshot aus Hardware-Monitoring.
 
{\n  \"type\": \"HARDWARE_MONITOR_UPDATE\",\n  \"payload\": {\n    \"enabled\": true,\n    \"intervalMs\": 5000,\n    \"updatedAt\": \"2026-03-10T09:00:00.000Z\",\n    \"sample\": {\n      \"cpu\": {},\n      \"memory\": {},\n      \"gpu\": {},\n      \"storage\": {}\n    },\n    \"error\": null\n  }\n}\n
"},{"location":"api/websocket/#pipeline_error","title":"PIPELINE_ERROR","text":"
Fehler bei Disc-Event-Verarbeitung in Pipeline.
"},{"location":"api/websocket/#disk_detection_error","title":"DISK_DETECTION_ERROR","text":"
Fehler in Laufwerkserkennung.
"},{"location":"api/websocket/#settings_updated","title":"SETTINGS_UPDATED","text":"
Einzelnes Setting wurde gespeichert.
"},{"location":"api/websocket/#settings_bulk_updated","title":"SETTINGS_BULK_UPDATED","text":"
Bulk-Settings gespeichert.
 
{\n  \"type\": \"SETTINGS_BULK_UPDATED\",\n  \"payload\": {\n    \"count\": 3,\n    \"keys\": [\"raw_dir\", \"movie_dir\", \"handbrake_preset_bluray\"]\n  }\n}\n
"},{"location":"api/websocket/#settings_scripts_updated","title":"SETTINGS_SCRIPTS_UPDATED","text":"
Skript ge\u00e4ndert (created|updated|deleted|reordered).
"},{"location":"api/websocket/#settings_script_chains_updated","title":"SETTINGS_SCRIPT_CHAINS_UPDATED","text":"
Skript-Kette ge\u00e4ndert (created|updated|deleted|reordered).
"},{"location":"api/websocket/#user_presets_updated","title":"USER_PRESETS_UPDATED","text":"
User-Preset ge\u00e4ndert (created|updated|deleted).
"},{"location":"api/websocket/#cron_jobs_updated","title":"CRON_JOBS_UPDATED","text":"
Cron-Config ge\u00e4ndert (created|updated|deleted).
"},{"location":"api/websocket/#cron_job_updated","title":"CRON_JOB_UPDATED","text":"
Laufzeitstatus eines Cron-Jobs ge\u00e4ndert.
 
{\n  \"type\": \"CRON_JOB_UPDATED\",\n  \"payload\": {\n    \"id\": 1,\n    \"lastRunStatus\": \"running\",\n    \"lastRunAt\": \"2026-03-10T10:00:00.000Z\",\n    \"nextRunAt\": null\n  }\n}\n
"},{"location":"api/websocket/#runtime_activity_changed","title":"RUNTIME_ACTIVITY_CHANGED","text":"
Vollst\u00e4ndiger Snapshot aller laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten.
 
Wird ausgel\u00f6st, wenn eine Aktivit\u00e4t gestartet, aktualisiert oder abgeschlossen wird sowie nach clear-recent.
 
{\n  \"type\": \"RUNTIME_ACTIVITY_CHANGED\",\n  \"payload\": {\n    \"active\": [\n      {\n        \"id\": 7,\n        \"type\": \"chain\",\n        \"name\": \"Post-Encode Aufr\u00e4umen\",\n        \"status\": \"running\",\n        \"source\": \"cron\",\n        \"message\": \"Schritt 2 von 3\",\n        \"currentStep\": \"cleanup.sh\",\n        \"currentStepType\": \"script\",\n        \"stepIndex\": 2,\n        \"stepTotal\": 3,\n        \"canCancel\": true,\n        \"canNextStep\": false,\n        \"outcome\": \"running\",\n        \"startedAt\": \"2026-03-10T10:00:00.000Z\",\n        \"finishedAt\": null,\n        \"durationMs\": null\n      }\n    ],\n    \"recent\": [],\n    \"updatedAt\": \"2026-03-10T10:00:05.000Z\"\n  }\n}\n
 
Vollst\u00e4ndige Feldbeschreibung: Runtime Activities API.
"},{"location":"api/websocket/#converter_scan_update","title":"CONVERTER_SCAN_UPDATE","text":"
Wird nach einem Scan des Converter-Eingangsordners gesendet (manuell oder per Polling).
 
{\n  \"type\": \"CONVERTER_SCAN_UPDATE\",\n  \"payload\": {\n    \"entryCount\": 12\n  }\n}\n
"},{"location":"api/websocket/#downloads_updated","title":"DOWNLOADS_UPDATED","text":"
Wird bei jeder Status\u00e4nderung in der Download-Queue gesendet.
 
{\n  \"type\": \"DOWNLOADS_UPDATED\",\n  \"payload\": {\n    \"reason\": \"ready\",\n    \"item\": {\n      \"id\": \"dl-1\",\n      \"jobId\": 42,\n      \"status\": \"ready\",\n      \"archiveName\": \"Job_42_movie.zip\",\n      \"createdAt\": \"2026-03-30T10:00:00.000Z\"\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"pending\": 1,\n      \"processing\": 0,\n      \"ready\": 1,\n      \"failed\": 1\n    }\n  }\n}\n
 
M\u00f6gliche reason-Werte: queued, processing, ready, failed, deleted.
"},{"location":"api/websocket/#reconnect-verhalten","title":"Reconnect-Verhalten","text":"
useWebSocket verbindet bei Abbruch automatisch neu:
 
     
  • Retry-Intervall: 1500ms
    •  
  • Wiederverbindung bis Komponente unmounted wird
    •  
"},{"location":"appendix/","title":"Technischer Anhang","text":"
Dieser Bereich enth\u00e4lt die technische Referenz hinter dem Benutzerhandbuch.
"},{"location":"appendix/#inhalt","title":"Inhalt","text":"
     
  • Konfiguration
    •  
  • komplette Feldreferenz
    •  
  • Umgebungsvariablen
    •  
  • Pipeline intern
    •  
  • Zustandsmodell
    •  
  • Encode-Planung
    •  
  • Playlist-Analyse
    •  
  • Pre-/Post-Encode-Ausf\u00fchrungen
    •  
  • API-Referenz
    •  
  • REST-Endpunkte
    •  
  • WebSocket-Events
    •  
  • Architektur
    •  
  • Backend-/Frontend-Aufbau
    •  
  • Datenbank
    •  
  • Deployment
    •  
  • Betrieb in Entwicklung und Produktion
    •  
  • Externe Tools
    •  
  • MakeMKV, HandBrake, MediaInfo
    •  
"},{"location":"appendix/#wann-du-in-den-anhang-wechselst","title":"Wann du in den Anhang wechselst","text":"
     
  • du integrierst Ripster mit anderen Systemen
    •  
  • du betreibst mehrere Instanzen oder willst tiefer debuggen
    •  
  • du brauchst Feld-/API-/Schema-Details f\u00fcr Automatisierung
    •  
"},{"location":"architecture/","title":"Anhang: Architektur","text":"
Ripster ist eine Client-Server-Anwendung mit REST + WebSocket und externen CLI-Tools.
"},{"location":"architecture/#systemuberblick","title":"System\u00fcberblick","text":"
graph TB\n    subgraph Browser[\"Browser (React)\"]\n        Ripper[Ripper]\n        Settings[Einstellungen]\n        History[Historie]\n    end\n\n    subgraph Backend[\"Node.js Backend\"]\n        API[REST API\\nExpress]\n        WS[WebSocket\\n/ws]\n        Pipeline[pipelineService]\n        Cron[cronService]\n        DB[(SQLite)]\n    end\n\n    subgraph Tools[\"Externe Tools\"]\n        MakeMKV[makemkvcon]\n        HandBrake[HandBrakeCLI]\n        MediaInfo[mediainfo]\n    end\n\n    Browser <-->|HTTP| API\n    Browser <-->|WebSocket| WS\n    Pipeline --> MakeMKV\n    Pipeline --> HandBrake\n    Pipeline --> MediaInfo\n    API --> DB\n    Pipeline --> DB\n    Cron --> DB
"},{"location":"architecture/#details","title":"Details","text":"
     
  •  \u00dcbersicht
    •  
  •  Backend-Services
    •  
  •  Frontend-Komponenten
    •  
  •  Datenbank
    •  
"},{"location":"architecture/backend/","title":"Backend-Services","text":"
Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung \u00fcber ein Plugin-System.
"},{"location":"architecture/backend/#plugin-system-srcplugins","title":"Plugin-System (src/plugins/)","text":"
Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
"},{"location":"architecture/backend/#basisklassen","title":"Basisklassen","text":"
     
  • PluginBase.js \u2014 Abstrakte Basisklasse SourcePlugin mit Lifecycle-Methoden
    •  
  • PluginRegistry.js \u2014 Dynamische Plugin-Erkennung, priorit\u00e4tsbasierte Auswahl, Settings-Schema-Aggregation
    •  
  • PluginContext.js \u2014 Ausf\u00fchrungskontext (Logger, Callbacks, Signals) f\u00fcr Plugin-Aufrufe
    •  
"},{"location":"architecture/backend/#plugin-lifecycle","title":"Plugin-Lifecycle","text":"
Jedes Plugin implementiert die folgenden Methoden:
 Methode Beschreibung detect(discInfo) Medientyp-Erkennung analyze(devicePath, job, ctx) Analyse / Metadaten-Extraktion rip(job, ctx) Rohdaten-Extraktion review(job, ctx) Optionale Vorschau-Vorbereitung encode(job, ctx) Finales Encoding/Konvertierung finalize(job, ctx) Nachbearbeitung onCancel(job, ctx) Bereinigung bei Abbruch onRetry(job, ctx) Zustand-Reset vor Retry"},{"location":"architecture/backend/#implementierte-plugins","title":"Implementierte Plugins","text":"
     
  • BluRayPlugin.js \u2014 Blu-ray via MakeMKV (Backup-Modus)
    •  
  • DVDPlugin.js \u2014 DVD via MakeMKV (MKV-Modus)
    •  
  • CdPlugin.js \u2014 Audio-CD via cdparanoia + FFmpeg (experimentell)
    •  
  • AudiobookPlugin.js \u2014 AAX/M4B via FFmpeg mit Kapitel-Splitting
    •  
  • ConverterPlugin.js \u2014 Generische Audio/Video-Konvertierung via FFmpeg
    •  
  • VideoDiscPlugin.js \u2014 Gemeinsame Basis f\u00fcr Blu-ray/DVD (MediaInfo-Parsing)
    •  
"},{"location":"architecture/backend/#pipelineservicejs","title":"pipelineService.js","text":"
Zentrale Workflow-Orchestrierung.
 
Aufgaben:
 
     
  • Pipeline-State-Machine + Persistenz (pipeline_state)
    •  
  • Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
    •  
  • Queue-Management (Jobs + script|chain|wait Eintr\u00e4ge)
    •  
  • Retry/Re-Encode/Restart-Flows
    •  
  • WebSocket-Broadcasts f\u00fcr State/Progress/Queue
    •  
  • Converter-Job-Verwaltung (createConverterJobFromEntry, uploadConverterFiles, startConverterJob)
    •  
 
Wichtige Methoden:
 
     
  • analyzeDisc()
    •  
  • selectMetadata()
    •  
  • startPreparedJob()
    •  
  • confirmEncodeReview()
    •  
  • cancel()
    •  
  • retry()
    •  
  • reencodeFromRaw()
    •  
  • restartReviewFromRaw()
    •  
  • restartEncodeWithLastSettings()
    •  
  • resumeReadyToEncodeJob()
    •  
  • enqueueNonJobEntry(), reorderQueue(), removeQueueEntry()
    •  
  • createConverterJobFromEntry(), createConverterJobsFromSelection()
    •  
  • uploadConverterFiles(), startConverterJob()
    •  
"},{"location":"architecture/backend/#diskdetectionservicejs","title":"diskDetectionService.js","text":"
Pollt Laufwerk(e) und emittiert:
 
     
  • discInserted
    •  
  • discRemoved
    •  
  • error
    •  
 
Zusatz:
 
     
  • Modus auto oder explicit
    •  
  • heuristische mediaProfile-Erkennung (bluray/dvd/other)
    •  
  • rescanAndEmit() f\u00fcr manuellen Trigger
    •  
"},{"location":"architecture/backend/#settingsservicejs","title":"settingsService.js","text":"
Settings-Layer mit Validation/Serialisierung.
 
Features:
 
     
  • getCategorizedSettings() f\u00fcr UI-Form
    •  
  • setSettingValue() / setSettingsBulk()
    •  
  • profilspezifische Aufl\u00f6sung (resolveEffectiveToolSettings)
    •  
  • CLI-Config-Building f\u00fcr MakeMKV/HandBrake/MediaInfo/FFmpeg
    •  
  • HandBrake-Preset-Liste via HandBrakeCLI -z
    •  
  • MakeMKV-Registration-Command aus makemkv_registration_key
    •  
  • Pfadaufl\u00f6sung f\u00fcr alle Medienprofile inkl. Audiobook und Converter
    •  
"},{"location":"architecture/backend/#historyservicejs","title":"historyService.js","text":"
Historie + Dateioperationen.
 
Features:
 
     
  • Job-Liste/Detail inkl. Log-Tail
    •  
  • Orphan-RAW-Erkennung und Import
    •  
  • OMDb-Nachzuweisung
    •  
  • Dateil\u00f6schung (raw|movie|both)
    •  
  • Job-L\u00f6schung (none|raw|movie|both)
    •  
"},{"location":"architecture/backend/#audiobookservicejs","title":"audiobookService.js","text":"
Audiobook-Verarbeitung (AAX/M4B).
 
Features:
 
     
  • FFprobe-basierte Analyse (Kapitel, Metadaten)
    •  
  • FFmpeg-basiertes Encoding mit Kapitel-Splitting
    •  
  • Ausgabeformate: M4B, MP3, FLAC
    •  
  • Template-basierte Pfade ({author}, {title}, {year}, {narrator}, {series}, {part})
    •  
"},{"location":"architecture/backend/#activationbytesservicejs","title":"activationBytesService.js","text":"
Verwaltung von Audible-Activation-Bytes f\u00fcr AAX-DRM-Handling.
 
Features:
 
     
  • SHA-1-Pr\u00fcfsumme der AAX-Datei berechnen
    •  
  • Activation Bytes in aax_activation_bytes-Tabelle cachen
    •  
  • Lookup via audnexService (wenn konfiguriert)
    •  
"},{"location":"architecture/backend/#converterscanservicejs","title":"converterScanService.js","text":"
Dateisystem-\u00dcberwachung des Converter-Eingangsordners.
 
Features:
 
     
  • Vollst\u00e4ndiger FS-Baum (getTree())
    •  
  • DB-basierter Datei-Explorer (getEntries())
    •  
  • Manueller und automatischer Scan (Polling)
    •  
  • Pfad-Normalisierung mit Traversal-Schutz
    •  
  • WebSocket-Broadcast: CONVERTER_SCAN_UPDATE
    •  
"},{"location":"architecture/backend/#downloadservicejs","title":"downloadService.js","text":"
Download-Queue f\u00fcr Ausgabedateien aus der Historie.
 
Features:
 
     
  • Job in Download-Queue einreihen (enqueueHistoryJob)
    •  
  • ZIP-Archiv aus Ausgabedateien erstellen (archiver)
    •  
  • Datei-Streaming via res.download()
    •  
  • WebSocket-Broadcast: DOWNLOADS_UPDATED bei Status-\u00c4nderungen
    •  
  • Download-Item l\u00f6schen
    •  
"},{"location":"architecture/backend/#cronservicejs","title":"cronService.js","text":"
Integriertes Cron-System ohne externe Parser-Library.
 
Features:
 
     
  • 5-Feld-Cron-Parser + nextRun-Berechnung
    •  
  • Quellen: script oder chain
    •  
  • Laufzeitlogs (cron_run_logs)
    •  
  • manuelles Triggern
    •  
  • WebSocket-Events: CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
"},{"location":"architecture/backend/#runtimeactivityservicejs","title":"runtimeActivityService.js","text":"
In-Memory-Tracking aller laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten (Skripte, Ketten, Cron-Jobs, Tasks).
 
Features:
 
     
  • startActivity(type, payload) \u2192 Aktivit\u00e4t registrieren, ID zur\u00fcckgeben
    •  
  • updateActivity(id, patch) \u2192 Laufende Aktivit\u00e4t aktualisieren
    •  
  • completeActivity(id, payload) \u2192 Aktivit\u00e4t abschlie\u00dfen und in recent verschieben
    •  
  • setControls(id, { cancel, nextStep }) \u2192 Steuer-Handler registrieren (f\u00fcr canCancel/canNextStep)
    •  
  • requestCancel(id) / requestNextStep(id) \u2192 Steuer-Handler aufrufen
    •  
  • clearRecent() \u2192 Abgeschlossene Aktivit\u00e4ten l\u00f6schen
    •  
  • getSnapshot() \u2192 Snapshot mit active + recent + updatedAt
    •  
  • Broadcasts RUNTIME_ACTIVITY_CHANGED \u00fcber WebSocket bei jeder \u00c4nderung
    •  
 
Limits:
 
     
  • recent max. 120 Eintr\u00e4ge
    •  
  • stdout/stderr/output max. 12.000 Zeichen
    •  
  • message/errorMessage max. 2.000 Zeichen
    •  
 
Vollst\u00e4ndige API-Dokumentation: Runtime Activities API
"},{"location":"architecture/backend/#weitere-services","title":"Weitere Services","text":"
     
  • scriptService.js (CRUD + Test + Wrapper-Ausf\u00fchrung)
    •  
  • scriptChainService.js (CRUD + Step-Execution)
    •  
  • userPresetService.js (HandBrake User-Presets)
    •  
  • hardwareMonitorService.js (CPU/RAM/GPU/Storage)
    •  
  • websocketService.js (Client-Registry + Broadcast)
    •  
  • notificationService.js (PushOver)
    •  
  • cdRipService.js (CD-Ripping mit cdparanoia)
    •  
  • musicBrainzService.js (MusicBrainz-Metadaten-Lookup)
    •  
  • audnexService.js (Audnex-API f\u00fcr Audiobook-Metadaten)
    •  
  • coverArtRecoveryService.js (Cover-Art-Wiederherstellung)
    •  
  • thumbnailService.js (Vorschaubild-Generierung)
    •  
  • omdbService.js (OMDb-Metadaten-Suche)
    •  
  • logger.js (rotierende Datei-Logs)
    •  
"},{"location":"architecture/backend/#bootstrapping-srcindexjs","title":"Bootstrapping (src/index.js)","text":"
Beim Start:
 
     
  1. DB init/migrate
    2.  
  2. Pipeline-Init (inkl. Plugin-Registry)
    3.  
  3. Cron-Init
    4.  
  4. Express-Routes + Error-Handler
    5.  
  5. WebSocket-Server auf /ws
    6.  
  6. Hardware-Monitoring-Init
    7.  
  7. Disk-Detection-Start
    8.  
  8. Converter-Scan-Service-Init (Polling falls aktiviert)
    9.  
"},{"location":"architecture/database/","title":"Datenbank","text":"
Ripster verwendet SQLite (backend/data/ripster.db).
"},{"location":"architecture/database/#tabellen","title":"Tabellen","text":"
settings_schema\nsettings_values\njobs\njob_lineage_artifacts\njob_output_folders\npipeline_state\nscripts\nscript_chains\nscript_chain_steps\nuser_presets\ncron_jobs\ncron_run_logs\naax_activation_bytes\nuser_prefs\nconverter_scan_entries\n
"},{"location":"architecture/database/#jobs","title":"jobs","text":"
Speichert Pipeline-Lifecycle und Artefakte pro Job.
 
Zentrale Felder:
 
     
  • Metadaten: title, year, imdb_id, poster_url, omdb_json, selected_from_omdb
    •  
  • Laufzeit: start_time, end_time, status, last_state
    •  
  • Pfade: raw_path, output_path, encode_input_path
    •  
  • Tool-Ausgaben: makemkv_info_json, handbrake_info_json, mediainfo_info_json, encode_plan_json
    •  
  • Kontrolle: encode_review_confirmed, rip_successful, error_message
    •  
  • Medientyp: media_type (bluray|dvd|cd|audiobook|converter)
    •  
  • Job-Typ/Beziehung: job_kind, parent_job_id
    •  
  • Multipart-/Disc-Merkmale: is_multipart_movie, disc_number, metadata_fingerprint
    •  
  • Pr\u00fcfsumme: aax_checksum (f\u00fcr AAX-Dateien)
    •  
  • Audit: created_at, updated_at
    •  
 
Typische job_kind-Werte:
 
     
  • Standard: bluray, dvd, cd, audiobook, converter_audio, converter_video, converter_iso
    •  
  • Serien: dvd_series_container, dvd_series_child
    •  
  • Multipart Film: multipart_movie_container, multipart_movie_child
    •  
 
Wichtige Indizes:
 
     
  • idx_jobs_status
    •  
  • idx_jobs_parent_job_id
    •  
  • idx_jobs_job_kind
    •  
  • idx_jobs_disc_number
    •  
  • idx_jobs_metadata_fingerprint
    •  
"},{"location":"architecture/database/#job_lineage_artifacts","title":"job_lineage_artifacts","text":"
Verkn\u00fcpft Jobs mit ihren Quell-Jobs (z. B. Re-Encode aus einem vorherigen Rip).
 
Felder:
 
     
  • job_id \u2014 der abgeleitete Job
    •  
  • source_job_id \u2014 der Quell-Job
    •  
  • artifact_type \u2014 Art der Verkn\u00fcpfung (z. B. reencode, restart_review)
    •  
  • created_at
    •  
"},{"location":"architecture/database/#job_output_folders","title":"job_output_folders","text":"
Verfolgt Ausgabepfade pro Job (mehrere Ausgaben m\u00f6glich, z. B. bei Kapitel-Splitting).
 
Felder:
 
     
  • job_id
    •  
  • folder_path
    •  
  • label \u2014 optionaler Bezeichner
    •  
  • created_at
    •  
"},{"location":"architecture/database/#pipeline_state","title":"pipeline_state","text":"
Singleton-Tabelle (id = 1) f\u00fcr aktiven Snapshot:
 
     
  • state
    •  
  • active_job_id
    •  
  • progress
    •  
  • eta
    •  
  • status_text
    •  
  • context_json
    •  
  • updated_at
    •  
"},{"location":"architecture/database/#settings_schema-settings_values","title":"settings_schema + settings_values","text":"
     
  • settings_schema: Definition (Typ, Default, Validation, Reihenfolge)
    •  
  • settings_values: aktueller Wert pro Key
    •  
"},{"location":"architecture/database/#scripts-script_chains-script_chain_steps","title":"scripts, script_chains, script_chain_steps","text":"
     
  • scripts: Shell-Skripte (name, script_body, order_index)
    •  
  • script_chains: Ketten (name, order_index)
    •  
  • script_chain_steps: Schritte je Kette
    •  
  • step_type: script oder wait
    •  
  • script_id oder wait_seconds
    •  
"},{"location":"architecture/database/#user_presets","title":"user_presets","text":"
Benannte HandBrake-Preset-Sets:
 
     
  • name
    •  
  • media_type (bluray|dvd|other|all)
    •  
  • handbrake_preset
    •  
  • extra_args
    •  
  • description
    •  
"},{"location":"architecture/database/#cron_jobs-cron_run_logs","title":"cron_jobs + cron_run_logs","text":"
     
  • cron_jobs: Zeitplan + Status
    •  
  • cron_run_logs: einzelne L\u00e4ufe
    •  
  • status: running|success|error
    •  
  • output
    •  
  • error_message
    •  
"},{"location":"architecture/database/#aax_activation_bytes","title":"aax_activation_bytes","text":"
Cache f\u00fcr Audible-Activation-Bytes (AAX-DRM).
 
Felder:
 
     
  • checksum \u2014 SHA-1-Pr\u00fcfsumme der AAX-Datei (Prim\u00e4rschl\u00fcssel)
    •  
  • activation_bytes \u2014 Hex-String der Activation Bytes
    •  
  • created_at
    •  
"},{"location":"architecture/database/#user_prefs","title":"user_prefs","text":"
Benutzer-spezifische Einstellungen (Key-Value).
 
Felder:
 
     
  • key
    •  
  • value
    •  
  • updated_at
    •  
"},{"location":"architecture/database/#converter_scan_entries","title":"converter_scan_entries","text":"
DB-seitige Erfassung gescannter Dateien im Converter-Eingangsordner.
 
Felder:
 
     
  • rel_path \u2014 relativer Pfad zum converter_raw_dir
    •  
  • is_dir \u2014 Verzeichnis-Flag
    •  
  • size \u2014 Dateigr\u00f6\u00dfe in Bytes
    •  
  • modified_at \u2014 Datei-\u00c4nderungsdatum
    •  
  • job_id \u2014 zugewiesener Converter-Job (falls vorhanden)
    •  
  • scanned_at
    •  
"},{"location":"architecture/database/#migrationrecovery","title":"Migration/Recovery","text":"
Beim Start werden Schema und Settings-Metadaten automatisch abgeglichen.
 
Bei korruptem SQLite-File:
 
     
  1. Datei wird nach backend/data/corrupt-backups/ verschoben
    2.  
  2. neue DB wird initialisiert
    3.  
  3. Schema wird neu aufgebaut
    4.  
"},{"location":"architecture/database/#direkte-inspektion","title":"Direkte Inspektion","text":"
sqlite3 backend/data/ripster.db\n\n.mode table\nSELECT id, status, title, media_type, created_at FROM jobs ORDER BY created_at DESC;\nSELECT id, parent_job_id, job_kind, is_multipart_movie, disc_number FROM jobs ORDER BY created_at DESC;\nSELECT key, value FROM settings_values ORDER BY key;\nSELECT checksum, activation_bytes FROM aax_activation_bytes;\nSELECT rel_path, job_id FROM converter_scan_entries;\n
"},{"location":"architecture/frontend/","title":"Frontend-Komponenten","text":"
Frontend: React + PrimeReact + Vite.
"},{"location":"architecture/frontend/#hauptseiten","title":"Hauptseiten","text":""},{"location":"architecture/frontend/#jobsinboxpagejsx","title":"JobsInboxPage.jsx","text":"
Zentrale Job-Inbox:
 
     
  • einheitliche Liste \u00fcber Ripper-, Converter- und Audiobook-Jobs
    •  
  • View-/Status-Filter, Suche, Paginierung
    •  
  • Schnellsprung in passende Detailseite (Ripper/Converter)
    •  
"},{"location":"architecture/frontend/#ripperpagejsx","title":"RipperPage.jsx","text":"
Pipeline-Steuerung:
 
     
  • Status/Progress/ETA
    •  
  • Metadaten-Dialog
    •  
  • Playlist-Entscheidung
    •  
  • Review-Panel (Track-Auswahl)
    •  
  • Queue-Interaktion (reorder/add/remove)
    •  
  • Job-Aktionen (Start/Cancel/Retry/Re-Encode)
    •  
  • Hardware-Monitoring-Anzeige
    •  
  • Aktivit\u00e4ts-Tracking (Skripte, Ketten, Cron)
    •  
"},{"location":"architecture/frontend/#settingspagejsx","title":"SettingsPage.jsx","text":"
Konfiguration:
 
     
  • dynamisches Settings-Formular (DynamicSettingsForm)
    •  
  • Skripte/Ketten inkl. Reorder/Test
    •  
  • User-Presets
    •  
  • Cron-Jobs (CronJobsTab)
    •  
"},{"location":"architecture/frontend/#historypagejsx","title":"HistoryPage.jsx","text":"
Historie:
 
     
  • Job-Liste/Filter
    •  
  • Job-Details + Logs
    •  
  • OMDb-Nachzuweisung
    •  
  • Re-Encode/Restart-Workflows
    •  
"},{"location":"architecture/frontend/#converterpagejsx","title":"ConverterPage.jsx","text":"
Datei-Converter:
 
     
  • Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
    •  
  • Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
    •  
  • Dateiverwaltung: Umbenennen, Verschieben, L\u00f6schen, Ordner erstellen
    •  
  • Jobs aus Dateiauswahl erstellen
    •  
  • Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
    •  
  • Job-Start, Abbruch, L\u00f6schung
    •  
  • Automatischer Scan-Status
    •  
"},{"location":"architecture/frontend/#audiobookspagejsx","title":"AudiobooksPage.jsx","text":"
Dedizierter AAX-/Audiobook-Flow:
 
     
  • Upload-Panel f\u00fcr AAX-Dateien
    •  
  • aktive Audiobook-Jobkarten mit Start/Cancel/Retry/Delete
    •  
  • Audiobook-Konfigurationspanel und Output-Explorer
    •  
"},{"location":"architecture/frontend/#downloadspagejsx","title":"DownloadsPage.jsx","text":"
Download-Queue:
 
     
  • Ausgabedateien aus der Job-Historie in die Queue einreihen
    •  
  • Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
    •  
  • Dateien als ZIP herunterladen
    •  
  • Download-Eintr\u00e4ge l\u00f6schen
    •  
"},{"location":"architecture/frontend/#databasepagejsx","title":"DatabasePage.jsx","text":"
Expert-Modus:
 
     
  • Tabellarische Rohsicht der Job-Datenbank
    •  
  • Orphan-RAW-Import
    •  
"},{"location":"architecture/frontend/#wichtige-komponenten","title":"Wichtige Komponenten","text":"
     
  • PipelineStatusCard.jsx \u2014 Pipeline-Status-Anzeige mit Progress
    •  
  • MetadataSelectionDialog.jsx \u2014 OMDb-Metadaten-Auswahl
    •  
  • MediaInfoReviewPanel.jsx \u2014 Track-Auswahl-Interface (Video/Audio/Untertitel)
    •  
  • JobDetailDialog.jsx \u2014 Job-Detailansicht mit Logs
    •  
  • CronJobsTab.jsx \u2014 Cron-Job-Verwaltung
    •  
  • DynamicSettingsForm.jsx \u2014 Schema-gesteuertes Einstellungsformular
    •  
  • ConverterJobCard.jsx \u2014 Converter-Job-Darstellung
    •  
  • CdRipConfigPanel.jsx \u2014 Konfiguration f\u00fcr Audio-CD-Ripping
    •  
"},{"location":"architecture/frontend/#api-client-apiclientjs","title":"API-Client (api/client.js)","text":"
     
  • zentraler request() mit JSON-Handling
    •  
  • Fehlerobjekt aus API wird auf Error(message) gemappt
    •  
  • VITE_API_BASE default /api
    •  
"},{"location":"architecture/frontend/#websocket-hooksusewebsocketjs","title":"WebSocket (hooks/useWebSocket.js)","text":"
     
  • URL: VITE_WS_URL oder automatisch ws(s)://<host>/ws
    •  
  • Auto-Reconnect mit 1500ms Intervall
    •  
 
In App.jsx werden u. a. verarbeitet:
 
     
  • PIPELINE_STATE_CHANGED
    •  
  • PIPELINE_PROGRESS
    •  
  • PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt / Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • DOWNLOADS_UPDATED
    •  
  • CONVERTER_SCAN_UPDATE
    •  
  • RUNTIME_ACTIVITY_CHANGED
    •  
"},{"location":"architecture/frontend/#buildrun","title":"Build/Run","text":"
# dev\nnpm run dev --prefix frontend\n\n# prod build\nnpm run build --prefix frontend\n
"},{"location":"architecture/overview/","title":"Architektur-\u00dcbersicht","text":""},{"location":"architecture/overview/#kernprinzipien","title":"Kernprinzipien","text":""},{"location":"architecture/overview/#event-getriebene-pipeline","title":"Event-getriebene Pipeline","text":"
pipelineService h\u00e4lt einen Snapshot der State-Machine und broadcastet \u00c4nderungen sofort via WebSocket.
 
State-\u00c4nderung -> PIPELINE_STATE_CHANGED/PIPELINE_PROGRESS -> Frontend-Update\n
"},{"location":"architecture/overview/#service-layer","title":"Service-Layer","text":"
Route -> Service -> DB/Tool-Execution\n
 
Routes enthalten kaum Business-Logik.
"},{"location":"architecture/overview/#schema-getriebene-settings","title":"Schema-getriebene Settings","text":"
Settings sind DB-schema-getrieben (settings_schema + settings_values), UI rendert dynamisch aus diesen Daten.
"},{"location":"architecture/overview/#echtzeit-kommunikation","title":"Echtzeit-Kommunikation","text":"
WebSocket l\u00e4uft auf /ws.
 
Wichtige Events:
 
     
  • PIPELINE_STATE_CHANGED, PIPELINE_PROGRESS, PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt, Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • SETTINGS_UPDATED, SETTINGS_BULK_UPDATED
    •  
  • SETTINGS_SCRIPTS_UPDATED, SETTINGS_SCRIPT_CHAINS_UPDATED, USER_PRESETS_UPDATED
    •  
  • CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
  • PIPELINE_ERROR, DISK_DETECTION_ERROR
    •  
"},{"location":"architecture/overview/#prozessausfuhrung","title":"Prozessausf\u00fchrung","text":"
Externe Tools werden als Child-Processes gestartet (processRunner):
 
     
  • Streaming von stdout/stderr
    •  
  • Progress-Parsing (progressParsers.js)
    •  
  • kontrollierter Abbruch (SIGINT/SIGKILL-Fallback)
    •  
"},{"location":"architecture/overview/#persistenz","title":"Persistenz","text":"
SQLite-Datei: backend/data/ripster.db
 
Kern-Tabellen:
 
     
  • jobs, pipeline_state
    •  
  • settings_schema, settings_values
    •  
  • scripts, script_chains, script_chain_steps
    •  
  • user_presets
    •  
  • cron_jobs, cron_run_logs
    •  
 
Beim Start werden Schema und Settings-Migrationen automatisch ausgef\u00fchrt.
"},{"location":"architecture/overview/#fehlerbehandlung","title":"Fehlerbehandlung","text":"
Zentrales Error-Handling liefert:
 
{\n  \"error\": {\n    \"message\": \"...\",\n    \"statusCode\": 400,\n    \"reqId\": \"...\",\n    \"details\": []\n  }\n}\n
 
Fehlgeschlagene Jobs bleiben in der Historie (Fehler oder Abgebrochen) und k\u00f6nnen erneut gestartet werden.
"},{"location":"architecture/overview/#cors-runtime-konfig","title":"CORS & Runtime-Konfig","text":"
     
  • CORS_ORIGIN default: *
    •  
  • LOG_LEVEL default: info
    •  
  • DB-/Log-Pfade \u00fcber DB_PATH/LOG_DIR konfigurierbar
    •  
"},{"location":"configuration/","title":"Anhang: Konfiguration","text":"
Dieser Abschnitt ist die technische Referenz zu allen Konfigurationsarten in Ripster.
"},{"location":"configuration/#inhalte","title":"Inhalte","text":"
     
  •  
     Einstellungsreferenz
     
    Vollst\u00e4ndige Liste aller UI-Settings (Typ, Default, Hinweise).
     
     Einstellungsreferenz
     
    •  
  •  
     Umgebungsvariablen
     
    backend/.env und frontend/.env inkl. Priorit\u00e4ten.
     
     Umgebungsvariablen
     
    •  
"},{"location":"configuration/#zuruck-zum-handbuch","title":"Zur\u00fcck zum Handbuch","text":"
     
  • Benutzerhandbuch \u00dcberblick
    •  
"},{"location":"configuration/environment/","title":"Umgebungsvariablen","text":"
Umgebungsvariablen steuern Backend/Vite au\u00dferhalb der DB-basierten UI-Settings.
"},{"location":"configuration/environment/#backend-backendenv","title":"Backend (backend/.env)","text":"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\u00fcr API LOG_LEVEL info debug, info, warn, error 
Beispiel:
 
PORT=3001\nDB_PATH=/var/lib/ripster/ripster.db\nLOG_DIR=/var/log/ripster\nCORS_ORIGIN=http://192.168.1.50:5173\nLOG_LEVEL=info\n
 
Hinweis: backend/.env.example enth\u00e4lt bewusst dev-freundliche Werte (z. B. lokaler CORS_ORIGIN).
"},{"location":"configuration/environment/#frontend-frontendenv","title":"Frontend (frontend/.env)","text":"Variable Default Beschreibung VITE_API_BASE /api API-Basis f\u00fcr Fetch-Client VITE_WS_URL automatisch aus window.location + /ws Optional explizite WebSocket-URL VITE_PUBLIC_ORIGIN leer \u00d6ffentliche Vite-Origin (Remote-Dev) VITE_ALLOWED_HOSTS true Komma-separierte Hostliste f\u00fcr 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 
Beispiele:
 
# lokal (mit Vite-Proxy)\nVITE_API_BASE=/api\n
 
# remote dev\nVITE_API_BASE=http://192.168.1.50:3001/api\nVITE_WS_URL=ws://192.168.1.50:3001/ws\nVITE_PUBLIC_ORIGIN=http://192.168.1.50:5173\nVITE_ALLOWED_HOSTS=192.168.1.50,ripster.local\nVITE_HMR_PROTOCOL=ws\nVITE_HMR_HOST=192.168.1.50\nVITE_HMR_CLIENT_PORT=5173\n
"},{"location":"configuration/environment/#prioritat","title":"Priorit\u00e4t","text":"
     
  1. Prozess-Umgebungsvariablen
    2.  
  2. .env
    3.  
  3. Code-Defaults
    4.  
"},{"location":"configuration/settings-reference/","title":"Einstellungsreferenz","text":"
Diese Seite dokumentiert alle UI-Settings mit ihrer Wirkung auf Flows, Pfade, Queue und Automatisierung.
"},{"location":"configuration/settings-reference/#wie-ripster-settings-auflost","title":"Wie Ripster Settings aufl\u00f6st","text":"
Ripster arbeitet intern mit profilspezifischen Settings (bluray, dvd, cd, audiobook) und bildet sie auf effektive Laufzeitwerte ab.
 
Wichtige Regeln:
 
     
  1. F\u00fcr bluray wird bei fehlenden profilierten Toolwerten auf dvd zur\u00fcckgefallen, und umgekehrt.
    2.  
  2. F\u00fcr cd und audiobook gibt es nur das eigene Profil.
    3.  
  3. Strikt profilgebundene Pfadkeys (raw_dir, movie_dir, series_dir plus Owner) fallen bei leeren Werten auf Installationsdefaults zur\u00fcck.
    4.  
 
Installationsdefaults:
 
     
  • RAW: data/output/raw
    •  
  • Movies: data/output/movies
    •  
  • Series: data/output/series
    •  
  • CD: data/output/cd
    •  
  • Audiobook RAW: data/output/audiobook-raw
    •  
  • Audiobook Output: data/output/audiobooks
    •  
  • Converter RAW: data/output/converter-raw
    •  
  • Converter Video: data/output/converted-movies
    •  
  • Converter Audio: data/output/converted-audio
    •  
"},{"location":"configuration/settings-reference/#kritische-wirkungsbereiche","title":"Kritische Wirkungsbereiche","text":""},{"location":"configuration/settings-reference/#1-pfad-und-template-einstellungen","title":"1) Pfad- und Template-Einstellungen","text":"
Diese Settings bestimmen direkt:
 
     
  • wo RAW landet
    •  
  • wo finale Ausgaben landen
    •  
  • wie Ordner/Dateinamen gerendert werden
    •  
 
Relevante Besonderheiten:
 
     
  • Serien-RAW nutzt bei Serienworkflow bevorzugt raw_dir_*_series.
    •  
  • Serien-Ausgabe nutzt series_dir_* und Serien-Templates (Episode/Multi-Episode).
    •  
  • Film-Ausgabe nutzt movie_dir_* und Film-Template.
    •  
  • Encode schreibt zun\u00e4chst in Incomplete_job-<id> und finalisiert danach in den Zielpfad.
    •  
"},{"location":"configuration/settings-reference/#2-queue-und-parallelitats-settings","title":"2) Queue- und Parallelit\u00e4ts-Settings","text":"
Die vier Limits greifen kombiniert:
 
     
  • pipeline_max_parallel_jobs (Film/Video-Lane)
    •  
  • pipeline_max_parallel_cd_encodes (Audio/CD-Lane)
    •  
  • pipeline_max_total_encodes (globaler Deckel)
    •  
  • pipeline_cd_bypasses_queue (Audio-Lane darf Filmwarteschlange umgehen)
    •  
 
Effekt:
 
     
  • Film und Audio haben getrennte Lane-Limits.
    •  
  • Das Gesamtlimit \u00fcberstimmt beide, sobald erreicht.
    •  
  • Queue kann zus\u00e4tzlich Nicht-Job-Eintr\u00e4ge (Skript, Kette, Warten) enthalten.
    •  
"},{"location":"configuration/settings-reference/#3-serien-metadaten-settings","title":"3) Serien-Metadaten-Settings","text":"
Diese steuern die Serienqualit\u00e4t direkt:
 
     
  • TMDb-Token aktiviert TMDb-gest\u00fctzte Serienmetadaten.
    •  
  • Sprache/Fallback-Sprachen beeinflussen Titel- und Episodenaufl\u00f6sung.
    •  
  • Ordnungspr\u00e4ferenz steuert Episode-Order.
    •  
  • Disc-Profile-Reuse verbessert automatische Zuordnung \u00fcber mehrere Discs.
    •  
"},{"location":"configuration/settings-reference/#4-tool-settings","title":"4) Tool-Settings","text":"
Toolfelder (makemkv_*, mediainfo_*, handbrake_*, ffmpeg_*, ffprobe_*, cdparanoia_*) wirken unmittelbar auf die tats\u00e4chlich ausgef\u00fchrten CLI-Aufrufe.
 
Typische Auswirkungen:
 
     
  • falscher Toolpfad => fr\u00fcher Pipelinefehler
    •  
  • ge\u00e4nderte Extra-Args => anderes Analyze-/Encode-Verhalten
    •  
  • ge\u00e4nderte Presets => andere HandBrake-Ausgaben
    •  
"},{"location":"configuration/settings-reference/#template-platzhalter","title":"Template-Platzhalter","text":""},{"location":"configuration/settings-reference/#film-templates","title":"Film-Templates","text":"
     
  • ${title}, ${year}, ${imdbId}
    •  
"},{"location":"configuration/settings-reference/#serien-templates","title":"Serien-Templates","text":"
     
  • {seriesTitle}, {seasonNr}, {episodeNr}, {episodeNoStart}, {episodeNoEnd}
    •  
  • {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}
    •  
  • f\u00fchrende Null m\u00f6glich mit {0:seasonNr} etc.
    •  
"},{"location":"configuration/settings-reference/#audiobook-templates","title":"Audiobook-Templates","text":"
     
  • {author}, {title}, {year}, {narrator}, {series}, {part}, {format}
    •  
"},{"location":"configuration/settings-reference/#converter-templates","title":"Converter-Templates","text":"
     
  • Video: {title}, {year}
    •  
  • Audio: {artist}, {title}, {album}, {year}, {trackNr}
    •  
"},{"location":"configuration/settings-reference/#vollstandige-feldliste","title":"Vollst\u00e4ndige Feldliste","text":""},{"location":"configuration/settings-reference/#kategorie-benachrichtigungen","title":"Kategorie: Benachrichtigungen","text":"GUI-Feld Key Typ Default Wirkung im System Expertenmodus ui_expert_mode boolean false Schaltet erweiterte Einstellungen in der UI ein. PushOver aktiviert pushover_enabled boolean false Master-Schalter f\u00fcr PushOver Versand. PushOver Token pushover_token string leer Application Token f\u00fcr PushOver. PushOver User pushover_user string leer User-Key f\u00fcr PushOver. PushOver Device (optional) pushover_device string leer Optionales Ziel-Device in PushOver. PushOver Titel-Pr\u00e4fix pushover_title_prefix string Ripster Prefix im PushOver Titel. PushOver Priority pushover_priority number 0 Priorit\u00e4t -2 bis 2. PushOver Timeout (ms) pushover_timeout_ms number 7000 HTTP Timeout f\u00fcr PushOver Requests. Bei Metadaten-Auswahl senden pushover_notify_metadata_ready boolean true Sendet wenn Metadaten zur Auswahl bereitstehen. Bei Rip-Start senden pushover_notify_rip_started boolean true Sendet beim Start des MakeMKV-Rips. Bei Encode-Start senden pushover_notify_encoding_started boolean true Sendet beim Start von HandBrake. Bei Erfolg senden pushover_notify_job_finished boolean true Sendet bei erfolgreich abgeschlossenem Job. Bei Fehler senden pushover_notify_job_error boolean true Sendet bei Fehlern in der Pipeline. Bei Abbruch senden pushover_notify_job_cancelled boolean true Sendet wenn Job manuell abgebrochen wurde. Bei Re-Encode Start senden pushover_notify_reencode_started boolean true Sendet beim Start von RAW Re-Encode. Bei Re-Encode Erfolg senden pushover_notify_reencode_finished boolean true Sendet bei erfolgreichem RAW Re-Encode."},{"location":"configuration/settings-reference/#kategorie-converter","title":"Kategorie: Converter","text":"GUI-Feld Key Typ Default Wirkung im System Erlaubte Datei-Endungen* converter_scan_extensions string mkv,mp4,m2ts,iso,avi,mov,flac,mp3,wav,m4a,ogg,opus Erlaubte Datei-Endungen f\u00fcr den Converter-Scan (ohne Punkt). Wird in der UI als Checkbox-Liste gepflegt. Auto-Scan (Polling) converter_polling_enabled boolean false Converter Raw-Ordner automatisch in regelm\u00e4\u00dfigen Abst\u00e4nden scannen. Polling-Intervall (Sekunden) converter_polling_interval number 300 Intervall f\u00fcr automatischen Scan des Converter-Ordners."},{"location":"configuration/settings-reference/#kategorie-laufwerk","title":"Kategorie: Laufwerk","text":"GUI-Feld Key Typ Default Wirkung im System Laufwerksmodus drive_mode select auto Auto-Discovery oder explizites Device. Device Pfad drive_device path /dev/sr0 Nur f\u00fcr expliziten Modus, z.B. /dev/sr0. MakeMKV Source Index makemkv_source_index number 0 Disc Index im Auto-Modus. Automatische Disk-Erkennung disc_auto_detection_enabled boolean true Wenn deaktiviert, findet keine automatische Laufwerkspr\u00fcfung statt. Neue Disks werden nur per \"Laufwerk neu lesen\" erkannt. Polling Intervall (ms) disc_poll_interval_ms number 4000 Intervall f\u00fcr Disk-Erkennung."},{"location":"configuration/settings-reference/#kategorie-metadaten","title":"Kategorie: Metadaten","text":"GUI-Feld Key Typ Default Wirkung im System OMDb API Key omdb_api_key string leer API Key f\u00fcr Metadatensuche. TMDb Read Access Token tmdb_api_read_access_token string leer Read Access Token f\u00fcr Serien-Metadaten \u00fcber TheMovieDB (TMDb). DVD Serien-Sprache dvd_series_language string de-DE Bevorzugte Sprache f\u00fcr Serien-Metadaten im TMDb-Format, z.B. de-DE oder en-US. DVD Serien-Fallback-Sprachen dvd_series_fallback_languages string de-DE,en-US Kommagetrennte TMDb-Sprachen f\u00fcr Fallback-Titel, z.B. de-DE,en-US,fr-FR. DVD Serien-Ordnung dvd_series_order_preference select episode_group Bevorzugte Episodenordnung f\u00fcr DVD-Serien. Episode Groups nutzen TMDb Alternate Orders, falls vorhanden. DVD Disc-Profile wiederverwenden dvd_series_reuse_disc_profiles boolean true Verwendet zuvor best\u00e4tigte Disc-Profile erneut, um Episoden automatischer zuzuordnen. OMDb Typ omdb_default_type select movie Vorauswahl f\u00fcr Suche. MusicBrainz aktiviert musicbrainz_enabled boolean true MusicBrainz-Metadatensuche f\u00fcr CDs aktivieren. Coverart-Nachladen aktiv coverart_recovery_enabled boolean true Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen gepr\u00fcft und nachgeladen. Coverart-Pr\u00fcfintervall (Stunden) coverart_recovery_interval_hours number 6 Intervall f\u00fcr automatische Pr\u00fcfung fehlender Coverarts in Stunden."},{"location":"configuration/settings-reference/#kategorie-monitoring","title":"Kategorie: Monitoring","text":"GUI-Feld Key Typ Default Wirkung im System Hardware Monitoring aktiviert hardware_monitoring_enabled boolean true Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). Hardware Monitoring Intervall (ms) hardware_monitoring_interval_ms number 5000 Polling-Intervall f\u00fcr CPU/RAM/GPU/Storage-Metriken."},{"location":"configuration/settings-reference/#kategorie-pfade","title":"Kategorie: Pfade","text":"GUI-Feld Key Typ Default Wirkung im System Raw-Ordner (Blu-ray) raw_dir_bluray path leer RAW-Zielpfad f\u00fcr Blu-ray. Leer = Standardpfad (data/output/raw). Raw-Ordner (DVD) raw_dir_dvd path leer RAW-Zielpfad f\u00fcr DVD. Leer = Standardpfad (data/output/raw). CD RAW-Ordner raw_dir_cd path leer Basisordner f\u00fcr rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). Audiobook RAW-Ordner raw_dir_audiobook path leer Basisordner f\u00fcr hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). Serien-Ordner (Blu-ray) series_dir_bluray path leer Zielordner f\u00fcr Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). Film-Ordner (Blu-ray) movie_dir_bluray path leer Encode-Zielpfad f\u00fcr Blu-ray. Leer = Standardpfad (data/output/movies). Film-Ordner (DVD) movie_dir_dvd path leer Encode-Zielpfad f\u00fcr DVD. Leer = Standardpfad (data/output/movies). Serien-Ordner (DVD) series_dir_dvd path leer Zielordner f\u00fcr DVD-Serienfolgen. Leer = Standardpfad (data/output/series). CD Output-Ordner movie_dir_cd path leer Zielordner f\u00fcr encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. Audiobook Output-Ordner movie_dir_audiobook path leer Zielordner f\u00fcr encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). Externe Speicher external_storage_paths path [] Wird links unter \"Freie Speicher\" angezeigt. Log Ordner log_dir path data/logs Basisordner f\u00fcr Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. CD Output Template cd_output_template string {artist} - {album} ({year})/{trackNr} {artist} - {title} Template f\u00fcr relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind \u00fcber \"/\" m\u00f6glich \u2013 alles nach dem letzten \"/\" ist der Dateiname. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (Blu-ray) output_template_bluray string ${title} (${year})/${title} (${year}) Template f\u00fcr Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner \u00fcber \"/\" m\u00f6glich \u2013 alles nach dem letzten \"/\" ist der Dateiname. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (Blu-ray Serie, Episode) output_template_bluray_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Template f\u00fcr einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNr}. Output Template (Blu-ray Serie, Multi-Episode) output_template_bluray_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Template f\u00fcr zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. Output Template (DVD) output_template_dvd string ${title} (${year})/${title} (${year}) Template f\u00fcr Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner \u00fcber \"/\" m\u00f6glich \u2013 alles nach dem letzten \"/\" ist der Dateiname. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (DVD Serie, Episode) output_template_dvd_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Template f\u00fcr einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNr}. Output Template (DVD Serie, Multi-Episode) output_template_dvd_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Template f\u00fcr zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. Output Template (Audiobook) output_template_audiobook string {author}/{author} - {title} ({year}) Template f\u00fcr relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind \u00fcber \"/\" m\u00f6glich. Audiobook RAW Template audiobook_raw_template string {author} - {title} ({year}) Template f\u00fcr relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. Converter Raw-Ordner converter_raw_dir path leer Eingangsordner f\u00fcr den Converter (Import-Scan und Datei-Uploads). Jeder Upload erh\u00e4lt einen Unterordner. Leer = Standardpfad (data/output/converter-raw). Converter Ausgabe (Video) converter_movie_dir path leer Ausgabepfad f\u00fcr konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). Converter Ausgabe (Audio) converter_audio_dir path leer Ausgabepfad f\u00fcr konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). Output-Template (Video) converter_output_template_video string {title} Dateiname-Template f\u00fcr konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. Output-Template (Audio) converter_output_template_audio string {artist} - {title} Dateiname-Template f\u00fcr konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series path leer RAW-Zielpfad f\u00fcr Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). Eigent\u00fcmer RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe f\u00fcr Blu-ray-Serien-RAW. Leer = Eigent\u00fcmer Raw-Ordner (Blu-ray). Eigent\u00fcmer Raw-Ordner (Blu-ray) raw_dir_bluray_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. RAW-Ordner (DVD Serie) raw_dir_dvd_series path leer RAW-Zielpfad f\u00fcr DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). Eigent\u00fcmer RAW-Ordner (DVD Serie) raw_dir_dvd_series_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe f\u00fcr DVD-Serien-RAW. Leer = Eigent\u00fcmer Raw-Ordner (DVD). Eigent\u00fcmer Raw-Ordner (DVD) raw_dir_dvd_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer CD RAW-Ordner raw_dir_cd_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Audiobook RAW-Ordner raw_dir_audiobook_owner string leer Eigent\u00fcmer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Serien-Ordner (Blu-ray) series_dir_bluray_owner string leer Eigent\u00fcmer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Film-Ordner (Blu-ray) movie_dir_bluray_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Film-Ordner (DVD) movie_dir_dvd_owner string leer Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Serien-Ordner (DVD) series_dir_dvd_owner string leer Eigent\u00fcmer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer CD Output-Ordner movie_dir_cd_owner string leer Eigent\u00fcmer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Audiobook Output-Ordner movie_dir_audiobook_owner string leer Eigent\u00fcmer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes."},{"location":"configuration/settings-reference/#kategorie-tools","title":"Kategorie: Tools","text":"GUI-Feld Key Typ Default Wirkung im System MakeMKV Kommando makemkv_command string makemkvcon Pfad oder Befehl f\u00fcr makemkvcon. MakeMKV Key makemkv_registration_key string leer Optionaler Registrierungsschl\u00fcssel. Wird vor Analyze/Rip automatisch per \"makemkvcon reg\" gesetzt. Mediainfo Kommando mediainfo_command string mediainfo Pfad oder Befehl f\u00fcr mediainfo. Minimale Titell\u00e4nge (Minuten) makemkv_min_length_minutes number 60 Filtert kurze Titel beim Rip. HandBrake Kommando handbrake_command string HandBrakeCLI Pfad oder Befehl f\u00fcr HandBrakeCLI. Encode-Neustart: unvollst\u00e4ndige Ausgabe l\u00f6schen handbrake_restart_delete_incomplete_output boolean true Wenn aktiv, wird bei \"Encode neu starten\" der bisherige (nicht erfolgreiche) Output vor Start entfernt. Max. parallele Film/Video Encodes pipeline_max_parallel_jobs number 1 Maximale Anzahl parallel laufender Film/Video Encode-Jobs. Gilt zus\u00e4tzlich zum Gesamtlimit. Max. parallele Audio CD Jobs pipeline_max_parallel_cd_encodes number 2 Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zus\u00e4tzlich zum Gesamtlimit. Max. Encodes gesamt (medienunabh\u00e4ngig) pipeline_max_total_encodes number 3 Gesamtlimit f\u00fcr alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. Audio CDs: Queue-Reihenfolge \u00fcberspringen pipeline_cd_bypasses_queue boolean false Wenn aktiv, k\u00f6nnen Audio CD Jobs unabh\u00e4ngig von Film-Jobs starten (\u00fcberspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. Script-Test Timeout (ms) script_test_timeout_ms number 0 Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. cdparanoia Kommando cdparanoia_command string cdparanoia Pfad oder Befehl f\u00fcr cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. FFmpeg Kommando ffmpeg_command string ffmpeg Pfad oder Befehl f\u00fcr ffmpeg. Wird f\u00fcr Audiobook-Encoding genutzt. FFprobe Kommando ffprobe_command string ffprobe Pfad oder Befehl f\u00fcr ffprobe. Wird f\u00fcr Audiobook-Metadaten und Kapitel genutzt. Mediainfo Extra Args mediainfo_extra_args_bluray string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr mediainfo (Blu-ray). MakeMKV Rip Modus makemkv_rip_mode_bluray select backup backup: vollst\u00e4ndige Blu-ray Struktur im RAW-Ordner (empfohlen, erm\u00f6glicht --decrypt). MakeMKV Analyze Extra Args makemkv_analyze_extra_args_bluray string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr Analyze (Blu-ray). MakeMKV Rip Extra Args makemkv_rip_extra_args_bluray string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr Rip (Blu-ray). HandBrake Preset handbrake_preset_bluray string H.264 MKV 1080p30 Preset Name f\u00fcr -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. HandBrake Extra Args handbrake_extra_args_bluray string leer Zus\u00e4tzliche CLI-Argumente (Blu-ray). Ausgabeformat output_extension_bluray select mkv Dateiendung f\u00fcr finale Datei (Blu-ray). Mediainfo Extra Args mediainfo_extra_args_dvd string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr mediainfo (DVD). MakeMKV Rip Modus makemkv_rip_mode_dvd select backup backup: vollst\u00e4ndige Disc-Struktur im RAW-Ordner (einzig g\u00fcltige Option f\u00fcr DVDs). MakeMKV Analyze Extra Args makemkv_analyze_extra_args_dvd string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr Analyze (DVD). MakeMKV Rip Extra Args makemkv_rip_extra_args_dvd string leer Zus\u00e4tzliche CLI-Parameter f\u00fcr Rip (DVD). HandBrake Preset handbrake_preset_dvd string H.264 MKV 480p30 Preset Name f\u00fcr -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. HandBrake Extra Args handbrake_extra_args_dvd string leer Zus\u00e4tzliche CLI-Argumente (DVD). Ausgabeformat output_extension_dvd select mkv Dateiendung f\u00fcr finale Datei (DVD)."},{"location":"deployment/","title":"Anhang: Deployment","text":"
Technische Betriebsdokumentation f\u00fcr Entwicklung und Produktion.
 
     
  •  
     Entwicklungsumgebung
     
    Lokale Entwicklung mit Hot-Reload.
     
     Entwicklung
     
    •  
  •  
     Produktion
     
    Installation und Betrieb auf Servern.
     
     Produktion
     
    •  
"},{"location":"deployment/development/","title":"Entwicklungsumgebung","text":""},{"location":"deployment/development/#voraussetzungen","title":"Voraussetzungen","text":"
     
  • Node.js >= 20.19.0
    •  
  • externe Tools installiert (makemkvcon, HandBrakeCLI, mediainfo)
    •  
"},{"location":"deployment/development/#schnellstart","title":"Schnellstart","text":"
./start.sh\n
 
Startet:
 
     
  • Backend (http://localhost:3001, mit nodemon)
    •  
  • Frontend (http://localhost:5173, mit Vite HMR)
    •  
 
Stoppen: Ctrl+C.
"},{"location":"deployment/development/#manuell","title":"Manuell","text":""},{"location":"deployment/development/#backend","title":"Backend","text":"
cd backend\nnpm install\nnpm run dev\n
"},{"location":"deployment/development/#frontend","title":"Frontend","text":"
cd frontend\nnpm install\nnpm run dev\n
"},{"location":"deployment/development/#vite-proxy-dev","title":"Vite-Proxy (Dev)","text":"
frontend/vite.config.js proxied standardm\u00e4\u00dfig:
 
     
  • /api -> http://127.0.0.1:3001
    •  
  • /ws -> ws://127.0.0.1:3001
    •  
"},{"location":"deployment/development/#remote-dev-optional","title":"Remote-Dev (optional)","text":"
Beispiel frontend/.env.local:
 
VITE_API_BASE=http://192.168.1.100:3001/api\nVITE_WS_URL=ws://192.168.1.100:3001/ws\nVITE_PUBLIC_ORIGIN=http://192.168.1.100:5173\nVITE_ALLOWED_HOSTS=192.168.1.100,ripster.local\nVITE_HMR_PROTOCOL=ws\nVITE_HMR_HOST=192.168.1.100\nVITE_HMR_CLIENT_PORT=5173\n
"},{"location":"deployment/development/#nutzliche-kommandos","title":"N\u00fctzliche Kommandos","text":"
# Root dev (backend + frontend)\nnpm run dev\n\n# einzeln\nnpm run dev:backend\nnpm run dev:frontend\n\n# Frontend Build\nnpm run build:frontend\n
"},{"location":"deployment/production/","title":"Produktions-Deployment","text":""},{"location":"deployment/production/#automatische-installation-empfohlen","title":"Automatische Installation (empfohlen)","text":"
Das mitgelieferte install.sh richtet Ripster vollautomatisch ein \u2013 inklusive Node.js, MakeMKV, HandBrake, nginx und systemd-Dienst.
 
Unterst\u00fctzte Systeme laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS Voraussetzung: root-Rechte, Internetzugang
"},{"location":"deployment/production/#schnellstart-via-curl","title":"Schnellstart via curl","text":"
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash\n
 
Oder mit wget:
 
wget -qO- https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash\n
 
Optionen nur via Datei
 
Beim Pipen von curl/wget k\u00f6nnen keine Argumente \u00fcbergeben werden. F\u00fcr benutzerdefinierte Optionen zuerst herunterladen und dann mit sudo bash install.sh [Optionen] ausf\u00fchren.
"},{"location":"deployment/production/#optionen","title":"Optionen","text":"Option Standard Beschreibung --branch <branch> dev Git-Branch f\u00fcr die Installation --dir <pfad> /opt/ripster Installationsverzeichnis --user <benutzer> ripster Systembenutzer f\u00fcr den Dienst --port <port> 3001 Backend-Port --host <hostname> Auto (Maschinen-IP) Hostname/IP f\u00fcr die Weboberfl\u00e4che --no-makemkv \u2013 MakeMKV-Installation \u00fcberspringen --no-handbrake \u2013 HandBrake-Installation \u00fcberspringen --no-nginx \u2013 nginx-Einrichtung \u00fcberspringen --reinstall \u2013 Bestehende Installation aktualisieren (Daten bleiben erhalten) -h, --help \u2013 Hilfe anzeigen"},{"location":"deployment/production/#beispiele","title":"Beispiele","text":"
# Standard-Installation\nsudo bash install.sh\n\n# Anderen Branch und Port verwenden\nsudo bash install.sh --branch dev --port 8080\n\n# Ohne MakeMKV (bereits installiert)\nsudo bash install.sh --no-makemkv\n\n# Bestehende Installation aktualisieren\nsudo bash install.sh --reinstall\n\n# Ohne nginx (eigener Reverse-Proxy)\nsudo bash install.sh --no-nginx --host mein-server.local\n
"},{"location":"deployment/production/#was-das-skript-erledigt","title":"Was das Skript erledigt","text":"
     
  1. Systempr\u00fcfung \u2013 OS-Erkennung und Root-Check
    2.  
  2. Systempakete \u2013 curl, wget, git, mediainfo, udev u. a.
    3.  
  3. Node.js 20 \u2013 via NodeSource, falls noch nicht installiert
    4.  
  4. MakeMKV \u2013 aktuelle Version wird aus dem offiziellen Forum ermittelt und aus dem Quellcode kompiliert (kann mit --no-makemkv \u00fcbersprungen werden)
    5.  
  5. HandBrake \u2013 interaktive Auswahl:
       
    • Option 1: Standard (apt install handbrake-cli)
      •  
    • Option 2: Geb\u00fcndelte GPU-Version mit NVDEC aus bin/HandBrakeCLI
      •  
     
    6.  
  6. Systembenutzer ripster \u2013 ohne Login-Shell und ohne Home-Verzeichnis; Gruppen werden (falls vorhanden) erg\u00e4nzt: cdrom, optical, disk, video, render
    7.  
  7. Repository \u2013 klont Branch nach --dir (bei --reinstall: sichert backend/data, aktualisiert Repo, stellt Daten wieder her)
    8.  
  8. Verzeichnisse \u2013 stellt u. a. sicher: backend/data, backend/logs, backend/data/output/raw, backend/data/output/movies, backend/data/logs
    9.  
  9. npm-Abh\u00e4ngigkeiten \u2013 Root, Backend (nur production), Frontend
    10.  
  10. Frontend-Build \u2013 npm run build mit relativen API-URLs (nginx-kompatibel)
    11.  
  11. Backend .env \u2013 wird automatisch generiert (bei --reinstall bleibt bestehende .env erhalten)
    12.  
  12. Berechtigungen \u2013 zun\u00e4chst ripster:ripster auf Installationsverzeichnis; bei sudo-Aufruf werden Output-/Log-Ordner auf <aufrufender user>:ripster mit 775 gesetzt; .env wird auf 600 gesetzt
    13.  
  13. MakeMKV User-Ordner \u2013 erstellt bei sudo-Aufruf ~/.MakeMKV f\u00fcr den aufrufenden Benutzer
    14.  
  14. systemd-Dienst \u2013 ripster-backend.service erstellt, aktiviert und gestartet
    15.  
  15. nginx \u2013 konfiguriert als Reverse-Proxy f\u00fcr Frontend, /api/ und /ws (kann mit --no-nginx \u00fcbersprungen werden)
    16.  
"},{"location":"deployment/production/#nach-der-installation","title":"Nach der Installation","text":"
# Status pr\u00fcfen\nsudo systemctl status ripster-backend\n\n# Logs verfolgen\nsudo journalctl -u ripster-backend -f\n\n# Neustart\nsudo systemctl restart ripster-backend\n\n# Aktualisieren\nsudo bash /opt/ripster/install.sh --reinstall\n
 
Zugriff: http://<Maschinen-IP> (oder der mit --host angegebene Hostname)
"},{"location":"deployment/production/#handbrake-modus-gpunvdec","title":"HandBrake-Modus (GPU/NVDEC)","text":"
Bei nicht-interaktiver Ausf\u00fchrung (Pipe von curl) wird automatisch die Standard-Version gew\u00e4hlt. F\u00fcr die GPU-Version zuerst herunterladen:
 
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh -o install.sh\nsudo bash install.sh\n# \u2192 Interaktive Auswahl: Option 2 f\u00fcr NVDEC\n
 
Das geb\u00fcndelte Binary liegt unter bin/HandBrakeCLI und wird nach /usr/local/bin/HandBrakeCLI kopiert.
"},{"location":"deployment/production/#manuelle-installation","title":"Manuelle Installation","text":"
Die folgenden Abschnitte beschreiben die einzelnen Schritte f\u00fcr manuelle oder angepasste Setups.
"},{"location":"deployment/production/#empfohlene-architektur","title":"Empfohlene Architektur","text":"
Client\n  -> nginx (Reverse Proxy + statisches Frontend)\n    -> Backend API/WebSocket (Node.js, Port 3001)\n
 
Wichtig: Das Backend serviert im aktuellen Stand keine frontend/dist-Dateien automatisch.
"},{"location":"deployment/production/#1-frontend-builden","title":"1) Frontend builden","text":"
cd frontend\nnpm install\nnpm run build\n
 
Artefakte liegen in frontend/dist/.
"},{"location":"deployment/production/#2-backend-als-systemd-service","title":"2) Backend als systemd-Service","text":"
Beispiel /etc/systemd/system/ripster-backend.service:
 
[Unit]\nDescription=Ripster Backend\nAfter=network.target\n\n[Service]\nType=simple\nUser=ripster\nWorkingDirectory=/opt/ripster/backend\nExecStart=/usr/bin/env node src/index.js\nRestart=on-failure\nRestartSec=5\nEnvironment=NODE_ENV=production\nEnvironment=PORT=3001\nEnvironment=LOG_LEVEL=info\n\n[Install]\nWantedBy=multi-user.target\n
 
Aktivieren:
 
sudo systemctl daemon-reload\nsudo systemctl enable --now ripster-backend\nsudo systemctl status ripster-backend\n
"},{"location":"deployment/production/#3-nginx-konfigurieren","title":"3) nginx konfigurieren","text":"
Beispiel /etc/nginx/sites-available/ripster:
 
server {\n    listen 80;\n    server_name ripster.local;\n    client_max_body_size 8G;\n\n    root /opt/ripster/frontend/dist;\n    index index.html;\n\n    location / {\n        try_files $uri $uri/ /index.html;\n    }\n\n    location /api/ {\n        proxy_pass http://127.0.0.1:3001;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n    }\n\n    location /ws {\n        proxy_pass http://127.0.0.1:3001;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection \"upgrade\";\n        proxy_set_header Host $host;\n    }\n}\n
 
Aktivieren:
 
sudo ln -s /etc/nginx/sites-available/ripster /etc/nginx/sites-enabled/\nsudo nginx -t\nsudo systemctl reload nginx\n
 
Hinweis: Fuer groessere Uploads wie .aax-Audiobooks muss client_max_body_size ausreichend hoch gesetzt sein. Im mitgelieferten Beispiel sind 8G hinterlegt.
"},{"location":"deployment/production/#datenbank-backup","title":"Datenbank-Backup","text":"
sqlite3 /opt/ripster/backend/data/ripster.db \\\n  \".backup '/var/backups/ripster-$(date +%Y%m%d).db'\"\n
"},{"location":"deployment/production/#sicherheit","title":"Sicherheit","text":"
     
  • Ripster hat keine eingebaute Authentifizierung.
    •  
  • F\u00fcr externen Zugriff mindestens Basic Auth + TLS + Netzwerksegmentierung/VPN einsetzen.
    •  
  • Secrets nicht ins Repo committen (.env, Settings-Felder).
    •  
"},{"location":"getting-started/","title":"Benutzerhandbuch \u00dcberblick","text":"
Dieses Kapitel ist f\u00fcr den Betrieb von Ripster im Alltag geschrieben.
"},{"location":"getting-started/#zielgruppe","title":"Zielgruppe","text":"
     
  • Anwender, die Discs verarbeiten wollen
    •  
  • Betreiber, die den t\u00e4glichen Ablauf stabil fahren m\u00f6chten
    •  
  • Power-User, die Queue/Skripte/Cron im UI steuern m\u00f6chten
    •  
"},{"location":"getting-started/#kapitelstruktur","title":"Kapitelstruktur","text":"Kapitel Zweck Voraussetzungen Produktions- vs. Dev-Voraussetzungen klar trennen Installation Ripster aufsetzen und starten Ersteinrichtung Pfade, Tools und Metadaten korrekt setzen Erster Lauf Ein kompletter Job von Disc bis Datei GUI-Seiten Alle Ansichten und Aktionen im Detail Workflows Typische Abl\u00e4ufe und Entscheidungen aus User-Sicht"},{"location":"getting-started/#wenn-du-neu-startest","title":"Wenn du neu startest","text":"
     
  1. Voraussetzungen
    2.  
  2. Installation
    3.  
  3. Ersteinrichtung
    4.  
  4. Erster Lauf
    5.  
"},{"location":"getting-started/#wenn-ripster-bereits-lauft","title":"Wenn Ripster bereits l\u00e4uft","text":"
     
  1. GUI-Seiten
    2.  
  2. Workflows
    3.  
  3. Bei Detailfragen: Technischer Anhang
    4.  
"},{"location":"getting-started/configuration/","title":"Ersteinrichtung","text":"
Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
"},{"location":"getting-started/configuration/#ziel-der-ersteinrichtung","title":"Ziel der Ersteinrichtung","text":"
Vor dem ersten Job m\u00fcssen drei Dinge stabil sein:
 
     
  1. Pfade stimmen (RAW, Output, Logs)
    2.  
  2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
    3.  
  3. Metadatenzug\u00e4nge funktionieren (OMDb, optional TMDb/MusicBrainz)
    4.  
"},{"location":"getting-started/configuration/#empfohlene-reihenfolge","title":"Empfohlene Reihenfolge","text":""},{"location":"getting-started/configuration/#1-basis-in-settings-konfiguration","title":"1) Basis in Settings -> Konfiguration","text":"
Setze zuerst:
 
     
  • Raw-Ordner und Film-/Serien-Ordner
    •  
  • Log Ordner
    •  
  • MakeMKV Kommando, HandBrake Kommando, Mediainfo Kommando
    •  
  • OMDb API Key
    •  
 
Dann speichern.
"},{"location":"getting-started/configuration/#2-profile-pro-medium-festziehen","title":"2) Profile pro Medium festziehen","text":"
Ripster l\u00f6st viele Werte profilspezifisch auf (bluray, dvd, cd, audiobook).
 
Pflichtpr\u00fcfung:
 
     
  • RAW-Pfade je Profil
    •  
  • Output-Pfade je Profil
    •  
  • HandBrake-Preset je Profil
    •  
  • Output-Templates je Profil
    •  
 
F\u00fcr Serien zus\u00e4tzlich:
 
     
  • RAW-Ordner (Blu-ray/DVD Serie)
    •  
  • Serien-Ordner (Blu-ray/DVD)
    •  
  • Serien-Templates (Episode/Multi-Episode)
    •  
"},{"location":"getting-started/configuration/#3-queue-verhalten-definieren","title":"3) Queue-Verhalten definieren","text":"
Stelle ein:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
 
Damit steuerst du Durchsatz, Priorit\u00e4t und Lastverteilung.
"},{"location":"getting-started/configuration/#4-metadatenquellen-absichern","title":"4) Metadatenquellen absichern","text":"
Film:
 
     
  • OMDb-Key pr\u00fcfen
    •  
 
Serien:
 
     
  • TMDb Read Access Token setzen
    •  
  • Sprache/Fallback-Sprachen festlegen
    •  
 
CD/Audiodaten:
 
     
  • MusicBrainz aktiviert nach Bedarf
    •  
"},{"location":"getting-started/configuration/#5-optional-benachrichtigungen","title":"5) Optional: Benachrichtigungen","text":"
     
  • PushOver-Zugangsdaten setzen
    •  
  • PushOver Test ausf\u00fchren
    •  
  • Event-Toggles pro Phase pr\u00fcfen
    •  
"},{"location":"getting-started/configuration/#6-optional-automatisierung","title":"6) Optional: Automatisierung","text":"
     
  1. Skripte testen
    2.  
  2. Skriptketten bauen/testen
    3.  
  3. Cronjobs erst danach aktivieren
    4.  
"},{"location":"getting-started/configuration/#funktionsprufung-kurztest","title":"Funktionspr\u00fcfung (Kurztest)","text":"
     
  1. Disc in Ripper erkennen lassen.
    2.  
  2. Analyse starten.
    3.  
  3. Metadaten \u00fcbernehmen.
    4.  
  4. Bis Bereit zum Encodieren laufen.
    5.  
  5. Encode starten und Abschluss in Historie pr\u00fcfen.
    6.  
"},{"location":"getting-started/configuration/#typische-konfigurationsfehler","title":"Typische Konfigurationsfehler","text":"Symptom H\u00e4ufige Ursache Job bleibt fr\u00fch auf Fehler Toolkommando falsch oder nicht im PATH RAW/Output landet am falschen Ort Profilpfade nicht gesetzt, Fallback greift Serienausgabe landet bei Filmen Serienpfade/Serientemplates fehlen Queue verh\u00e4lt sich unerwartet Gesamtlimit und Lane-Limits widersprechen sich"},{"location":"getting-started/configuration/#weiter","title":"Weiter","text":"
     
  • Erster Lauf
    •  
  • GUI-Seiten
    •  
  • Workflows aus Nutzersicht
    •  
"},{"location":"getting-started/installation/","title":"Installation","text":"
Die empfohlene Installation l\u00e4uft \u00fcber install.sh und richtet Ripster vollst\u00e4ndig ein.
 
Du musst daf\u00fcr keine Tools manuell vorinstallieren. Das Skript installiert die ben\u00f6tigten Abh\u00e4ngigkeiten automatisch, sofern sie nicht explizit mit --no-* \u00fcbersprungen werden.
"},{"location":"getting-started/installation/#unterstutzte-systeme-und-anforderungen","title":"Unterst\u00fctzte Systeme und Anforderungen","text":"
     
  • unterst\u00fctzt laut Script: debian, ubuntu, linuxmint, pop
    •  
  • Ausf\u00fchrung als root (oder via sudo)
    •  
  • Internetzugang w\u00e4hrend der Installation
    •  
"},{"location":"getting-started/installation/#schritt-fur-schritt","title":"Schritt-f\u00fcr-Schritt","text":""},{"location":"getting-started/installation/#1-installationsskript-herunterladen","title":"1. Installationsskript herunterladen","text":"
wget -qO install.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh\n
"},{"location":"getting-started/installation/#2-installation-ausfuhren","title":"2. Installation ausf\u00fchren","text":"
sudo bash install.sh\n
 
W\u00e4hrend der Installation w\u00e4hlst du den HandBrake-Modus:
 
     
  • 1 Standard (Paketinstallation)
    •  
  • 2 GPU/NVDEC (geb\u00fcndeltes Binary)
    •  
"},{"location":"getting-started/installation/#3-dienststatus-prufen","title":"3. Dienststatus pr\u00fcfen","text":"
sudo systemctl status ripster-backend\n
"},{"location":"getting-started/installation/#4-weboberflache-offnen","title":"4. Weboberfl\u00e4che \u00f6ffnen","text":"
     
  • mit nginx (Standard): http://<Server-IP>
    •  
  • ohne nginx (--no-nginx): API auf http://<Server-IP>:3001/api
    •  
"},{"location":"getting-started/installation/#was-installsh-konkret-einrichtet","title":"Was install.sh konkret einrichtet","text":"
     
  1. pr\u00fcft Betriebssystem, Root-Rechte und ermittelt Host/IP
    2.  
  2. aktualisiert Paketquellen und installiert Basispakete (curl, wget, git, mediainfo, udev ...)
    3.  
  3. installiert Node.js 20 (falls nicht passend vorhanden)
    4.  
  4. installiert optional MakeMKV (Build aus den offiziellen Quellen)
    5.  
  5. installiert optional HandBrakeCLI (Standard oder GPU/NVDEC)
    6.  
  6. installiert optional nginx
    7.  
  7. legt den Systembenutzer ripster an (ohne Login-Shell, ohne Home) und erg\u00e4nzt Gruppen (cdrom, optical, disk, video, render, falls vorhanden)
    8.  
  8. klont das Repository nach /opt/ripster (oder aktualisiert bei --reinstall)
    9.  
  9. legt Verzeichnisse an:
    10.  
  10. /opt/ripster/backend/data
    11.  
  11. /opt/ripster/backend/logs
    12.  
  12. /opt/ripster/backend/data/output/raw
    13.  
  13. /opt/ripster/backend/data/output/movies
    14.  
  14. /opt/ripster/backend/data/logs
    15.  
  15. installiert npm-Abh\u00e4ngigkeiten (Root, Backend, Frontend) und baut das Frontend
    16.  
  16. erzeugt backend/.env (bei --reinstall bleibt bestehende .env erhalten)
    17.  
  17. setzt Rechte/Besitz und erstellt bei sudo-Installation zus\u00e4tzlich ~/.MakeMKV f\u00fcr den aufrufenden Benutzer
    18.  
  18. erzeugt und startet ripster-backend.service
    19.  
  19. konfiguriert und startet nginx (falls nicht \u00fcbersprungen)
    20.  
"},{"location":"getting-started/installation/#wichtige-optionen","title":"Wichtige Optionen","text":"Option Default laut Script Zweck --branch <branch> dev Branch f\u00fcr die Installation --dir <pfad> /opt/ripster Installationsverzeichnis --user <benutzer> ripster Service-Benutzer --port <port> 3001 Backend-Port --host <hostname> automatisch ermittelte Host-IP Hostname/IP f\u00fcr Webzugriff/CORS --no-makemkv aus MakeMKV-Installation \u00fcberspringen --no-handbrake aus HandBrake-Installation \u00fcberspringen --no-nginx aus nginx-Setup \u00fcberspringen --reinstall aus bestehende Installation aktualisieren 
Beispiele:
 
sudo bash install.sh --branch dev\nsudo bash install.sh --port 8080 --host ripster.local\nsudo bash install.sh --reinstall\n
"},{"location":"getting-started/installation/#betrieb-im-alltag","title":"Betrieb im Alltag","text":"
# Logs live ansehen\nsudo journalctl -u ripster-backend -f\n\n# Dienst neu starten\nsudo systemctl restart ripster-backend\n\n# Update aus bestehender Installation\nsudo bash /opt/ripster/install.sh --reinstall\n
"},{"location":"getting-started/installation/#haufige-stolperstellen","title":"H\u00e4ufige Stolperstellen","text":"
     
  • Laufwerk nicht zugreifbar: Laufwerksrechte/Gruppen pr\u00fcfen
    •  
  • CLI-Tool fehlt wegen --no-*: Tool nachinstallieren oder Befehl in Settings korrigieren
    •  
  • UI nicht erreichbar: nginx-Status und Firewall pr\u00fcfen
    •  
"},{"location":"getting-started/installation/#danach-weiter","title":"Danach weiter","text":"
     
  1. Ersteinrichtung
    2.  
  2. Erster Lauf
    3.  
"},{"location":"getting-started/prerequisites/","title":"Voraussetzungen","text":"
Die Voraussetzungen h\u00e4ngen davon ab, wie du Ripster betreibst.
"},{"location":"getting-started/prerequisites/#produktionsbetrieb-mit-installsh-standard","title":"Produktionsbetrieb mit install.sh (Standard)","text":"
F\u00fcr den normalen Betrieb sind nur wenige Punkte vorab n\u00f6tig.
"},{"location":"getting-started/prerequisites/#pflicht","title":"Pflicht","text":"
     
  • unterst\u00fctztes Linux-System (laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS)
    •  
  • root-Rechte
    •  
  • Internetzugang w\u00e4hrend der Installation
    •  
  • optisches Laufwerk f\u00fcr Disc-Betrieb
    •  
 
install.sh installiert die ben\u00f6tigten Tools selbst (u. a. Node.js, MakeMKV, HandBrakeCLI, MediaInfo), sofern sie nicht explizit per --no-* \u00fcbersprungen werden.
"},{"location":"getting-started/prerequisites/#laufwerk-kurz-prufen","title":"Laufwerk kurz pr\u00fcfen","text":"
ls /dev/sr*\nlsblk | grep rom\n
 
Wenn n\u00f6tig Rechte setzen (Beispiel):
 
sudo chmod a+rw /dev/sr0\n
"},{"location":"getting-started/prerequisites/#optional-vorab","title":"Optional vorab","text":"
     
  • OMDb API-Key (kann auch nach Installation in den Settings gesetzt werden)
    •  
  • PushOver-Zugangsdaten (optional)
    •  
"},{"location":"getting-started/prerequisites/#entwicklungsmodus-nur-fur-dev","title":"Entwicklungsmodus (nur f\u00fcr Dev)","text":"
Wenn du lokal entwickelst (./start.sh, npm run dev), gelten zus\u00e4tzliche Voraussetzungen:
 
     
  • Node.js >= 20.19.0
    •  
  • makemkvcon, HandBrakeCLI, mediainfo im PATH
    •  
 
Details: Entwicklungsumgebung
"},{"location":"getting-started/prerequisites/#abschluss-checkliste","title":"Abschluss-Checkliste","text":"
     
  • [ ] Produktionsbetrieb: Linux + root + Internet + Laufwerk vorhanden
    •  
  • [ ] Dev-Modus (nur falls ben\u00f6tigt): Node.js und CLI-Tools verf\u00fcgbar
    •  
"},{"location":"getting-started/quickstart/","title":"Erster Lauf","text":"
Dieser Ablauf f\u00fchrt einen vollst\u00e4ndigen Disc-Job von Erkennung bis fertiger Datei durch.
"},{"location":"getting-started/quickstart/#1-disc-erkennen","title":"1) Disc erkennen","text":"
     
  1. Ripper \u00f6ffnen.
    2.  
  2. Disc einlegen.
    3.  
  3. Auf Medium erkannt warten.
    4.  
 
Pr\u00fcfen:
 
     
  • Disk-Information zeigt Device/Label.
    •  
  • Falls nicht: Laufwerk neu lesen.
    •  
"},{"location":"getting-started/quickstart/#2-analyse-starten","title":"2) Analyse starten","text":"
Aktion:
 
     
  • Analyse starten
    •  
 
Erwartung:
 
     
  • Status Analyse
    •  
  • danach Metadaten-Dialog
    •  
"},{"location":"getting-started/quickstart/#3-metadaten-bestatigen","title":"3) Metadaten best\u00e4tigen","text":"
Im Dialog:
 
     
  1. Treffer suchen/ausw\u00e4hlen.
    2.  
  2. Bei Serie zus\u00e4tzlich Disc-Nummer setzen.
    3.  
  3. Auswahl \u00fcbernehmen.
    4.  
 
M\u00f6gliche Abzweigungen:
 
     
  • Duplikatfilm -> \u00dcbernahme erzwingen oder Multipart movie
    •  
  • vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
    •  
"},{"location":"getting-started/quickstart/#4-ripreview-phase","title":"4) Rip/Review-Phase","text":"
Normalfall:
 
     
  • Startbereit -> Rippen -> Mediainfo-Pruefung
    •  
 
M\u00f6gliche Alternativen:
 
     
  • vorhandenes RAW: direkter Sprung in Pr\u00fcfung
    •  
  • Blu-ray/DVD-Entscheidung n\u00f6tig: Warte auf Auswahl f\u00fcr Playlist/Titel
    •  
"},{"location":"getting-started/quickstart/#5-encode-review-abschlieen","title":"5) Encode-Review abschlie\u00dfen","text":"
Bei Bereit zum Encodieren:
 
     
  • Titel festlegen
    •  
  • Audio-/Subtitle-Spuren pr\u00fcfen
    •  
  • optional Preset ausw\u00e4hlen
    •  
  • optional Pre-/Post-Skripte w\u00e4hlen
    •  
 
Dann:
 
     
  • Encoding starten
    •  
"},{"location":"getting-started/quickstart/#6-encoding-uberwachen","title":"6) Encoding \u00fcberwachen","text":"
W\u00e4hrend Encodieren:
 
     
  • Fortschritt/ETA im Ripper
    •  
  • Queue- und Runtime-Status beobachten
    •  
  • optional Logkontrolle in Historie
    •  
"},{"location":"getting-started/quickstart/#7-ergebnis-verifizieren","title":"7) Ergebnis verifizieren","text":"
Nach Fertig:
 
     
  1. Historie \u00f6ffnen.
    2.  
  2. Jobdetail pr\u00fcfen.
    3.  
  3. Output-Pfad und Log plausibilisieren.
    4.  
 
Kontrollpunkte:
 
     
  • finale Datei am erwarteten Template-Pfad
    •  
  • RAW-Ordnerzustand finalisiert (kein Incomplete_)
    •  
"},{"location":"getting-started/quickstart/#8-typische-folgeaktionen","title":"8) Typische Folgeaktionen","text":"
     
  • falsche Metadaten: OMDb neu zuordnen
    •  
  • andere Trackauswahl: Review neu starten
    •  
  • erneuter Encode aus RAW: RAW neu encodieren
    •  
  • gleicher Plan erneut: Encode neu starten
    •  
"},{"location":"gui/","title":"GUI-Seiten","text":"
Dieses Kapitel ist das Bedienhandbuch f\u00fcr die Oberfl\u00e4chen im Alltag.
"},{"location":"gui/#seitenuberblick","title":"Seiten\u00fcberblick","text":"Seite Rolle im Betrieb Typischer Einsatz Jobs zentrale Inbox Gesamtlage pr\u00fcfen und in Fachseite springen Ripper Live-Steuerung der Pipeline Disc-Flow starten, Queue steuern, Review freigeben Audiobooks AAX-Spezialflow Upload, Konfiguration und Encode von Audiobooks Settings Konfiguration/Automatisierung Pfade, Tools, Queue-Limits, Skripte, Cron Historie Nachbearbeitung und Kontrolle Logs, Re-Encode, L\u00f6schvorschau, Recovery-Aktionen Converter dateibasierte Konvertierung Video/Audio/ISO ohne Disc-Rip verarbeiten Downloads ZIP-Exports RAW/Output aus Historie bereitstellen Database (Expert) Recovery-Sicht orphan RAW finden und importieren"},{"location":"gui/#empfohlener-tagesablauf","title":"Empfohlener Tagesablauf","text":"
     
  1. Jobs: Statuslage und Auff\u00e4lligkeiten pr\u00fcfen.
    2.  
  2. Ripper oder Converter/Audiobooks: neue Arbeit starten.
    3.  
  3. Historie: Ergebnisse validieren und ggf. nachbearbeiten.
    4.  
  4. Downloads: Exporte f\u00fcr externe \u00dcbergabe erzeugen.
    5.  
  5. Settings: Regeln und Limits nur kontrolliert anpassen.
    6.  
"},{"location":"gui/#navigation","title":"Navigation","text":"
Direkt in der Top-Navigation:
 
     
  • Jobs, Ripper, Converter, Audiobooks, Settings, Historie, Downloads
    •  
 
Nur per URL:
 
     
  • Database unter /database
    •  
"},{"location":"gui/audiobooks/","title":"Audiobooks","text":"
Die Seite Audiobooks ist der spezialisierte AAX-Workflow.
"},{"location":"gui/audiobooks/#ablaufubersicht","title":"Ablauf\u00fcbersicht","text":"
Die Oberfl\u00e4che ist in drei Bereiche gegliedert:
 
     
  1. Audiobooks Upload
    2.  
  2. Audiobook Jobs
    3.  
  3. Audiobook Output Explorer
    4.  
"},{"location":"gui/audiobooks/#1-audiobooks-upload","title":"1) Audiobooks Upload","text":"
Der Upload verarbeitet ausschlie\u00dflich AAX-Dateien.
 
Direkt nach Upload passieren im Hintergrund:
 
     
  • Probe/Metadatenanalyse (ffprobe)
    •  
  • Anlage eines RAW-Ordners per Audiobook RAW Template
    •  
  • Ablage der AAX-Datei im RAW-Pfad
    •  
  • Initiale Jobkonfiguration (Format, Kapitel, Metadaten)
    •  
 
Wichtige Parameter:
 
     
  • Zielformat (m4b, mp3, flac)
    •  
  • optionaler Sofortstart
    •  
 
Toolabh\u00e4ngigkeit:
 
     
  • ffprobe_command f\u00fcr Metadaten/Kapitel
    •  
  • ffmpeg_command f\u00fcr Encode/Cover-Extraktion
    •  
"},{"location":"gui/audiobooks/#2-audiobook-jobs","title":"2) Audiobook Jobs","text":"
Jobkarten zeigen Zustand, Fortschritt und verf\u00fcgbare Aktionen.
 
Typische Aktionen:
 
     
  • Starten
    •  
  • Abbrechen
    •  
  • Retry
    •  
  • L\u00f6schen
    •  
  • Im Ripper (Kontextwechsel)
    •  
 
Die Karten werden regelm\u00e4\u00dfig aktualisiert und durch WebSocket-Ereignisse erg\u00e4nzt.
"},{"location":"gui/audiobooks/#3-audiobook-output-explorer","title":"3) Audiobook Output Explorer","text":"
Read-only Explorer des Audiobook-Outputpfads:
 
     
  • Ordner-/Dateistruktur
    •  
  • Zeitstempel/Gr\u00f6\u00dfen
    •  
  • schnelle Ergebnispr\u00fcfung ohne Dateisystemwechsel
    •  
"},{"location":"gui/audiobooks/#pfad-und-template-logik","title":"Pfad- und Template-Logik","text":"Bereich Gesteuert durch RAW-Ablage raw_dir_audiobook + audiobook_raw_template Finale Ausgabe movie_dir_audiobook + output_template_audiobook Dateiformat Jobkonfiguration (m4b, mp3, flac)"},{"location":"gui/audiobooks/#typische-probleme","title":"Typische Probleme","text":"
     
  • Upload wird abgelehnt: Eingabedatei ist keine AAX-Datei.
    •  
  • Start schl\u00e4gt fehl: ffmpeg/ffprobe nicht aufrufbar.
    •  
  • Unerwartete Pfade: Templates enthalten ung\u00fcltige oder zu generische Platzhalter.
    •  
"},{"location":"gui/converter/","title":"Converter","text":"
Die Seite Converter verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
"},{"location":"gui/converter/#betriebsmodell","title":"Betriebsmodell","text":"
Der Converter arbeitet auf dem Eingangspfad converter_raw_dir:
 
     
  • Uploads landen dort
    •  
  • Explorer-Aktionen arbeiten dort
    •  
  • daraus werden Converter-Jobs erstellt
    •  
 
Wichtig:
 
     
  • Upload erzeugt nicht automatisch einen Job.
    •  
  • Joberstellung erfolgt explizit \u00fcber Auswahl im Explorer.
    •  
"},{"location":"gui/converter/#datei-explorer","title":"Datei-Explorer","text":"
Der Explorer zeigt den kompletten Baum unter converter_raw_dir.
 
Aktionen:
 Aktion Wirkung Upload Dateien werden in den Raw-Baum geschrieben Ordner erstellen legt Unterordner im Raw-Baum an Umbenennen benennt Datei/Ordner im Raw-Baum um Verschieben verschiebt innerhalb des Raw-Baums L\u00f6schen entfernt Datei/Ordner dauerhaft Scannen synchronisiert Explorer und DB-Zuordnungen 
Upload-Regeln:
 
     
  • Dateiendung muss in Erlaubte Datei-Endungen* enthalten sein
    •  
  • bei Versto\u00df wird der Upload abgelehnt
    •  
"},{"location":"gui/converter/#joberstellung-aus-explorer-auswahl","title":"Joberstellung aus Explorer-Auswahl","text":"
Es gibt zwei Audio-Strategien:
 
     
  1. Ein Job pro Datei
    2.  
  2. Gemeinsamer Job (Audio)
    3.  
 
Verhalten:
 
     
  • Video/ISO werden grunds\u00e4tzlich als Einzeljobs angelegt.
    •  
  • Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
    •  
 
Shared-Audio-Job:
 
     
  • h\u00e4lt mehrere inputPaths
    •  
  • kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
    •  
"},{"location":"gui/converter/#job-konfiguration","title":"Job-Konfiguration","text":"
Vor Start je Job einstellbar:
 
     
  • converterMediaType (video, audio, iso)
    •  
  • outputFormat
    •  
  • Metadaten
    •  
  • Track-/Titelwahl (bei video/iso)
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
 
Spezifika:
 
     
  • Video/ISO laufen durch Mediainfo/Review \u00e4hnlich zum Disc-Flow.
    •  
  • Audio kann direkt mit Formatoptionen konfiguriert werden.
    •  
"},{"location":"gui/converter/#ausgabe-pfade","title":"Ausgabe-Pfade","text":""},{"location":"gui/converter/#videoiso","title":"Video/ISO","text":"
     
  • Root: converter_movie_dir
    •  
  • Dateiname: Output-Template (Video)
    •  
  • Endung: aus gew\u00e4hltem Output-Format
    •  
"},{"location":"gui/converter/#audio","title":"Audio","text":"
     
  • Root: converter_audio_dir
    •  
  • Dateiname/Ordner: Output-Template (Audio)
    •  
  • bei Shared-/Folder-Job: Ausgabe als Ordnerstruktur mit Trackdateien
    •  
"},{"location":"gui/converter/#queue-und-start","title":"Queue und Start","text":"
Converter-Jobs laufen \u00fcber dieselbe Pipeline-/Queue-Logik:
 
     
  • sofortiger Start wenn Limits frei
    •  
  • sonst Queue-Eintrag
    •  
 
Parallelit\u00e4t richtet sich nach den globalen Encode-Limits in Settings.
"},{"location":"gui/converter/#auto-scan-polling","title":"Auto-Scan (Polling)","text":"
Mit aktiviertem Polling:
 
     
  • converter_raw_dir wird zyklisch gescannt
    •  
  • neue Dateien erscheinen automatisch im Explorer
    •  
 
Relevante Settings:
 
     
  • Auto-Scan (Polling)
    •  
  • Polling-Intervall (Sekunden)
    •  
"},{"location":"gui/converter/#abgrenzung-zu-audiobooks","title":"Abgrenzung zu Audiobooks","text":"
     
  • Converter: beliebige Audio/Video/ISO-Dateien
    •  
  • Audiobooks: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
    •  
"},{"location":"gui/database/","title":"Database (Expert)","text":"
/database ist die Recovery- und Expertensicht f\u00fcr F\u00e4lle, in denen Dateisystem und Historie nicht mehr sauber zusammenpassen.
"},{"location":"gui/database/#zugriff","title":"Zugriff","text":"
     
  • direkte Route: /database
    •  
  • nicht Teil der Standardnavigation
    •  
"},{"location":"gui/database/#bereich-gefundene-raw-eintrage","title":"Bereich Gefundene RAW-Eintr\u00e4ge","text":"
Dieser Bereich listet RAW-Verzeichnisse ohne zugeordneten Historie-Job.
 
Aktionen:
 
     
  • RAW pr\u00fcfen: scannt konfigurierte RAW-Wurzeln
    •  
  • Job anlegen: erstellt aus einem orphan RAW einen neuen Historie-Job
    •  
"},{"location":"gui/database/#was-bei-job-anlegen-passiert","title":"Was bei Job anlegen passiert","text":"
     
  • RAW-Pfad wird als Importquelle registriert
    •  
  • Job wird in die Historie geschrieben
    •  
  • anschlie\u00dfende Analyse l\u00e4uft als RAW-basierter Einstieg (ohne klassischen Disc-Read)
    •  
 
Typischer Einsatz:
 
     
  • manuelle Dateioperationen au\u00dferhalb der UI
    •  
  • Migrationen
    •  
  • Wiederherstellung nach abgebrochenen L\u00e4ufen
    •  
"},{"location":"gui/database/#sicherheits-und-betriebsregeln","title":"Sicherheits- und Betriebsregeln","text":"
     
  • Aktionen wirken direkt auf produktive Historie/Dateipfade.
    •  
  • Vor Import oder L\u00f6schung immer Pfad und Ziel pr\u00fcfen.
    •  
  • Diese Seite nur f\u00fcr Recovery-Szenarien nutzen, nicht f\u00fcr normalen Tagesbetrieb.
    •  
"},{"location":"gui/downloads/","title":"Downloads","text":"
Auf Downloads werden ZIP-Archive f\u00fcr Historie-Artefakte erstellt und bereitgestellt.
"},{"location":"gui/downloads/#was-heruntergeladen-werden-kann","title":"Was heruntergeladen werden kann","text":"
Ein Download-Eintrag referenziert immer einen Historie-Job und genau ein Ziel:
 
     
  • RAW
    •  
  • Output
    •  
 
Erzeugt wird ein ZIP-Archiv im Download-Verzeichnis des Backends.
"},{"location":"gui/downloads/#statusmodell","title":"Statusmodell","text":"Status Bedeutung queued Eintrag erstellt, wartet auf Verarbeitung processing ZIP wird gerade gebaut ready Archiv fertig, Download-Link aktiv failed Erzeugung oder Zugriff fehlgeschlagen"},{"location":"gui/downloads/#eintrag-anlegen","title":"Eintrag anlegen","text":"
Startpunkt ist die Historie:
 
     
  1. Job \u00f6ffnen.
    2.  
  2. Download einreihen.
    3.  
  3. Ziel (RAW oder Output) w\u00e4hlen.
    4.  
  4. Status in Downloads verfolgen.
    5.  
"},{"location":"gui/downloads/#wichtige-laufzeitdetails","title":"Wichtige Laufzeitdetails","text":"
     
  • Wenn bereits ein passendes, aktuelles Archiv existiert, kann der Eintrag wiederverwendet werden.
    •  
  • Nach Backend-Neustart werden unterbrochene queued/processing-Eintr\u00e4ge gepr\u00fcft und fortgesetzt.
    •  
  • Fehlt eine erwartete ZIP-Datei bei ready, wird der Eintrag auf failed gesetzt.
    •  
"},{"location":"gui/downloads/#download-auslosen","title":"Download ausl\u00f6sen","text":"
Bei Status ready:
 
     
  • Download-Button l\u00e4dt die ZIP direkt aus /api/downloads/:id/file.
    •  
"},{"location":"gui/downloads/#eintrage-entfernen","title":"Eintr\u00e4ge entfernen","text":"
L\u00f6schen entfernt:
 
     
  • Queue-Metadaten
    •  
  • zugeh\u00f6rige Archivdatei
    •  
 
Nicht erlaubt:
 
     
  • L\u00f6schen w\u00e4hrend queued/processing
    •  
"},{"location":"gui/downloads/#echtzeitaktualisierung","title":"Echtzeitaktualisierung","text":"
Die Seite reagiert auf DOWNLOADS_UPDATED per WebSocket. Dadurch sind Statuswechsel ohne Reload sichtbar.
"},{"location":"gui/history/","title":"Historie","text":"
Historie ist die Kontroll- und Nachbearbeitungsoberfl\u00e4che f\u00fcr alle bereits angelegten Jobs.
"},{"location":"gui/history/#hauptansicht","title":"Hauptansicht","text":"
Filter und Arbeitsmittel:
 
     
  • Suche (Titel, IMDb, Kontextbegriffe)
    •  
  • Statusfilter
    •  
  • Mediumfilter
    •  
  • Sortierung
    •  
  • Listen-/Grid-Layout
    •  
 
Jeder Eintrag zeigt auf einen Blick:
 
     
  • Titel, Jahr, Poster
    •  
  • Status und Zeitstempel
    •  
  • RAW-/Output-Verf\u00fcgbarkeit
    •  
  • Medien- und ggf. Containerhinweise
    •  
"},{"location":"gui/history/#detaildialog-was-dort-zusammenlauft","title":"Detaildialog: Was dort zusammenl\u00e4uft","text":"
Der Detaildialog b\u00fcndelt:
 
     
  • Metadaten (Film oder Serie)
    •  
  • Jobstatus und Fehlertexte
    •  
  • RAW-/Output-Pfade
    •  
  • Encode-Plan und Trackauswahl
    •  
  • ausgef\u00fchrte Kommandodetails
    •  
  • Prozesslog (Tail oder vollst\u00e4ndig)
    •  
 
Bei Seriencontainern wird disk-/child-orientiert dargestellt, nicht nur als Einzeljob.
"},{"location":"gui/history/#nachbearbeitungsaktionen-und-wirkung","title":"Nachbearbeitungsaktionen und Wirkung","text":"Aktion Typischer Einsatz Technische Wirkung OMDb neu zuordnen falsches Match, Titel/Jahr korrigieren Metadatenfelder werden neu geschrieben; Folder-Rename wird best effort angesto\u00dfen Review neu starten neue Track-/Titelbewertung n\u00f6tig Mediainfo/Review wird aus RAW neu aufgebaut RAW neu encodieren neuer Encode aus vorhandenem RAW startet Encode ohne neuen Laufwerks-Rip Encode neu starten gleiche best\u00e4tigte Auswahl erneut fahren letzter best\u00e4tigter Plan wird geladen, optional mit Bereinigung unvollst\u00e4ndiger Ausgabe Retry Rippen Rip/Analyse neu ansto\u00dfen neuer Rip-Lauf, inkl. erneuter RAW-Phase 
L\u00f6schaktionen im Dialog:
 
     
  • RAW l\u00f6schen
    •  
  • Movie l\u00f6schen
    •  
  • Beides l\u00f6schen
    •  
  • Historieneintrag l\u00f6schen
    •  
"},{"location":"gui/history/#loschvorschau-und-selektives-loschen","title":"L\u00f6schvorschau und selektives L\u00f6schen","text":"
Vor endg\u00fcltigem L\u00f6schen zeigt Ripster eine Vorschau mit:
 
     
  • RAW-Kandidaten
    •  
  • Movie-/Episoden-Kandidaten
    •  
  • Related-Scope (Container/Kinder/verbundene Jobs)
    •  
 
Wichtige Punkte:
 
     
  • Pfade sind selektierbar.
    •  
  • F\u00fcr RAW-L\u00f6schung muss bei Mehrfachkandidaten mindestens ein RAW-Pfad gew\u00e4hlt werden.
    •  
  • Schutzlogik verhindert L\u00f6schungen au\u00dferhalb erlaubter Root-Verzeichnisse.
    •  
"},{"location":"gui/history/#serien-und-multipart-sicht-in-der-historie","title":"Serien- und Multipart-Sicht in der Historie","text":""},{"location":"gui/history/#serien","title":"Serien","text":"
     
  • Container zeigt aggregierten Zustand aus Child-Jobs.
    •  
  • Disk-/Episode-Aktionen k\u00f6nnen child-spezifisch ausgef\u00fchrt werden.
    •  
  • Im Ripper \u00f6ffnen hilft bei Bereit zum Encodieren-Kindern.
    •  
"},{"location":"gui/history/#multipart","title":"Multipart","text":"
     
  • gemeinsamer Container mit Disc-Childs
    •  
  • Disc-Nummern bleiben pro Child nachvollziehbar
    •  
  • Delete-Preview kann Related-Pfade gemeinsam aufl\u00f6sen
    •  
"},{"location":"gui/history/#logs-sinnvoll-nutzen","title":"Logs sinnvoll nutzen","text":"
     
  • Tail laden (800) f\u00fcr schnellen Fehlerkontext
    •  
  • Vollst\u00e4ndiges Log laden f\u00fcr forensische Analyse
    •  
 
Empfehlung:
 
     
  1. Erst Tail pr\u00fcfen.
    2.  
  2. Bei Pfad-/Toolproblemen vollst\u00e4ndiges Log laden.
    3.  
  3. Danach passende Wiederanlauf-Aktion w\u00e4hlen.
    4.  
"},{"location":"gui/jobs/","title":"Jobs","text":"
Jobs ist die zentrale Inbox \u00fcber alle Jobarten und dient als schneller Einstieg in den Tagesbetrieb.
"},{"location":"gui/jobs/#zweck-der-seite","title":"Zweck der Seite","text":"
Die Liste vereinheitlicht:
 
     
  • Disc-/Ripper-Jobs
    •  
  • Converter-Jobs
    •  
  • Audiobook-Jobs
    •  
 
Dadurch kannst du unabh\u00e4ngig von der Fachseite zuerst den Gesamtzustand pr\u00fcfen.
"},{"location":"gui/jobs/#filterlogik","title":"Filterlogik","text":""},{"location":"gui/jobs/#view-filter","title":"View-Filter","text":"
     
  • Alle Jobs
    •  
  • Ripper-View
    •  
  • Converter-View
    •  
  • Audiobooks
    •  
"},{"location":"gui/jobs/#status-filter","title":"Status-Filter","text":"
     
  • Alle
    •  
  • Aktiv
    •  
  • Fehler/Abbruch
    •  
 
Zus\u00e4tzlich:
 
     
  • Freitextsuche
    •  
  • Paginierung
    •  
"},{"location":"gui/jobs/#was-ein-jobeintrag-zeigt","title":"Was ein Jobeintrag zeigt","text":"
     
  • Job-ID und Titel
    •  
  • Statusbadge
    •  
  • Jobtypbadge (z. B. Blu-ray, DVD, Converter Audio, Audiobook)
    •  
  • Aktualisierungszeit
    •  
 
Die Ansicht wird periodisch aktualisiert und erg\u00e4nzt sich mit WebSocket-Events.
"},{"location":"gui/jobs/#schnellaktion-pro-zeile","title":"Schnellaktion pro Zeile","text":"
     
  • Im Ripper \u00f6ffnen f\u00fcr Disc-/Audiobook-nahe Jobs
    •  
  • Im Converter \u00f6ffnen f\u00fcr Converter-Jobs
    •  
 
So kommst du ohne Umwege in die Oberfl\u00e4che mit den passenden Detailaktionen.
"},{"location":"gui/jobs/#empfohlener-einsatz","title":"Empfohlener Einsatz","text":"
     
  1. In Jobs St\u00f6rungen und Auslastung identifizieren.
    2.  
  2. Danach gezielt in Ripper, Converter oder Historie springen.
    3.  
"},{"location":"gui/ripper/","title":"Ripper","text":"
Die Seite Ripper ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
"},{"location":"gui/ripper/#seitenaufbau-und-betriebslogik","title":"Seitenaufbau und Betriebslogik","text":"
Die Bereiche erscheinen in dieser Reihenfolge:
 
     
  1. Hardware Monitoring
    2.  
  2. Job Queue
    3.  
  3. Skript- / Cron-Status
    4.  
  4. Job \u00dcbersicht
    5.  
  5. Disk-Information
    6.  
"},{"location":"gui/ripper/#1-hardware-monitoring","title":"1) Hardware Monitoring","text":"
Zeigt kontinuierlich:
 
     
  • CPU / RAM
    •  
  • GPU (wenn verf\u00fcgbar)
    •  
  • freie Speicherst\u00e4nde konfigurierter Pfade
    •  
 
Nutzen im Betrieb:
 
     
  • Engp\u00e4sse vor Jobfehlern erkennen
    •  
  • Pfadf\u00fcllst\u00e4nde vor Start gro\u00dfer Batchs pr\u00fcfen
    •  
 
Gesteuert \u00fcber Settings:
 
     
  • Hardware Monitoring aktiviert
    •  
  • Hardware Monitoring Intervall (ms)
    •  
"},{"location":"gui/ripper/#2-job-queue","title":"2) Job Queue","text":"
Es gibt zwei operative Zonen:
 
     
  • Laufende Jobs
    •  
  • Warteschlange
    •  
 
M\u00f6gliche Queue-Eintr\u00e4ge:
 
     
  • Job-Startaktionen (Start, Retry Rippen, RAW neu encodieren, Encode neu starten, Review neu berechnen, Audio CD starten)
    •  
  • Nicht-Job-Eintr\u00e4ge (Skript, Skriptkette, Warten)
    •  
 
Wichtige Regeln:
 
     
  • Queue-Reihenfolge ist per Drag-and-Drop \u00e4nderbar.
    •  
  • Warten blockiert nachfolgende Queue-Starts bis kein aktiver Prozess mehr l\u00e4uft.
    •  
  • Skript und Skriptkette werden als Queue-Eintr\u00e4ge mitgef\u00fchrt.
    •  
 
Parallelit\u00e4t kommt aus Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
"},{"location":"gui/ripper/#3-skript-cron-status","title":"3) Skript- / Cron-Status","text":"
Zeigt Runtime-Aktivit\u00e4ten:
 
     
  • laufende Skripte
    •  
  • laufende Ketten
    •  
  • Cron-Ausf\u00fchrungen
    •  
  • letzte abgeschlossene Aktivit\u00e4ten
    •  
 
Aktionen:
 
     
  • N\u00e4chster Schritt bei Ketten
    •  
  • Abbrechen
    •  
  • Liste leeren
    •  
"},{"location":"gui/ripper/#4-job-ubersicht","title":"4) Job \u00dcbersicht","text":"
Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick \u00f6ffnet den jeweiligen Pipeline-Status.
"},{"location":"gui/ripper/#badges-und-kontext","title":"Badges und Kontext","text":"
Neben Status/Fortschritt zeigt die Liste je nach Job:
 
     
  • Serienkontext (Serien-Container, Staffel/Disk)
    •  
  • Multipart-Kontext (Multipart Movie, Disc-Nr.)
    •  
  • Queue-/Subjob-Kontext bei Serien-Episoden
    •  
"},{"location":"gui/ripper/#zustandsabhangige-aktionen","title":"Zustandsabh\u00e4ngige Aktionen","text":"Zustand Hauptaktion im Ripper Ergebnis Medium erkannt, Bereit Analyse starten startet MakeMKV-Analyse Metadatenauswahl Metadaten \u00f6ffnen Film/Serie ausw\u00e4hlen, Provider festlegen Warte auf Auswahl Playlist/Titel/RAW-Entscheidung best\u00e4tigen setzt Flow fort zur Pr\u00fcfung Startbereit Job starten startet Rip oder RAW-basierte Pr\u00fcfung Bereit zum Encodieren Encoding starten startet HandBrake mit best\u00e4tigter Auswahl Laufend (Analyse, Rippen, Encodieren) Abbrechen setzt Job auf Abgebrochen Fehler, Abgebrochen Retry Rippen neuer Rip-Anlauf 
Zusatzaktionen je nach Zustand und Jobtyp:
 
     
  • Review neu starten
    •  
  • Encode neu starten
    •  
  • RAW neu encodieren
    •  
  • Aus Queue l\u00f6schen
    •  
"},{"location":"gui/ripper/#review-bereich-bereit-zum-encodieren","title":"Review-Bereich (Bereit zum Encodieren)","text":"
Hier wird die effektive Encode-Entscheidung festgelegt:
 
     
  • Titelwahl
    •  
  • Audio-/Subtitle-Trackselektion
    •  
  • User-Preset
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
  • HandBrake-Kommandovorschau
    •  
 
Ohne Best\u00e4tigung dieses Blocks startet kein produktiver Encode.
"},{"location":"gui/ripper/#raw-ordnerphasen-sichtbar-uber-logsdetails","title":"RAW-Ordnerphasen (sichtbar \u00fcber Logs/Details)","text":"
Der Ripper arbeitet mit drei RAW-Zust\u00e4nden:
 
     
  • Incomplete_... w\u00e4hrend unvollst\u00e4ndigem Rip
    •  
  • Rip_Complete_... nach erfolgreich abgeschlossenem Rip, vor Encode
    •  
  • ohne Prefix nach erfolgreichem Encode
    •  
 
Das ist wichtig f\u00fcr Recovery und Delete-Vorschau.
"},{"location":"gui/ripper/#5-disk-information","title":"5) Disk-Information","text":"
Zeigt aktuelle Laufwerksdaten:
 
     
  • Device-Pfad
    •  
  • Modell
    •  
  • Disc-Label / Mount
    •  
 
Aktionen:
 
     
  • Laufwerk neu lesen
    •  
  • Disk neu analysieren
    •  
  • Metadaten-Dialog \u00f6ffnen
    •  
 
Hinweis:
 
     
  • Laufwerk neu lesen ist nicht mehr an einen festen Pipeline-State gebunden.
    •  
"},{"location":"gui/ripper/#wichtige-dialoge","title":"Wichtige Dialoge","text":""},{"location":"gui/ripper/#metadaten-auswahlen","title":"Metadaten ausw\u00e4hlen","text":"
Im Dialog werden Film-/Serienmetadaten best\u00e4tigt.
 
Sonderf\u00e4lle:
 
     
  • Film-Duplikat: \u00dcbernahme erzwingen oder Multipart movie
    •  
  • Serie: Disc-Nummer ist Pflicht
    •  
"},{"location":"gui/ripper/#vorhandenes-raw-erkannt","title":"Vorhandenes RAW erkannt","text":"
Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
 
     
  • vorhandenes RAW verwenden
    •  
  • RAW verwerfen/l\u00f6schen und neu rippen
    •  
"},{"location":"gui/ripper/#queue-eintrag-einfugen","title":"Queue-Eintrag einf\u00fcgen","text":"
Du kannst gezielt ab Position einf\u00fcgen:
 
     
  • Skript
    •  
  • Skriptkette
    •  
  • Wartezeit
    •  
"},{"location":"gui/settings/","title":"Settings","text":"
Die Seite Settings steuert alle Betriebsparameter von Ripster: Pfade, Tools, Queue-Limits, Metadatenquellen, Automatisierung.
"},{"location":"gui/settings/#tab-uberblick","title":"Tab-\u00dcberblick","text":"Tab Hauptzweck Konfiguration globale und profilspezifische Laufzeitsettings Scripte einzelne Skripte verwalten und testen Skriptketten mehrstufige Abl\u00e4ufe aus Skript/Warten Encode-Presets wiederverwendbare HandBrake-Profile f\u00fcr Review Cronjobs zeitgesteuerte Ausf\u00fchrung von Skript/Kette"},{"location":"gui/settings/#tab-konfiguration","title":"Tab Konfiguration","text":""},{"location":"gui/settings/#bedienprinzip","title":"Bedienprinzip","text":"
     
  1. Werte \u00e4ndern.
    2.  
  2. \u00c4nderungen speichern.
    3.  
  3. erst danach sind Werte f\u00fcr neue Aktionen wirksam.
    4.  
 
Zus\u00e4tzliche Bedienhilfen:
 
     
  • Neu laden verwirft lokale Formzust\u00e4nde
    •  
  • \u00c4nderungen verwerfen setzt auf zuletzt gespeicherten Stand
    •  
  • PushOver Test validiert Benachrichtigungszugang sofort
    •  
"},{"location":"gui/settings/#was-wirkt-unmittelbar-was-erst-bei-neuem-job","title":"Was wirkt unmittelbar, was erst bei neuem Job?","text":"
     
  • Queue-/Parallelit\u00e4t wirkt auf neue Queue-Entscheidungen und Pump-L\u00e4ufe.
    •  
  • Tool-/Pfad-/Template-\u00c4nderungen wirken vollst\u00e4ndig auf neu gestartete Schritte.
    •  
  • Bereits laufende Prozesse \u00fcbernehmen \u00c4nderungen in der Regel nicht r\u00fcckwirkend.
    •  
"},{"location":"gui/settings/#welche-bereiche-im-alltag-kritisch-sind","title":"Welche Bereiche im Alltag kritisch sind","text":"Bereich Kritisch f\u00fcr Pfade wo RAW, finale Ausgaben, Converter/Audiobook-Dateien landen Tools ob Analyze/Rip/Encode ausf\u00fchrbar sind Metadaten Film-/Serienzuordnung und Episode-Mapping Queue-Limits Durchsatz und Reihenfolgeverhalten Monitoring Sichtbarkeit von Last und Speicherengp\u00e4ssen Benachrichtigungen PushOver-Ereignisse je Pipelinephase"},{"location":"gui/settings/#tab-scripte","title":"Tab Scripte","text":"
Funktionen:
 
     
  • anlegen, bearbeiten, l\u00f6schen
    •  
  • testen (Test)
    •  
  • sortieren
    •  
 
Testausf\u00fchrung liefert:
 
     
  • Exit-Code
    •  
  • Dauer
    •  
  • stdout/stderr
    •  
 
Wichtig:
 
     
  • Nur erfolgreiche Skripte sollten in produktive Pre-/Post-Listen \u00fcbernommen werden.
    •  
"},{"location":"gui/settings/#tab-skriptketten","title":"Tab Skriptketten","text":"
Ketten bestehen aus Schritten:
 
     
  • Skript
    •  
  • Warten
    •  
 
Typischer Einsatz:
 
     
  • externe Hooks vor/nach Encode
    •  
  • gestaffelte Abl\u00e4ufe mit Pausen
    •  
 
In der Queue erscheinen Ketten als eigene Eintr\u00e4ge und werden dort ausgef\u00fchrt.
"},{"location":"gui/settings/#tab-encode-presets","title":"Tab Encode-Presets","text":"
Ein Preset b\u00fcndelt:
 
     
  • optionales HandBrake-Preset (-Z)
    •  
  • optionale Extra-Args
    •  
  • Medienziel (Universell/Blu-ray/DVD/Sonstiges)
    •  
 
Im Ripper-Review kannst du Presets pro Job ausw\u00e4hlen, statt Parameter jedes Mal neu zu setzen.
"},{"location":"gui/settings/#tab-cronjobs","title":"Tab Cronjobs","text":"
Funktionen:
 
     
  • Cronjob anlegen und bearbeiten
    •  
  • Quelle w\u00e4hlen (Skript oder Skriptkette)
    •  
  • Cron-Ausdruck pr\u00fcfen
    •  
  • Jetzt ausf\u00fchren
    •  
  • Job-Logs ansehen
    •  
  • Aktivierung/Pushover toggeln
    •  
 
Empfehlung:
 
     
  1. Skript/Kette manuell testen.
    2.  
  2. Dann Cron aktivieren.
    3.  
  3. Erste automatische L\u00e4ufe aktiv im Runtime-Status kontrollieren.
    4.  
"},{"location":"gui/settings/#verbindung-zur-einstellungsreferenz","title":"Verbindung zur Einstellungsreferenz","text":"
Die vollst\u00e4ndige Wirkung jeder einzelnen Einstellung steht in Einstellungsreferenz.
"},{"location":"pipeline/","title":"Anhang: Pipeline intern","text":"
Dieser Abschnitt beschreibt die technische Pipeline-Logik hinter den UI-Workflows.
 
     
  •  
     Workflow & Zust\u00e4nde
     
    Zustandsmodell, \u00dcberg\u00e4nge, Queue-Verhalten.
     
     Workflow
     
    •  
  •  
     Encode-Planung
     
    Aufbereitung von Titeln/Tracks und Best\u00e4tigungslogik.
     
     Encoding
     
    •  
  •  
     Playlist-Analyse
     
    Bewertung mehrdeutiger Blu-ray-Playlists.
     
     Playlist-Analyse
     
    •  
  •  
     Pre-/Post-Encode-Ausf\u00fchrungen
     
    Skript- und Kettenlauf vor/nach dem Encoding.
     
     Encode-Skripte
     
    •  
"},{"location":"pipeline/#zuruck-zum-handbuch","title":"Zur\u00fcck zum Handbuch","text":"
     
  • Workflows aus Nutzersicht
    •  
"},{"location":"pipeline/encoding/","title":"Encode-Planung & Track-Auswahl","text":"
Vor dem eigentlichen Encoding erstellt Ripster einen Encode-Plan und zeigt ihn im Review an.
"},{"location":"pipeline/encoding/#ablauf","title":"Ablauf","text":"
Quelle bestimmen (Disc/RAW)\n  -> HandBrake-Scan (--scan --json)\n  -> Plan erstellen (Titel, Audio, Untertitel)\n  -> Status: Bereit zum Encodieren\n  -> Benutzer bestaetigt Auswahl\n  -> finaler HandBrake-Aufruf\n
"},{"location":"pipeline/encoding/#review-inhalt-status-bereit-zum-encodieren","title":"Review-Inhalt (Status: Bereit zum Encodieren)","text":"
     
  • ausw\u00e4hlbarer Encode-Titel
    •  
  • Audio-Track-Auswahl
    •  
  • Untertitel-Track-Auswahl inkl. Flags
    •  
  • burnIn
    •  
  • forced
    •  
  • defaultTrack
    •  
  • optionale User-Presets (HandBrake Preset + Extra Args)
    •  
  • optionale Pre-/Post-Skripte und Ketten
    •  
"},{"location":"pipeline/encoding/#bestaetigung-confirm-encode","title":"Bestaetigung (confirm-encode)","text":"
Typischer Payload:
 
{\n  \"selectedEncodeTitleId\": 1,\n  \"selectedTrackSelection\": {\n    \"1\": {\n      \"audioTrackIds\": [1, 2],\n      \"subtitleTrackIds\": [3]\n    }\n  },\n  \"selectedPreEncodeScriptIds\": [1],\n  \"selectedPostEncodeScriptIds\": [2],\n  \"selectedPreEncodeChainIds\": [3],\n  \"selectedPostEncodeChainIds\": [4],\n  \"selectedUserPresetId\": 5\n}\n
 
Die best\u00e4tigte Auswahl wird im Job gespeichert und f\u00fcr Neustarts wiederverwendet.
"},{"location":"pipeline/encoding/#handbrake-aufruf","title":"HandBrake-Aufruf","text":"
Grundstruktur:
 
HandBrakeCLI \\\n  -i <input> \\\n  -o <output> \\\n  -t <titleId> \\\n  -Z \"<preset>\" \\\n  <extra-args> \\\n  -a <audioTrackIds|none> \\\n  -s <subtitleTrackIds|none>\n
 
Untertitel-Flags werden bei Bedarf erg\u00e4nzt:
 
     
  • --subtitle-burned=<id>
    •  
  • --subtitle-default=<id>
    •  
  • --subtitle-forced=<id> oder --subtitle-forced
    •  
"},{"location":"pipeline/encoding/#pre-post-encode-ausfuhrungen","title":"Pre-/Post-Encode-Ausf\u00fchrungen","text":"
     
  • Pre-Encode l\u00e4uft vor HandBrake
    •  
  • Post-Encode l\u00e4uft nach HandBrake
    •  
 
Fehlerverhalten:
 
     
  • Pre-Encode-Fehler: Job endet mit Status Fehler (Encode startet nicht)
    •  
  • Post-Encode-Fehler: Job kann Fertig bleiben, enth\u00e4lt aber Fehlerhinweis/Script-Summary
    •  
"},{"location":"pipeline/encoding/#dateinamenordner","title":"Dateinamen/Ordner","text":"
Der finale Outputpfad wird aus den Templates in den Settings aufgebaut.
 
Platzhalter:
 
     
  • ${title}
    •  
  • ${year}
    •  
  • ${imdbId}
    •  
 
Ung\u00fcltige Dateizeichen werden bereinigt.
"},{"location":"pipeline/playlist-analysis/","title":"Playlist-Analyse","text":"
Ripster analysiert bei Blu-ray-\u00e4hnlichen Quellen Playlists und fordert bei Mehrdeutigkeit eine manuelle Auswahl an.
"},{"location":"pipeline/playlist-analysis/#ziel","title":"Ziel","text":"
Erkennen, welche Playlist sehr wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
"},{"location":"pipeline/playlist-analysis/#eingabedaten","title":"Eingabedaten","text":"
Die Analyse basiert auf MakeMKV-Infos (u. a. Playlist-/Segment-Struktur, Laufzeiten, Titelzuordnung).
"},{"location":"pipeline/playlist-analysis/#auswertung-vereinfacht","title":"Auswertung (vereinfacht)","text":"
F\u00fcr Kandidaten werden u. a. ber\u00fccksichtigt:
 
     
  • Laufzeit
    •  
  • Segment-Reihenfolge
    •  
  • R\u00fcckw\u00e4rtsspr\u00fcnge/gro\u00dfe Spr\u00fcnge
    •  
  • Koh\u00e4renz linearer Segmentfolgen
    •  
  • Duplikatgruppen mit \u00e4hnlicher Laufzeit
    •  
 
Daraus entstehen intern Kandidatenlisten, Bewertungen und eine Empfehlung.
"},{"location":"pipeline/playlist-analysis/#wann-muss-der-benutzer-entscheiden","title":"Wann muss der Benutzer entscheiden?","text":"
Wenn nach Filterung mehr als ein relevanter Kandidat \u00fcbrig bleibt, wechselt der Job in der GUI auf:
 
     
  • Warte auf Auswahl
    •  
 
Dann muss eine Playlist best\u00e4tigt werden, bevor der Workflow weiterl\u00e4uft.
"},{"location":"pipeline/playlist-analysis/#konfigurationseinfluss","title":"Konfigurationseinfluss","text":"Feld in Settings Wirkung Minimale Titellaenge (Minuten) Mindestlaufzeit f\u00fcr Kandidaten 
Default ist aktuell 60 Minuten.
"},{"location":"pipeline/playlist-analysis/#ui-verhalten","title":"UI-Verhalten","text":"
Bei manueller Entscheidung zeigt das Ripper Kandidaten inkl. Score/Bewertung und markiert eine Empfehlung.
 
Nach Best\u00e4tigung:
 
     
  • mit vorhandenem RAW -> zur\u00fcck zu Mediainfo-Pruefung
    •  
  • ohne RAW -> Startpfad \u00fcber Startbereit / Rippen
    •  
"},{"location":"pipeline/post-encode-scripts/","title":"Encode-Skripte (Pre & Post)","text":"
Ripster kann Skripte und Skript-Ketten vor und nach dem Encode ausf\u00fchren.
"},{"location":"pipeline/post-encode-scripts/#ablauf","title":"Ablauf","text":"
Bereit zum Encodieren\n  -> Pre-Encode Skripte/Ketten\n  -> HandBrake Encoding\n  -> Post-Encode Skripte/Ketten\n  -> Fertig oder Fehler\n
"},{"location":"pipeline/post-encode-scripts/#auswahl-im-review","title":"Auswahl im Review","text":"
Im Review-Panel kannst du getrennt w\u00e4hlen:
 
     
  • selectedPreEncodeScriptIds
    •  
  • selectedPostEncodeScriptIds
    •  
  • selectedPreEncodeChainIds
    •  
  • selectedPostEncodeChainIds
    •  
"},{"location":"pipeline/post-encode-scripts/#fehlerverhalten","title":"Fehlerverhalten","text":"
     
  • Pre-Encode-Fehler stoppen die Kette und f\u00fchren zu Fehler.
    •  
  • Post-Encode-Fehler stoppen die restlichen Post-Schritte; Job kann dennoch Fertig sein (mit Fehlerzusatz im Status/Log).
    •  
"},{"location":"pipeline/post-encode-scripts/#verfugbare-umgebungsvariablen","title":"Verf\u00fcgbare Umgebungsvariablen","text":"
Beim Script-Run werden gesetzt:
 
     
  • RIPSTER_SCRIPT_RUN_AT
    •  
  • RIPSTER_JOB_ID
    •  
  • RIPSTER_JOB_TITLE
    •  
  • RIPSTER_MODE
    •  
  • RIPSTER_INPUT_PATH
    •  
  • RIPSTER_OUTPUT_PATH
    •  
  • RIPSTER_RAW_PATH
    •  
  • RIPSTER_SCRIPT_ID
    •  
  • RIPSTER_SCRIPT_NAME
    •  
  • RIPSTER_SCRIPT_SOURCE
    •  
"},{"location":"pipeline/post-encode-scripts/#skript-ketten","title":"Skript-Ketten","text":"
Ketten unterst\u00fctzen zwei Step-Typen:
 
     
  • script (f\u00fchrt ein hinterlegtes Skript aus)
    •  
  • wait (wartet waitSeconds)
    •  
 
Bei Fehler in einem Script-Step wird die Kette abgebrochen.
"},{"location":"pipeline/post-encode-scripts/#testlaufe","title":"Testl\u00e4ufe","text":"
     
  • Skript testen: POST /api/settings/scripts/:id/test
    •  
  • Kette testen: POST /api/settings/script-chains/:id/test
    •  
 
Ergebnisse enthalten Erfolg/Exit-Code, Laufzeit und stdout/stderr.
"},{"location":"pipeline/workflow/","title":"Workflow & Zust\u00e4nde","text":"
Ripster steuert den Ablauf als Zustandsmaschine.
"},{"location":"pipeline/workflow/#zustandsdiagramm-vereinfacht","title":"Zustandsdiagramm (vereinfacht)","text":"
flowchart LR\n    A[Bereit] --> B[Medium erkannt]\n    B --> C[Analyse]\n    C --> D[Metadatenauswahl]\n    D --> E[Startbereit]\n    E --> F[Rippen]\n    E --> G[Mediainfo-Pruefung]\n    G --> H[Warte auf Auswahl]\n    H --> G\n    G --> I[Bereit zum Encodieren]\n    I --> J[Encodieren]\n    J --> K[Fertig]\n    J --> L[Fehler]\n    F --> L\n    F --> M[Abgebrochen]
"},{"location":"pipeline/workflow/#statusliste-gui-anzeige","title":"Statusliste (GUI-Anzeige)","text":"Status in der GUI Bedeutung Bereit Wartet auf Disc Medium erkannt Disc wurde erkannt Analyse MakeMKV-Analyse l\u00e4uft Metadatenauswahl Metadaten m\u00fcssen best\u00e4tigt werden Warte auf Auswahl Playlist-Auswahl ist erforderlich Warte auf Auswahl auch f\u00fcr RAW-Entscheidung bei vorhandenen Quelldaten genutzt Startbereit kurzer \u00dcbergang vor Start Rippen MakeMKV-Rip l\u00e4uft Mediainfo-Pruefung Titel/Spuren werden ausgewertet Bereit zum Encodieren Review ist bereit Encodieren HandBrake l\u00e4uft CD-Metadatenauswahl CD-Metadaten m\u00fcssen best\u00e4tigt werden CD-Startbereit CD-Job wartet auf Start CD-Analyse CD-Track-/Strukturaufbereitung CD-Rippen Audio-CD-Rip l\u00e4uft CD-Encodieren CD-Encode l\u00e4uft Fertig erfolgreich abgeschlossen Abgebrochen manuell oder technisch abgebrochen Fehler fehlgeschlagen"},{"location":"pipeline/workflow/#typische-pfade","title":"Typische Pfade","text":""},{"location":"pipeline/workflow/#standardfall-kein-vorhandenes-raw","title":"Standardfall (kein vorhandenes RAW)","text":"
     
  1. Medium erkannt
    2.  
  2. Analyse + Metadaten
    3.  
  3. Rippen
    4.  
  4. Mediainfo-Pruefung
    5.  
  5. Bereit zum Encodieren
    6.  
  6. Encodieren
    7.  
  7. Fertig
    8.  
"},{"location":"pipeline/workflow/#vorhandenes-raw","title":"Vorhandenes RAW","text":"
Startbereit springt direkt zu Mediainfo-Pruefung (kein neuer Rip).
"},{"location":"pipeline/workflow/#mehrdeutige-blu-ray-playlist","title":"Mehrdeutige Blu-ray-Playlist","text":"
Mediainfo-Pruefung -> Warte auf Auswahl bis Playlist best\u00e4tigt wurde.
"},{"location":"pipeline/workflow/#vorhandenes-raw-mit-nutzerentscheidung","title":"Vorhandenes RAW mit Nutzerentscheidung","text":"
Metadatenauswahl -> Warte auf Auswahl bis Entscheidung f\u00fcr Weiterverarbeitung (continue) oder Neustart getroffen wurde.
"},{"location":"pipeline/workflow/#cd-flow","title":"CD-Flow","text":"
CD-Metadatenauswahl -> CD-Startbereit -> CD-Rippen -> CD-Encodieren -> Fertig
"},{"location":"pipeline/workflow/#queue-verhalten","title":"Queue-Verhalten","text":"
Wenn der Wert Parallele Jobs erreicht ist:
 
     
  • neue Starts werden als Queue-Eintr\u00e4ge abgelegt
    •  
  • die Queue kann zus\u00e4tzlich Nicht-Job-Eintr\u00e4ge enthalten (Skript, Kette, Warten)
    •  
  • Reihenfolge ist per UI/API \u00e4nderbar
    •  
"},{"location":"pipeline/workflow/#abbruch-wiederaufnahme-neustart","title":"Abbruch, Wiederaufnahme, Neustart","text":"
     
  • Abbrechen: laufenden Job stoppen oder Queue-Eintrag entfernen
    •  
  • Retry Rippen: Fehler-/Abbruch-Job erneut starten
    •  
  • RAW neu encodieren: aus vorhandenem RAW neu encodieren
    •  
  • Review neu starten: Review aus RAW neu aufbauen
    •  
  • Encode neu starten: Encoding mit letzter best\u00e4tigter Auswahl neu starten
    •  
"},{"location":"tools/","title":"Anhang: Externe Tools","text":"
Ripster orchestriert externe CLI-Tools. Dieser Abschnitt erkl\u00e4rt deren Rolle im Gesamtsystem.
 
     
  •  
     MakeMKV
     
    Disc-Analyse und Ripping.
     
     MakeMKV
     
    •  
  •  
     HandBrake
     
    Video-Encoding inklusive Preset-Logik.
     
     HandBrake
     
    •  
  •  
     MediaInfo
     
    Track-/Containeranalyse f\u00fcr Review und Auswahl.
     
     MediaInfo
     
    •  
"},{"location":"tools/handbrake/","title":"HandBrake","text":"
Ripster verwendet HandBrakeCLI f\u00fcr Scan und Encode.
"},{"location":"tools/handbrake/#verwendete-aufrufe","title":"Verwendete Aufrufe","text":""},{"location":"tools/handbrake/#scan-review-aufbau","title":"Scan (Review-Aufbau)","text":"
HandBrakeCLI --scan --json -i <input> -t 0\n
"},{"location":"tools/handbrake/#encode-vereinfacht","title":"Encode (vereinfacht)","text":"
HandBrakeCLI \\\n  -i <input> \\\n  -o <output> \\\n  -t <titleId> \\\n  -Z \"<preset>\" \\\n  <extra-args> \\\n  -a <audioTrackIds|none> \\\n  -s <subtitleTrackIds|none>\n
 
Optional erg\u00e4nzt Ripster:
 
     
  • --subtitle-burned=<id>
    •  
  • --subtitle-default=<id>
    •  
  • --subtitle-forced=<id> oder --subtitle-forced
    •  
"},{"location":"tools/handbrake/#presets-auslesen","title":"Presets auslesen","text":"
Ripster liest Presets mit:
 
HandBrakeCLI -z\n
"},{"location":"tools/handbrake/#relevante-felder-in-settings","title":"Relevante Felder in Settings","text":"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\u00e4ndige Ausgabe l\u00f6schen unvollst\u00e4ndige Ausgabe bei Neustart l\u00f6schen"},{"location":"tools/handbrake/#fortschritts-parsing","title":"Fortschritts-Parsing","text":"
Ripster parst HandBrake-Stderr (Prozent/ETA/Detail) und sendet WebSocket-Progress (PIPELINE_PROGRESS).
"},{"location":"tools/handbrake/#troubleshooting","title":"Troubleshooting","text":"
     
  • Preset nicht gefunden: Preset-Namen mit HandBrakeCLI -z pr\u00fcfen
    •  
  • sehr langsames Encoding: Preset/Extra-Args pr\u00fcfen (z. B. --encoder-preset)
    •  
 
Das Produktions-Installer-Script install.sh bietet eine Option zur Installation eines geb\u00fcndelten HandBrakeCLI-Binaries mit NVDEC-Unterst\u00fctzung (NVIDIA GPU-Dekodierung). Diese Option erscheint interaktiv w\u00e4hrend der Installation.
"},{"location":"tools/makemkv/","title":"MakeMKV","text":"
Ripster nutzt makemkvcon f\u00fcr Disc-Analyse und Rip.
"},{"location":"tools/makemkv/#verwendete-aufrufe","title":"Verwendete Aufrufe","text":""},{"location":"tools/makemkv/#analyse","title":"Analyse","text":"
makemkvcon -r info <source>\n
 
<source> ist typischerweise:
 
     
  • disc:<index> (Auto-Modus)
    •  
  • dev:/dev/sr0 (explicit)
    •  
  • file:<path> (Datei/Ordner-Analyse)
    •  
"},{"location":"tools/makemkv/#rip-mkv-modus","title":"Rip (MKV-Modus)","text":"
makemkvcon mkv <source> <title-or-all> <rawDir> [--minlength=...] [...extraArgs]\n
"},{"location":"tools/makemkv/#rip-backup-modus","title":"Rip (Backup-Modus)","text":"
makemkvcon backup <source> <rawDir> --decrypt\n
"},{"location":"tools/makemkv/#registrierungsschlussel-optional","title":"Registrierungsschl\u00fcssel (optional)","text":"
Wenn in Settings ein MakeMKV Key gesetzt ist, f\u00fchrt Ripster vor Analyse/Rip aus:
 
makemkvcon reg <key>\n
"},{"location":"tools/makemkv/#relevante-felder-in-settings","title":"Relevante Felder in Settings","text":"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\u00fcr Analyse MakeMKV Rip Extra Args (Blu-ray/DVD) Zusatzargumente f\u00fcr Rip"},{"location":"tools/makemkv/#hinweise","title":"Hinweise","text":"
     
  • Blu-ray-Backups werden oft f\u00fcr robuste Playlist-Analyse genutzt.
    •  
  • MakeMKV-Ausgaben werden geparst und als makemkvInfo im Job gespeichert.
    •  
"},{"location":"tools/mediainfo/","title":"MediaInfo","text":"
Ripster nutzt mediainfo zur JSON-Analyse von Medien-Dateien.
"},{"location":"tools/mediainfo/#aufruf","title":"Aufruf","text":"
mediainfo --Output=JSON <input>\n
 
Der Input ist typischerweise eine RAW-Datei oder ein vom Workflow gew\u00e4hlter Inputpfad.
"},{"location":"tools/mediainfo/#verwendung-in-ripster","title":"Verwendung in Ripster","text":"
     
  • Track-/Codec-Metadaten f\u00fcr Review-Plan
    •  
  • Fallback-Informationen in bestimmten Analysepfaden
    •  
  • Persistenz als mediainfoInfo im Job
    •  
"},{"location":"tools/mediainfo/#relevante-settings","title":"Relevante Settings","text":"Key Bedeutung mediainfo_command CLI-Binary mediainfo_extra_args_bluray / _dvd profilspezifische Zusatzargumente"},{"location":"tools/mediainfo/#troubleshooting","title":"Troubleshooting","text":"
     
  • JSON-Test: mediainfo --Output=JSON <datei>
    •  
  • unbekannte Sprache erscheint oft als und (undetermined)
    •  
"},{"location":"workflows/","title":"Workflows aus Nutzersicht","text":"
Diese Seite beschreibt die produktiven Abl\u00e4ufe als Handbuch: welche Entscheidung an welcher Stelle f\u00e4llt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
"},{"location":"workflows/#gemeinsame-grundlagen","title":"Gemeinsame Grundlagen","text":""},{"location":"workflows/#statuskette-im-normalfall","title":"Statuskette im Normalfall","text":"
Medium erkannt -> Analyse -> Metadatenauswahl -> Startbereit -> Rippen -> Mediainfo-Pruefung -> Bereit zum Encodieren -> Encodieren -> Fertig
 
Abweichungen:
 
     
  • bei Blu-ray/DVD mit n\u00f6tiger Playlistwahl: Mediainfo-Pruefung -> Warte auf Auswahl -> zur\u00fcck in Mediainfo-Pruefung
    •  
  • bei vorhandenem RAW: Startbereit springt direkt in Review/Pr\u00fcfung ohne neuen Laufwerks-Rip
    •  
  • bei Fehler/Abbruch: Fehler oder Abgebrochen mit Wiederanlauf-Aktionen
    •  
"},{"location":"workflows/#job-und-container-typen","title":"Job- und Container-Typen","text":"Typ Zweck Was enth\u00e4lt der Typ? Normaler Disc-Job Einzel-Film oder einzelne Disc RAW-Pfad, Output-Pfad, Logs, Review dvd_series_container logischer Serien-Container (pro Serie/Staffel) Metadatenanker, aggregierter Status \u00fcber Kinder dvd_series_child einzelne Serien-Disc oder Serien-Episode-Job eigentliche RAW-/Encode-Arbeit multipart_movie_container logischer Multipart-Film-Container Zusammenfassung f\u00fcr mehrere Film-Discs multipart_movie_child einzelne Disc innerhalb Multipart-Film Disc-spezifische RAW-/Encode-Daten 
Wichtig:
 
     
  • Container sind prim\u00e4r Ordnungs- und Statusobjekte.
    •  
  • Dateien (RAW/Output) h\u00e4ngen an den Child-Jobs.
    •  
"},{"location":"workflows/#workflow-a-film-blu-raydvd","title":"Workflow A: Film (Blu-ray/DVD)","text":""},{"location":"workflows/#1-disc-analysieren-und-film-metadaten-wahlen","title":"1) Disc analysieren und Film-Metadaten w\u00e4hlen","text":"
     
  1. Im Ripper Analyse starten.
    2.  
  2. Im Metadaten-Dialog Film ausw\u00e4hlen (OMDb bzw. manuelle Film-Metadaten).
    3.  
  3. Auswahl \u00fcbernehmen.
    4.  
 
Wirkung:
 
     
  • der Job wird als Film-Workflow gef\u00fchrt
    •  
  • Film-Fingerprint f\u00fcr Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
    •  
"},{"location":"workflows/#2-duplikatfall-entscheiden","title":"2) Duplikatfall entscheiden","text":"
Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
 
     
  1. \u00dcbernahme erzwingen (allow_new): neuer unabh\u00e4ngiger Film-Job
    2.  
  2. Multipart movie: neuer Job wird mit bestehendem Job in einem Multipart-Container verkn\u00fcpft
    3.  
 
Bei Multipart gilt:
 
     
  • beide Discs brauchen unterschiedliche Disc-Nummer
    •  
  • gleiche Disc-Nummer blockiert den Vorgang (MULTIPART_DISC_ALREADY_EXISTS)
    •  
"},{"location":"workflows/#3-raw-verzeichnis-entsteht","title":"3) RAW-Verzeichnis entsteht","text":"
Ordnername basiert auf Metadaten plus Job-ID:
 
     
  • Incomplete_<Titel> (<Jahr>) - RAW - job-<id>
    •  
 
Zustandswechsel des RAW-Ordners:
 
     
  • beim Start: Incomplete_...
    •  
  • nach erfolgreichem Rip: Rip_Complete_...
    •  
  • nach erfolgreichem Encode: Prefix wird entfernt (final)
    •  
"},{"location":"workflows/#4-review-und-encode","title":"4) Review und Encode","text":"
In Bereit zum Encodieren:
 
     
  • Titel w\u00e4hlen
    •  
  • Audio-/Subtitle-Spuren festlegen
    •  
  • optional User-Preset
    •  
  • optional Pre-/Post-Encode-Skripte oder Ketten
    •  
 
Beim Start:
 
     
  • tempor\u00e4re Ausgabe in Incomplete_job-<id>/<Datei>.<ext>
    •  
  • nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
    •  
"},{"location":"workflows/#workflow-b-serie-blu-raydvd","title":"Workflow B: Serie (Blu-ray/DVD)","text":""},{"location":"workflows/#1-serienmodus-aktivieren","title":"1) Serienmodus aktivieren","text":"
     
  1. Disc analysieren.
    2.  
  2. Im Metadaten-Dialog Serienmetadaten w\u00e4hlen (TMDb-basiert).
    3.  
  3. Disc-Nummer setzen (Pflicht, ab 1).
    4.  
 
Wirkung:
 
     
  • Workflow-Kind wird series
    •  
  • Seriencontainer wird gesucht/angelegt
    •  
  • aktueller Job wird als dvd_series_child darunter gef\u00fchrt
    •  
"},{"location":"workflows/#2-seriencontainer-und-disc-konflikte","title":"2) Seriencontainer und Disc-Konflikte","text":"
Beim Speichern wird gepr\u00fcft:
 
     
  • existiert f\u00fcr Serie/Staffel bereits ein Container?
    •  
  • existiert in diesem Container bereits dieselbe Disc-Nummer?
    •  
 
Wenn ja, wird blockiert (SERIES_DISC_ALREADY_EXISTS).
"},{"location":"workflows/#3-serien-raw-pfad","title":"3) Serien-RAW-Pfad","text":"
F\u00fcr Serien wird ein eigener RAW-Pfad bevorzugt:
 
     
  • Blu-ray: raw_dir_bluray_series (Fallback: raw_dir_bluray)
    •  
  • DVD: raw_dir_dvd_series (Fallback: raw_dir_dvd)
    •  
 
RAW-Namensbasis enth\u00e4lt Staffel/Disc (SxDy) und wird ebenfalls mit den Prefix-Phasen gef\u00fchrt:
 
     
  • Incomplete_... -> Rip_Complete_... -> final
    •  
"},{"location":"workflows/#4-serien-review-und-episoden-ausgabe","title":"4) Serien-Review und Episoden-Ausgabe","text":"
Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
 
     
  • Einzel-Episode: Episode-Template
    •  
  • Multi-Episode-Titel: Multi-Episode-Template
    •  
 
Ausgabepfad:
 
     
  • Root: series_dir_* (Fallback auf movie_dir_*)
    •  
  • Dateiname/Unterordner aus Serien-Template
    •  
"},{"location":"workflows/#5-multi-episode-disc-als-batch","title":"5) Multi-Episode-Disc als Batch","text":"
Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
 
     
  • Ripster erzeugt Episode-Child-Jobs
    •  
  • der urspr\u00fcngliche Disc-Job dient als Batch-Anker
    •  
  • RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
    •  
"},{"location":"workflows/#workflow-c-multipart-film","title":"Workflow C: Multipart-Film","text":""},{"location":"workflows/#wann-dieser-flow-gedacht-ist","title":"Wann dieser Flow gedacht ist","text":"
     
  • gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
    •  
  • Zusammengeh\u00f6rigkeit soll in Historie und Detailansichten sichtbar sein
    •  
"},{"location":"workflows/#ablauf","title":"Ablauf","text":"
     
  1. Film-Metadaten w\u00e4hlen.
    2.  
  2. Duplikatdialog -> Multipart movie.
    3.  
  3. Disc-Nummern f\u00fcr bestehenden und neuen Job festlegen.
    4.  
 
Wirkung:
 
     
  • multipart_movie_container wird angelegt oder wiederverwendet
    •  
  • beteiligte Jobs werden multipart_movie_child
    •  
  • Container f\u00fchrt gemeinsame Metadaten, Kinder f\u00fchren je Disc die eigentlichen Artefakte
    •  
"},{"location":"workflows/#workflow-d-vorhandenes-raw-raw-import","title":"Workflow D: Vorhandenes RAW / RAW-Import","text":""},{"location":"workflows/#fall-1-raw-bereits-vorhanden-bei-metadatenubernahme","title":"Fall 1: RAW bereits vorhanden bei Metadaten\u00fcbernahme","text":"
Nach Metadaten-\u00dcbernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
 
M\u00f6glichkeiten:
 
     
  • vorhandenes RAW weiterverwenden (kein neuer Rip)
    •  
  • RAW l\u00f6schen/ignorieren und neu rippen
    •  
"},{"location":"workflows/#fall-2-orphan-raw-aus-database","title":"Fall 2: Orphan-RAW aus /database","text":"
     
  1. In Database RAW pr\u00fcfen.
    2.  
  2. Bei orphan RAW Job anlegen.
    3.  
  3. Job wird in Historie erzeugt und wie \"Disk analysieren aus RAW\" weiterverarbeitet.
    4.  
"},{"location":"workflows/#workflow-e-nachbearbeitung-bestehender-jobs","title":"Workflow E: Nachbearbeitung bestehender Jobs","text":"
In Historie (Detaildialog):
 Aktion Wirkung OMDb neu zuordnen Metadaten neu schreiben, Folder-Rename wird best effort angesto\u00dfen Review neu starten Titel-/Spurpr\u00fcfung aus aktuellem RAW neu aufbauen RAW neu encodieren Encode erneut aus vorhandenem RAW starten Encode neu starten letzte best\u00e4tigte Review-Einstellungen wiederverwenden Retry Rippen Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden"},{"location":"workflows/#wo-landet-was-artefakt-matrix","title":"Wo landet was? (Artefakt-Matrix)","text":"Artefakt Film Serie Multipart RAW raw_dir_* bevorzugt raw_dir_*_series pro Child-Job im normalen Film-RAW-Schema Finale Ausgabe movie_dir_* + Film-Template series_dir_* (Fallback movie_dir_*) + Serien-Templates pro Child-Job normaler Film-Output Container-Datensatz nein ja (dvd_series_container) ja (multipart_movie_container) L\u00f6schvorschau in Historie einzelner Job oder Related Scope Container-/Child-bezogen mit Pfadauswahl Container-/Child-bezogen mit Pfadauswahl"},{"location":"workflows/#queue-verhalten-im-alltag","title":"Queue-Verhalten im Alltag","text":"
Die Startfreigabe h\u00e4ngt an vier Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
 
Praxis:
 
     
  • Film/Video- und Audio/CD laufen in getrennten Lanes
    •  
  • Gesamtlimit begrenzt beide gemeinsam
    •  
  • Queue kann neben Jobs auch Skript, Kette, Warten enthalten
    •  
"}]}
\ No newline at end of file
+{"config":{"lang":["de"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Ripster Handbuch","text":"
Diese Dokumentation ist als vollst\u00e4ndiges Benutzerhandbuch aufgebaut: t\u00e4gliche Bedienung zuerst, technische Referenz danach.
"},{"location":"#einstieg-in-3-schritten","title":"Einstieg in 3 Schritten","text":"
     
  1. Installation: Installation
    2.  
  2. Betriebskonfiguration: Ersteinrichtung
    3.  
  3. erster End-to-End-Lauf: Erster Lauf
    4.  
"},{"location":"#was-das-handbuch-abdeckt","title":"Was das Handbuch abdeckt","text":"
     
  • alle GUI-Seiten mit Aktionen und Wirkung
    •  
  • vollst\u00e4ndige Workflows f\u00fcr Film, Serie und Multipart
    •  
  • Queue-, Job-, Container- und Recovery-Verhalten
    •  
  • detaillierte Settings-Wirkung inklusive Fallbacks
    •  
"},{"location":"#empfohlene-lesereihenfolge","title":"Empfohlene Lesereihenfolge","text":"
     
  1. Benutzerhandbuch \u00dcberblick
    2.  
  2. GUI-Seiten
    3.  
  3. Workflows aus Nutzersicht
    4.  
  4. Einstellungsreferenz
    5.  
  5. bei Bedarf technischer Tiefgang im Anhang
    6.  
"},{"location":"api/","title":"Anhang: API-Referenz","text":"
REST- und WebSocket-Schnittstellen f\u00fcr Integration, Automatisierung und Debugging.
"},{"location":"api/#basis-url","title":"Basis-URL","text":"
http://localhost:3001\n
 
API-Prefix: /api
"},{"location":"api/#api-gruppen","title":"API-Gruppen","text":"
     
  •  
     Health
     
    Service-Liveness.
     
    GET /api/health
     
    •  
  •  
     Pipeline API
     
    Analyse, Start/Retry/Cancel, Queue, Re-Encode.
     
     Pipeline API
     
    •  
  •  
     Settings API
     
    Einstellungen, Skripte/Ketten, User-Presets.
     
     Settings API
     
    •  
  •  
     History API
     
    Job-Historie, Orphan-Import, L\u00f6schoperationen.
     
     History API
     
    •  
  •  
     Cron API
     
    Zeitgesteuerte Skript-/Kettenausf\u00fchrung.
     
     Cron API
     
    •  
  •  
     Converter API
     
    Datei-Explorer, Upload, Job-Verwaltung f\u00fcr den Converter.
     
     Converter API
     
    •  
  •  
     Downloads API
     
    Download-Queue f\u00fcr Ausgabedateien aus der Job-Historie.
     
     Downloads API
     
    •  
  •  
     Runtime Activities API
     
    Laufende und abgeschlossene Aktivit\u00e4ten (Skripte, Ketten, Cron, Tasks).
     
     Runtime Activities
     
    •  
  •  
    :material-websocket: WebSocket Events
     
    Pipeline-, Queue-, Disk-, Settings-, Cron-, Converter- und Download-Events.
     
     WebSocket
     
    •  
"},{"location":"api/#hinweis","title":"Hinweis","text":"
Ripster hat keine eingebaute Authentifizierung und ist f\u00fcr lokalen, gesch\u00fctzten Betrieb gedacht.
"},{"location":"api/converter/","title":"Converter API","text":"
Endpunkte f\u00fcr den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.
 
Basis-Pfad: /api/converter
"},{"location":"api/converter/#scan-explorer","title":"Scan & Explorer","text":""},{"location":"api/converter/#get-apiconvertertree","title":"GET /api/converter/tree","text":"
Vollst\u00e4ndiger Verzeichnisbaum des converter_raw_dir (FS-basiert, keine DB).
 
Response:
 
{\n  \"tree\": [\n    {\n      \"name\": \"filme\",\n      \"relPath\": \"filme\",\n      \"isDir\": true,\n      \"children\": [\n        {\n          \"name\": \"film.mkv\",\n          \"relPath\": \"filme/film.mkv\",\n          \"isDir\": false,\n          \"size\": 10485760\n        }\n      ]\n    }\n  ]\n}\n
"},{"location":"api/converter/#get-apiconverterbrowseparentrelpath","title":"GET /api/converter/browse?parent=relPath","text":"
DB-basierter Datei-Explorer. Gibt Eintr\u00e4ge f\u00fcr einen Unterordner zur\u00fcck.
 
Query-Parameter:
 Parameter Typ Beschreibung parent string Relativer Pfad zum Unterordner (leer = Root) 
Response:
 
{\n  \"entries\": [\n    {\n      \"id\": 1,\n      \"rel_path\": \"filme/film.mkv\",\n      \"is_dir\": false,\n      \"size\": 10485760,\n      \"job_id\": null\n    }\n  ],\n  \"rawDir\": \"/data/output/converter-raw\"\n}\n
"},{"location":"api/converter/#post-apiconverterscan","title":"POST /api/converter/scan","text":"
Manuellen Scan des converter_raw_dir ausl\u00f6sen. Aktualisiert converter_scan_entries in der DB.
 
Response:
 
{ \"result\": { \"added\": 3, \"removed\": 1 } }\n
"},{"location":"api/converter/#jobs-erstellen","title":"Jobs erstellen","text":""},{"location":"api/converter/#post-apiconverterjobsfrom-selection","title":"POST /api/converter/jobs/from-selection","text":"
Jobs aus im Datei-Explorer ausgew\u00e4hlten Dateien erstellen.
 
Body:
 
{\n  \"relPaths\": [\"filme/film.mkv\", \"musik/track.flac\"],\n  \"audioMode\": \"individual\"\n}\n
 Feld Typ Beschreibung relPaths string[] Relative Pfade der ausgew\u00e4hlten Dateien audioMode string individual (ein Job pro Datei) oder shared (ein gemeinsamer Job) 
Response:
 
{ \"jobs\": [{ \"id\": 42, \"status\": \"READY_TO_START\" }] }\n
"},{"location":"api/converter/#post-apiconvertercreate-jobs","title":"POST /api/converter/create-jobs","text":"
Jobs aus DB-Scan-Eintr\u00e4gen erstellen.
 
Body:
 
{\n  \"entries\": [\n    { \"relPath\": \"filme/film.mkv\", \"converterMediaType\": \"video\" }\n  ]\n}\n
"},{"location":"api/converter/#post-apiconverterupload","title":"POST /api/converter/upload","text":"
Dateien hochladen (Multipart, max. 50 Dateien).
 
Form-Felder:
 Feld Typ Beschreibung files File[] Hochzuladende Dateien folderName string (Optional) Ziel-Unterordner 
Response:
 
{\n  \"folders\": [{ \"folderRelPath\": \"upload-2026-03-30\", \"fileCount\": 2 }]\n}\n
"},{"location":"api/converter/#job-verwaltung","title":"Job-Verwaltung","text":""},{"location":"api/converter/#get-apiconverterjobs","title":"GET /api/converter/jobs","text":"
Alle Converter-Jobs zur\u00fcckgeben.
 
Response:
 
{ \"jobs\": [{ \"id\": 42, \"status\": \"READY_TO_START\", \"title\": \"film.mkv\" }] }\n
"},{"location":"api/converter/#get-apiconverterjobsjobid","title":"GET /api/converter/jobs/:jobId","text":"
Einzelnen Converter-Job abrufen.
"},{"location":"api/converter/#post-apiconverterjobsjobidconfig","title":"POST /api/converter/jobs/:jobId/config","text":"
Konfigurationsentwurf f\u00fcr einen Job speichern (persistiert in encode_plan_json).
 
Body: Partielles Konfig-Objekt (Ausgabeformat, Presets, Metadaten, Track-Auswahl).
"},{"location":"api/converter/#post-apiconverterjobsjobidassign-files","title":"POST /api/converter/jobs/:jobId/assign-files","text":"
Dateien einem bestehenden (noch nicht gestarteten) Job hinzuf\u00fcgen.
 
Body:
 
{ \"relPaths\": [\"musik/track2.flac\"] }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidremove-file","title":"POST /api/converter/jobs/:jobId/remove-file","text":"
Datei aus einem Job entfernen (per relativer Pfad).
 
Body:
 
{ \"relPath\": \"musik/track2.flac\" }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidremove-input","title":"POST /api/converter/jobs/:jobId/remove-input","text":"
Datei aus einem Job entfernen (per absolutem Eingabepfad).
 
Body:
 
{ \"inputPath\": \"/data/output/converter-raw/musik/track2.flac\" }\n
"},{"location":"api/converter/#post-apiconverterjobsjobidstart","title":"POST /api/converter/jobs/:jobId/start","text":"
Job mit finaler Konfiguration starten.
 
Body:
 
{\n  \"converterMediaType\": \"video\",\n  \"outputFormat\": \"mkv\",\n  \"userPreset\": \"H.264 MKV 1080p30\",\n  \"trackSelection\": {},\n  \"handBrakeTitleId\": 1,\n  \"audioFormatOptions\": {}\n}\n
"},{"location":"api/converter/#post-apiconverterjobsjobidcancel","title":"POST /api/converter/jobs/:jobId/cancel","text":"
Laufenden Job abbrechen.
"},{"location":"api/converter/#delete-apiconverterjobsjobid","title":"DELETE /api/converter/jobs/:jobId","text":"
Job aus der DB l\u00f6schen.
"},{"location":"api/converter/#datei-operationen","title":"Datei-Operationen","text":"
Alle Datei-Operationen arbeiten direkt auf dem Dateisystem (ohne DB-Aktualisierung). Ein anschlie\u00dfender Scan-Aufruf synchronisiert die DB.
"},{"location":"api/converter/#delete-apiconverterfiles","title":"DELETE /api/converter/files","text":"
Datei oder Ordner l\u00f6schen.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\" }\n
"},{"location":"api/converter/#post-apiconverterfilesrename","title":"POST /api/converter/files/rename","text":"
Datei oder Ordner umbenennen.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\", \"newName\": \"film-neu.mkv\" }\n
"},{"location":"api/converter/#post-apiconverterfilesmove","title":"POST /api/converter/files/move","text":"
Datei oder Ordner verschieben.
 
Body:
 
{ \"relPath\": \"filme/film.mkv\", \"targetParentRelPath\": \"archiv\" }\n
 
targetParentRelPath = \"\" verschiebt in das Root-Verzeichnis.
"},{"location":"api/converter/#post-apiconverterfilesfolder","title":"POST /api/converter/files/folder","text":"
Neuen Ordner anlegen.
 
Body:
 
{ \"parentRelPath\": \"filme\", \"name\": \"neu\" }\n
"},{"location":"api/crons/","title":"Cron API","text":"
Ripster enth\u00e4lt ein eingebautes Cron-System f\u00fcr Skripte und Skript-Ketten (sourceType: script|chain).
"},{"location":"api/crons/#get-apicrons","title":"GET /api/crons","text":"
Listet alle Cron-Jobs.
 
{\n  \"jobs\": [\n    {\n      \"id\": 1,\n      \"name\": \"Nachtlauf Backup\",\n      \"cronExpression\": \"0 2 * * *\",\n      \"sourceType\": \"script\",\n      \"sourceId\": 3,\n      \"sourceName\": \"Backup-Skript\",\n      \"enabled\": true,\n      \"pushoverEnabled\": true,\n      \"lastRunAt\": \"2026-03-10T02:00:00.000Z\",\n      \"lastRunStatus\": \"success\",\n      \"nextRunAt\": \"2026-03-11T02:00:00.000Z\",\n      \"createdAt\": \"2026-03-01T10:00:00.000Z\",\n      \"updatedAt\": \"2026-03-10T02:00:05.000Z\"\n    }\n  ]\n}\n
"},{"location":"api/crons/#post-apicrons","title":"POST /api/crons","text":"
Erstellt Cron-Job.
 
{\n  \"name\": \"Nachtlauf Backup\",\n  \"cronExpression\": \"0 2 * * *\",\n  \"sourceType\": \"script\",\n  \"sourceId\": 3,\n  \"enabled\": true,\n  \"pushoverEnabled\": true\n}\n
 
Response: 201 mit { \"job\": { ... } }
"},{"location":"api/crons/#get-apicronsid","title":"GET /api/crons/:id","text":"
Response:
 
{ \"job\": { \"id\": 1, \"name\": \"...\" } }\n
"},{"location":"api/crons/#put-apicronsid","title":"PUT /api/crons/:id","text":"
Aktualisiert Cron-Job. Felder wie bei POST.
 
Response:
 
{ \"job\": { ... } }\n
"},{"location":"api/crons/#delete-apicronsid","title":"DELETE /api/crons/:id","text":"
Response:
 
{ \"removed\": { \"id\": 1, \"name\": \"Nachtlauf Backup\" } }\n
"},{"location":"api/crons/#get-apicronsidlogs","title":"GET /api/crons/:id/logs","text":"
Liefert Ausf\u00fchrungs-Logs.
 
Query-Parameter:
 Parameter Typ Default Beschreibung limit number 20 Anzahl Eintr\u00e4ge, max. 100 
Response:
 
{\n  \"logs\": [\n    {\n      \"id\": 42,\n      \"cronJobId\": 1,\n      \"startedAt\": \"2026-03-10T02:00:01.000Z\",\n      \"finishedAt\": \"2026-03-10T02:00:05.000Z\",\n      \"status\": \"success\",\n      \"output\": \"Backup abgeschlossen.\",\n      \"errorMessage\": null\n    }\n  ]\n}\n
 
status: running | success | error
"},{"location":"api/crons/#post-apicronsidrun","title":"POST /api/crons/:id/run","text":"
Triggert Job manuell (asynchron).
 
Response:
 
{ \"triggered\": true, \"cronJobId\": 1 }\n
 
Wenn Job bereits l\u00e4uft: 409.
"},{"location":"api/crons/#post-apicronsvalidate-expression","title":"POST /api/crons/validate-expression","text":"
Validiert 5-Felder-Cron-Ausdruck und berechnet n\u00e4chsten Lauf.
 
Request:
 
{ \"cronExpression\": \"*/15 * * * *\" }\n
 
G\u00fcltige Response:
 
{\n  \"valid\": true,\n  \"nextRunAt\": \"2026-03-10T14:15:00.000Z\"\n}\n
 
Ung\u00fcltige Response:
 
{\n  \"valid\": false,\n  \"error\": \"Cron-Ausdruck muss genau 5 Felder haben (Minute Stunde Tag Monat Wochentag).\",\n  \"nextRunAt\": null\n}\n
"},{"location":"api/crons/#cron-format","title":"Cron-Format","text":"
Ripster unterst\u00fctzt 5 Felder:
 
Minute Stunde Tag Monat Wochentag\n
 
Beispiele:
 
     
  • 0 2 * * * t\u00e4glich 02:00
    •  
  • */15 * * * * alle 15 Minuten
    •  
  • 0 6 * * 1-5 Mo-Fr 06:00
    •  
"},{"location":"api/crons/#websocket-events-zu-cron","title":"WebSocket-Events zu Cron","text":"
     
  • CRON_JOBS_UPDATED bei Create/Update/Delete
    •  
  • CRON_JOB_UPDATED bei Laufzeitstatus (running -> success|error)
    •  
"},{"location":"api/downloads/","title":"Downloads API","text":"
Endpunkte f\u00fcr die Download-Queue. Ausgabedateien aus der Job-Historie k\u00f6nnen als ZIP heruntergeladen werden.
 
Basis-Pfad: /api/downloads
"},{"location":"api/downloads/#get-apidownloads","title":"GET /api/downloads","text":"
Liste aller Download-Eintr\u00e4ge plus Zusammenfassung.
 
Response:
 
{\n  \"items\": [\n    {\n      \"id\": \"dl-42-raw\",\n      \"jobId\": 42,\n      \"target\": \"raw\",\n      \"status\": \"ready\",\n      \"archiveName\": \"Job_42_raw.zip\",\n      \"outputPath\": null,\n      \"createdAt\": \"2026-03-30T10:00:00.000Z\",\n      \"updatedAt\": \"2026-03-30T10:01:00.000Z\",\n      \"errorMessage\": null\n    }\n  ],\n  \"summary\": {\n    \"total\": 3,\n    \"pending\": 1,\n    \"processing\": 0,\n    \"ready\": 1,\n    \"failed\": 1\n  }\n}\n
 
Status-Werte:
 Status Beschreibung pending In der Queue, noch nicht gestartet processing ZIP wird gerade erstellt ready ZIP fertig, Download verf\u00fcgbar failed Fehler bei der Erstellung"},{"location":"api/downloads/#get-apidownloadssummary","title":"GET /api/downloads/summary","text":"
Nur die Zusammenfassung der Download-Queue (ohne Item-Liste).
 
Response:
 
{\n  \"summary\": {\n    \"total\": 3,\n    \"pending\": 1,\n    \"processing\": 0,\n    \"ready\": 1,\n    \"failed\": 1\n  }\n}\n
"},{"location":"api/downloads/#post-apidownloadshistoryjobid","title":"POST /api/downloads/history/:jobId","text":"
Job-Ausgabe in die Download-Queue einreihen.
 
Parameter:
 Parameter Typ Beschreibung jobId number ID des Jobs in der Historie 
Body:
 
{\n  \"target\": \"raw\",\n  \"outputPath\": null\n}\n
 Feld Typ Default Beschreibung target string raw raw (RAW-Dateien) oder movie (Ausgabedateien) outputPath string null Optionaler expliziter Ausgabepfad 
Response (201 Created):
 
{\n  \"created\": true,\n  \"id\": \"dl-42-raw\",\n  \"status\": \"pending\",\n  \"summary\": { \"total\": 1, \"pending\": 1, \"processing\": 0, \"ready\": 0, \"failed\": 0 }\n}\n
 
Ist der Eintrag bereits vorhanden, wird 201 durch 200 ersetzt und created: false zur\u00fcckgegeben.
"},{"location":"api/downloads/#get-apidownloadsidfile","title":"GET /api/downloads/:id/file","text":"
Fertige ZIP-Datei herunterladen.
 
Parameter:
 Parameter Typ Beschreibung id string Download-ID (z. B. dl-42-raw) 
Response: Datei-Download (Content-Disposition: attachment).
 
Schl\u00e4gt fehl mit 404, wenn kein Download-Eintrag mit dieser ID existiert oder die Datei noch nicht bereit ist.
"},{"location":"api/downloads/#delete-apidownloadsid","title":"DELETE /api/downloads/:id","text":"
Download-Eintrag l\u00f6schen (auch fertige ZIP-Dateien werden vom Dateisystem entfernt).
 
Response:
 
{\n  \"ok\": true,\n  \"summary\": { \"total\": 2, \"pending\": 0, \"processing\": 0, \"ready\": 2, \"failed\": 0 }\n}\n
"},{"location":"api/downloads/#websocket","title":"WebSocket","text":"
Status\u00e4nderungen werden \u00fcber DOWNLOADS_UPDATED in Echtzeit gemeldet. Vollst\u00e4ndige Dokumentation: WebSocket Events.
"},{"location":"api/history/","title":"History API","text":"
Endpunkte f\u00fcr Job-Historie, Metadaten-Nachpflege, Orphan-Import und L\u00f6schoperationen.
"},{"location":"api/history/#get-apihistory","title":"GET /api/history","text":"
Liefert Jobs mit optionalen Filtern.
 
Query-Parameter:
 Parameter Typ Beschreibung status string Einzelstatus-Filter (legacy-kompatibel). statuses string Mehrfachstatus als CSV, z. B. FINISHED,ERROR. search string Suche in Titel-/IMDb-Feldern. limit number Maximale Anzahl Ergebnisse. lite bool Ohne Dateisystem-Checks (schneller). includeChildren bool Child-Jobs (z. B. Serien-/Multipart-Kinder) explizit einbeziehen. 
Beispiel:
 
GET /api/history?statuses=FINISHED,ERROR&search=Inception&limit=50&lite=1\n
 
Response (Beispiel):
 
{\n  \"jobs\": [\n    {\n      \"id\": 42,\n      \"status\": \"FINISHED\",\n      \"title\": \"Inception\",\n      \"job_kind\": \"bluray\",\n      \"raw_path\": \"/mnt/raw/Inception - RAW - job-42\",\n      \"output_path\": \"/mnt/movies/Inception (2010)/Inception (2010).mkv\",\n      \"mediaType\": \"bluray\",\n      \"ripSuccessful\": true,\n      \"encodeSuccess\": true,\n      \"created_at\": \"2026-03-10T08:00:00.000Z\",\n      \"updated_at\": \"2026-03-10T10:00:00.000Z\"\n    }\n  ]\n}\n
"},{"location":"api/history/#get-apihistoryid","title":"GET /api/history/:id","text":"
Liefert Job-Detail.
 
Query-Parameter:
 Parameter Typ Standard Beschreibung includeLogs bool false Prozesslog laden. includeLiveLog bool false Live-/Tail-Log laden. includeAllLogs bool false vollst\u00e4ndiges Log statt Tail. logTailLines number 800 Tail-L\u00e4nge falls nicht includeAllLogs. lite bool false Detailantwort ohne FS-Checks. 
Response (Beispiel):
 
{\n  \"job\": {\n    \"id\": 42,\n    \"status\": \"FINISHED\",\n    \"makemkvInfo\": {},\n    \"mediainfoInfo\": {},\n    \"handbrakeInfo\": {},\n    \"encodePlan\": {},\n    \"log\": \"...\",\n    \"log_count\": 1,\n    \"logMeta\": {\n      \"loaded\": true,\n      \"total\": 800,\n      \"returned\": 800,\n      \"truncated\": true\n    }\n  }\n}\n
"},{"location":"api/history/#get-apihistoryorphan-raw","title":"GET /api/history/orphan-raw","text":"
Sucht RAW-Ordner ohne zugeh\u00f6rigen Job.
"},{"location":"api/history/#post-apihistoryorphan-rawimport","title":"POST /api/history/orphan-raw/import","text":"
Importiert einen RAW-Ordner als Job und triggert optional die Analyse des Imports.
 
Request:
 
{ \"rawPath\": \"/mnt/raw/Inception (2010) [tt1375666] - RAW - job-99\" }\n
 
Response (Beispiel):
 
{\n  \"job\": { \"id\": 77, \"status\": \"FINISHED\" },\n  \"activation\": { \"started\": true },\n  \"activationError\": null\n}\n
"},{"location":"api/history/#post-apihistoryidomdbassign","title":"POST /api/history/:id/omdb/assign","text":"
Weist OMDb-/Filmdaten nachtr\u00e4glich zu.
"},{"location":"api/history/#post-apihistoryidcdassign","title":"POST /api/history/:id/cd/assign","text":"
Weist CD-Metadaten (z. B. MusicBrainz) nachtr\u00e4glich zu.
"},{"location":"api/history/#post-apihistoryiderrorack","title":"POST /api/history/:id/error/ack","text":"
Quittiert einen Fehlerzustand im Historieneintrag.
"},{"location":"api/history/#get-apihistoryiddelete-preview","title":"GET /api/history/:id/delete-preview","text":"
Liefert eine Vorschau der l\u00f6schbaren Pfade (inkl. Scope auf verkn\u00fcpfte Jobs).
 
Query-Parameter:
 Parameter Typ Standard Beschreibung includeRelated bool true Verkn\u00fcpfte Jobs in die Vorschau einbeziehen. 
Response (Beispiel):
 
{\n  \"preview\": {\n    \"jobId\": 42,\n    \"relatedJobs\": [{ \"id\": 42 }, { \"id\": 73 }],\n    \"pathCandidates\": {\n      \"raw\": [{ \"path\": \"/mnt/raw/...\", \"exists\": true, \"isDirectory\": true }],\n      \"movie\": [{ \"path\": \"/mnt/movies/...\", \"exists\": true, \"isDirectory\": true }]\n    }\n  }\n}\n
"},{"location":"api/history/#post-apihistoryiddelete-files","title":"POST /api/history/:id/delete-files","text":"
L\u00f6scht Dateien eines Jobs, beh\u00e4lt DB-Eintrag.
 
Request:
 
{\n  \"target\": \"both\",\n  \"includeRelated\": true,\n  \"selectedRawPaths\": [\"/mnt/raw/Inception - RAW - Disc1\"],\n  \"selectedMoviePaths\": [\"/mnt/movies/Inception (2010)\"]\n}\n
 
target: raw | movie | both
 
selectedRawPaths / selectedMoviePaths sind optional und begrenzen die L\u00f6schung auf ausgew\u00e4hlte Pfade aus der Vorschau.
"},{"location":"api/history/#post-apihistoryiddelete","title":"POST /api/history/:id/delete","text":"
L\u00f6scht Job aus DB; optional auch Dateien.
 
Request:
 
{\n  \"target\": \"both\",\n  \"includeRelated\": true,\n  \"resetDriveState\": false,\n  \"keepDetectedDevice\": true,\n  \"preserveRawForImportJobs\": false,\n  \"selectedRawPaths\": [\"/mnt/raw/Inception - RAW - Disc1\"],\n  \"selectedMoviePaths\": [\"/mnt/movies/Inception (2010)\"]\n}\n
 
target: none | raw | movie | both
 
Response (Beispiel):
 
{\n  \"deleted\": true,\n  \"jobId\": 42,\n  \"fileTarget\": \"both\",\n  \"fileSummary\": {\n    \"target\": \"both\",\n    \"raw\": { \"filesDeleted\": 10 },\n    \"movie\": { \"filesDeleted\": 1 }\n  },\n  \"uiReset\": {\n    \"reset\": true,\n    \"state\": \"IDLE\"\n  },\n  \"safeguards\": {\n    \"containsOrphanRawImportJob\": false,\n    \"resetDriveStateApplied\": false,\n    \"keepDetectedDeviceApplied\": true\n  }\n}\n
"},{"location":"api/history/#hinweise","title":"Hinweise","text":"
     
  • Ein aktiver Pipeline-Job kann nicht gel\u00f6scht werden (409).
    •  
  • L\u00f6schoperationen sind irreversibel.
    •  
  • Bei Serien-/Multipart-Containern steuern includeRelated und Pfadselektionen den genauen Scope.
    •  
"},{"location":"api/pipeline/","title":"Pipeline API","text":"
Endpunkte zur Steuerung des Pipeline-Workflows.
"},{"location":"api/pipeline/#get-apipipelinestate","title":"GET /api/pipeline/state","text":"
Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.
 
Response (Beispiel):
 
{\n  \"pipeline\": {\n    \"state\": \"READY_TO_ENCODE\",\n    \"activeJobId\": 42,\n    \"progress\": 0,\n    \"eta\": null,\n    \"statusText\": \"Mediainfo best\u00e4tigt - Encode manuell starten\",\n    \"context\": {\n      \"jobId\": 42\n    },\n    \"jobProgress\": {\n      \"42\": {\n        \"state\": \"MEDIAINFO_CHECK\",\n        \"progress\": 68.5,\n        \"eta\": null,\n        \"statusText\": \"MEDIAINFO_CHECK 68.50%\"\n      }\n    },\n    \"queue\": {\n      \"maxParallelJobs\": 1,\n      \"runningCount\": 1,\n      \"queuedCount\": 2,\n      \"runningJobs\": [],\n      \"queuedJobs\": []\n    }\n  },\n  \"hardwareMonitoring\": {\n    \"enabled\": true,\n    \"intervalMs\": 5000,\n    \"updatedAt\": \"2026-03-10T09:00:00.000Z\",\n    \"sample\": {\n      \"cpu\": {},\n      \"memory\": {},\n      \"gpu\": {},\n      \"storage\": {}\n    },\n    \"error\": null\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelineanalyze","title":"POST /api/pipeline/analyze","text":"
Startet Disc-Analyse und legt Job an.
 
Response:
 
{\n  \"result\": {\n    \"jobId\": 42,\n    \"detectedTitle\": \"INCEPTION\",\n    \"omdbCandidates\": []\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinerescan-disc","title":"POST /api/pipeline/rescan-disc","text":"
Erzwingt erneute Laufwerkspr\u00fcfung.
 
Response (Beispiel):
 
{\n  \"result\": {\n    \"present\": true,\n    \"changed\": true,\n    \"emitted\": \"discInserted\",\n    \"device\": {\n      \"path\": \"/dev/sr0\",\n      \"discLabel\": \"INCEPTION\",\n      \"mediaProfile\": \"bluray\"\n    }\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinerescan-drive","title":"POST /api/pipeline/rescan-drive","text":"
Erzwingt Rescan f\u00fcr ein konkretes Laufwerk.
 
Request:
 
{ \"devicePath\": \"/dev/sr0\" }\n
"},{"location":"api/pipeline/#get-apipipelineomdbsearchq","title":"GET /api/pipeline/omdb/search?q= 
OMDb-Titelsuche.
 
Response:
 
{\n  \"results\": [\n    {\n      \"imdbId\": \"tt1375666\",\n      \"title\": \"Inception\",\n      \"year\": \"2010\",\n      \"type\": \"movie\",\n      \"poster\": \"https://...\"\n    }\n  ]\n}\n
","text":""},{"location":"api/pipeline/#get-apipipelinetmdbseriessearchqseason","title":"GET /api/pipeline/tmdb/series/search?q=&season= 
TMDb-Seriensuche (f\u00fcr Serien-Workflow bei DVD/Blu-ray).
","text":""},{"location":"api/pipeline/#get-apipipelinecddrives","title":"GET /api/pipeline/cd/drives 
Liefert Snapshot der aktuell bekannten CD-Laufwerke.
","text":""},{"location":"api/pipeline/#get-apipipelinecdmusicbrainzsearchq","title":"GET /api/pipeline/cd/musicbrainz/search?q= 
MusicBrainz-Suche f\u00fcr CD-Metadaten.
","text":""},{"location":"api/pipeline/#get-apipipelinecdmusicbrainzreleasembid","title":"GET /api/pipeline/cd/musicbrainz/release/:mbId 
L\u00e4dt Release-Details zu einer MusicBrainz-ID.
","text":""},{"location":"api/pipeline/#post-apipipelinecdselect-metadata","title":"POST /api/pipeline/cd/select-metadata 
\u00dcbernimmt CD-Metadaten f\u00fcr einen Job.
 
Request (Beispiel):
 
{\n  \"jobId\": 91,\n  \"title\": \"Album\",\n  \"artist\": \"Artist\",\n  \"year\": 2020,\n  \"mbId\": \"f5093c06-23e3-404f-aeaa-40f72885ee3a\",\n  \"coverUrl\": \"https://...\",\n  \"tracks\": []\n}\n
","text":""},{"location":"api/pipeline/#post-apipipelinecdstartjobid","title":"POST /api/pipeline/cd/start/:jobId 
Startet/queued CD-Rip mit Format-/Script-/Chain-Konfiguration.
","text":""},{"location":"api/pipeline/#post-apipipelineaudiobookupload","title":"POST /api/pipeline/audiobook/upload 
Upload von AAX-Datei (Multipart/FormData).
 
FormData-Felder:
 
     
  • file (Pflicht)
    •  
  • format (optional)
    •  
  • startImmediately (optional)
    •  
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookpending-activation","title":"GET /api/pipeline/audiobook/pending-activation 
Zeigt AAX-Jobs mit fehlenden Activation-Bytes.
","text":""},{"location":"api/pipeline/#post-apipipelineaudiobookstartjobid","title":"POST /api/pipeline/audiobook/start/:jobId 
Startet Audiobook-Job mit optionaler Konfiguration.
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookjobs","title":"GET /api/pipeline/audiobook/jobs 
Liefert Audiobook-Jobliste.
","text":""},{"location":"api/pipeline/#get-apipipelineaudiobookoutput-tree","title":"GET /api/pipeline/audiobook/output-tree 
Read-only Baumansicht des Audiobook-Ausgabeordners.
","text":""},{"location":"api/pipeline/#post-apipipelineselect-metadata","title":"POST /api/pipeline/select-metadata 
Setzt Metadaten (und optional Playlist) f\u00fcr einen Job.
 
Request:
 
{\n  \"jobId\": 42,\n  \"title\": \"Inception\",\n  \"year\": 2010,\n  \"imdbId\": \"tt1375666\",\n  \"poster\": \"https://...\",\n  \"fromOmdb\": true,\n  \"selectedPlaylist\": \"00800\"\n}\n
 
Wichtige optionale Felder:
 
     
  • selectedHandBrakeTitleId / selectedHandBrakeTitleIds: Titel-Auswahl f\u00fcr Review/MediaInfo.
    •  
  • metadataProvider: omdb oder tmdb.
    •  
  • workflowKind: bei Disc-Jobs typischerweise film oder series.
    •  
  • discNumber: Pflicht f\u00fcr Serien-Disc-Zuordnung (workflowKind=series).
    •  
  • duplicateAction: Duplikatverhalten bei Film-Metadaten (allow_new oder multipart_movie).
    •  
  • existingJobId: optionaler Referenzjob f\u00fcr multipart_movie.
    •  
  • existingDiscNumber: Disc-Nummer des bestehenden Jobs f\u00fcr multipart_movie.
    •  
 
Response:
 
{ \"job\": { \"id\": 42, \"status\": \"READY_TO_START\" } }\n
 
Konflikt-Response (Beispiel, HTTP 409):
 
{\n  \"message\": \"Metadaten bereits in der Historie gefunden. Bitte Auswahl \u00fcbernehmen oder Multipart movie w\u00e4hlen.\",\n  \"details\": [\n    {\n      \"code\": \"METADATA_DUPLICATE_FOUND\",\n      \"mediaProfile\": \"bluray\",\n      \"existingJob\": {\n        \"id\": 17,\n        \"title\": \"Inception\",\n        \"year\": 2010,\n        \"status\": \"FINISHED\",\n        \"jobKind\": \"bluray\",\n        \"discNumber\": 1,\n        \"isMultipartMovie\": false\n      }\n    }\n  ]\n}\n
 
Relevante Fehlercodes (POST /api/pipeline/select-metadata):
    Code Bedeutung     METADATA_DUPLICATE_FOUND Film-Metadaten existieren bereits in der Historie (Konfliktdialog im UI).   MULTIPART_DISC_REQUIRED F\u00fcr Multipart fehlen Disc-Nummern (discNumber/existingDiscNumber).   MULTIPART_DISC_ALREADY_EXISTS Disc-Nummer im Multipart-Container bereits vergeben oder doppelt.   MULTIPART_MEDIA_MISMATCH Multipart nur bei gleichem Medientyp (DVD oder Blu-ray).   MULTIPART_SERIES_NOT_ALLOWED Multipart ist nur f\u00fcr Film-Jobs erlaubt, nicht f\u00fcr Serien-Workflow.   MULTIPART_METADATA_MISMATCH Ausgew\u00e4hlter bestehender Job passt nicht zu den Film-Metadaten.   SERIES_DISC_ALREADY_EXISTS Serien-Disc-Nummer innerhalb einer Staffel bereits vorhanden.","text":""},{"location":"api/pipeline/#post-apipipelinejobsjobidraw-decision","title":"POST /api/pipeline/jobs/:jobId/raw-decision 
Trifft Entscheidung bei vorhandenem RAW (continue oder restart je nach Dialogfluss).
 
Request:
 
{ \"decision\": \"continue\" }\n
","text":""},{"location":"api/pipeline/#post-apipipelinestartjobid","title":"POST /api/pipeline/start/:jobId 
Startet vorbereiteten Job oder queued ihn (je nach Parallel-Limit).
 
M\u00f6gliche Responses:
 
{ \"result\": { \"started\": true, \"stage\": \"RIPPING\" } }\n
 
{ \"result\": { \"queued\": true, \"started\": false, \"queuePosition\": 2, \"action\": \"START_PREPARED\" } }\n
","text":""},{"location":"api/pipeline/#post-apipipelineconfirm-encodejobid","title":"POST /api/pipeline/confirm-encode/:jobId 
Best\u00e4tigt Review-Auswahl (Tracks, Pre/Post-Skripte/Ketten, User-Preset).
 
Request (typisch):
 
{\n  \"selectedEncodeTitleId\": 1,\n  \"selectedTrackSelection\": {\n    \"1\": {\n      \"audioTrackIds\": [1, 2],\n      \"subtitleTrackIds\": [3]\n    }\n  },\n  \"selectedPreEncodeScriptIds\": [1],\n  \"selectedPostEncodeScriptIds\": [2, 7],\n  \"selectedPreEncodeChainIds\": [3],\n  \"selectedPostEncodeChainIds\": [4],\n  \"selectedUserPresetId\": 5,\n  \"skipPipelineStateUpdate\": false\n}\n
 
Response:
 
{ \"job\": { \"id\": 42, \"encode_review_confirmed\": 1 } }\n
","text":""},{"location":"api/pipeline/#post-apipipelinecancel","title":"POST /api/pipeline/cancel 
Bricht laufenden Job ab oder entfernt Queue-Eintrag.
 
Request (optional):
 
{ \"jobId\": 42 }\n
 
M\u00f6gliche Responses:
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": true, \"jobId\": 42 } }\n
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": false, \"jobId\": 42 } }\n
 
{ \"result\": { \"cancelled\": true, \"queuedOnly\": false, \"pending\": true, \"jobId\": 42 } }\n
","text":""},{"location":"api/pipeline/#post-apipipelineretryjobid","title":"POST /api/pipeline/retry/:jobId 
Retry f\u00fcr ERROR/CANCELLED-Jobs (oder Queue-Einreihung).
","text":""},{"location":"api/pipeline/#post-apipipelinereencodejobid","title":"POST /api/pipeline/reencode/:jobId 
Startet Re-Encode aus bestehendem RAW.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-reviewjobid","title":"POST /api/pipeline/restart-review/:jobId 
Berechnet Review aus RAW neu.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-encodejobid","title":"POST /api/pipeline/restart-encode/:jobId 
Startet Encoding mit letzter best\u00e4tigter Review neu.
","text":""},{"location":"api/pipeline/#post-apipipelinerestart-cd-reviewjobid","title":"POST /api/pipeline/restart-cd-review/:jobId 
Berechnet CD-Review aus vorhandenem RAW neu.
","text":""},{"location":"api/pipeline/#post-apipipelineresume-readyjobid","title":"POST /api/pipeline/resume-ready/:jobId 
L\u00e4dt READY_TO_ENCODE-Job nach Neustart wieder in aktive Session.
","text":""},{"location":"api/pipeline/#get-apipipelineoutput-foldersjobid","title":"GET /api/pipeline/output-folders/:jobId 
Liefert bekannte Output-Ordner entlang der Job-Lineage.
","text":""},{"location":"api/pipeline/#post-apipipelinedelete-output-foldersjobid","title":"POST /api/pipeline/delete-output-folders/:jobId 
L\u00f6scht ausgew\u00e4hlte Output-Ordner.
 
Request:
 
{ \"folderPaths\": [\"/mnt/movies/Inception (2010)\"] }\n
 
Alle Endpunkte liefern { result: ... } bzw. { job: ... }.
","text":""},{"location":"api/pipeline/#queue-endpunkte","title":"Queue-Endpunkte","text":""},{"location":"api/pipeline/#get-apipipelinequeue","title":"GET /api/pipeline/queue","text":"
Liefert Queue-Snapshot.
 
{\n  \"queue\": {\n    \"maxParallelJobs\": 1,\n    \"runningCount\": 1,\n    \"queuedCount\": 3,\n    \"runningJobs\": [\n      {\n        \"jobId\": 41,\n        \"title\": \"Inception\",\n        \"status\": \"ENCODING\",\n        \"lastState\": \"ENCODING\"\n      }\n    ],\n    \"queuedJobs\": [\n      {\n        \"entryId\": 11,\n        \"position\": 1,\n        \"type\": \"job\",\n        \"jobId\": 42,\n        \"action\": \"START_PREPARED\",\n        \"actionLabel\": \"Start\",\n        \"title\": \"Matrix\",\n        \"status\": \"READY_TO_ENCODE\",\n        \"lastState\": \"READY_TO_ENCODE\",\n        \"hasScripts\": true,\n        \"hasChains\": false,\n        \"enqueuedAt\": \"2026-03-10T09:00:00.000Z\"\n      },\n      {\n        \"entryId\": 12,\n        \"position\": 2,\n        \"type\": \"wait\",\n        \"waitSeconds\": 30,\n        \"title\": \"Warten 30s\",\n        \"status\": \"QUEUED\",\n        \"enqueuedAt\": \"2026-03-10T09:01:00.000Z\"\n      }\n    ],\n    \"updatedAt\": \"2026-03-10T09:01:02.000Z\"\n  }\n}\n
"},{"location":"api/pipeline/#post-apipipelinequeuereorder","title":"POST /api/pipeline/queue/reorder","text":"
Sortiert Queue-Eintr\u00e4ge neu.
 
Request:
 
{\n  \"orderedEntryIds\": [12, 11]\n}\n
 
Legacy fallback wird akzeptiert:
 
{\n  \"orderedJobIds\": [42, 43]\n}\n
"},{"location":"api/pipeline/#post-apipipelinequeueentry","title":"POST /api/pipeline/queue/entry","text":"
F\u00fcgt Nicht-Job-Queue-Eintrag hinzu (script, chain, wait).
 
Request-Beispiele:
 
{ \"type\": \"script\", \"scriptId\": 3 }\n
 
{ \"type\": \"chain\", \"chainId\": 2, \"insertAfterEntryId\": 11 }\n
 
{ \"type\": \"wait\", \"waitSeconds\": 45 }\n
 
Response:
 
{\n  \"result\": { \"entryId\": 12, \"type\": \"wait\", \"position\": 2 },\n  \"queue\": { \"...\": \"...\" }\n}\n
"},{"location":"api/pipeline/#delete-apipipelinequeueentryentryid","title":"DELETE /api/pipeline/queue/entry/:entryId","text":"
Entfernt Queue-Eintrag.
 
Response:
 
{ \"queue\": { \"...\": \"...\" } }\n
"},{"location":"api/pipeline/#pipeline-zustande","title":"Pipeline-Zust\u00e4nde    State Bedeutung     IDLE Wartet auf Medium   DISC_DETECTED Medium erkannt   ANALYZING MakeMKV-Analyse l\u00e4uft   METADATA_SELECTION Metadaten-Auswahl   WAITING_FOR_USER_DECISION Nutzerentscheidung erforderlich (Playlist-Auswahl oder RAW-Entscheidung)   READY_TO_START \u00dcbergang vor Start   RIPPING MakeMKV-Rip l\u00e4uft   MEDIAINFO_CHECK Titel-/Track-Auswertung   READY_TO_ENCODE Review bereit   ENCODING HandBrake-Encoding l\u00e4uft   CD_METADATA_SELECTION CD-Metadatenauswahl aktiv   CD_READY_TO_RIP CD-Job ist startbereit   CD_ANALYZING CD-Struktur/Tracks werden vorbereitet   CD_RIPPING CD-Ripping l\u00e4uft   CD_ENCODING CD-Encode l\u00e4uft   FINISHED Abgeschlossen   DONE Abgeschlossen (v. a. Audiobook/Converter/CD-Varianten)   CANCELLED Abgebrochen   ERROR Fehler","text":""},{"location":"api/runtime-activities/","title":"Runtime Activities API","text":"
Ripster verfolgt alle laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten (Skripte, Skript-Ketten, Cron-Jobs, interne Tasks) in Echtzeit \u00fcber den RuntimeActivityService.
"},{"location":"api/runtime-activities/#ubersicht","title":"\u00dcbersicht","text":"
Aktivit\u00e4ten entstehen, wenn Ripster intern Aktionen ausf\u00fchrt \u2013 z. B. beim Start eines Cron-Jobs, beim Ausf\u00fchren einer Skript-Kette oder beim Durchlaufen von Pipeline-Schritten. Sie sind nicht persistent (kein DB-Speicher) und werden nur im Arbeitsspeicher gehalten.
 
     
  • Aktive Aktivit\u00e4ten (active): Laufen gerade.
    •  
  • Letzte Aktivit\u00e4ten (recent): Abgeschlossen, max. 120 Eintr\u00e4ge.
    •  
 
\u00c4nderungen werden \u00fcber WebSocket (RUNTIME_ACTIVITY_CHANGED) in Echtzeit gesendet.
"},{"location":"api/runtime-activities/#aktivitats-objekt","title":"Aktivit\u00e4ts-Objekt","text":"
{\n  \"id\": 7,\n  \"type\": \"chain\",\n  \"name\": \"Post-Encode Aufr\u00e4umen\",\n  \"status\": \"running\",\n  \"source\": \"cron\",\n  \"message\": \"Schritt 2 von 3\",\n  \"currentStep\": \"cleanup.sh\",\n  \"currentStepType\": \"script\",\n  \"currentScriptName\": \"cleanup.sh\",\n  \"stepIndex\": 2,\n  \"stepTotal\": 3,\n  \"parentActivityId\": null,\n  \"jobId\": 42,\n  \"cronJobId\": 3,\n  \"chainId\": 5,\n  \"scriptId\": null,\n  \"canCancel\": true,\n  \"canNextStep\": false,\n  \"outcome\": \"running\",\n  \"errorMessage\": null,\n  \"output\": null,\n  \"stdout\": null,\n  \"stderr\": null,\n  \"stdoutTruncated\": false,\n  \"stderrTruncated\": false,\n  \"startedAt\": \"2026-03-10T10:00:00.000Z\",\n  \"finishedAt\": null,\n  \"durationMs\": null,\n  \"exitCode\": null,\n  \"success\": null\n}\n
"},{"location":"api/runtime-activities/#felder","title":"Felder","text":"Feld Typ Beschreibung id number Eindeutige ID (Laufz\u00e4hler, nicht persistent) type string Art der Aktivit\u00e4t: script | chain | cron | task name string \\| null Anzeigename der Aktivit\u00e4t status string Aktueller Status: running | success | error source string \\| null Ausl\u00f6ser (z. B. cron, pipeline, manual) message string \\| null Kurztext zum aktuellen Zustand currentStep string \\| null Name des aktuell ausgef\u00fchrten Schritts currentStepType string \\| null Typ des Schritts (z. B. script, wait) currentScriptName string \\| null Name des Skripts im aktuellen Schritt stepIndex number \\| null Aktueller Schritt (1-basiert) stepTotal number \\| null Gesamtanzahl Schritte parentActivityId number \\| null ID der \u00fcbergeordneten Aktivit\u00e4t jobId number \\| null Verkn\u00fcpfte Job-ID cronJobId number \\| null Verkn\u00fcpfte Cron-Job-ID chainId number \\| null Verkn\u00fcpfte Skript-Ketten-ID scriptId number \\| null Verkn\u00fcpfte Skript-ID canCancel boolean Abbrechen \u00fcber API m\u00f6glich canNextStep boolean N\u00e4chster Schritt \u00fcber API ausl\u00f6sbar outcome string \\| null Abschluss-Ergebnis: success | error | cancelled | skipped | running errorMessage string \\| null Fehlermeldung (max. 2.000 Zeichen) output string \\| null Allgemeine Ausgabe (max. 12.000 Zeichen) stdout string \\| null Standardausgabe des Prozesses (max. 12.000 Zeichen) stderr string \\| null Fehlerausgabe des Prozesses (max. 12.000 Zeichen) stdoutTruncated boolean true, wenn stdout gek\u00fcrzt wurde stderrTruncated boolean true, wenn stderr gek\u00fcrzt wurde startedAt string ISO-8601-Zeitstempel des Starts finishedAt string \\| null ISO-8601-Zeitstempel des Endes durationMs number \\| null Laufzeit in Millisekunden exitCode number \\| null Exit-Code des Prozesses success boolean \\| null Erfolgsstatus (null bei laufender Aktivit\u00e4t)"},{"location":"api/runtime-activities/#snapshot-objekt","title":"Snapshot-Objekt","text":"
Alle Aktivit\u00e4ts-Endpunkte geben einen Snapshot zur\u00fcck:
 
{\n  \"active\": [ /* laufende Aktivit\u00e4ten, nach startedAt absteigend */ ],\n  \"recent\": [ /* abgeschlossene Aktivit\u00e4ten, nach finishedAt absteigend, max. 120 */ ],\n  \"updatedAt\": \"2026-03-10T10:05:00.000Z\"\n}\n
"},{"location":"api/runtime-activities/#endpunkte","title":"Endpunkte","text":""},{"location":"api/runtime-activities/#get-apiruntimeactivities","title":"GET /api/runtime/activities","text":"
Aktuellen Aktivit\u00e4ts-Snapshot abrufen.
 
Antwort:
 
{\n  \"active\": [],\n  \"recent\": [\n    {\n      \"id\": 5,\n      \"type\": \"script\",\n      \"name\": \"notify.sh\",\n      \"status\": \"success\",\n      \"outcome\": \"success\",\n      \"startedAt\": \"2026-03-10T09:58:00.000Z\",\n      \"finishedAt\": \"2026-03-10T09:58:02.000Z\",\n      \"durationMs\": 2100,\n      \"exitCode\": 0,\n      \"success\": true,\n      \"canCancel\": false,\n      \"canNextStep\": false\n    }\n  ],\n  \"updatedAt\": \"2026-03-10T10:05:00.000Z\"\n}\n
"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesidcancel","title":"POST /api/runtime/activities/:id/cancel","text":"
Aktive Aktivit\u00e4t abbrechen (nur wenn canCancel: true).
 
Parameter:
 Name In Typ Beschreibung id path number Aktivit\u00e4ts-ID reason body string Optionaler Abbruchgrund 
Request Body:
 
{ \"reason\": \"Manueller Abbruch durch Benutzer\" }\n
 
Antwort (Erfolg):
 
{\n  \"ok\": true,\n  \"action\": null,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
 
Fehlercodes:
 HTTP Bedeutung 404 Aktivit\u00e4t nicht gefunden oder bereits abgeschlossen 409 Abbrechen wird von dieser Aktivit\u00e4t nicht unterst\u00fctzt"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesidnext-step","title":"POST /api/runtime/activities/:id/next-step","text":"
N\u00e4chsten Schritt einer Aktivit\u00e4t ausl\u00f6sen (nur wenn canNextStep: true).
 
Parameter:
 Name In Typ Beschreibung id path number Aktivit\u00e4ts-ID 
Antwort (Erfolg):
 
{\n  \"ok\": true,\n  \"action\": null,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
 
Fehlercodes:
 HTTP Bedeutung 404 Aktivit\u00e4t nicht gefunden 409 N\u00e4chster Schritt wird von dieser Aktivit\u00e4t nicht unterst\u00fctzt"},{"location":"api/runtime-activities/#post-apiruntimeactivitiesclear-recent","title":"POST /api/runtime/activities/clear-recent","text":"
Alle abgeschlossenen Aktivit\u00e4ten aus recent l\u00f6schen.
 
Antwort:
 
{\n  \"ok\": true,\n  \"removed\": 14,\n  \"snapshot\": { \"active\": [], \"recent\": [], \"updatedAt\": \"...\" }\n}\n
"},{"location":"api/runtime-activities/#grenzwerte","title":"Grenzwerte","text":"Wert Limit Maximale recent-Eintr\u00e4ge 120 Maximale L\u00e4nge stdout / stderr / output 12.000 Zeichen Maximale L\u00e4nge errorMessage / message 2.000 Zeichen Maximale L\u00e4nge outcome 40 Zeichen 
Gek\u00fcrzte Ausgaben erhalten den Suffix ...[gek\u00fcrzt] (bei Inline-Text) bzw. \\n...[gek\u00fcrzt] (bei mehrzeiligem Output).
"},{"location":"api/runtime-activities/#echtzeit-updates","title":"Echtzeit-Updates","text":"
\u00c4nderungen werden automatisch als RUNTIME_ACTIVITY_CHANGED WebSocket-Event gesendet. Die Frontend-Komponente braucht GET /api/runtime/activities nur beim initialen Laden aufzurufen.
"},{"location":"api/settings/","title":"Settings API","text":"
Endpunkte f\u00fcr Einstellungen, Skripte, Skript-Ketten und User-Presets.
"},{"location":"api/settings/#get-apisettings","title":"GET /api/settings","text":"
Liefert alle Einstellungen kategorisiert.
 
Response (Struktur):
 
{\n  \"categories\": [\n    {\n      \"category\": \"Pfade\",\n      \"settings\": [\n        {\n          \"key\": \"raw_dir\",\n          \"label\": \"Raw Ausgabeordner\",\n          \"type\": \"path\",\n          \"required\": true,\n          \"description\": \"...\",\n          \"defaultValue\": \"data/output/raw\",\n          \"options\": [],\n          \"validation\": { \"minLength\": 1 },\n          \"value\": \"data/output/raw\",\n          \"orderIndex\": 100\n        }\n      ]\n    }\n  ]\n}\n
"},{"location":"api/settings/#put-apisettingskey","title":"PUT /api/settings/:key","text":"
Aktualisiert eine einzelne Einstellung.
 
Request:
 
{ \"value\": \"/mnt/storage/raw\" }\n
 
Response:
 
{\n  \"setting\": {\n    \"key\": \"raw_dir\",\n    \"value\": \"/mnt/storage/raw\"\n  },\n  \"reviewRefresh\": {\n    \"triggered\": false,\n    \"reason\": \"not_ready\"\n  }\n}\n
 
reviewRefresh ist null oder ein Objekt mit Status der optionalen Review-Neuberechnung.
"},{"location":"api/settings/#put-apisettings","title":"PUT /api/settings","text":"
Aktualisiert mehrere Einstellungen atomar.
 
Request:
 
{\n  \"settings\": {\n    \"raw_dir\": \"/mnt/storage/raw\",\n    \"movie_dir\": \"/mnt/storage/movies\",\n    \"handbrake_preset_bluray\": \"H.264 MKV 1080p30\"\n  }\n}\n
 
Response:
 
{\n  \"changes\": [\n    { \"key\": \"raw_dir\", \"value\": \"/mnt/storage/raw\" },\n    { \"key\": \"movie_dir\", \"value\": \"/mnt/storage/movies\" }\n  ],\n  \"reviewRefresh\": {\n    \"triggered\": true,\n    \"jobId\": 42,\n    \"relevantKeys\": [\"handbrake_preset_bluray\"]\n  }\n}\n
 
Bei Validierungsfehlern kommt 400 mit error.details[].
"},{"location":"api/settings/#get-apisettingshandbrake-presets","title":"GET /api/settings/handbrake-presets","text":"
Liest Preset-Liste via HandBrakeCLI -z (mit Fallback auf konfigurierte Presets).
 
Response (Beispiel):
 
{\n  \"source\": \"handbrake-cli\",\n  \"message\": null,\n  \"options\": [\n    { \"label\": \"General/\", \"value\": \"__group__general\", \"disabled\": true, \"category\": \"General\" },\n    { \"label\": \"   Fast 1080p30\", \"value\": \"Fast 1080p30\", \"category\": \"General\" }\n  ]\n}\n
"},{"location":"api/settings/#post-apisettingspushovertest","title":"POST /api/settings/pushover/test","text":"
Sendet Testnachricht \u00fcber aktuelle PushOver-Settings.
 
Request (optional):
 
{\n  \"title\": \"Test\",\n  \"message\": \"Ripster Test\"\n}\n
 
Response:
 
{\n  \"result\": {\n    \"sent\": true,\n    \"eventKey\": \"test\",\n    \"requestId\": \"...\"\n  }\n}\n
 
Wenn PushOver deaktiviert ist oder Credentials fehlen, kommt i. d. R. ebenfalls 200 mit sent: false + reason.
"},{"location":"api/settings/#skripte","title":"Skripte","text":"
Basis: /api/settings/scripts
"},{"location":"api/settings/#get-apisettingsscripts","title":"GET /api/settings/scripts","text":"
{ \"scripts\": [ { \"id\": 1, \"name\": \"...\", \"scriptBody\": \"...\", \"orderIndex\": 1, \"createdAt\": \"...\", \"updatedAt\": \"...\" } ] }\n
"},{"location":"api/settings/#post-apisettingsscripts","title":"POST /api/settings/scripts","text":"
{ \"name\": \"Move\", \"scriptBody\": \"mv \\\"$RIPSTER_OUTPUT_PATH\\\" /mnt/movies/\" }\n
 
Response: 201 mit { \"script\": { ... } }
"},{"location":"api/settings/#put-apisettingsscriptsid","title":"PUT /api/settings/scripts/:id","text":"
Body wie POST, Response { \"script\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsscriptsid","title":"DELETE /api/settings/scripts/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscriptsreorder","title":"POST /api/settings/scripts/reorder","text":"
{ \"orderedScriptIds\": [3, 1, 2] }\n
 
Response { \"scripts\": [ ... ] }.
"},{"location":"api/settings/#post-apisettingsscriptsidtest","title":"POST /api/settings/scripts/:id/test","text":"
F\u00fchrt Skript als Testlauf aus.
 
{\n  \"result\": {\n    \"scriptId\": 1,\n    \"scriptName\": \"Move\",\n    \"success\": true,\n    \"exitCode\": 0,\n    \"signal\": null,\n    \"timedOut\": false,\n    \"durationMs\": 120,\n    \"stdout\": \"...\",\n    \"stderr\": \"...\",\n    \"stdoutTruncated\": false,\n    \"stderrTruncated\": false\n  }\n}\n
"},{"location":"api/settings/#umgebungsvariablen-fur-skripte","title":"Umgebungsvariablen f\u00fcr Skripte","text":"
Diese Variablen werden beim Ausf\u00fchren gesetzt:
 
     
  • RIPSTER_SCRIPT_RUN_AT
    •  
  • RIPSTER_JOB_ID
    •  
  • RIPSTER_JOB_TITLE
    •  
  • RIPSTER_MODE
    •  
  • RIPSTER_INPUT_PATH
    •  
  • RIPSTER_OUTPUT_PATH
    •  
  • RIPSTER_RAW_PATH
    •  
  • RIPSTER_SCRIPT_ID
    •  
  • RIPSTER_SCRIPT_NAME
    •  
  • RIPSTER_SCRIPT_SOURCE
    •  
"},{"location":"api/settings/#skript-ketten","title":"Skript-Ketten","text":"
Basis: /api/settings/script-chains
 
Eine Kette hat Schritte vom Typ:
 
     
  • script (scriptId erforderlich)
    •  
  • wait (waitSeconds 1..3600)
    •  
"},{"location":"api/settings/#get-apisettingsscript-chains","title":"GET /api/settings/script-chains","text":"
Response { \"chains\": [ ... ] } (inkl. steps[]).
"},{"location":"api/settings/#get-apisettingsscript-chainsid","title":"GET /api/settings/script-chains/:id","text":"
Response { \"chain\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscript-chains","title":"POST /api/settings/script-chains","text":"
{\n  \"name\": \"After Encode\",\n  \"steps\": [\n    { \"stepType\": \"script\", \"scriptId\": 1 },\n    { \"stepType\": \"wait\", \"waitSeconds\": 15 },\n    { \"stepType\": \"script\", \"scriptId\": 2 }\n  ]\n}\n
 
Response: 201 mit { \"chain\": { ... } }
"},{"location":"api/settings/#put-apisettingsscript-chainsid","title":"PUT /api/settings/script-chains/:id","text":"
Body wie POST, Response { \"chain\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsscript-chainsid","title":"DELETE /api/settings/script-chains/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#post-apisettingsscript-chainsreorder","title":"POST /api/settings/script-chains/reorder","text":"
{ \"orderedChainIds\": [2, 1, 3] }\n
 
Response { \"chains\": [ ... ] }.
"},{"location":"api/settings/#post-apisettingsscript-chainsidtest","title":"POST /api/settings/script-chains/:id/test","text":"
Response:
 
{\n  \"result\": {\n    \"chainId\": 2,\n    \"chainName\": \"After Encode\",\n    \"steps\": 3,\n    \"succeeded\": 3,\n    \"failed\": 0,\n    \"aborted\": false,\n    \"results\": []\n  }\n}\n
"},{"location":"api/settings/#user-presets","title":"User-Presets","text":"
Basis: /api/settings/user-presets
"},{"location":"api/settings/#get-apisettingsuser-presets","title":"GET /api/settings/user-presets","text":"
Optionaler Query-Parameter: media_type=bluray|dvd|other|all
 
{\n  \"presets\": [\n    {\n      \"id\": 1,\n      \"name\": \"Blu-ray HQ\",\n      \"mediaType\": \"bluray\",\n      \"handbrakePreset\": \"H.264 MKV 1080p30\",\n      \"extraArgs\": \"--encoder-preset slow\",\n      \"description\": \"...\",\n      \"createdAt\": \"...\",\n      \"updatedAt\": \"...\"\n    }\n  ]\n}\n
"},{"location":"api/settings/#post-apisettingsuser-presets","title":"POST /api/settings/user-presets","text":"
{\n  \"name\": \"Blu-ray HQ\",\n  \"mediaType\": \"bluray\",\n  \"handbrakePreset\": \"H.264 MKV 1080p30\",\n  \"extraArgs\": \"--encoder-preset slow\",\n  \"description\": \"optional\"\n}\n
 
Response: 201 mit { \"preset\": { ... } }
"},{"location":"api/settings/#put-apisettingsuser-presetsid","title":"PUT /api/settings/user-presets/:id","text":"
Body mit beliebigen Feldern aus POST, Response { \"preset\": { ... } }.
"},{"location":"api/settings/#delete-apisettingsuser-presetsid","title":"DELETE /api/settings/user-presets/:id","text":"
Response { \"removed\": { ... } }.
"},{"location":"api/settings/#weitere-endpunkte","title":"Weitere Endpunkte","text":""},{"location":"api/settings/#get-apisettingseffective-paths","title":"GET /api/settings/effective-paths","text":"
Liefert aufgel\u00f6ste, effektiv genutzte Pfade aus den Settings (f\u00fcr UI- und Diagnosezwecke).
"},{"location":"api/settings/#post-apisettingscoverartrecover","title":"POST /api/settings/coverart/recover","text":"
Startet eine manuelle Coverart-Recovery.
 
Response (Beispiel):
 
{\n  \"result\": { \"started\": true },\n  \"scheduler\": { \"enabled\": true }\n}\n
"},{"location":"api/settings/#activation-bytes-aax","title":"Activation Bytes (AAX)","text":""},{"location":"api/settings/#get-apisettingsactivation-bytes","title":"GET /api/settings/activation-bytes","text":"
Liest gecachte AAX-Activation-Bytes.
"},{"location":"api/settings/#post-apisettingsactivation-bytes","title":"POST /api/settings/activation-bytes","text":"
Speichert Activation-Bytes.
 
Request:
 
{\n  \"checksum\": \"abc123...\",\n  \"activationBytes\": \"1a2b3c4d\"\n}\n
"},{"location":"api/settings/#laufwerke","title":"Laufwerke","text":""},{"location":"api/settings/#get-apisettingsdrives","title":"GET /api/settings/drives","text":"
Liefert erkannte optische Laufwerke (/dev/...) inkl. MakeMKV-Disc-Index.
"},{"location":"api/settings/#post-apisettingsdrivesforce-unlock","title":"POST /api/settings/drives/force-unlock","text":"
Erzwingt Entsperren aktiver Laufwerkslocks.
 
Hinweis: Expertenmodus (ui_expert_mode) ist erforderlich, sonst 403.
 
Request (ein Laufwerk):
 
{ \"devicePath\": \"/dev/sr0\" }\n
 
Request (alle):
 
{ \"all\": true }\n
"},{"location":"api/settings/#ui-preferences","title":"UI Preferences","text":""},{"location":"api/settings/#get-apisettingsprefskey","title":"GET /api/settings/prefs/:key","text":"
Liest einen persistierten UI-Preference-Wert.
"},{"location":"api/settings/#put-apisettingsprefskey","title":"PUT /api/settings/prefs/:key","text":"
Speichert einen persistierten UI-Preference-Wert.
 
Request:
 
{ \"value\": \"{\\\"columns\\\":[\\\"id\\\",\\\"status\\\"]}\" }\n
"},{"location":"api/websocket/","title":"WebSocket Events","text":"
Ripster sendet Echtzeit-Updates \u00fcber /ws.
"},{"location":"api/websocket/#verbindung","title":"Verbindung","text":"
const ws = new WebSocket('ws://localhost:3001/ws');\n\nws.onmessage = (event) => {\n  const msg = JSON.parse(event.data);\n  console.log(msg.type, msg.payload);\n};\n
"},{"location":"api/websocket/#nachrichtenformat","title":"Nachrichtenformat","text":"
Die meisten Broadcasts haben dieses Schema:
 
{\n  \"type\": \"EVENT_TYPE\",\n  \"payload\": {},\n  \"timestamp\": \"2026-03-10T09:00:00.000Z\"\n}\n
 
Ausnahme: WS_CONNECTED beim Verbindungsaufbau enth\u00e4lt kein timestamp.
"},{"location":"api/websocket/#event-typen","title":"Event-Typen","text":""},{"location":"api/websocket/#ws_connected","title":"WS_CONNECTED","text":"
Sofort nach erfolgreicher Verbindung.
 
{\n  \"type\": \"WS_CONNECTED\",\n  \"payload\": {\n    \"connectedAt\": \"2026-03-10T09:00:00.000Z\"\n  }\n}\n
"},{"location":"api/websocket/#pipeline_state_changed","title":"PIPELINE_STATE_CHANGED","text":"
Neuer Pipeline-Snapshot.
 
{\n  \"type\": \"PIPELINE_STATE_CHANGED\",\n  \"payload\": {\n    \"state\": \"ENCODING\",\n    \"activeJobId\": 42,\n    \"progress\": 62.5,\n    \"eta\": \"00:12:34\",\n    \"statusText\": \"ENCODING 62.50%\",\n    \"context\": {},\n    \"jobProgress\": {\n      \"42\": {\n        \"state\": \"ENCODING\",\n        \"progress\": 62.5,\n        \"eta\": \"00:12:34\",\n        \"statusText\": \"ENCODING 62.50%\"\n      }\n    },\n    \"queue\": {\n      \"maxParallelJobs\": 1,\n      \"runningCount\": 1,\n      \"queuedCount\": 2,\n      \"runningJobs\": [],\n      \"queuedJobs\": []\n    }\n  }\n}\n
"},{"location":"api/websocket/#pipeline_progress","title":"PIPELINE_PROGRESS","text":"
Laufende Fortschrittsupdates.
 
{\n  \"type\": \"PIPELINE_PROGRESS\",\n  \"payload\": {\n    \"state\": \"ENCODING\",\n    \"activeJobId\": 42,\n    \"progress\": 62.5,\n    \"eta\": \"00:12:34\",\n    \"statusText\": \"ENCODING 62.50%\"\n  }\n}\n
"},{"location":"api/websocket/#pipeline_queue_changed","title":"PIPELINE_QUEUE_CHANGED","text":"
Queue-Snapshot aktualisiert.
"},{"location":"api/websocket/#disc_detected-disc_removed","title":"DISC_DETECTED / DISC_REMOVED","text":"
Disc-Insertion/-Removal.
 
{\n  \"type\": \"DISC_DETECTED\",\n  \"payload\": {\n    \"device\": {\n      \"path\": \"/dev/sr0\",\n      \"discLabel\": \"INCEPTION\",\n      \"model\": \"ASUS BW-16D1HT\",\n      \"fstype\": \"udf\",\n      \"mountpoint\": null,\n      \"mediaProfile\": \"bluray\"\n    }\n  }\n}\n
 
mediaProfile: bluray | dvd | other | null
"},{"location":"api/websocket/#hardware_monitor_update","title":"HARDWARE_MONITOR_UPDATE","text":"
Snapshot aus Hardware-Monitoring.
 
{\n  \"type\": \"HARDWARE_MONITOR_UPDATE\",\n  \"payload\": {\n    \"enabled\": true,\n    \"intervalMs\": 5000,\n    \"updatedAt\": \"2026-03-10T09:00:00.000Z\",\n    \"sample\": {\n      \"cpu\": {},\n      \"memory\": {},\n      \"gpu\": {},\n      \"storage\": {}\n    },\n    \"error\": null\n  }\n}\n
"},{"location":"api/websocket/#pipeline_error","title":"PIPELINE_ERROR","text":"
Fehler bei Disc-Event-Verarbeitung in Pipeline.
"},{"location":"api/websocket/#disk_detection_error","title":"DISK_DETECTION_ERROR","text":"
Fehler in Laufwerkserkennung.
"},{"location":"api/websocket/#settings_updated","title":"SETTINGS_UPDATED","text":"
Einzelnes Setting wurde gespeichert.
"},{"location":"api/websocket/#settings_bulk_updated","title":"SETTINGS_BULK_UPDATED","text":"
Bulk-Settings gespeichert.
 
{\n  \"type\": \"SETTINGS_BULK_UPDATED\",\n  \"payload\": {\n    \"count\": 3,\n    \"keys\": [\"raw_dir\", \"movie_dir\", \"handbrake_preset_bluray\"]\n  }\n}\n
"},{"location":"api/websocket/#settings_scripts_updated","title":"SETTINGS_SCRIPTS_UPDATED","text":"
Skript ge\u00e4ndert (created|updated|deleted|reordered).
"},{"location":"api/websocket/#settings_script_chains_updated","title":"SETTINGS_SCRIPT_CHAINS_UPDATED","text":"
Skript-Kette ge\u00e4ndert (created|updated|deleted|reordered).
"},{"location":"api/websocket/#user_presets_updated","title":"USER_PRESETS_UPDATED","text":"
User-Preset ge\u00e4ndert (created|updated|deleted).
"},{"location":"api/websocket/#cron_jobs_updated","title":"CRON_JOBS_UPDATED","text":"
Cron-Config ge\u00e4ndert (created|updated|deleted).
"},{"location":"api/websocket/#cron_job_updated","title":"CRON_JOB_UPDATED","text":"
Laufzeitstatus eines Cron-Jobs ge\u00e4ndert.
 
{\n  \"type\": \"CRON_JOB_UPDATED\",\n  \"payload\": {\n    \"id\": 1,\n    \"lastRunStatus\": \"running\",\n    \"lastRunAt\": \"2026-03-10T10:00:00.000Z\",\n    \"nextRunAt\": null\n  }\n}\n
"},{"location":"api/websocket/#runtime_activity_changed","title":"RUNTIME_ACTIVITY_CHANGED","text":"
Vollst\u00e4ndiger Snapshot aller laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten.
 
Wird ausgel\u00f6st, wenn eine Aktivit\u00e4t gestartet, aktualisiert oder abgeschlossen wird sowie nach clear-recent.
 
{\n  \"type\": \"RUNTIME_ACTIVITY_CHANGED\",\n  \"payload\": {\n    \"active\": [\n      {\n        \"id\": 7,\n        \"type\": \"chain\",\n        \"name\": \"Post-Encode Aufr\u00e4umen\",\n        \"status\": \"running\",\n        \"source\": \"cron\",\n        \"message\": \"Schritt 2 von 3\",\n        \"currentStep\": \"cleanup.sh\",\n        \"currentStepType\": \"script\",\n        \"stepIndex\": 2,\n        \"stepTotal\": 3,\n        \"canCancel\": true,\n        \"canNextStep\": false,\n        \"outcome\": \"running\",\n        \"startedAt\": \"2026-03-10T10:00:00.000Z\",\n        \"finishedAt\": null,\n        \"durationMs\": null\n      }\n    ],\n    \"recent\": [],\n    \"updatedAt\": \"2026-03-10T10:00:05.000Z\"\n  }\n}\n
 
Vollst\u00e4ndige Feldbeschreibung: Runtime Activities API.
"},{"location":"api/websocket/#converter_scan_update","title":"CONVERTER_SCAN_UPDATE","text":"
Wird nach einem Scan des Converter-Eingangsordners gesendet (manuell oder per Polling).
 
{\n  \"type\": \"CONVERTER_SCAN_UPDATE\",\n  \"payload\": {\n    \"entryCount\": 12\n  }\n}\n
"},{"location":"api/websocket/#downloads_updated","title":"DOWNLOADS_UPDATED","text":"
Wird bei jeder Status\u00e4nderung in der Download-Queue gesendet.
 
{\n  \"type\": \"DOWNLOADS_UPDATED\",\n  \"payload\": {\n    \"reason\": \"ready\",\n    \"item\": {\n      \"id\": \"dl-1\",\n      \"jobId\": 42,\n      \"status\": \"ready\",\n      \"archiveName\": \"Job_42_movie.zip\",\n      \"createdAt\": \"2026-03-30T10:00:00.000Z\"\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"pending\": 1,\n      \"processing\": 0,\n      \"ready\": 1,\n      \"failed\": 1\n    }\n  }\n}\n
 
M\u00f6gliche reason-Werte: queued, processing, ready, failed, deleted.
"},{"location":"api/websocket/#reconnect-verhalten","title":"Reconnect-Verhalten","text":"
useWebSocket verbindet bei Abbruch automatisch neu:
 
     
  • Retry-Intervall: 1500ms
    •  
  • Wiederverbindung bis Komponente unmounted wird
    •  
"},{"location":"appendix/","title":"Technischer Anhang","text":"
Dieser Bereich enth\u00e4lt die technische Referenz hinter dem Benutzerhandbuch.
"},{"location":"appendix/#inhalt","title":"Inhalt","text":"
     
  • Konfiguration
    •  
  • komplette Feldreferenz
    •  
  • Umgebungsvariablen
    •  
  • Pipeline intern
    •  
  • Zustandsmodell
    •  
  • Encode-Planung
    •  
  • Playlist-Analyse
    •  
  • Pre-/Post-Encode-Ausf\u00fchrungen
    •  
  • API-Referenz
    •  
  • REST-Endpunkte
    •  
  • WebSocket-Events
    •  
  • Architektur
    •  
  • Backend-/Frontend-Aufbau
    •  
  • Datenbank
    •  
  • Deployment
    •  
  • Betrieb in Entwicklung und Produktion
    •  
  • Externe Tools
    •  
  • MakeMKV, HandBrake, MediaInfo
    •  
"},{"location":"appendix/#wann-du-in-den-anhang-wechselst","title":"Wann du in den Anhang wechselst","text":"
     
  • du integrierst Ripster mit anderen Systemen
    •  
  • du betreibst mehrere Instanzen oder willst tiefer debuggen
    •  
  • du brauchst Feld-/API-/Schema-Details f\u00fcr Automatisierung
    •  
"},{"location":"architecture/","title":"Anhang: Architektur","text":"
Ripster ist eine Client-Server-Anwendung mit REST + WebSocket und externen CLI-Tools.
"},{"location":"architecture/#systemuberblick","title":"System\u00fcberblick","text":"
graph TB\n    subgraph Browser[\"Browser (React)\"]\n        Ripper[Ripper]\n        Settings[Einstellungen]\n        History[Historie]\n    end\n\n    subgraph Backend[\"Node.js Backend\"]\n        API[REST API\\nExpress]\n        WS[WebSocket\\n/ws]\n        Pipeline[pipelineService]\n        Cron[cronService]\n        DB[(SQLite)]\n    end\n\n    subgraph Tools[\"Externe Tools\"]\n        MakeMKV[makemkvcon]\n        HandBrake[HandBrakeCLI]\n        MediaInfo[mediainfo]\n    end\n\n    Browser <-->|HTTP| API\n    Browser <-->|WebSocket| WS\n    Pipeline --> MakeMKV\n    Pipeline --> HandBrake\n    Pipeline --> MediaInfo\n    API --> DB\n    Pipeline --> DB\n    Cron --> DB
"},{"location":"architecture/#details","title":"Details","text":"
     
  •  \u00dcbersicht
    •  
  •  Backend-Services
    •  
  •  Frontend-Komponenten
    •  
  •  Datenbank
    •  
"},{"location":"architecture/backend/","title":"Backend-Services","text":"
Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung \u00fcber ein Plugin-System.
"},{"location":"architecture/backend/#plugin-system-srcplugins","title":"Plugin-System (src/plugins/)","text":"
Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
"},{"location":"architecture/backend/#basisklassen","title":"Basisklassen","text":"
     
  • PluginBase.js \u2014 Abstrakte Basisklasse SourcePlugin mit Lifecycle-Methoden
    •  
  • PluginRegistry.js \u2014 Dynamische Plugin-Erkennung, priorit\u00e4tsbasierte Auswahl, Settings-Schema-Aggregation
    •  
  • PluginContext.js \u2014 Ausf\u00fchrungskontext (Logger, Callbacks, Signals) f\u00fcr Plugin-Aufrufe
    •  
"},{"location":"architecture/backend/#plugin-lifecycle","title":"Plugin-Lifecycle","text":"
Jedes Plugin implementiert die folgenden Methoden:
 Methode Beschreibung detect(discInfo) Medientyp-Erkennung analyze(devicePath, job, ctx) Analyse / Metadaten-Extraktion rip(job, ctx) Rohdaten-Extraktion review(job, ctx) Optionale Vorschau-Vorbereitung encode(job, ctx) Finales Encoding/Konvertierung finalize(job, ctx) Nachbearbeitung onCancel(job, ctx) Bereinigung bei Abbruch onRetry(job, ctx) Zustand-Reset vor Retry"},{"location":"architecture/backend/#implementierte-plugins","title":"Implementierte Plugins","text":"
     
  • BluRayPlugin.js \u2014 Blu-ray via MakeMKV (Backup-Modus)
    •  
  • DVDPlugin.js \u2014 DVD via MakeMKV (MKV-Modus)
    •  
  • CdPlugin.js \u2014 Audio-CD via cdparanoia + FFmpeg (experimentell)
    •  
  • AudiobookPlugin.js \u2014 AAX/M4B via FFmpeg mit Kapitel-Splitting
    •  
  • ConverterPlugin.js \u2014 Generische Audio/Video-Konvertierung via FFmpeg
    •  
  • VideoDiscPlugin.js \u2014 Gemeinsame Basis f\u00fcr Blu-ray/DVD (MediaInfo-Parsing)
    •  
"},{"location":"architecture/backend/#pipelineservicejs","title":"pipelineService.js","text":"
Zentrale Workflow-Orchestrierung.
 
Aufgaben:
 
     
  • Pipeline-State-Machine + Persistenz (pipeline_state)
    •  
  • Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
    •  
  • Queue-Management (Jobs + script|chain|wait Eintr\u00e4ge)
    •  
  • Retry/Re-Encode/Restart-Flows
    •  
  • WebSocket-Broadcasts f\u00fcr State/Progress/Queue
    •  
  • Converter-Job-Verwaltung (createConverterJobFromEntry, uploadConverterFiles, startConverterJob)
    •  
 
Wichtige Methoden:
 
     
  • analyzeDisc()
    •  
  • selectMetadata()
    •  
  • startPreparedJob()
    •  
  • confirmEncodeReview()
    •  
  • cancel()
    •  
  • retry()
    •  
  • reencodeFromRaw()
    •  
  • restartReviewFromRaw()
    •  
  • restartEncodeWithLastSettings()
    •  
  • resumeReadyToEncodeJob()
    •  
  • enqueueNonJobEntry(), reorderQueue(), removeQueueEntry()
    •  
  • createConverterJobFromEntry(), createConverterJobsFromSelection()
    •  
  • uploadConverterFiles(), startConverterJob()
    •  
"},{"location":"architecture/backend/#diskdetectionservicejs","title":"diskDetectionService.js","text":"
Pollt Laufwerk(e) und emittiert:
 
     
  • discInserted
    •  
  • discRemoved
    •  
  • error
    •  
 
Zusatz:
 
     
  • Modus auto oder explicit
    •  
  • heuristische mediaProfile-Erkennung (bluray/dvd/other)
    •  
  • rescanAndEmit() f\u00fcr manuellen Trigger
    •  
"},{"location":"architecture/backend/#settingsservicejs","title":"settingsService.js","text":"
Settings-Layer mit Validation/Serialisierung.
 
Features:
 
     
  • getCategorizedSettings() f\u00fcr UI-Form
    •  
  • setSettingValue() / setSettingsBulk()
    •  
  • profilspezifische Aufl\u00f6sung (resolveEffectiveToolSettings)
    •  
  • CLI-Config-Building f\u00fcr MakeMKV/HandBrake/MediaInfo/FFmpeg
    •  
  • HandBrake-Preset-Liste via HandBrakeCLI -z
    •  
  • MakeMKV-Key-Synchronisation aus makemkv_registration_key nach ~/.MakeMKV/settings.conf
    •  
  • Pfadaufl\u00f6sung f\u00fcr alle Medienprofile inkl. Audiobook und Converter
    •  
"},{"location":"architecture/backend/#historyservicejs","title":"historyService.js","text":"
Historie + Dateioperationen.
 
Features:
 
     
  • Job-Liste/Detail inkl. Log-Tail
    •  
  • Orphan-RAW-Erkennung und Import
    •  
  • OMDb-Nachzuweisung
    •  
  • Dateil\u00f6schung (raw|movie|both)
    •  
  • Job-L\u00f6schung (none|raw|movie|both)
    •  
"},{"location":"architecture/backend/#audiobookservicejs","title":"audiobookService.js","text":"
Audiobook-Verarbeitung (AAX/M4B).
 
Features:
 
     
  • FFprobe-basierte Analyse (Kapitel, Metadaten)
    •  
  • FFmpeg-basiertes Encoding mit Kapitel-Splitting
    •  
  • Ausgabeformate: M4B, MP3, FLAC
    •  
  • Template-basierte Pfade ({author}, {title}, {year}, {narrator}, {series}, {part})
    •  
"},{"location":"architecture/backend/#activationbytesservicejs","title":"activationBytesService.js","text":"
Verwaltung von Audible-Activation-Bytes f\u00fcr AAX-DRM-Handling.
 
Features:
 
     
  • SHA-1-Pr\u00fcfsumme der AAX-Datei berechnen
    •  
  • Activation Bytes in aax_activation_bytes-Tabelle cachen
    •  
  • Lookup via audnexService (wenn konfiguriert)
    •  
"},{"location":"architecture/backend/#converterscanservicejs","title":"converterScanService.js","text":"
Dateisystem-\u00dcberwachung des Converter-Eingangsordners.
 
Features:
 
     
  • Vollst\u00e4ndiger FS-Baum (getTree())
    •  
  • DB-basierter Datei-Explorer (getEntries())
    •  
  • Manueller und automatischer Scan (Polling)
    •  
  • Pfad-Normalisierung mit Traversal-Schutz
    •  
  • WebSocket-Broadcast: CONVERTER_SCAN_UPDATE
    •  
"},{"location":"architecture/backend/#downloadservicejs","title":"downloadService.js","text":"
Download-Queue f\u00fcr Ausgabedateien aus der Historie.
 
Features:
 
     
  • Job in Download-Queue einreihen (enqueueHistoryJob)
    •  
  • ZIP-Archiv aus Ausgabedateien erstellen (archiver)
    •  
  • Datei-Streaming via res.download()
    •  
  • WebSocket-Broadcast: DOWNLOADS_UPDATED bei Status-\u00c4nderungen
    •  
  • Download-Item l\u00f6schen
    •  
"},{"location":"architecture/backend/#cronservicejs","title":"cronService.js","text":"
Integriertes Cron-System ohne externe Parser-Library.
 
Features:
 
     
  • 5-Feld-Cron-Parser + nextRun-Berechnung
    •  
  • Quellen: script oder chain
    •  
  • Laufzeitlogs (cron_run_logs)
    •  
  • manuelles Triggern
    •  
  • WebSocket-Events: CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
"},{"location":"architecture/backend/#runtimeactivityservicejs","title":"runtimeActivityService.js","text":"
In-Memory-Tracking aller laufenden und k\u00fcrzlich abgeschlossenen Aktivit\u00e4ten (Skripte, Ketten, Cron-Jobs, Tasks).
 
Features:
 
     
  • startActivity(type, payload) \u2192 Aktivit\u00e4t registrieren, ID zur\u00fcckgeben
    •  
  • updateActivity(id, patch) \u2192 Laufende Aktivit\u00e4t aktualisieren
    •  
  • completeActivity(id, payload) \u2192 Aktivit\u00e4t abschlie\u00dfen und in recent verschieben
    •  
  • setControls(id, { cancel, nextStep }) \u2192 Steuer-Handler registrieren (f\u00fcr canCancel/canNextStep)
    •  
  • requestCancel(id) / requestNextStep(id) \u2192 Steuer-Handler aufrufen
    •  
  • clearRecent() \u2192 Abgeschlossene Aktivit\u00e4ten l\u00f6schen
    •  
  • getSnapshot() \u2192 Snapshot mit active + recent + updatedAt
    •  
  • Broadcasts RUNTIME_ACTIVITY_CHANGED \u00fcber WebSocket bei jeder \u00c4nderung
    •  
 
Limits:
 
     
  • recent max. 120 Eintr\u00e4ge
    •  
  • stdout/stderr/output max. 12.000 Zeichen
    •  
  • message/errorMessage max. 2.000 Zeichen
    •  
 
Vollst\u00e4ndige API-Dokumentation: Runtime Activities API
"},{"location":"architecture/backend/#weitere-services","title":"Weitere Services","text":"
     
  • scriptService.js (CRUD + Test + Wrapper-Ausf\u00fchrung)
    •  
  • scriptChainService.js (CRUD + Step-Execution)
    •  
  • userPresetService.js (HandBrake User-Presets)
    •  
  • hardwareMonitorService.js (CPU/RAM/GPU/Storage)
    •  
  • websocketService.js (Client-Registry + Broadcast)
    •  
  • notificationService.js (PushOver)
    •  
  • cdRipService.js (CD-Ripping mit cdparanoia)
    •  
  • musicBrainzService.js (MusicBrainz-Metadaten-Lookup)
    •  
  • audnexService.js (Audnex-API f\u00fcr Audiobook-Metadaten)
    •  
  • coverArtRecoveryService.js (Cover-Art-Wiederherstellung)
    •  
  • thumbnailService.js (Vorschaubild-Generierung)
    •  
  • omdbService.js (OMDb-Metadaten-Suche)
    •  
  • logger.js (rotierende Datei-Logs)
    •  
"},{"location":"architecture/backend/#bootstrapping-srcindexjs","title":"Bootstrapping (src/index.js)","text":"
Beim Start:
 
     
  1. DB init/migrate
    2.  
  2. Pipeline-Init (inkl. Plugin-Registry)
    3.  
  3. Cron-Init
    4.  
  4. Express-Routes + Error-Handler
    5.  
  5. WebSocket-Server auf /ws
    6.  
  6. Hardware-Monitoring-Init
    7.  
  7. Disk-Detection-Start
    8.  
  8. Converter-Scan-Service-Init (Polling falls aktiviert)
    9.  
"},{"location":"architecture/database/","title":"Datenbank","text":"
Ripster verwendet SQLite (backend/data/ripster.db).
"},{"location":"architecture/database/#tabellen","title":"Tabellen","text":"
settings_schema\nsettings_values\njobs\njob_lineage_artifacts\njob_output_folders\npipeline_state\nscripts\nscript_chains\nscript_chain_steps\nuser_presets\ncron_jobs\ncron_run_logs\naax_activation_bytes\nuser_prefs\nconverter_scan_entries\n
"},{"location":"architecture/database/#jobs","title":"jobs","text":"
Speichert Pipeline-Lifecycle und Artefakte pro Job.
 
Zentrale Felder:
 
     
  • Metadaten: title, year, imdb_id, poster_url, omdb_json, selected_from_omdb
    •  
  • Laufzeit: start_time, end_time, status, last_state
    •  
  • Pfade: raw_path, output_path, encode_input_path
    •  
  • Tool-Ausgaben: makemkv_info_json, handbrake_info_json, mediainfo_info_json, encode_plan_json
    •  
  • Kontrolle: encode_review_confirmed, rip_successful, error_message
    •  
  • Medientyp: media_type (bluray|dvd|cd|audiobook|converter)
    •  
  • Job-Typ/Beziehung: job_kind, parent_job_id
    •  
  • Multipart-/Disc-Merkmale: is_multipart_movie, disc_number, metadata_fingerprint
    •  
  • Pr\u00fcfsumme: aax_checksum (f\u00fcr AAX-Dateien)
    •  
  • Audit: created_at, updated_at
    •  
 
Typische job_kind-Werte:
 
     
  • Standard: bluray, dvd, cd, audiobook, converter_audio, converter_video, converter_iso
    •  
  • Serien: dvd_series_container, dvd_series_child
    •  
  • Multipart Film: multipart_movie_container, multipart_movie_child
    •  
 
Wichtige Indizes:
 
     
  • idx_jobs_status
    •  
  • idx_jobs_parent_job_id
    •  
  • idx_jobs_job_kind
    •  
  • idx_jobs_disc_number
    •  
  • idx_jobs_metadata_fingerprint
    •  
"},{"location":"architecture/database/#job_lineage_artifacts","title":"job_lineage_artifacts","text":"
Verkn\u00fcpft Jobs mit ihren Quell-Jobs (z. B. Re-Encode aus einem vorherigen Rip).
 
Felder:
 
     
  • job_id \u2014 der abgeleitete Job
    •  
  • source_job_id \u2014 der Quell-Job
    •  
  • artifact_type \u2014 Art der Verkn\u00fcpfung (z. B. reencode, restart_review)
    •  
  • created_at
    •  
"},{"location":"architecture/database/#job_output_folders","title":"job_output_folders","text":"
Verfolgt Ausgabepfade pro Job (mehrere Ausgaben m\u00f6glich, z. B. bei Kapitel-Splitting).
 
Felder:
 
     
  • job_id
    •  
  • folder_path
    •  
  • label \u2014 optionaler Bezeichner
    •  
  • created_at
    •  
"},{"location":"architecture/database/#pipeline_state","title":"pipeline_state","text":"
Singleton-Tabelle (id = 1) f\u00fcr aktiven Snapshot:
 
     
  • state
    •  
  • active_job_id
    •  
  • progress
    •  
  • eta
    •  
  • status_text
    •  
  • context_json
    •  
  • updated_at
    •  
"},{"location":"architecture/database/#settings_schema-settings_values","title":"settings_schema + settings_values","text":"
     
  • settings_schema: Definition (Typ, Default, Validation, Reihenfolge)
    •  
  • settings_values: aktueller Wert pro Key
    •  
"},{"location":"architecture/database/#scripts-script_chains-script_chain_steps","title":"scripts, script_chains, script_chain_steps","text":"
     
  • scripts: Shell-Skripte (name, script_body, order_index)
    •  
  • script_chains: Ketten (name, order_index)
    •  
  • script_chain_steps: Schritte je Kette
    •  
  • step_type: script oder wait
    •  
  • script_id oder wait_seconds
    •  
"},{"location":"architecture/database/#user_presets","title":"user_presets","text":"
Benannte HandBrake-Preset-Sets:
 
     
  • name
    •  
  • media_type (bluray|dvd|other|all)
    •  
  • handbrake_preset
    •  
  • extra_args
    •  
  • description
    •  
"},{"location":"architecture/database/#cron_jobs-cron_run_logs","title":"cron_jobs + cron_run_logs","text":"
     
  • cron_jobs: Zeitplan + Status
    •  
  • cron_run_logs: einzelne L\u00e4ufe
    •  
  • status: running|success|error
    •  
  • output
    •  
  • error_message
    •  
"},{"location":"architecture/database/#aax_activation_bytes","title":"aax_activation_bytes","text":"
Cache f\u00fcr Audible-Activation-Bytes (AAX-DRM).
 
Felder:
 
     
  • checksum \u2014 SHA-1-Pr\u00fcfsumme der AAX-Datei (Prim\u00e4rschl\u00fcssel)
    •  
  • activation_bytes \u2014 Hex-String der Activation Bytes
    •  
  • created_at
    •  
"},{"location":"architecture/database/#user_prefs","title":"user_prefs","text":"
Benutzer-spezifische Einstellungen (Key-Value).
 
Felder:
 
     
  • key
    •  
  • value
    •  
  • updated_at
    •  
"},{"location":"architecture/database/#converter_scan_entries","title":"converter_scan_entries","text":"
DB-seitige Erfassung gescannter Dateien im Converter-Eingangsordner.
 
Felder:
 
     
  • rel_path \u2014 relativer Pfad zum converter_raw_dir
    •  
  • is_dir \u2014 Verzeichnis-Flag
    •  
  • size \u2014 Dateigr\u00f6\u00dfe in Bytes
    •  
  • modified_at \u2014 Datei-\u00c4nderungsdatum
    •  
  • job_id \u2014 zugewiesener Converter-Job (falls vorhanden)
    •  
  • scanned_at
    •  
"},{"location":"architecture/database/#migrationrecovery","title":"Migration/Recovery","text":"
Beim Start werden Schema und Settings-Metadaten automatisch abgeglichen.
 
Bei korruptem SQLite-File:
 
     
  1. Datei wird nach backend/data/corrupt-backups/ verschoben
    2.  
  2. neue DB wird initialisiert
    3.  
  3. Schema wird neu aufgebaut
    4.  
"},{"location":"architecture/database/#direkte-inspektion","title":"Direkte Inspektion","text":"
sqlite3 backend/data/ripster.db\n\n.mode table\nSELECT id, status, title, media_type, created_at FROM jobs ORDER BY created_at DESC;\nSELECT id, parent_job_id, job_kind, is_multipart_movie, disc_number FROM jobs ORDER BY created_at DESC;\nSELECT key, value FROM settings_values ORDER BY key;\nSELECT checksum, activation_bytes FROM aax_activation_bytes;\nSELECT rel_path, job_id FROM converter_scan_entries;\n
"},{"location":"architecture/frontend/","title":"Frontend-Komponenten","text":"
Frontend: React + PrimeReact + Vite.
"},{"location":"architecture/frontend/#hauptseiten","title":"Hauptseiten","text":""},{"location":"architecture/frontend/#ripperpagejsx","title":"RipperPage.jsx","text":"
Pipeline-Steuerung:
 
     
  • Status/Progress/ETA
    •  
  • Metadaten-Dialog
    •  
  • Playlist-Entscheidung
    •  
  • Review-Panel (Track-Auswahl)
    •  
  • Queue-Interaktion (reorder/add/remove)
    •  
  • Job-Aktionen (Start/Cancel/Retry/Re-Encode)
    •  
  • Hardware-Monitoring-Anzeige
    •  
  • Aktivit\u00e4ts-Tracking (Skripte, Ketten, Cron)
    •  
"},{"location":"architecture/frontend/#settingspagejsx","title":"SettingsPage.jsx","text":"
Konfiguration:
 
     
  • dynamisches Settings-Formular (DynamicSettingsForm)
    •  
  • Skripte/Ketten inkl. Reorder/Test
    •  
  • User-Presets
    •  
  • Cron-Jobs (CronJobsTab)
    •  
"},{"location":"architecture/frontend/#historypagejsx","title":"HistoryPage.jsx","text":"
Historie:
 
     
  • Job-Liste/Filter
    •  
  • Job-Details + Logs
    •  
  • OMDb-Nachzuweisung
    •  
  • Re-Encode/Restart-Workflows
    •  
"},{"location":"architecture/frontend/#converterpagejsx","title":"ConverterPage.jsx","text":"
Datei-Converter:
 
     
  • Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
    •  
  • Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
    •  
  • Dateiverwaltung: Umbenennen, Verschieben, L\u00f6schen, Ordner erstellen
    •  
  • Jobs aus Dateiauswahl erstellen
    •  
  • Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
    •  
  • Job-Start, Abbruch, L\u00f6schung
    •  
  • Automatischer Scan-Status
    •  
"},{"location":"architecture/frontend/#audiobookspagejsx","title":"AudiobooksPage.jsx","text":"
Dedizierter AAX-/Audiobook-Flow:
 
     
  • Upload-Panel f\u00fcr AAX-Dateien
    •  
  • aktive Audiobook-Jobkarten mit Start/Cancel/Retry/Delete
    •  
  • Audiobook-Konfigurationspanel und Output-Explorer
    •  
"},{"location":"architecture/frontend/#downloadspagejsx","title":"DownloadsPage.jsx","text":"
Download-Queue:
 
     
  • Ausgabedateien aus der Job-Historie in die Queue einreihen
    •  
  • Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
    •  
  • Dateien als ZIP herunterladen
    •  
  • Download-Eintr\u00e4ge l\u00f6schen
    •  
"},{"location":"architecture/frontend/#databasepagejsx","title":"DatabasePage.jsx","text":"
Expert-Modus:
 
     
  • Tabellarische Rohsicht der Job-Datenbank
    •  
  • Orphan-RAW-Import
    •  
"},{"location":"architecture/frontend/#wichtige-komponenten","title":"Wichtige Komponenten","text":"
     
  • PipelineStatusCard.jsx \u2014 Pipeline-Status-Anzeige mit Progress
    •  
  • MetadataSelectionDialog.jsx \u2014 OMDb-Metadaten-Auswahl
    •  
  • MediaInfoReviewPanel.jsx \u2014 Track-Auswahl-Interface (Video/Audio/Untertitel)
    •  
  • JobDetailDialog.jsx \u2014 Job-Detailansicht mit Logs
    •  
  • CronJobsTab.jsx \u2014 Cron-Job-Verwaltung
    •  
  • DynamicSettingsForm.jsx \u2014 Schema-gesteuertes Einstellungsformular
    •  
  • ConverterJobCard.jsx \u2014 Converter-Job-Darstellung
    •  
  • CdRipConfigPanel.jsx \u2014 Konfiguration f\u00fcr Audio-CD-Ripping
    •  
"},{"location":"architecture/frontend/#api-client-apiclientjs","title":"API-Client (api/client.js)","text":"
     
  • zentraler request() mit JSON-Handling
    •  
  • Fehlerobjekt aus API wird auf Error(message) gemappt
    •  
  • VITE_API_BASE default /api
    •  
"},{"location":"architecture/frontend/#websocket-hooksusewebsocketjs","title":"WebSocket (hooks/useWebSocket.js)","text":"
     
  • URL: VITE_WS_URL oder automatisch ws(s)://<host>/ws
    •  
  • Auto-Reconnect mit 1500ms Intervall
    •  
 
In App.jsx werden u. a. verarbeitet:
 
     
  • PIPELINE_STATE_CHANGED
    •  
  • PIPELINE_PROGRESS
    •  
  • PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt / Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • DOWNLOADS_UPDATED
    •  
  • CONVERTER_SCAN_UPDATE
    •  
  • RUNTIME_ACTIVITY_CHANGED
    •  
"},{"location":"architecture/frontend/#buildrun","title":"Build/Run","text":"
# dev\nnpm run dev --prefix frontend\n\n# prod build\nnpm run build --prefix frontend\n
"},{"location":"architecture/overview/","title":"Architektur-\u00dcbersicht","text":""},{"location":"architecture/overview/#kernprinzipien","title":"Kernprinzipien","text":""},{"location":"architecture/overview/#event-getriebene-pipeline","title":"Event-getriebene Pipeline","text":"
pipelineService h\u00e4lt einen Snapshot der State-Machine und broadcastet \u00c4nderungen sofort via WebSocket.
 
State-\u00c4nderung -> PIPELINE_STATE_CHANGED/PIPELINE_PROGRESS -> Frontend-Update\n
"},{"location":"architecture/overview/#service-layer","title":"Service-Layer","text":"
Route -> Service -> DB/Tool-Execution\n
 
Routes enthalten kaum Business-Logik.
"},{"location":"architecture/overview/#schema-getriebene-settings","title":"Schema-getriebene Settings","text":"
Settings sind DB-schema-getrieben (settings_schema + settings_values), UI rendert dynamisch aus diesen Daten.
"},{"location":"architecture/overview/#echtzeit-kommunikation","title":"Echtzeit-Kommunikation","text":"
WebSocket l\u00e4uft auf /ws.
 
Wichtige Events:
 
     
  • PIPELINE_STATE_CHANGED, PIPELINE_PROGRESS, PIPELINE_QUEUE_CHANGED
    •  
  • Disk erkannt, Disk entfernt
    •  
  • HARDWARE_MONITOR_UPDATE
    •  
  • SETTINGS_UPDATED, SETTINGS_BULK_UPDATED
    •  
  • SETTINGS_SCRIPTS_UPDATED, SETTINGS_SCRIPT_CHAINS_UPDATED, USER_PRESETS_UPDATED
    •  
  • CRON_JOBS_UPDATED, CRON_JOB_UPDATED
    •  
  • PIPELINE_ERROR, DISK_DETECTION_ERROR
    •  
"},{"location":"architecture/overview/#prozessausfuhrung","title":"Prozessausf\u00fchrung","text":"
Externe Tools werden als Child-Processes gestartet (processRunner):
 
     
  • Streaming von stdout/stderr
    •  
  • Progress-Parsing (progressParsers.js)
    •  
  • kontrollierter Abbruch (SIGINT/SIGKILL-Fallback)
    •  
"},{"location":"architecture/overview/#persistenz","title":"Persistenz","text":"
SQLite-Datei: backend/data/ripster.db
 
Kern-Tabellen:
 
     
  • jobs, pipeline_state
    •  
  • settings_schema, settings_values
    •  
  • scripts, script_chains, script_chain_steps
    •  
  • user_presets
    •  
  • cron_jobs, cron_run_logs
    •  
 
Beim Start werden Schema und Settings-Migrationen automatisch ausgef\u00fchrt.
"},{"location":"architecture/overview/#fehlerbehandlung","title":"Fehlerbehandlung","text":"
Zentrales Error-Handling liefert:
 
{\n  \"error\": {\n    \"message\": \"...\",\n    \"statusCode\": 400,\n    \"reqId\": \"...\",\n    \"details\": []\n  }\n}\n
 
Fehlgeschlagene Jobs bleiben in der Historie (Fehler oder Abgebrochen) und k\u00f6nnen erneut gestartet werden.
"},{"location":"architecture/overview/#cors-runtime-konfig","title":"CORS & Runtime-Konfig","text":"
     
  • CORS_ORIGIN default: *
    •  
  • LOG_LEVEL default: info
    •  
  • DB-/Log-Pfade \u00fcber DB_PATH/LOG_DIR konfigurierbar
    •  
"},{"location":"configuration/","title":"Anhang: Konfiguration","text":"
Dieser Abschnitt ist die technische Referenz zu allen Konfigurationsarten in Ripster.
"},{"location":"configuration/#inhalte","title":"Inhalte","text":"
     
  •  
     Einstellungsreferenz
     
    Vollst\u00e4ndige Liste aller UI-Settings (Typ, Default, Hinweise).
     
     Einstellungsreferenz
     
    •  
  •  
     Umgebungsvariablen
     
    backend/.env und frontend/.env inkl. Priorit\u00e4ten.
     
     Umgebungsvariablen
     
    •  
"},{"location":"configuration/#zuruck-zum-handbuch","title":"Zur\u00fcck zum Handbuch","text":"
     
  • Benutzerhandbuch \u00dcberblick
    •  
"},{"location":"configuration/environment/","title":"Umgebungsvariablen","text":"
Umgebungsvariablen steuern Backend/Vite au\u00dferhalb der DB-basierten UI-Settings.
"},{"location":"configuration/environment/#backend-backendenv","title":"Backend (backend/.env)","text":"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\u00fcr API LOG_LEVEL info debug, info, warn, error 
Beispiel:
 
PORT=3001\nDB_PATH=/var/lib/ripster/ripster.db\nLOG_DIR=/var/log/ripster\nCORS_ORIGIN=http://192.168.1.50:5173\nLOG_LEVEL=info\n
 
Hinweis: backend/.env.example enth\u00e4lt bewusst dev-freundliche Werte (z. B. lokaler CORS_ORIGIN).
"},{"location":"configuration/environment/#frontend-frontendenv","title":"Frontend (frontend/.env)","text":"Variable Default Beschreibung VITE_API_BASE /api API-Basis f\u00fcr Fetch-Client VITE_WS_URL automatisch aus window.location + /ws Optional explizite WebSocket-URL VITE_PUBLIC_ORIGIN leer \u00d6ffentliche Vite-Origin (Remote-Dev) VITE_ALLOWED_HOSTS true Komma-separierte Hostliste f\u00fcr 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 
Beispiele:
 
# lokal (mit Vite-Proxy)\nVITE_API_BASE=/api\n
 
# remote dev\nVITE_API_BASE=http://192.168.1.50:3001/api\nVITE_WS_URL=ws://192.168.1.50:3001/ws\nVITE_PUBLIC_ORIGIN=http://192.168.1.50:5173\nVITE_ALLOWED_HOSTS=192.168.1.50,ripster.local\nVITE_HMR_PROTOCOL=ws\nVITE_HMR_HOST=192.168.1.50\nVITE_HMR_CLIENT_PORT=5173\n
"},{"location":"configuration/environment/#prioritat","title":"Priorit\u00e4t","text":"
     
  1. Prozess-Umgebungsvariablen
    2.  
  2. .env
    3.  
  3. Code-Defaults
    4.  
"},{"location":"configuration/settings-reference/","title":"Einstellungsreferenz","text":"
Diese Seite dokumentiert den aktuellen Stand der Settings auf Basis von settings_schema und der aktiven GUI-Logik.
"},{"location":"configuration/settings-reference/#wichtiges-verhalten-in-der-gui","title":"Wichtiges Verhalten in der GUI","text":"
     
  • Speichern erfolgt gesammelt ueber Aenderungen speichern (Bulk-Update).
    •  
  • ui_expert_mode wird sofort einzeln gespeichert (nicht erst mit Bulk-Speichern).
    •  
  • *_owner-Felder sind in der GUI erst aktiv, wenn der zugehoerige Pfad gesetzt ist.
    •  
  • Einige Keys sind absichtlich ausgeblendet und nur technisch (API/DB) nutzbar.
    •  
  • Benachrichtigungs-Event-Toggles sind nur sichtbar, wenn pushover_enabled=true.
    •  
"},{"location":"configuration/settings-reference/#fallbacks-und-pfadaufloesung","title":"Fallbacks und Pfadaufloesung","text":"
     
  • Leere profilspezifische Pfade fallen auf Installationsdefaults zurueck.
    •  
  • download_dir nutzt bei leerem Wert den Default-Downloadpfad.
    •  
  • Die Konfigurationsseite zeigt im Block Effektive Pfade die tatsaechlich verwendeten Laufzeitpfade.
    •  
"},{"location":"configuration/settings-reference/#vollstaendige-feldliste","title":"Vollstaendige Feldliste","text":""},{"location":"configuration/settings-reference/#kategorie-benachrichtigungen","title":"Kategorie: Benachrichtigungen","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Expertenmodus ui_expert_mode boolean false Standard Schaltet erweiterte Einstellungen in der UI ein. PushOver aktiviert pushover_enabled boolean false Standard Master-Schalter f\u00fcr PushOver Versand. PushOver Token pushover_token string leer Standard Application Token f\u00fcr PushOver. PushOver User pushover_user string leer Standard User-Key f\u00fcr PushOver. PushOver Device (optional) pushover_device string leer Expertenmodus Optionales Ziel-Device in PushOver. PushOver Titel-Pr\u00e4fix pushover_title_prefix string Ripster Standard Prefix im PushOver Titel. PushOver Priority pushover_priority number 0 Expertenmodus Priorit\u00e4t -2 bis 2. PushOver Timeout (ms) pushover_timeout_ms number 7000 Expertenmodus HTTP Timeout f\u00fcr PushOver Requests. Bei manueller Auswahl senden pushover_notify_metadata_ready boolean true Standard Sendet, wenn ein Job eine manuelle Auswahl/Entscheidung ben\u00f6tigt (z.B. Metadaten, Titel oder Playlist). Bei Rip-Start senden pushover_notify_rip_started boolean true Standard Sendet beim Start des MakeMKV-Rips. Bei Encode-Start senden pushover_notify_encoding_started boolean true Standard Sendet beim Start von HandBrake. Bei Erfolg senden pushover_notify_job_finished boolean true Standard Sendet bei erfolgreich abgeschlossenem Job. Bei Fehler senden pushover_notify_job_error boolean true Standard Sendet bei Fehlern in der Pipeline. Bei Abbruch senden pushover_notify_job_cancelled boolean true Standard Sendet wenn Job manuell abgebrochen wurde. Bei Re-Encode Start senden pushover_notify_reencode_started boolean true Standard Sendet beim Start von RAW Re-Encode. Bei Re-Encode Erfolg senden pushover_notify_reencode_finished boolean true Standard Sendet bei erfolgreichem RAW Re-Encode."},{"location":"configuration/settings-reference/#kategorie-converter","title":"Kategorie: Converter","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Erlaubte Datei-Endungen converter_scan_extensions string mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus Standard Komma-getrennte Liste erlaubter Dateiendungen f\u00fcr den Scan (ohne Punkt). Auto-Scan (Polling) converter_polling_enabled boolean false Standard Converter Raw-Ordner automatisch in regelm\u00e4\u00dfigen Abst\u00e4nden scannen. Polling-Intervall (Sekunden) converter_polling_interval number 300 Standard Intervall f\u00fcr automatischen Scan des Converter-Ordners."},{"location":"configuration/settings-reference/#kategorie-laufwerk","title":"Kategorie: Laufwerk","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Laufwerksmodus drive_mode select auto Standard Auto-Discovery oder explizites Device. Explizite Laufwerke drive_devices path [] Standard Laufwerke f\u00fcr den expliziten Modus als JSON-Array mit Pfad und MakeMKV-Index, z.B. [{\"path\":\"/dev/sr0\",\"makemkvIndex\":0},{\"path\":\"/dev/sr1\",\"makemkvIndex\":1}]. Nur relevant wenn Modus = Explizites Device. Device Pfad drive_device path /dev/sr0 Ausgeblendet (nur API/DB) Nur f\u00fcr expliziten Modus, z.B. /dev/sr0. MakeMKV Source Index makemkv_source_index number 0 Ausgeblendet (nur API/DB) Disc Index im Auto-Modus. Automatische Disk-Erkennung disc_auto_detection_enabled boolean true Standard Wenn deaktiviert, findet keine automatische Laufwerkspr\u00fcfung statt. Neue Disks werden nur per \"Laufwerk neu lesen\" erkannt. Polling Intervall (ms) disc_poll_interval_ms number 4000 Expertenmodus Intervall f\u00fcr Disk-Erkennung. Laufwerk nach Rip auswerfen auto_eject_after_rip boolean false Standard Wenn aktiv, wird das Laufwerk nach erfolgreichem Abschluss eines Rip-Vorgangs automatisch ausgeworfen (eject)."},{"location":"configuration/settings-reference/#kategorie-logging","title":"Kategorie: Logging","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Terminal-Ausgabe aktiv server_console_log_output_enabled boolean true Expertenmodus Master-Schalter f\u00fcr die Ausgabe der Server-Logs im Terminal (z.B. start.sh). Das Schreiben in Log-Dateien bleibt immer aktiv. HTTP-Logs im Terminal server_console_log_http_enabled boolean true Expertenmodus Steuert HTTP Request-Logs im Terminal (z.B. request:start). Dateilogs bleiben unver\u00e4ndert. DEBUG im Terminal server_console_log_debug_enabled boolean true Expertenmodus Steuert DEBUG-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unver\u00e4ndert. INFO im Terminal server_console_log_info_enabled boolean true Expertenmodus Steuert INFO-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unver\u00e4ndert. WARN im Terminal server_console_log_warn_enabled boolean true Expertenmodus Steuert WARN-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unver\u00e4ndert. ERROR im Terminal server_console_log_error_enabled boolean true Expertenmodus Steuert ERROR-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unver\u00e4ndert."},{"location":"configuration/settings-reference/#kategorie-metadaten","title":"Kategorie: Metadaten","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System TMDb Read Access Token tmdb_api_read_access_token string leer Standard Read Access Token f\u00fcr Serien-Metadaten \u00fcber TheMovieDB (TMDb). Film-Sprache dvd_series_language string de-DE Standard Bevorzugte TMDb-Sprache f\u00fcr Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE oder en-US. Fallback Sprache dvd_series_fallback_languages string de-DE,en-US Standard Kommagetrennte TMDb-Fallback-Sprachen f\u00fcr Film- und Serienmetadaten (DVD/Blu-ray), z.B. de-DE,en-US,fr-FR. Coverart-Nachladen aktiv coverart_recovery_enabled boolean true Standard Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen gepr\u00fcft und nachgeladen. Coverart-Pr\u00fcfintervall (Stunden) coverart_recovery_interval_hours number 6 Standard Intervall f\u00fcr automatische Pr\u00fcfung fehlender Coverarts in Stunden. NFO nach Encode erzeugen generate_nfo_after_encode boolean false Standard Erstellt nach erfolgreichem Encode automatisch eine .nfo-Datei neben der Ausgabedatei."},{"location":"configuration/settings-reference/#kategorie-monitoring","title":"Kategorie: Monitoring","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Hardware Monitoring aktiviert hardware_monitoring_enabled boolean true Standard Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). Hardware Monitoring Intervall (ms) hardware_monitoring_interval_ms number 5000 Expertenmodus Polling-Intervall f\u00fcr CPU/RAM/GPU/Storage-Metriken."},{"location":"configuration/settings-reference/#kategorie-pfade","title":"Kategorie: Pfade","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System Raw Ausgabeordner (Blu-ray) raw_dir_bluray path leer Standard Optionaler RAW-Zielpfad nur f\u00fcr Blu-ray. Leer = Fallback auf \"Raw Ausgabeordner\". Raw Ausgabeordner (DVD) raw_dir_dvd path leer Standard Optionaler RAW-Zielpfad nur f\u00fcr DVD. Leer = Fallback auf \"Raw Ausgabeordner\". CD RAW-Ordner raw_dir_cd path leer Standard Basisordner f\u00fcr rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). Audiobook RAW-Ordner raw_dir_audiobook path leer Standard Basisordner f\u00fcr hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). Serien-Ordner (Blu-ray) series_dir_bluray path leer Standard Zielordner f\u00fcr Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). Film Ausgabeordner (Blu-ray) movie_dir_bluray path leer Standard Optionaler Encode-Zielpfad nur f\u00fcr Blu-ray. Leer = Fallback auf \"Film Ausgabeordner\". Film Ausgabeordner (DVD) movie_dir_dvd path leer Standard Optionaler Encode-Zielpfad nur f\u00fcr DVD. Leer = Fallback auf \"Film Ausgabeordner\". Serien-Ordner (DVD) series_dir_dvd path leer Standard Zielordner f\u00fcr DVD-Serienfolgen. Leer = Standardpfad (data/output/series). CD Output-Ordner movie_dir_cd path leer Standard Zielordner f\u00fcr encodierte CD-Ausgaben (FLAC, MP3 usw.). Leer = gleicher Ordner wie CD RAW-Ordner. Audiobook Output-Ordner movie_dir_audiobook path leer Standard Zielordner f\u00fcr encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). Download ZIP-Ordner download_dir path leer Standard Zielordner f\u00fcr vorbereitete ZIP-Downloads. Leer = Standardpfad (data/downloads). Externe Speicher external_storage_paths path [] Standard Wird links unter \"Freie Speicher\" angezeigt. Log Ordner log_dir path installationsabhaengig Standard Basisordner f\u00fcr Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. CD Output Template cd_output_template string {artist} - {album} ({year})/{trackNr} {artist} - {title} Standard Template f\u00fcr relative CD-Ausgabepfade ohne Dateiendung. Platzhalter: {artist}, {album}, {year}, {title}, {trackNr}, {trackNo}. Unterordner sind \u00fcber \"/\" m\u00f6glich. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (Blu-ray) output_template_bluray string ${title} (${year})/${title} (${year}) Standard Template f\u00fcr Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner \u00fcber \"/\" m\u00f6glich \u2013 alles nach dem letzten \"/\" ist der Dateiname. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (Blu-ray Serie, Episode) output_template_bluray_series_episode string {seriesTitle}/Staffel {seasonNr}/S{seasonNr}E{episodeNr} - {episodeTitle} Standard Template f\u00fcr einzelne Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNr}. Output Template (Blu-ray Serie, Multi-Episode) output_template_bluray_series_multi_episode string {seriesTitle}/Staffel {seasonNr}/S{0:seasonNr}E{episodeRange} - {episodeTitle} (Teil {parts}) Standard Template f\u00fcr zusammengefasste Blu-ray-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. Output Template (DVD) output_template_dvd string ${title} (${year})/${title} (${year}) Standard Template f\u00fcr Ordner und Dateiname. Platzhalter: ${title}, ${year}, ${imdbId}. Unterordner \u00fcber \"/\" m\u00f6glich \u2013 alles nach dem letzten \"/\" ist der Dateiname. Die Endung wird \u00fcber das gew\u00e4hlte Ausgabeformat gesetzt. Output Template (DVD Serie, Episode) output_template_dvd_series_episode string {seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeNo} - {episodeTitle} Standard Template f\u00fcr einzelne DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNr}, {episodeTitle}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNr}. Output Template (DVD Serie, Multi-Episode) output_template_dvd_series_multi_episode string {seriesTitle}/Season {seasonNr}/{seriesTitle} - S{seasonNo}E{episodeRange} Standard Template f\u00fcr zusammengefasste DVD-Serienepisoden ohne Dateiendung. Platzhalter: {seriesTitle}, {seasonNr}, {episodeNoStart}, {episodeNoEnd}, {episodeRange}, {episodeTitle}, {parts}, {discNr}, {year}, {language}. Optional mit f\u00fchrender Null: {0:seasonNr}, {0:episodeNoStart}, {0:episodeNoEnd}. Output Template (Audiobook) output_template_audiobook string {author}/{author} - {title} ({year}) Standard Template f\u00fcr relative Audiobook-Ausgabepfade ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}. Unterordner sind \u00fcber \"/\" m\u00f6glich. Audiobook RAW Template audiobook_raw_template string {author} - {title} ({year}) Standard Template f\u00fcr relative Audiobook-RAW-Ordner. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}. Converter Raw-Ordner converter_raw_dir path leer Standard Eingangsordner f\u00fcr den Converter (Import-Scan und Datei-Uploads). Jeder Upload erh\u00e4lt einen Unterordner. Leer = Standardpfad (data/output/converter-raw). Converter Ausgabe (Video) converter_movie_dir path leer Standard Ausgabepfad f\u00fcr konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). Converter Ausgabe (Audio) converter_audio_dir path leer Standard Ausgabepfad f\u00fcr konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). Output-Template (Video) converter_output_template_video string {title} Standard Dateiname-Template f\u00fcr konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. Output-Template (Audio) converter_output_template_audio string {artist} - {title} Standard Dateiname-Template f\u00fcr konvertierte Audio-Dateien (ohne Endung). Platzhalter: {artist}, {title}, {album}, {year}, {trackNr}. RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series path leer Standard RAW-Zielpfad f\u00fcr Blu-ray-Serien. Leer = gleicher Pfad wie RAW-Ordner (Blu-ray). Eigent\u00fcmer RAW-Ordner (Blu-ray Serie) raw_dir_bluray_series_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe f\u00fcr Blu-ray-Serien-RAW. Leer = Eigent\u00fcmer Raw-Ordner (Blu-ray). Eigent\u00fcmer Raw-Ordner (Blu-ray) raw_dir_bluray_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. RAW-Ordner (DVD Serie) raw_dir_dvd_series path leer Standard RAW-Zielpfad f\u00fcr DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). Eigent\u00fcmer RAW-Ordner (DVD Serie) raw_dir_dvd_series_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe f\u00fcr DVD-Serien-RAW. Leer = Eigent\u00fcmer Raw-Ordner (DVD). Eigent\u00fcmer Raw-Ordner (DVD) raw_dir_dvd_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer CD RAW-Ordner raw_dir_cd_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Audiobook RAW-Ordner raw_dir_audiobook_owner string leer Standard Eigent\u00fcmer der Audiobook-RAW-Dateien im Format user:gruppe. Nur aktiv wenn ein Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Converter RAW-Ordner converter_raw_dir_owner string leer Standard Eigent\u00fcmer der Converter-Eingabedateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Serien-Ordner (Blu-ray) series_dir_bluray_owner string leer Standard Eigent\u00fcmer der Blu-ray-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Film-Ordner (Blu-ray) movie_dir_bluray_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Film-Ordner (DVD) movie_dir_dvd_owner string leer Standard Eigent\u00fcmer der Dateien im Format user:gruppe. Nur aktiv wenn ein alternativer Pfad gesetzt ist. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Serien-Ordner (DVD) series_dir_dvd_owner string leer Standard Eigent\u00fcmer der DVD-Serienausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer CD Output-Ordner movie_dir_cd_owner string leer Standard Eigent\u00fcmer der encodierten CD-Ausgaben im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Audiobook Output-Ordner movie_dir_audiobook_owner string leer Standard Eigent\u00fcmer der encodierten Audiobook-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Converter Video Output-Ordner converter_movie_dir_owner string leer Standard Eigent\u00fcmer der konvertierten Video-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Converter Audio Output-Ordner converter_audio_dir_owner string leer Standard Eigent\u00fcmer der konvertierten Audio-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Eigent\u00fcmer Download ZIP-Ordner download_dir_owner string leer Standard Eigent\u00fcmer der vorbereiteten ZIP-Dateien im Format user:gruppe. Leer = Standardbenutzer des Dienstes. Kapitel Template (Audiobook) output_chapter_template_audiobook string {author}/{author} - {title} ({year})/{chapterNr} {chapterTitle} Standard Template f\u00fcr kapitelweise Audiobook-Ausgaben (MP3/FLAC) ohne Dateiendung. Platzhalter: {author}, {title}, {year}, {narrator}, {series}, {part}, {format}, {chapterNr}, {chapterNo}, {chapterTitle}. Unterordner sind \u00fcber \"/\" m\u00f6glich."},{"location":"configuration/settings-reference/#kategorie-tools","title":"Kategorie: Tools","text":"GUI-Feld Key Typ Default Sichtbarkeit Wirkung im System MakeMKV Kommando makemkv_command string makemkvcon Expertenmodus Pfad oder Befehl f\u00fcr makemkvcon. MakeMKV Key makemkv_registration_key string leer Standard Optionaler Registrierungsschl\u00fcssel. Wird beim Speichern nach ~/.MakeMKV/settings.conf synchronisiert. Darunter kann der aktuelle Betakey per API \u00fcbernommen werden. Mediainfo Kommando mediainfo_command string mediainfo Expertenmodus Pfad oder Befehl f\u00fcr mediainfo. Minimale Titell\u00e4nge (Minuten) makemkv_min_length_minutes number 60 Standard Filtert kurze Titel beim Rip. HandBrake Kommando handbrake_command string HandBrakeCLI Expertenmodus Pfad oder Befehl f\u00fcr HandBrakeCLI. Encode-Neustart: unvollst\u00e4ndige Ausgabe l\u00f6schen handbrake_restart_delete_incomplete_output boolean true Standard Wenn aktiv, wird bei \"Encode neu starten\" der bisherige (nicht erfolgreiche) Output vor Start entfernt. Parallele Jobs pipeline_max_parallel_jobs number 1 Standard Maximale Anzahl parallel laufender Jobs. Weitere Starts landen in der Queue. Max. parallele Audio CD Jobs pipeline_max_parallel_cd_encodes number 2 Standard Maximale Anzahl parallel laufender Audio CD Jobs (Rip + Encode als Einheit). Gilt zus\u00e4tzlich zum Gesamtlimit. Script-Test Timeout (ms) script_test_timeout_ms number 0 Expertenmodus Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. Max. Encodes gesamt (medienunabh\u00e4ngig) pipeline_max_total_encodes number 3 Standard Gesamtlimit f\u00fcr alle parallel laufenden Encode-Jobs (Film + Audio CD). Dieses Limit hat Vorrang vor den Einzellimits. Audio CDs: Queue-Reihenfolge \u00fcberspringen pipeline_cd_bypasses_queue boolean false Standard Wenn aktiv, k\u00f6nnen Audio CD Jobs unabh\u00e4ngig von Film-Jobs starten (\u00fcberspringen die Film-Queue-Reihenfolge). Einzellimits und Gesamtlimit gelten weiterhin. cdparanoia Kommando cdparanoia_command string cdparanoia Expertenmodus Pfad oder Befehl f\u00fcr cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. FFmpeg Kommando ffmpeg_command string ffmpeg Standard Pfad oder Befehl f\u00fcr ffmpeg. Wird f\u00fcr Audiobook-Encoding genutzt. FFprobe Kommando ffprobe_command string ffprobe Standard Pfad oder Befehl f\u00fcr ffprobe. Wird f\u00fcr Audiobook-Metadaten und Kapitel genutzt. Serie: PlayAll Untergrenze (%) series_playall_tolerance_lower_pct number 10 Standard Untere Toleranz in Prozent f\u00fcr die Plausibilit\u00e4tspr\u00fcfung von PlayAll gegen Episodensumme (DVD/Blu-ray). Serie: PlayAll Obergrenze (%) series_playall_tolerance_upper_pct number 10 Standard Obere Toleranz in Prozent f\u00fcr die Plausibilit\u00e4tspr\u00fcfung von PlayAll gegen Episodensumme (DVD/Blu-ray). Mediainfo Extra Args mediainfo_extra_args_bluray string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr mediainfo (Blu-ray). MakeMKV Rip Modus makemkv_rip_mode_bluray select backup Ausgeblendet (nur API/DB) mkv: direkte MKV-Dateien; backup: vollst\u00e4ndige Blu-ray Struktur im RAW-Ordner. MakeMKV Analyze Extra Args makemkv_analyze_extra_args_bluray string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr Analyze (Blu-ray). MakeMKV Rip Extra Args makemkv_rip_extra_args_bluray string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr Rip (Blu-ray). HandBrake Preset handbrake_preset_bluray string H.264 MKV 1080p30 Standard Preset Name f\u00fcr -Z (Blu-ray). Leer = kein Preset, nur CLI-Parameter werden verwendet. HandBrake Extra Args handbrake_extra_args_bluray string --audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au... Standard Zus\u00e4tzliche CLI-Argumente (Blu-ray). Ausgabeformat output_extension_bluray select mkv Standard Dateiendung f\u00fcr finale Datei (Blu-ray). Mediainfo Extra Args mediainfo_extra_args_dvd string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr mediainfo (DVD). MakeMKV Rip Modus makemkv_rip_mode_dvd select mkv Ausgeblendet (nur API/DB) mkv: direkte MKV-Dateien; backup: vollst\u00e4ndige Disc-Struktur im RAW-Ordner. MakeMKV Analyze Extra Args makemkv_analyze_extra_args_dvd string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr Analyze (DVD). MakeMKV Rip Extra Args makemkv_rip_extra_args_dvd string leer Expertenmodus Zus\u00e4tzliche CLI-Parameter f\u00fcr Rip (DVD). HandBrake Preset handbrake_preset_dvd string H.264 MKV 480p30 Standard Preset Name f\u00fcr -Z (DVD). Leer = kein Preset, nur CLI-Parameter werden verwendet. HandBrake Extra Args handbrake_extra_args_dvd string --audio-lang-list deu,eng --first-audio --subtitle-lang-list deu,eng --first-subtitle --aencoder copy --audio-copy-mask ac3,eac3,dts --au... Standard Zus\u00e4tzliche CLI-Argumente (DVD). Ausgabeformat output_extension_dvd select mkv Standard Dateiendung f\u00fcr finale Datei (DVD). mkvmerge Kommando mkvmerge_command string mkvmerge Standard Pfad oder Befehl f\u00fcr mkvmerge. Wird f\u00fcr Multipart-Movie-Merges genutzt."},{"location":"configuration/settings-reference/#beispiele-fuer-haeufige-settings","title":"Beispiele fuer haeufige Settings","text":"
     
  • drive_devices: [{\"path\":\"/dev/sr0\",\"makemkvIndex\":0},{\"path\":\"/dev/sr1\",\"makemkvIndex\":1}]
    •  
  • external_storage_paths: [{\"name\":\"USB HDD\",\"path\":\"/mnt/usb-hdd\"}]
    •  
  • converter_scan_extensions: mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus
    •  
  • output_template_bluray: ${title} (${year})/${title} (${year})
    •  
  • output_template_audiobook: {author}/{author} - {title} ({year})
    •  
  • output_chapter_template_audiobook: {author}/{author} - {title} ({year})/{chapterNr} {chapterTitle}
    •  
  • download_dir_owner: ripster:media
    •  
"},{"location":"configuration/settings-reference/#hinweise-zu-ausgeblendeten-keys","title":"Hinweise zu ausgeblendeten Keys","text":"
Folgende Keys liegen im Schema, sind aber im normalen Settings-Formular absichtlich ausgeblendet: drive_device, makemkv_source_index, makemkv_rip_mode_bluray, makemkv_rip_mode_dvd. Aenderungen daran erfolgen nur ueber API/DB oder technische Migrationen.
"},{"location":"deployment/","title":"Anhang: Deployment","text":"
Technische Betriebsdokumentation f\u00fcr Entwicklung und Produktion.
 
     
  •  
     Entwicklungsumgebung
     
    Lokale Entwicklung mit Hot-Reload.
     
     Entwicklung
     
    •  
  •  
     Produktion
     
    Installation und Betrieb auf Servern.
     
     Produktion
     
    •  
"},{"location":"deployment/development/","title":"Entwicklungsumgebung","text":""},{"location":"deployment/development/#voraussetzungen","title":"Voraussetzungen","text":"
     
  • Node.js >= 20.19.0
    •  
  • externe Tools installiert (makemkvcon, HandBrakeCLI, mediainfo)
    •  
"},{"location":"deployment/development/#schnellstart","title":"Schnellstart","text":"
./start.sh\n
 
Startet:
 
     
  • Backend (http://localhost:3001, mit nodemon)
    •  
  • Frontend (http://localhost:5173, mit Vite HMR)
    •  
 
Stoppen: Ctrl+C.
"},{"location":"deployment/development/#manuell","title":"Manuell","text":""},{"location":"deployment/development/#backend","title":"Backend","text":"
cd backend\nnpm install\nnpm run dev\n
"},{"location":"deployment/development/#frontend","title":"Frontend","text":"
cd frontend\nnpm install\nnpm run dev\n
"},{"location":"deployment/development/#vite-proxy-dev","title":"Vite-Proxy (Dev)","text":"
frontend/vite.config.js proxied standardm\u00e4\u00dfig:
 
     
  • /api -> http://127.0.0.1:3001
    •  
  • /ws -> ws://127.0.0.1:3001
    •  
"},{"location":"deployment/development/#remote-dev-optional","title":"Remote-Dev (optional)","text":"
Beispiel frontend/.env.local:
 
VITE_API_BASE=http://192.168.1.100:3001/api\nVITE_WS_URL=ws://192.168.1.100:3001/ws\nVITE_PUBLIC_ORIGIN=http://192.168.1.100:5173\nVITE_ALLOWED_HOSTS=192.168.1.100,ripster.local\nVITE_HMR_PROTOCOL=ws\nVITE_HMR_HOST=192.168.1.100\nVITE_HMR_CLIENT_PORT=5173\n
"},{"location":"deployment/development/#nutzliche-kommandos","title":"N\u00fctzliche Kommandos","text":"
# Root dev (backend + frontend)\nnpm run dev\n\n# einzeln\nnpm run dev:backend\nnpm run dev:frontend\n\n# Frontend Build\nnpm run build:frontend\n
"},{"location":"deployment/production/","title":"Produktions-Deployment","text":""},{"location":"deployment/production/#automatische-installation-empfohlen","title":"Automatische Installation (empfohlen)","text":"
Das mitgelieferte install.sh richtet Ripster vollautomatisch ein \u2013 inklusive Node.js, MakeMKV, HandBrake, nginx und systemd-Dienst.
 
Unterst\u00fctzte Systeme laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS Voraussetzung: root-Rechte, Internetzugang
"},{"location":"deployment/production/#schnellstart-via-curl","title":"Schnellstart via curl","text":"
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash\n
 
Oder mit wget:
 
wget -qO- https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh | sudo bash\n
 
Optionen nur via Datei
 
Beim Pipen von curl/wget k\u00f6nnen keine Argumente \u00fcbergeben werden. F\u00fcr benutzerdefinierte Optionen zuerst herunterladen und dann mit sudo bash install.sh [Optionen] ausf\u00fchren.
"},{"location":"deployment/production/#optionen","title":"Optionen","text":"Option Standard Beschreibung --branch <branch> dev Git-Branch f\u00fcr die Installation --dir <pfad> /opt/ripster Installationsverzeichnis --user <benutzer> ripster Systembenutzer f\u00fcr den Dienst --port <port> 3001 Backend-Port --host <hostname> Auto (Maschinen-IP) Hostname/IP f\u00fcr die Weboberfl\u00e4che --no-makemkv \u2013 MakeMKV-Installation \u00fcberspringen --no-handbrake \u2013 HandBrake-Installation \u00fcberspringen --no-nginx \u2013 nginx-Einrichtung \u00fcberspringen --reinstall \u2013 Bestehende Installation aktualisieren (Daten bleiben erhalten) -h, --help \u2013 Hilfe anzeigen"},{"location":"deployment/production/#beispiele","title":"Beispiele","text":"
# Standard-Installation\nsudo bash install.sh\n\n# Anderen Branch und Port verwenden\nsudo bash install.sh --branch dev --port 8080\n\n# Ohne MakeMKV (bereits installiert)\nsudo bash install.sh --no-makemkv\n\n# Bestehende Installation aktualisieren\nsudo bash install.sh --reinstall\n\n# Ohne nginx (eigener Reverse-Proxy)\nsudo bash install.sh --no-nginx --host mein-server.local\n
"},{"location":"deployment/production/#was-das-skript-erledigt","title":"Was das Skript erledigt","text":"
     
  1. Systempr\u00fcfung \u2013 OS-Erkennung und Root-Check
    2.  
  2. Systempakete \u2013 curl, wget, git, mediainfo, udev u. a.
    3.  
  3. Node.js 20 \u2013 via NodeSource, falls noch nicht installiert
    4.  
  4. MakeMKV \u2013 aktuelle Version wird aus dem offiziellen Forum ermittelt und aus dem Quellcode kompiliert (kann mit --no-makemkv \u00fcbersprungen werden)
    5.  
  5. HandBrake \u2013 interaktive Auswahl:
       
    • Option 1: Standard (apt install handbrake-cli)
      •  
    • Option 2: Geb\u00fcndelte GPU-Version mit NVDEC aus bin/HandBrakeCLI
      •  
     
    6.  
  6. Systembenutzer ripster \u2013 ohne Login-Shell und ohne Home-Verzeichnis; Gruppen werden (falls vorhanden) erg\u00e4nzt: cdrom, optical, disk, video, render
    7.  
  7. Repository \u2013 klont Branch nach --dir (bei --reinstall: sichert backend/data, aktualisiert Repo, stellt Daten wieder her)
    8.  
  8. Verzeichnisse \u2013 stellt u. a. sicher: backend/data, backend/logs, backend/data/output/raw, backend/data/output/movies, backend/data/logs
    9.  
  9. npm-Abh\u00e4ngigkeiten \u2013 Root, Backend (nur production), Frontend
    10.  
  10. Frontend-Build \u2013 npm run build mit relativen API-URLs (nginx-kompatibel)
    11.  
  11. Backend .env \u2013 wird automatisch generiert (bei --reinstall bleibt bestehende .env erhalten)
    12.  
  12. Berechtigungen \u2013 zun\u00e4chst ripster:ripster auf Installationsverzeichnis; bei sudo-Aufruf werden Output-/Log-Ordner auf <aufrufender user>:ripster mit 775 gesetzt; .env wird auf 600 gesetzt
    13.  
  13. MakeMKV User-Ordner \u2013 erstellt bei sudo-Aufruf ~/.MakeMKV f\u00fcr den aufrufenden Benutzer
    14.  
  14. systemd-Dienst \u2013 ripster-backend.service erstellt, aktiviert und gestartet
    15.  
  15. nginx \u2013 konfiguriert als Reverse-Proxy f\u00fcr Frontend, /api/ und /ws (kann mit --no-nginx \u00fcbersprungen werden)
    16.  
"},{"location":"deployment/production/#nach-der-installation","title":"Nach der Installation","text":"
# Status pr\u00fcfen\nsudo systemctl status ripster-backend\n\n# Logs verfolgen\nsudo journalctl -u ripster-backend -f\n\n# Neustart\nsudo systemctl restart ripster-backend\n\n# Aktualisieren\nsudo bash /opt/ripster/install.sh --reinstall\n
 
Zugriff: http://<Maschinen-IP> (oder der mit --host angegebene Hostname)
"},{"location":"deployment/production/#handbrake-modus-gpunvdec","title":"HandBrake-Modus (GPU/NVDEC)","text":"
Bei nicht-interaktiver Ausf\u00fchrung (Pipe von curl) wird automatisch die Standard-Version gew\u00e4hlt. F\u00fcr die GPU-Version zuerst herunterladen:
 
curl -fsSL https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh -o install.sh\nsudo bash install.sh\n# \u2192 Interaktive Auswahl: Option 2 f\u00fcr NVDEC\n
 
Das geb\u00fcndelte Binary liegt unter bin/HandBrakeCLI und wird nach /usr/local/bin/HandBrakeCLI kopiert.
"},{"location":"deployment/production/#manuelle-installation","title":"Manuelle Installation","text":"
Die folgenden Abschnitte beschreiben die einzelnen Schritte f\u00fcr manuelle oder angepasste Setups.
"},{"location":"deployment/production/#empfohlene-architektur","title":"Empfohlene Architektur","text":"
Client\n  -> nginx (Reverse Proxy + statisches Frontend)\n    -> Backend API/WebSocket (Node.js, Port 3001)\n
 
Wichtig: Das Backend serviert im aktuellen Stand keine frontend/dist-Dateien automatisch.
"},{"location":"deployment/production/#1-frontend-builden","title":"1) Frontend builden","text":"
cd frontend\nnpm install\nnpm run build\n
 
Artefakte liegen in frontend/dist/.
"},{"location":"deployment/production/#2-backend-als-systemd-service","title":"2) Backend als systemd-Service","text":"
Beispiel /etc/systemd/system/ripster-backend.service:
 
[Unit]\nDescription=Ripster Backend\nAfter=network.target\n\n[Service]\nType=simple\nUser=ripster\nWorkingDirectory=/opt/ripster/backend\nExecStart=/usr/bin/env node src/index.js\nRestart=on-failure\nRestartSec=5\nEnvironment=NODE_ENV=production\nEnvironment=PORT=3001\nEnvironment=LOG_LEVEL=info\n\n[Install]\nWantedBy=multi-user.target\n
 
Aktivieren:
 
sudo systemctl daemon-reload\nsudo systemctl enable --now ripster-backend\nsudo systemctl status ripster-backend\n
"},{"location":"deployment/production/#3-nginx-konfigurieren","title":"3) nginx konfigurieren","text":"
Beispiel /etc/nginx/sites-available/ripster:
 
server {\n    listen 80;\n    server_name ripster.local;\n    client_max_body_size 8G;\n\n    root /opt/ripster/frontend/dist;\n    index index.html;\n\n    location / {\n        try_files $uri $uri/ /index.html;\n    }\n\n    location /api/ {\n        proxy_pass http://127.0.0.1:3001;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n    }\n\n    location /ws {\n        proxy_pass http://127.0.0.1:3001;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection \"upgrade\";\n        proxy_set_header Host $host;\n    }\n}\n
 
Aktivieren:
 
sudo ln -s /etc/nginx/sites-available/ripster /etc/nginx/sites-enabled/\nsudo nginx -t\nsudo systemctl reload nginx\n
 
Hinweis: Fuer groessere Uploads wie .aax-Audiobooks muss client_max_body_size ausreichend hoch gesetzt sein. Im mitgelieferten Beispiel sind 8G hinterlegt.
"},{"location":"deployment/production/#datenbank-backup","title":"Datenbank-Backup","text":"
sqlite3 /opt/ripster/backend/data/ripster.db \\\n  \".backup '/var/backups/ripster-$(date +%Y%m%d).db'\"\n
"},{"location":"deployment/production/#sicherheit","title":"Sicherheit","text":"
     
  • Ripster hat keine eingebaute Authentifizierung.
    •  
  • F\u00fcr externen Zugriff mindestens Basic Auth + TLS + Netzwerksegmentierung/VPN einsetzen.
    •  
  • Secrets nicht ins Repo committen (.env, Settings-Felder).
    •  
"},{"location":"getting-started/","title":"Benutzerhandbuch \u00dcberblick","text":"
Dieses Kapitel ist f\u00fcr den Betrieb von Ripster im Alltag geschrieben.
"},{"location":"getting-started/#zielgruppe","title":"Zielgruppe","text":"
     
  • Anwender, die Discs verarbeiten wollen
    •  
  • Betreiber, die den t\u00e4glichen Ablauf stabil fahren m\u00f6chten
    •  
  • Power-User, die Queue/Skripte/Cron im UI steuern m\u00f6chten
    •  
"},{"location":"getting-started/#kapitelstruktur","title":"Kapitelstruktur","text":"Kapitel Zweck Voraussetzungen Produktions- vs. Dev-Voraussetzungen klar trennen Installation Ripster aufsetzen und starten Ersteinrichtung Pfade, Tools und Metadaten korrekt setzen Erster Lauf Ein kompletter Job von Disc bis Datei GUI-Seiten Alle Ansichten und Aktionen im Detail Workflows Typische Abl\u00e4ufe und Entscheidungen aus User-Sicht"},{"location":"getting-started/#wenn-du-neu-startest","title":"Wenn du neu startest","text":"
     
  1. Voraussetzungen
    2.  
  2. Installation
    3.  
  3. Ersteinrichtung
    4.  
  4. Erster Lauf
    5.  
"},{"location":"getting-started/#wenn-ripster-bereits-lauft","title":"Wenn Ripster bereits l\u00e4uft","text":"
     
  1. GUI-Seiten
    2.  
  2. Workflows
    3.  
  3. Bei Detailfragen: Technischer Anhang
    4.  
"},{"location":"getting-started/configuration/","title":"Ersteinrichtung","text":"
Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
"},{"location":"getting-started/configuration/#ziel-der-ersteinrichtung","title":"Ziel der Ersteinrichtung","text":"
Vor dem ersten Job m\u00fcssen drei Dinge stabil sein:
 
     
  1. Pfade stimmen (RAW, Output, Logs)
    2.  
  2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
    3.  
  3. Metadatenzug\u00e4nge funktionieren (OMDb, optional TMDb/MusicBrainz)
    4.  
"},{"location":"getting-started/configuration/#empfohlene-reihenfolge","title":"Empfohlene Reihenfolge","text":""},{"location":"getting-started/configuration/#1-basis-in-settings-konfiguration","title":"1) Basis in Settings -> Konfiguration","text":"
Setze zuerst:
 
     
  • Raw-Ordner und Film-/Serien-Ordner
    •  
  • Log Ordner
    •  
  • MakeMKV Kommando, HandBrake Kommando, Mediainfo Kommando
    •  
  • OMDb API Key
    •  
 
Dann speichern.
"},{"location":"getting-started/configuration/#2-profile-pro-medium-festziehen","title":"2) Profile pro Medium festziehen","text":"
Ripster l\u00f6st viele Werte profilspezifisch auf (bluray, dvd, cd, audiobook).
 
Pflichtpr\u00fcfung:
 
     
  • RAW-Pfade je Profil
    •  
  • Output-Pfade je Profil
    •  
  • HandBrake-Preset je Profil
    •  
  • Output-Templates je Profil
    •  
 
F\u00fcr Serien zus\u00e4tzlich:
 
     
  • RAW-Ordner (Blu-ray/DVD Serie)
    •  
  • Serien-Ordner (Blu-ray/DVD)
    •  
  • Serien-Templates (Episode/Multi-Episode)
    •  
"},{"location":"getting-started/configuration/#3-queue-verhalten-definieren","title":"3) Queue-Verhalten definieren","text":"
Stelle ein:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
 
Damit steuerst du Durchsatz, Priorit\u00e4t und Lastverteilung.
"},{"location":"getting-started/configuration/#4-metadatenquellen-absichern","title":"4) Metadatenquellen absichern","text":"
Film:
 
     
  • OMDb-Key pr\u00fcfen
    •  
 
Serien:
 
     
  • TMDb Read Access Token setzen
    •  
  • Sprache/Fallback-Sprachen festlegen
    •  
 
CD/Audiodaten:
 
     
  • MusicBrainz aktiviert nach Bedarf
    •  
"},{"location":"getting-started/configuration/#5-optional-benachrichtigungen","title":"5) Optional: Benachrichtigungen","text":"
     
  • PushOver-Zugangsdaten setzen
    •  
  • PushOver Test ausf\u00fchren
    •  
  • Event-Toggles pro Phase pr\u00fcfen
    •  
"},{"location":"getting-started/configuration/#6-optional-automatisierung","title":"6) Optional: Automatisierung","text":"
     
  1. Skripte testen
    2.  
  2. Skriptketten bauen/testen
    3.  
  3. Cronjobs erst danach aktivieren
    4.  
"},{"location":"getting-started/configuration/#funktionsprufung-kurztest","title":"Funktionspr\u00fcfung (Kurztest)","text":"
     
  1. Disc in Ripper erkennen lassen.
    2.  
  2. Analyse starten.
    3.  
  3. Metadaten \u00fcbernehmen.
    4.  
  4. Bis Bereit zum Encodieren laufen.
    5.  
  5. Encode starten und Abschluss in Historie pr\u00fcfen.
    6.  
"},{"location":"getting-started/configuration/#typische-konfigurationsfehler","title":"Typische Konfigurationsfehler","text":"Symptom H\u00e4ufige Ursache Job bleibt fr\u00fch auf Fehler Toolkommando falsch oder nicht im PATH RAW/Output landet am falschen Ort Profilpfade nicht gesetzt, Fallback greift Serienausgabe landet bei Filmen Serienpfade/Serientemplates fehlen Queue verh\u00e4lt sich unerwartet Gesamtlimit und Lane-Limits widersprechen sich"},{"location":"getting-started/configuration/#weiter","title":"Weiter","text":"
     
  • Erster Lauf
    •  
  • GUI-Seiten
    •  
  • Workflows aus Nutzersicht
    •  
"},{"location":"getting-started/installation/","title":"Installation","text":"
Die empfohlene Installation l\u00e4uft \u00fcber install.sh und richtet Ripster vollst\u00e4ndig ein.
 
Du musst daf\u00fcr keine Tools manuell vorinstallieren. Das Skript installiert die ben\u00f6tigten Abh\u00e4ngigkeiten automatisch, sofern sie nicht explizit mit --no-* \u00fcbersprungen werden.
"},{"location":"getting-started/installation/#unterstutzte-systeme-und-anforderungen","title":"Unterst\u00fctzte Systeme und Anforderungen","text":"
     
  • unterst\u00fctzt laut Script: debian, ubuntu, linuxmint, pop
    •  
  • Ausf\u00fchrung als root (oder via sudo)
    •  
  • Internetzugang w\u00e4hrend der Installation
    •  
"},{"location":"getting-started/installation/#schritt-fur-schritt","title":"Schritt-f\u00fcr-Schritt","text":""},{"location":"getting-started/installation/#1-installationsskript-herunterladen","title":"1. Installationsskript herunterladen","text":"
wget -qO install.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh\n
"},{"location":"getting-started/installation/#2-installation-ausfuhren","title":"2. Installation ausf\u00fchren","text":"
sudo bash install.sh\n
 
W\u00e4hrend der Installation w\u00e4hlst du den HandBrake-Modus:
 
     
  • 1 Standard (Paketinstallation)
    •  
  • 2 GPU/NVDEC (geb\u00fcndeltes Binary)
    •  
"},{"location":"getting-started/installation/#3-dienststatus-prufen","title":"3. Dienststatus pr\u00fcfen","text":"
sudo systemctl status ripster-backend\n
"},{"location":"getting-started/installation/#4-weboberflache-offnen","title":"4. Weboberfl\u00e4che \u00f6ffnen","text":"
     
  • mit nginx (Standard): http://<Server-IP>
    •  
  • ohne nginx (--no-nginx): API auf http://<Server-IP>:3001/api
    •  
"},{"location":"getting-started/installation/#was-installsh-konkret-einrichtet","title":"Was install.sh konkret einrichtet","text":"
     
  1. pr\u00fcft Betriebssystem, Root-Rechte und ermittelt Host/IP
    2.  
  2. aktualisiert Paketquellen und installiert Basispakete (curl, wget, git, mediainfo, udev ...)
    3.  
  3. installiert Node.js 20 (falls nicht passend vorhanden)
    4.  
  4. installiert optional MakeMKV (Build aus den offiziellen Quellen)
    5.  
  5. installiert optional HandBrakeCLI (Standard oder GPU/NVDEC)
    6.  
  6. installiert optional nginx
    7.  
  7. legt den Systembenutzer ripster an (ohne Login-Shell, ohne Home) und erg\u00e4nzt Gruppen (cdrom, optical, disk, video, render, falls vorhanden)
    8.  
  8. klont das Repository nach /opt/ripster (oder aktualisiert bei --reinstall)
    9.  
  9. legt Verzeichnisse an:
    10.  
  10. /opt/ripster/backend/data
    11.  
  11. /opt/ripster/backend/logs
    12.  
  12. /opt/ripster/backend/data/output/raw
    13.  
  13. /opt/ripster/backend/data/output/movies
    14.  
  14. /opt/ripster/backend/data/logs
    15.  
  15. installiert npm-Abh\u00e4ngigkeiten (Root, Backend, Frontend) und baut das Frontend
    16.  
  16. erzeugt backend/.env (bei --reinstall bleibt bestehende .env erhalten)
    17.  
  17. setzt Rechte/Besitz und erstellt bei sudo-Installation zus\u00e4tzlich ~/.MakeMKV f\u00fcr den aufrufenden Benutzer
    18.  
  18. erzeugt und startet ripster-backend.service
    19.  
  19. konfiguriert und startet nginx (falls nicht \u00fcbersprungen)
    20.  
"},{"location":"getting-started/installation/#wichtige-optionen","title":"Wichtige Optionen","text":"Option Default laut Script Zweck --branch <branch> dev Branch f\u00fcr die Installation --dir <pfad> /opt/ripster Installationsverzeichnis --user <benutzer> ripster Service-Benutzer --port <port> 3001 Backend-Port --host <hostname> automatisch ermittelte Host-IP Hostname/IP f\u00fcr Webzugriff/CORS --no-makemkv aus MakeMKV-Installation \u00fcberspringen --no-handbrake aus HandBrake-Installation \u00fcberspringen --no-nginx aus nginx-Setup \u00fcberspringen --reinstall aus bestehende Installation aktualisieren 
Beispiele:
 
sudo bash install.sh --branch dev\nsudo bash install.sh --port 8080 --host ripster.local\nsudo bash install.sh --reinstall\n
"},{"location":"getting-started/installation/#betrieb-im-alltag","title":"Betrieb im Alltag","text":"
# Logs live ansehen\nsudo journalctl -u ripster-backend -f\n\n# Dienst neu starten\nsudo systemctl restart ripster-backend\n\n# Update aus bestehender Installation\nsudo bash /opt/ripster/install.sh --reinstall\n
"},{"location":"getting-started/installation/#haufige-stolperstellen","title":"H\u00e4ufige Stolperstellen","text":"
     
  • Laufwerk nicht zugreifbar: Laufwerksrechte/Gruppen pr\u00fcfen
    •  
  • CLI-Tool fehlt wegen --no-*: Tool nachinstallieren oder Befehl in Settings korrigieren
    •  
  • UI nicht erreichbar: nginx-Status und Firewall pr\u00fcfen
    •  
"},{"location":"getting-started/installation/#danach-weiter","title":"Danach weiter","text":"
     
  1. Ersteinrichtung
    2.  
  2. Erster Lauf
    3.  
"},{"location":"getting-started/prerequisites/","title":"Voraussetzungen","text":"
Die Voraussetzungen h\u00e4ngen davon ab, wie du Ripster betreibst.
"},{"location":"getting-started/prerequisites/#produktionsbetrieb-mit-installsh-standard","title":"Produktionsbetrieb mit install.sh (Standard)","text":"
F\u00fcr den normalen Betrieb sind nur wenige Punkte vorab n\u00f6tig.
"},{"location":"getting-started/prerequisites/#pflicht","title":"Pflicht","text":"
     
  • unterst\u00fctztes Linux-System (laut Script: Debian, Ubuntu, Linux Mint, Pop!_OS)
    •  
  • root-Rechte
    •  
  • Internetzugang w\u00e4hrend der Installation
    •  
  • optisches Laufwerk f\u00fcr Disc-Betrieb
    •  
 
install.sh installiert die ben\u00f6tigten Tools selbst (u. a. Node.js, MakeMKV, HandBrakeCLI, MediaInfo), sofern sie nicht explizit per --no-* \u00fcbersprungen werden.
"},{"location":"getting-started/prerequisites/#laufwerk-kurz-prufen","title":"Laufwerk kurz pr\u00fcfen","text":"
ls /dev/sr*\nlsblk | grep rom\n
 
Wenn n\u00f6tig Rechte setzen (Beispiel):
 
sudo chmod a+rw /dev/sr0\n
"},{"location":"getting-started/prerequisites/#optional-vorab","title":"Optional vorab","text":"
     
  • OMDb API-Key (kann auch nach Installation in den Settings gesetzt werden)
    •  
  • PushOver-Zugangsdaten (optional)
    •  
"},{"location":"getting-started/prerequisites/#entwicklungsmodus-nur-fur-dev","title":"Entwicklungsmodus (nur f\u00fcr Dev)","text":"
Wenn du lokal entwickelst (./start.sh, npm run dev), gelten zus\u00e4tzliche Voraussetzungen:
 
     
  • Node.js >= 20.19.0
    •  
  • makemkvcon, HandBrakeCLI, mediainfo im PATH
    •  
 
Details: Entwicklungsumgebung
"},{"location":"getting-started/prerequisites/#abschluss-checkliste","title":"Abschluss-Checkliste","text":"
     
  • [ ] Produktionsbetrieb: Linux + root + Internet + Laufwerk vorhanden
    •  
  • [ ] Dev-Modus (nur falls ben\u00f6tigt): Node.js und CLI-Tools verf\u00fcgbar
    •  
"},{"location":"getting-started/quickstart/","title":"Erster Lauf","text":"
Dieser Ablauf f\u00fchrt einen vollst\u00e4ndigen Disc-Job von Erkennung bis fertiger Datei durch.
"},{"location":"getting-started/quickstart/#1-disc-erkennen","title":"1) Disc erkennen","text":"
     
  1. Ripper \u00f6ffnen.
    2.  
  2. Disc einlegen.
    3.  
  3. Auf Medium erkannt warten.
    4.  
 
Pr\u00fcfen:
 
     
  • Disk-Information zeigt Device/Label.
    •  
  • Falls nicht: Laufwerk neu lesen.
    •  
"},{"location":"getting-started/quickstart/#2-analyse-starten","title":"2) Analyse starten","text":"
Aktion:
 
     
  • Analyse starten
    •  
 
Erwartung:
 
     
  • Status Analyse
    •  
  • danach Metadaten-Dialog
    •  
"},{"location":"getting-started/quickstart/#3-metadaten-bestatigen","title":"3) Metadaten best\u00e4tigen","text":"
Im Dialog:
 
     
  1. Treffer suchen/ausw\u00e4hlen.
    2.  
  2. Bei Serie zus\u00e4tzlich Disc-Nummer setzen.
    3.  
  3. Auswahl \u00fcbernehmen.
    4.  
 
M\u00f6gliche Abzweigungen:
 
     
  • Duplikatfilm -> \u00dcbernahme erzwingen oder Multipart movie
    •  
  • vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
    •  
"},{"location":"getting-started/quickstart/#4-ripreview-phase","title":"4) Rip/Review-Phase","text":"
Normalfall:
 
     
  • Startbereit -> Rippen -> Mediainfo-Pruefung
    •  
 
M\u00f6gliche Alternativen:
 
     
  • vorhandenes RAW: direkter Sprung in Pr\u00fcfung
    •  
  • Blu-ray/DVD-Entscheidung n\u00f6tig: Warte auf Auswahl f\u00fcr Playlist/Titel
    •  
"},{"location":"getting-started/quickstart/#5-encode-review-abschlieen","title":"5) Encode-Review abschlie\u00dfen","text":"
Bei Bereit zum Encodieren:
 
     
  • Titel festlegen
    •  
  • Audio-/Subtitle-Spuren pr\u00fcfen
    •  
  • optional Preset ausw\u00e4hlen
    •  
  • optional Pre-/Post-Skripte w\u00e4hlen
    •  
 
Dann:
 
     
  • Encoding starten
    •  
"},{"location":"getting-started/quickstart/#6-encoding-uberwachen","title":"6) Encoding \u00fcberwachen","text":"
W\u00e4hrend Encodieren:
 
     
  • Fortschritt/ETA im Ripper
    •  
  • Queue- und Runtime-Status beobachten
    •  
  • optional Logkontrolle in Historie
    •  
"},{"location":"getting-started/quickstart/#7-ergebnis-verifizieren","title":"7) Ergebnis verifizieren","text":"
Nach Fertig:
 
     
  1. Historie \u00f6ffnen.
    2.  
  2. Jobdetail pr\u00fcfen.
    3.  
  3. Output-Pfad und Log plausibilisieren.
    4.  
 
Kontrollpunkte:
 
     
  • finale Datei am erwarteten Template-Pfad
    •  
  • RAW-Ordnerzustand finalisiert (kein Incomplete_)
    •  
"},{"location":"getting-started/quickstart/#8-typische-folgeaktionen","title":"8) Typische Folgeaktionen","text":"
     
  • falsche Metadaten: OMDb neu zuordnen
    •  
  • andere Trackauswahl: Review neu starten
    •  
  • erneuter Encode aus RAW: RAW neu encodieren
    •  
  • gleicher Plan erneut: Encode neu starten
    •  
"},{"location":"gui/","title":"GUI-Seiten","text":"
Dieses Kapitel ist das Bedienhandbuch f\u00fcr die Oberfl\u00e4chen im Alltag.
"},{"location":"gui/#seitenuberblick","title":"Seiten\u00fcberblick","text":"Seite Rolle im Betrieb Typischer Einsatz Ripper Live-Steuerung der Pipeline Disc-Flow starten, Queue steuern, Review freigeben Audiobooks AAX-Spezialflow Upload, Jobkonfiguration und Encode von Audiobooks Settings Konfiguration/Automatisierung Pfade, Tools, Queue-Limits, Skripte, Cron Historie Nachbearbeitung und Kontrolle Logs, Re-Encode, L\u00f6schvorschau, Recovery-Aktionen Converter dateibasierte Konvertierung Video/Audio/ISO ohne Disc-Rip verarbeiten Downloads ZIP-Exports RAW/Output aus Historie bereitstellen Database (Expert) Recovery-Sicht orphan RAW finden und importieren"},{"location":"gui/#empfohlener-tagesablauf","title":"Empfohlener Tagesablauf","text":"
     
  1. Ripper oder Converter/Audiobooks: neue Arbeit starten.
    2.  
  2. Historie: Ergebnisse validieren und ggf. nachbearbeiten.
    3.  
  3. Downloads: Exporte f\u00fcr externe \u00dcbergabe erzeugen.
    4.  
  4. Settings: Regeln und Limits nur kontrolliert anpassen.
    5.  
"},{"location":"gui/#navigation","title":"Navigation","text":"
Direkt in der Top-Navigation:
 
     
  • Ripper, Converter, Audiobooks, Settings, Historie, Downloads
    •  
 
Nur per URL:
 
     
  • Database unter /database (nur Expertenmodus in der Navigation sichtbar)
    •  
  • TMDb Migration unter /tmdb-migration (Direktlink, nicht in der Navigation)
    •  
"},{"location":"gui/audiobooks/","title":"Audiobooks","text":"
Die Seite Audiobooks ist der spezialisierte Workflow f\u00fcr Audible-*.aax-Dateien.
"},{"location":"gui/audiobooks/#seitenstruktur","title":"Seitenstruktur","text":"
Die Oberfl\u00e4che besteht aus zwei Hauptbereichen:
 
     
  1. Audiobooks Upload
    2.  
  2. Audiobook Jobs
    3.  
"},{"location":"gui/audiobooks/#1-audiobooks-upload","title":"1) Audiobooks Upload","text":"
Der Upload akzeptiert ausschlie\u00dflich .aax.
"},{"location":"gui/audiobooks/#bedienung","title":"Bedienung","text":"
     
  • Datei ausw\u00e4hlen (Button oder Drag-and-Drop)
    •  
  • Upload starten
    •  
  • Auswahl entfernen oder laufenden Upload abbrechen
    •  
 
W\u00e4hrend des Uploads zeigt die UI:
 
     
  • Prozentfortschritt
    •  
  • \u00fcbertragene/gesamte Bytes
    •  
  • Statusmeldung (z. B. \u201eJob vorbereitet\u201c, \u201ein Queue eingereiht\u201c)
    •  
"},{"location":"gui/audiobooks/#ablauf-nach-erfolgreichem-upload","title":"Ablauf nach erfolgreichem Upload","text":"
     
  • AAX wird serverseitig gepr\u00fcft
    •  
  • Audiobook-Job wird angelegt
    •  
  • Job landet je nach Pipelinezustand in READY_TO_START, startet direkt oder wird eingereiht
    •  
"},{"location":"gui/audiobooks/#2-audiobook-jobs","title":"2) Audiobook Jobs","text":"
Gezeigt werden aktive Jobs (nicht abgeschlossene). Fertige Jobs liegen in der Historie.
 
Jeder Job kann eingeklappt/ausgeklappt werden und zeigt:
 
     
  • Titel-/Metadatenblock (Titel, Autor, Sprecher, Jahr, Kapitel)
    •  
  • Statusbadge
    •  
  • Fortschritt/ETA
    •  
  • ggf. Kapitel-Fortschritt
    •  
"},{"location":"gui/audiobooks/#konfigurierbare-job-parameter","title":"Konfigurierbare Job-Parameter","text":"
Im ausgeklappten Job:
 
     
  • Ausgabeformat (m4b, mp3, flac)
    •  
  • formatspezifische Optionen (dynamisch je Format)
    •  
  • Kapitelnamen bearbeiten
    •  
  • Pre-Rip-Ausf\u00fchrungen (Skript/Kette)
    •  
  • Post-Rip-Ausf\u00fchrungen (Skript/Kette)
    •  
"},{"location":"gui/audiobooks/#formatverhalten","title":"Formatverhalten","text":"
     
  • m4b: eine Datei mit Kapiteln
    •  
  • mp3/flac: kapitelweise Ausgabedateien
    •  
 
F\u00fcr mp3/flac zeigt die UI w\u00e4hrend/nach dem Lauf eine Kapitel-Status-Tabelle (Rip/Encode).
"},{"location":"gui/audiobooks/#aktionen-je-job","title":"Aktionen je Job","text":"
     
  • Encode starten (bzw. Neustart mit aktuellen Optionen)
    •  
  • Abbrechen
    •  
  • Job l\u00f6schen (mit Best\u00e4tigung)
    •  
"},{"location":"gui/audiobooks/#relevante-settings","title":"Relevante Settings","text":"
     
  • raw_dir_audiobook
    •  
  • movie_dir_audiobook
    •  
  • audiobook_raw_template
    •  
  • output_template_audiobook
    •  
  • output_chapter_template_audiobook
    •  
  • ffprobe_command
    •  
  • ffmpeg_command
    •  
"},{"location":"gui/audiobooks/#typische-fehlerbilder","title":"Typische Fehlerbilder","text":"
     
  • Upload wird abgelehnt: Datei ist keine g\u00fcltige *.aax.
    •  
  • Start/Encode schl\u00e4gt fehl: ffprobe oder ffmpeg nicht erreichbar.
    •  
  • Unerwartete Ausgabeorte: Templates/Pfade passen nicht zur gew\u00fcnschten Struktur.
    •  
"},{"location":"gui/converter/","title":"Converter","text":"
Die Seite Converter verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
"},{"location":"gui/converter/#betriebsmodell","title":"Betriebsmodell","text":"
Der Converter arbeitet auf dem Eingangspfad converter_raw_dir:
 
     
  • Uploads landen dort
    •  
  • Explorer-Aktionen arbeiten dort
    •  
  • daraus werden Converter-Jobs erstellt
    •  
 
Wichtig:
 
     
  • Upload erzeugt nicht automatisch einen Job.
    •  
  • Joberstellung erfolgt explizit \u00fcber Auswahl im Explorer.
    •  
"},{"location":"gui/converter/#datei-explorer","title":"Datei-Explorer","text":"
Der Explorer zeigt den kompletten Baum unter converter_raw_dir.
 
Aktionen:
 Aktion Wirkung Upload Dateien werden in den Raw-Baum geschrieben Ordner erstellen legt Unterordner im Raw-Baum an Umbenennen benennt Datei/Ordner im Raw-Baum um Verschieben verschiebt innerhalb des Raw-Baums L\u00f6schen entfernt Datei/Ordner dauerhaft Scannen synchronisiert Explorer und DB-Zuordnungen 
Upload-Regeln:
 
     
  • Dateiendung muss in Erlaubte Datei-Endungen* enthalten sein
    •  
  • bei Versto\u00df wird der Upload abgelehnt
    •  
"},{"location":"gui/converter/#joberstellung-aus-explorer-auswahl","title":"Joberstellung aus Explorer-Auswahl","text":"
Es gibt zwei Audio-Strategien:
 
     
  1. Ein Job pro Datei
    2.  
  2. Gemeinsamer Job (Audio)
    3.  
 
Verhalten:
 
     
  • Video/ISO werden grunds\u00e4tzlich als Einzeljobs angelegt.
    •  
  • Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
    •  
 
Shared-Audio-Job:
 
     
  • h\u00e4lt mehrere inputPaths
    •  
  • kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
    •  
"},{"location":"gui/converter/#job-konfiguration","title":"Job-Konfiguration","text":"
Vor Start je Job einstellbar:
 
     
  • converterMediaType (video, audio, iso)
    •  
  • outputFormat
    •  
  • Metadaten
    •  
  • Track-/Titelwahl (bei video/iso)
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
 
Spezifika:
 
     
  • Video/ISO laufen durch Mediainfo/Review \u00e4hnlich zum Disc-Flow.
    •  
  • Audio kann direkt mit Formatoptionen konfiguriert werden.
    •  
"},{"location":"gui/converter/#ausgabe-pfade","title":"Ausgabe-Pfade","text":""},{"location":"gui/converter/#videoiso","title":"Video/ISO","text":"
     
  • Root: converter_movie_dir
    •  
  • Dateiname: Output-Template (Video)
    •  
  • Endung: aus gew\u00e4hltem Output-Format
    •  
"},{"location":"gui/converter/#audio","title":"Audio","text":"
     
  • Root: converter_audio_dir
    •  
  • Dateiname/Ordner: Output-Template (Audio)
    •  
  • bei Shared-/Folder-Job: Ausgabe als Ordnerstruktur mit Trackdateien
    •  
"},{"location":"gui/converter/#queue-und-start","title":"Queue und Start","text":"
Converter-Jobs laufen \u00fcber dieselbe Pipeline-/Queue-Logik:
 
     
  • sofortiger Start wenn Limits frei
    •  
  • sonst Queue-Eintrag
    •  
 
Parallelit\u00e4t richtet sich nach den globalen Encode-Limits in Settings.
"},{"location":"gui/converter/#auto-scan-polling","title":"Auto-Scan (Polling)","text":"
Mit aktiviertem Polling:
 
     
  • converter_raw_dir wird zyklisch gescannt
    •  
  • neue Dateien erscheinen automatisch im Explorer
    •  
 
Relevante Settings:
 
     
  • Auto-Scan (Polling)
    •  
  • Polling-Intervall (Sekunden)
    •  
"},{"location":"gui/converter/#abgrenzung-zu-audiobooks","title":"Abgrenzung zu Audiobooks","text":"
     
  • Converter: beliebige Audio/Video/ISO-Dateien
    •  
  • Audiobooks: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
    •  
"},{"location":"gui/database/","title":"Database (Expert)","text":"
/database ist die Recovery- und Expertensicht f\u00fcr F\u00e4lle, in denen Dateisystem und Historie nicht mehr sauber zusammenpassen.
"},{"location":"gui/database/#zugriff","title":"Zugriff","text":"
     
  • direkte Route: /database
    •  
  • nicht Teil der Standardnavigation
    •  
"},{"location":"gui/database/#bereich-gefundene-raw-eintrage","title":"Bereich Gefundene RAW-Eintr\u00e4ge","text":"
Dieser Bereich listet RAW-Verzeichnisse ohne zugeordneten Historie-Job.
 
Aktionen:
 
     
  • RAW pr\u00fcfen: scannt konfigurierte RAW-Wurzeln
    •  
  • Job anlegen: erstellt aus einem orphan RAW einen neuen Historie-Job
    •  
"},{"location":"gui/database/#was-bei-job-anlegen-passiert","title":"Was bei Job anlegen passiert","text":"
     
  • RAW-Pfad wird als Importquelle registriert
    •  
  • Job wird in die Historie geschrieben
    •  
  • anschlie\u00dfende Analyse l\u00e4uft als RAW-basierter Einstieg (ohne klassischen Disc-Read)
    •  
 
Typischer Einsatz:
 
     
  • manuelle Dateioperationen au\u00dferhalb der UI
    •  
  • Migrationen
    •  
  • Wiederherstellung nach abgebrochenen L\u00e4ufen
    •  
"},{"location":"gui/database/#sicherheits-und-betriebsregeln","title":"Sicherheits- und Betriebsregeln","text":"
     
  • Aktionen wirken direkt auf produktive Historie/Dateipfade.
    •  
  • Vor Import oder L\u00f6schung immer Pfad und Ziel pr\u00fcfen.
    •  
  • Diese Seite nur f\u00fcr Recovery-Szenarien nutzen, nicht f\u00fcr normalen Tagesbetrieb.
    •  
"},{"location":"gui/downloads/","title":"Downloads","text":"
Auf Downloads werden ZIP-Archive f\u00fcr Historie-Artefakte erstellt und bereitgestellt.
"},{"location":"gui/downloads/#was-heruntergeladen-werden-kann","title":"Was heruntergeladen werden kann","text":"
Ein Download-Eintrag referenziert immer einen Historie-Job und genau ein Ziel:
 
     
  • RAW
    •  
  • Output
    •  
 
Erzeugt wird ein ZIP-Archiv im Download-Verzeichnis des Backends.
"},{"location":"gui/downloads/#statusmodell","title":"Statusmodell","text":"Status Bedeutung queued Eintrag erstellt, wartet auf Verarbeitung processing ZIP wird gerade gebaut ready Archiv fertig, Download-Link aktiv failed Erzeugung oder Zugriff fehlgeschlagen"},{"location":"gui/downloads/#eintrag-anlegen","title":"Eintrag anlegen","text":"
Startpunkt ist die Historie:
 
     
  1. Job \u00f6ffnen.
    2.  
  2. Download einreihen.
    3.  
  3. Ziel (RAW oder Output) w\u00e4hlen.
    4.  
  4. Status in Downloads verfolgen.
    5.  
"},{"location":"gui/downloads/#wichtige-laufzeitdetails","title":"Wichtige Laufzeitdetails","text":"
     
  • Wenn bereits ein passendes, aktuelles Archiv existiert, kann der Eintrag wiederverwendet werden.
    •  
  • Nach Backend-Neustart werden unterbrochene queued/processing-Eintr\u00e4ge gepr\u00fcft und fortgesetzt.
    •  
  • Fehlt eine erwartete ZIP-Datei bei ready, wird der Eintrag auf failed gesetzt.
    •  
"},{"location":"gui/downloads/#download-auslosen","title":"Download ausl\u00f6sen","text":"
Bei Status ready:
 
     
  • Download-Button l\u00e4dt die ZIP direkt aus /api/downloads/:id/file.
    •  
"},{"location":"gui/downloads/#eintrage-entfernen","title":"Eintr\u00e4ge entfernen","text":"
L\u00f6schen entfernt:
 
     
  • Queue-Metadaten
    •  
  • zugeh\u00f6rige Archivdatei
    •  
 
Nicht erlaubt:
 
     
  • L\u00f6schen w\u00e4hrend queued/processing
    •  
"},{"location":"gui/downloads/#echtzeitaktualisierung","title":"Echtzeitaktualisierung","text":"
Die Seite reagiert auf DOWNLOADS_UPDATED per WebSocket. Dadurch sind Statuswechsel ohne Reload sichtbar.
"},{"location":"gui/history/","title":"Historie","text":"
Historie ist die Kontroll- und Nachbearbeitungsoberfl\u00e4che f\u00fcr alle bereits angelegten Jobs.
"},{"location":"gui/history/#hauptansicht","title":"Hauptansicht","text":"
Filter und Arbeitsmittel:
 
     
  • Suche (Titel, IMDb, Kontextbegriffe)
    •  
  • Statusfilter
    •  
  • Mediumfilter
    •  
  • Sortierung
    •  
  • Listen-/Grid-Layout
    •  
 
Jeder Eintrag zeigt auf einen Blick:
 
     
  • Titel, Jahr, Poster
    •  
  • Status und Zeitstempel
    •  
  • RAW-/Output-Verf\u00fcgbarkeit
    •  
  • Medien- und ggf. Containerhinweise
    •  
"},{"location":"gui/history/#detaildialog-was-dort-zusammenlauft","title":"Detaildialog: Was dort zusammenl\u00e4uft","text":"
Der Detaildialog b\u00fcndelt:
 
     
  • Metadaten (Film oder Serie)
    •  
  • Jobstatus und Fehlertexte
    •  
  • RAW-/Output-Pfade
    •  
  • Encode-Plan und Trackauswahl
    •  
  • ausgef\u00fchrte Kommandodetails
    •  
  • Prozesslog (Tail oder vollst\u00e4ndig)
    •  
 
Bei Seriencontainern wird disk-/child-orientiert dargestellt, nicht nur als Einzeljob.
"},{"location":"gui/history/#nachbearbeitungsaktionen-und-wirkung","title":"Nachbearbeitungsaktionen und Wirkung","text":"Aktion Typischer Einsatz Technische Wirkung OMDb neu zuordnen falsches Match, Titel/Jahr korrigieren Metadatenfelder werden neu geschrieben; Folder-Rename wird best effort angesto\u00dfen Review neu starten neue Track-/Titelbewertung n\u00f6tig Mediainfo/Review wird aus RAW neu aufgebaut RAW neu encodieren neuer Encode aus vorhandenem RAW startet Encode ohne neuen Laufwerks-Rip Encode neu starten gleiche best\u00e4tigte Auswahl erneut fahren letzter best\u00e4tigter Plan wird geladen, optional mit Bereinigung unvollst\u00e4ndiger Ausgabe Retry Rippen Rip/Analyse neu ansto\u00dfen neuer Rip-Lauf, inkl. erneuter RAW-Phase 
L\u00f6schaktionen im Dialog:
 
     
  • RAW l\u00f6schen
    •  
  • Movie l\u00f6schen
    •  
  • Beides l\u00f6schen
    •  
  • Historieneintrag l\u00f6schen
    •  
"},{"location":"gui/history/#loschvorschau-und-selektives-loschen","title":"L\u00f6schvorschau und selektives L\u00f6schen","text":"
Vor endg\u00fcltigem L\u00f6schen zeigt Ripster eine Vorschau mit:
 
     
  • RAW-Kandidaten
    •  
  • Movie-/Episoden-Kandidaten
    •  
  • Related-Scope (Container/Kinder/verbundene Jobs)
    •  
 
Wichtige Punkte:
 
     
  • Pfade sind selektierbar.
    •  
  • F\u00fcr RAW-L\u00f6schung muss bei Mehrfachkandidaten mindestens ein RAW-Pfad gew\u00e4hlt werden.
    •  
  • Schutzlogik verhindert L\u00f6schungen au\u00dferhalb erlaubter Root-Verzeichnisse.
    •  
"},{"location":"gui/history/#serien-und-multipart-sicht-in-der-historie","title":"Serien- und Multipart-Sicht in der Historie","text":""},{"location":"gui/history/#serien","title":"Serien","text":"
     
  • Container zeigt aggregierten Zustand aus Child-Jobs.
    •  
  • Disk-/Episode-Aktionen k\u00f6nnen child-spezifisch ausgef\u00fchrt werden.
    •  
  • Im Ripper \u00f6ffnen hilft bei Bereit zum Encodieren-Kindern.
    •  
"},{"location":"gui/history/#multipart","title":"Multipart","text":"
     
  • gemeinsamer Container mit Disc-Childs
    •  
  • Disc-Nummern bleiben pro Child nachvollziehbar
    •  
  • Delete-Preview kann Related-Pfade gemeinsam aufl\u00f6sen
    •  
"},{"location":"gui/history/#logs-sinnvoll-nutzen","title":"Logs sinnvoll nutzen","text":"
     
  • Tail laden (800) f\u00fcr schnellen Fehlerkontext
    •  
  • Vollst\u00e4ndiges Log laden f\u00fcr forensische Analyse
    •  
 
Empfehlung:
 
     
  1. Erst Tail pr\u00fcfen.
    2.  
  2. Bei Pfad-/Toolproblemen vollst\u00e4ndiges Log laden.
    3.  
  3. Danach passende Wiederanlauf-Aktion w\u00e4hlen.
    4.  
"},{"location":"gui/ripper/","title":"Ripper","text":"
Die Seite Ripper ist die Live-Steuerung der Pipeline. Hier laufen Disc-Erkennung, Queue-Steuerung, Review und Encode-Start zusammen.
"},{"location":"gui/ripper/#seitenaufbau-und-betriebslogik","title":"Seitenaufbau und Betriebslogik","text":"
Die Bereiche erscheinen in dieser Reihenfolge:
 
     
  1. Hardware Monitoring
    2.  
  2. Job Queue
    3.  
  3. Skript- / Cron-Status
    4.  
  4. Job \u00dcbersicht
    5.  
  5. Disk-Information
    6.  
"},{"location":"gui/ripper/#1-hardware-monitoring","title":"1) Hardware Monitoring","text":"
Zeigt kontinuierlich:
 
     
  • CPU / RAM
    •  
  • GPU (wenn verf\u00fcgbar)
    •  
  • freie Speicherst\u00e4nde konfigurierter Pfade
    •  
 
Nutzen im Betrieb:
 
     
  • Engp\u00e4sse vor Jobfehlern erkennen
    •  
  • Pfadf\u00fcllst\u00e4nde vor Start gro\u00dfer Batchs pr\u00fcfen
    •  
 
Gesteuert \u00fcber Settings:
 
     
  • Hardware Monitoring aktiviert
    •  
  • Hardware Monitoring Intervall (ms)
    •  
"},{"location":"gui/ripper/#2-job-queue","title":"2) Job Queue","text":"
Es gibt zwei operative Zonen:
 
     
  • Laufende Jobs
    •  
  • Warteschlange
    •  
 
M\u00f6gliche Queue-Eintr\u00e4ge:
 
     
  • Job-Startaktionen (Start, Retry Rippen, RAW neu encodieren, Encode neu starten, Review neu berechnen, Audio CD starten)
    •  
  • Nicht-Job-Eintr\u00e4ge (Skript, Skriptkette, Warten)
    •  
 
Wichtige Regeln:
 
     
  • Queue-Reihenfolge ist per Drag-and-Drop \u00e4nderbar.
    •  
  • Warten blockiert nachfolgende Queue-Starts bis kein aktiver Prozess mehr l\u00e4uft.
    •  
  • Skript und Skriptkette werden als Queue-Eintr\u00e4ge mitgef\u00fchrt.
    •  
 
Parallelit\u00e4t kommt aus Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • optional Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
"},{"location":"gui/ripper/#3-skript-cron-status","title":"3) Skript- / Cron-Status","text":"
Zeigt Runtime-Aktivit\u00e4ten:
 
     
  • laufende Skripte
    •  
  • laufende Ketten
    •  
  • Cron-Ausf\u00fchrungen
    •  
  • letzte abgeschlossene Aktivit\u00e4ten
    •  
 
Aktionen:
 
     
  • N\u00e4chster Schritt bei Ketten
    •  
  • Abbrechen
    •  
  • Liste leeren
    •  
"},{"location":"gui/ripper/#4-job-ubersicht","title":"4) Job \u00dcbersicht","text":"
Die Jobliste ist der zentrale Arbeitsbereich. Ein Klick \u00f6ffnet den jeweiligen Pipeline-Status.
"},{"location":"gui/ripper/#badges-und-kontext","title":"Badges und Kontext","text":"
Neben Status/Fortschritt zeigt die Liste je nach Job:
 
     
  • Serienkontext (Serien-Container, Staffel/Disk)
    •  
  • Multipart-Kontext (Multipart Movie, Disc-Nr.)
    •  
  • Queue-/Subjob-Kontext bei Serien-Episoden
    •  
"},{"location":"gui/ripper/#zustandsabhangige-aktionen","title":"Zustandsabh\u00e4ngige Aktionen","text":"Zustand Hauptaktion im Ripper Ergebnis Medium erkannt, Bereit Analyse starten startet MakeMKV-Analyse Metadatenauswahl Metadaten \u00f6ffnen Film/Serie ausw\u00e4hlen, Provider festlegen Warte auf Auswahl Playlist/Titel/RAW-Entscheidung best\u00e4tigen setzt Flow fort zur Pr\u00fcfung Startbereit Job starten startet Rip oder RAW-basierte Pr\u00fcfung Bereit zum Encodieren Encoding starten startet HandBrake mit best\u00e4tigter Auswahl Laufend (Analyse, Rippen, Encodieren) Abbrechen setzt Job auf Abgebrochen Fehler, Abgebrochen Retry Rippen neuer Rip-Anlauf 
Zusatzaktionen je nach Zustand und Jobtyp:
 
     
  • Review neu starten
    •  
  • Encode neu starten
    •  
  • RAW neu encodieren
    •  
  • Aus Queue l\u00f6schen
    •  
"},{"location":"gui/ripper/#review-bereich-bereit-zum-encodieren","title":"Review-Bereich (Bereit zum Encodieren)","text":"
Hier wird die effektive Encode-Entscheidung festgelegt:
 
     
  • Titelwahl
    •  
  • Audio-/Subtitle-Trackselektion
    •  
  • User-Preset
    •  
  • Pre-/Post-Encode-Skripte und Ketten
    •  
  • HandBrake-Kommandovorschau
    •  
 
Ohne Best\u00e4tigung dieses Blocks startet kein produktiver Encode.
"},{"location":"gui/ripper/#raw-ordnerphasen-sichtbar-uber-logsdetails","title":"RAW-Ordnerphasen (sichtbar \u00fcber Logs/Details)","text":"
Der Ripper arbeitet mit drei RAW-Zust\u00e4nden:
 
     
  • Incomplete_... w\u00e4hrend unvollst\u00e4ndigem Rip
    •  
  • Rip_Complete_... nach erfolgreich abgeschlossenem Rip, vor Encode
    •  
  • ohne Prefix nach erfolgreichem Encode
    •  
 
Das ist wichtig f\u00fcr Recovery und Delete-Vorschau.
"},{"location":"gui/ripper/#5-disk-information","title":"5) Disk-Information","text":"
Zeigt aktuelle Laufwerksdaten:
 
     
  • Device-Pfad
    •  
  • Modell
    •  
  • Disc-Label / Mount
    •  
 
Aktionen:
 
     
  • Laufwerk neu lesen
    •  
  • Disk neu analysieren
    •  
  • Metadaten-Dialog \u00f6ffnen
    •  
 
Hinweis:
 
     
  • Laufwerk neu lesen ist nicht mehr an einen festen Pipeline-State gebunden.
    •  
"},{"location":"gui/ripper/#wichtige-dialoge","title":"Wichtige Dialoge","text":""},{"location":"gui/ripper/#metadaten-auswahlen","title":"Metadaten ausw\u00e4hlen","text":"
Im Dialog werden Film-/Serienmetadaten best\u00e4tigt.
 
Sonderf\u00e4lle:
 
     
  • Film-Duplikat: \u00dcbernahme erzwingen oder Multipart movie
    •  
  • Serie: Disc-Nummer ist Pflicht
    •  
"},{"location":"gui/ripper/#vorhandenes-raw-erkannt","title":"Vorhandenes RAW erkannt","text":"
Wenn passendes RAW existiert, fordert der Dialog eine explizite Entscheidung:
 
     
  • vorhandenes RAW verwenden
    •  
  • RAW verwerfen/l\u00f6schen und neu rippen
    •  
"},{"location":"gui/ripper/#queue-eintrag-einfugen","title":"Queue-Eintrag einf\u00fcgen","text":"
Du kannst gezielt ab Position einf\u00fcgen:
 
     
  • Skript
    •  
  • Skriptkette
    •  
  • Wartezeit
    •  
"},{"location":"gui/ripper/#audible-activation-bytes-eintragen","title":"Audible Activation Bytes eintragen","text":"
Wenn f\u00fcr eine AAX-Datei keine Activation Bytes automatisch ermittelt werden k\u00f6nnen, \u00f6ffnet Ripster einen Dialog zur manuellen Eingabe.
 
     
  • Eingabeformat: genau 8 Hex-Zeichen (z.B. 1a2b3c4d)
    •  
  • Speicherung: lokal im Activation-Bytes-Cache
    •  
  • Wirkung: nach dem Speichern kann der Audiobook-Flow fortgesetzt werden
    •  
"},{"location":"gui/settings/","title":"Settings","text":"
Die Seite Settings ist das zentrale Kontrollpanel f\u00fcr Laufzeitverhalten, Automatisierung und Expertenfunktionen.
"},{"location":"gui/settings/#tab-uberblick","title":"Tab-\u00dcberblick","text":"Tab Zweck Konfiguration Alle fachlichen Settings (Pfade, Tools, Laufwerk, Metadaten, Monitoring, Benachrichtigungen, Converter) Scripte Einzelne Bash-Skripte pflegen, testen und sortieren Skriptketten Mehrstufige Sequenzen aus Skript und Warten bauen und testen Encode-Presets Benutzer-Presets und Standard-Zuordnungen f\u00fcr Blu-ray/DVD-Workflows Cronjobs Zeitgesteuerte Jobs auf Basis Skript/Skriptkette"},{"location":"gui/settings/#tab-konfiguration","title":"Tab Konfiguration","text":""},{"location":"gui/settings/#bedienlogik","title":"Bedienlogik","text":"
     
  1. Felder \u00e4ndern.
    2.  
  2. \u00c4nderungen speichern klicken.
    3.  
  3. Erst dann werden \u00c4nderungen persistiert und f\u00fcr neue Pipeline-Schritte wirksam.
    4.  
 
Aktionen in der Toolbar:
 
     
  • \u00c4nderungen speichern: schreibt nur ge\u00e4nderte Felder als Bulk-Update.
    •  
  • \u00c4nderungen verwerfen: setzt den Formularzustand auf zuletzt geladen/zum Server gespeicherten Stand zur\u00fcck.
    •  
  • Neu laden: l\u00e4dt Kategorien + Werte erneut vom Backend.
    •  
  • PushOver Test: sendet eine Testnachricht mit aktuellen PushOver-Werten.
    •  
  • Coverarts pr\u00fcfen: startet die manuelle Coverart-Recovery.
    •  
  • Expertenmodus: wird sofort gespeichert (nicht Teil des normalen Bulk-Speicherns).
    •  
"},{"location":"gui/settings/#wichtige-ui-verhalten","title":"Wichtige UI-Verhalten","text":"
     
  • Jede Einstellung zeigt Gespeichert oder Ungespeichert direkt am Feld.
    •  
  • Pflichtfelder sind mit * markiert.
    •  
  • Bei Validierungsfehlern wird pro Feld ein Fehlertext angezeigt und Speichern blockiert.
    •  
  • Tool-Kommandos (makemkv_command, mediainfo_command, handbrake_command, ffmpeg_command, ffprobe_command, cdparanoia_command, mkvmerge_command) sind im Formular schreibgesch\u00fctzt markiert.
    •  
  • Einige Felder sind abh\u00e4ngig vom Expertenmodus sichtbar.
    •  
"},{"location":"gui/settings/#kategorie-pfade-besondere-interaktion","title":"Kategorie Pfade: Besondere Interaktion","text":"
Die Pfad-Kategorie hat eine eigene Darstellung:
 
     
  • Tabelle Effektive Pfade: zeigt die aktuell tats\u00e4chlich aufgel\u00f6sten Laufzeitpfade inkl. Fallbacks.
    •  
  • Accordion je Bereich (Blu-ray, DVD, CD / Audio, Audiobook, Converter, Downloads, optional Externe Speicher, Logs).
    •  
  • F\u00fcr Pfadfelder mit Owner-Pendant (*_owner) erscheint direkt darunter das Feld Eigent\u00fcmer (user:gruppe).
    •  
  • Owner-Felder sind deaktiviert, solange der zugeh\u00f6rige Pfad leer ist.
    •  
"},{"location":"gui/settings/#spezial-editoren-in-der-konfiguration","title":"Spezial-Editoren in der Konfiguration","text":"
     
  • drive_devices: JSON-Array wird \u00fcber UI-Editor gepflegt (Pfad + MakeMKV-Index je Laufwerk).
    •  
  • external_storage_paths: Liste aus Name + Pfad (f\u00fcr Anzeige freier externer Speicher).
    •  
  • converter_scan_extensions: Checkbox-Raster der erlaubten Endungen; mindestens eine Endung muss aktiv bleiben.
    •  
  • makemkv_registration_key: zus\u00e4tzlicher Betakey-Hinweis mit \u00fcbernehmen-Button.
    •  
"},{"location":"gui/settings/#laufwerks-infobox-innerhalb-laufwerk","title":"Laufwerks-Infobox innerhalb Laufwerk","text":"
In der Kategorie Laufwerk wird eine Live-Tabelle erkannter optischer Laufwerke angezeigt:
 
     
  • Neu einlesen l\u00e4dt Laufwerksinfos neu.
    •  
  • Im Expertenmodus: Freigeben pro Laufwerk und Alle Laufwerke freigeben.
    •  
"},{"location":"gui/settings/#tab-scripte","title":"Tab Scripte","text":"
Funktionen:
 
     
  • Skript anlegen (Inline-Editor)
    •  
  • Skript bearbeiten (Dialog)
    •  
  • Skript l\u00f6schen (mit Best\u00e4tigung)
    •  
  • Skript testen
    •  
  • Reihenfolge per Drag-and-Drop \u00e4ndern
    •  
 
Testergebnis enth\u00e4lt:
 
     
  • Erfolg/Fehler
    •  
  • Exit-Code
    •  
  • Timeout-Info
    •  
  • Dauer
    •  
  • stdout/stderr
    •  
"},{"location":"gui/settings/#tab-skriptketten","title":"Tab Skriptketten","text":"
Skriptketten bestehen aus Schritten:
 
     
  • Skript
    •  
  • Warten (Sekunden)
    •  
 
Funktionen:
 
     
  • Ketten anlegen/bearbeiten/l\u00f6schen
    •  
  • Reihenfolge der Ketten per Drag-and-Drop
    •  
  • Kette testen
    •  
  • Schritte in der Kette per Drag-and-Drop neu anordnen
    •  
 
Im Ketteneditor:
 
     
  • linke Palette (Systembl\u00f6cke, Scripte)
    •  
  • rechte Canvas mit Drop-Zonen
    •  
  • pro Warte-Schritt konfigurierbare Sekunden
    •  
"},{"location":"gui/settings/#tab-encode-presets","title":"Tab Encode-Presets","text":"
Bereiche:
 
     
  1. Standard-Zuordnungen (Slots)
    2.  
  2. Preset-Liste (CRUD)
    3.  
"},{"location":"gui/settings/#standard-zuordnungen","title":"Standard-Zuordnungen","text":"
Es gibt vier persistente Slots:
 
     
  • bluray_movie
    •  
  • bluray_series
    •  
  • dvd_movie
    •  
  • dvd_series
    •  
 
Die Auswahl ist medientyp-kompatibel gefiltert. Nicht kompatible oder fehlende bereits gespeicherte IDs werden weiterhin sichtbar gemacht, damit bestehende Zuordnungen nachvollziehbar bleiben.
"},{"location":"gui/settings/#preset-inhalt","title":"Preset-Inhalt","text":"
Ein Preset umfasst:
 
     
  • Name
    •  
  • Medientyp (all, bluray, dvd)
    •  
  • HandBrake-Preset (-Z)
    •  
  • Extra Args
    •  
  • optionale Beschreibung
    •  
"},{"location":"gui/settings/#tab-cronjobs","title":"Tab Cronjobs","text":"
Funktionen:
 
     
  • Cronjob erstellen/bearbeiten/l\u00f6schen
    •  
  • Debounced Validierung des Cron-Ausdrucks
    •  
  • Quelle w\u00e4hlen: Skript oder Skriptkette
    •  
  • Aktiv- und PushOver-Toggle je Job
    •  
  • Jetzt ausf\u00fchren
    •  
  • Lauf-Logs \u00f6ffnen
    •  
 
Die Seite zeigt zus\u00e4tzlich Live-Status laufender Cron-Aktivit\u00e4ten (Runtime Activities).
"},{"location":"gui/settings/#expertenbereich-activation-bytes-cache","title":"Expertenbereich: Activation Bytes Cache","text":"
Der Activation-Bytes-Block wird nur im Expertenmodus angezeigt und nur wenn Eintr\u00e4ge vorhanden sind.
 
Er zeigt:
 
     
  • AAX-Checksum
    •  
  • Activation Bytes
    •  
  • Speicherzeitpunkt
    •  
"},{"location":"gui/settings/#validierungshinweise-fur-template-felder","title":"Validierungshinweise f\u00fcr Template-Felder","text":"
Template-Felder akzeptieren nur:
 
     
  • Buchstaben/Ziffern
    •  
  • Leerzeichen
    •  
  • _ und -
    •  
  • Platzhalter in {...} bzw. ${...}
    •  
  • / f\u00fcr Ordnertrennung
    •  
 
Nicht erlaubt sind z. B. unvollst\u00e4ndige geschweifte Klammern oder sonstige Sonderzeichen.
"},{"location":"gui/settings/#siehe-auch","title":"Siehe auch","text":"
     
  • Einstellungsreferenz
    •  
  • Ripper
    •  
"},{"location":"pipeline/","title":"Anhang: Pipeline intern","text":"
Dieser Abschnitt beschreibt die technische Pipeline-Logik hinter den UI-Workflows.
 
     
  •  
     Workflow & Zust\u00e4nde
     
    Zustandsmodell, \u00dcberg\u00e4nge, Queue-Verhalten.
     
     Workflow
     
    •  
  •  
     Encode-Planung
     
    Aufbereitung von Titeln/Tracks und Best\u00e4tigungslogik.
     
     Encoding
     
    •  
  •  
     Playlist-Analyse
     
    Bewertung mehrdeutiger Blu-ray-Playlists.
     
     Playlist-Analyse
     
    •  
  •  
     Pre-/Post-Encode-Ausf\u00fchrungen
     
    Skript- und Kettenlauf vor/nach dem Encoding.
     
     Encode-Skripte
     
    •  
"},{"location":"pipeline/#zuruck-zum-handbuch","title":"Zur\u00fcck zum Handbuch","text":"
     
  • Workflows aus Nutzersicht
    •  
"},{"location":"pipeline/encoding/","title":"Encode-Planung & Track-Auswahl","text":"
Vor dem eigentlichen Encoding erstellt Ripster einen Encode-Plan und zeigt ihn im Review an.
"},{"location":"pipeline/encoding/#ablauf","title":"Ablauf","text":"
Quelle bestimmen (Disc/RAW)\n  -> HandBrake-Scan (--scan --json)\n  -> Plan erstellen (Titel, Audio, Untertitel)\n  -> Status: Bereit zum Encodieren\n  -> Benutzer bestaetigt Auswahl\n  -> finaler HandBrake-Aufruf\n
"},{"location":"pipeline/encoding/#review-inhalt-status-bereit-zum-encodieren","title":"Review-Inhalt (Status: Bereit zum Encodieren)","text":"
     
  • ausw\u00e4hlbarer Encode-Titel
    •  
  • Audio-Track-Auswahl
    •  
  • Untertitel-Track-Auswahl inkl. Flags
    •  
  • burnIn
    •  
  • forced
    •  
  • defaultTrack
    •  
  • optionale User-Presets (HandBrake Preset + Extra Args)
    •  
  • optionale Pre-/Post-Skripte und Ketten
    •  
"},{"location":"pipeline/encoding/#bestaetigung-confirm-encode","title":"Bestaetigung (confirm-encode)","text":"
Typischer Payload:
 
{\n  \"selectedEncodeTitleId\": 1,\n  \"selectedTrackSelection\": {\n    \"1\": {\n      \"audioTrackIds\": [1, 2],\n      \"subtitleTrackIds\": [3]\n    }\n  },\n  \"selectedPreEncodeScriptIds\": [1],\n  \"selectedPostEncodeScriptIds\": [2],\n  \"selectedPreEncodeChainIds\": [3],\n  \"selectedPostEncodeChainIds\": [4],\n  \"selectedUserPresetId\": 5\n}\n
 
Die best\u00e4tigte Auswahl wird im Job gespeichert und f\u00fcr Neustarts wiederverwendet.
"},{"location":"pipeline/encoding/#handbrake-aufruf","title":"HandBrake-Aufruf","text":"
Grundstruktur:
 
HandBrakeCLI \\\n  -i <input> \\\n  -o <output> \\\n  -t <titleId> \\\n  -Z \"<preset>\" \\\n  <extra-args> \\\n  -a <audioTrackIds|none> \\\n  -s <subtitleTrackIds|none>\n
 
Untertitel-Flags werden bei Bedarf erg\u00e4nzt:
 
     
  • --subtitle-burned=<id>
    •  
  • --subtitle-default=<id>
    •  
  • --subtitle-forced=<id> oder --subtitle-forced
    •  
"},{"location":"pipeline/encoding/#pre-post-encode-ausfuhrungen","title":"Pre-/Post-Encode-Ausf\u00fchrungen","text":"
     
  • Pre-Encode l\u00e4uft vor HandBrake
    •  
  • Post-Encode l\u00e4uft nach HandBrake
    •  
 
Fehlerverhalten:
 
     
  • Pre-Encode-Fehler: Job endet mit Status Fehler (Encode startet nicht)
    •  
  • Post-Encode-Fehler: Job kann Fertig bleiben, enth\u00e4lt aber Fehlerhinweis/Script-Summary
    •  
"},{"location":"pipeline/encoding/#dateinamenordner","title":"Dateinamen/Ordner","text":"
Der finale Outputpfad wird aus den Templates in den Settings aufgebaut.
 
Platzhalter:
 
     
  • ${title}
    •  
  • ${year}
    •  
  • ${imdbId}
    •  
 
Ung\u00fcltige Dateizeichen werden bereinigt.
"},{"location":"pipeline/playlist-analysis/","title":"Playlist-Analyse","text":"
Ripster analysiert bei Blu-ray-\u00e4hnlichen Quellen Playlists und fordert bei Mehrdeutigkeit eine manuelle Auswahl an.
"},{"location":"pipeline/playlist-analysis/#ziel","title":"Ziel","text":"
Erkennen, welche Playlist sehr wahrscheinlich der Hauptfilm ist, statt versehentlich eine Fake-/Dummy-Playlist zu verwenden.
"},{"location":"pipeline/playlist-analysis/#eingabedaten","title":"Eingabedaten","text":"
Die Analyse basiert auf MakeMKV-Infos (u. a. Playlist-/Segment-Struktur, Laufzeiten, Titelzuordnung).
"},{"location":"pipeline/playlist-analysis/#auswertung-vereinfacht","title":"Auswertung (vereinfacht)","text":"
F\u00fcr Kandidaten werden u. a. ber\u00fccksichtigt:
 
     
  • Laufzeit
    •  
  • Segment-Reihenfolge
    •  
  • R\u00fcckw\u00e4rtsspr\u00fcnge/gro\u00dfe Spr\u00fcnge
    •  
  • Koh\u00e4renz linearer Segmentfolgen
    •  
  • Duplikatgruppen mit \u00e4hnlicher Laufzeit
    •  
 
Daraus entstehen intern Kandidatenlisten, Bewertungen und eine Empfehlung.
"},{"location":"pipeline/playlist-analysis/#wann-muss-der-benutzer-entscheiden","title":"Wann muss der Benutzer entscheiden?","text":"
Wenn nach Filterung mehr als ein relevanter Kandidat \u00fcbrig bleibt, wechselt der Job in der GUI auf:
 
     
  • Warte auf Auswahl
    •  
 
Dann muss eine Playlist best\u00e4tigt werden, bevor der Workflow weiterl\u00e4uft.
"},{"location":"pipeline/playlist-analysis/#konfigurationseinfluss","title":"Konfigurationseinfluss","text":"Feld in Settings Wirkung Minimale Titellaenge (Minuten) Mindestlaufzeit f\u00fcr Kandidaten 
Default ist aktuell 60 Minuten.
"},{"location":"pipeline/playlist-analysis/#ui-verhalten","title":"UI-Verhalten","text":"
Bei manueller Entscheidung zeigt das Ripper Kandidaten inkl. Score/Bewertung und markiert eine Empfehlung.
 
Nach Best\u00e4tigung:
 
     
  • mit vorhandenem RAW -> zur\u00fcck zu Mediainfo-Pruefung
    •  
  • ohne RAW -> Startpfad \u00fcber Startbereit / Rippen
    •  
"},{"location":"pipeline/post-encode-scripts/","title":"Encode-Skripte (Pre & Post)","text":"
Ripster kann Skripte und Skript-Ketten vor und nach dem Encode ausf\u00fchren.
"},{"location":"pipeline/post-encode-scripts/#ablauf","title":"Ablauf","text":"
Bereit zum Encodieren\n  -> Pre-Encode Skripte/Ketten\n  -> HandBrake Encoding\n  -> Post-Encode Skripte/Ketten\n  -> Fertig oder Fehler\n
"},{"location":"pipeline/post-encode-scripts/#auswahl-im-review","title":"Auswahl im Review","text":"
Im Review-Panel kannst du getrennt w\u00e4hlen:
 
     
  • selectedPreEncodeScriptIds
    •  
  • selectedPostEncodeScriptIds
    •  
  • selectedPreEncodeChainIds
    •  
  • selectedPostEncodeChainIds
    •  
"},{"location":"pipeline/post-encode-scripts/#fehlerverhalten","title":"Fehlerverhalten","text":"
     
  • Pre-Encode-Fehler stoppen die Kette und f\u00fchren zu Fehler.
    •  
  • Post-Encode-Fehler stoppen die restlichen Post-Schritte; Job kann dennoch Fertig sein (mit Fehlerzusatz im Status/Log).
    •  
"},{"location":"pipeline/post-encode-scripts/#verfugbare-umgebungsvariablen","title":"Verf\u00fcgbare Umgebungsvariablen","text":"
Beim Script-Run werden gesetzt:
 
     
  • RIPSTER_SCRIPT_RUN_AT
    •  
  • RIPSTER_JOB_ID
    •  
  • RIPSTER_JOB_TITLE
    •  
  • RIPSTER_MODE
    •  
  • RIPSTER_INPUT_PATH
    •  
  • RIPSTER_OUTPUT_PATH
    •  
  • RIPSTER_RAW_PATH
    •  
  • RIPSTER_SCRIPT_ID
    •  
  • RIPSTER_SCRIPT_NAME
    •  
  • RIPSTER_SCRIPT_SOURCE
    •  
"},{"location":"pipeline/post-encode-scripts/#skript-ketten","title":"Skript-Ketten","text":"
Ketten unterst\u00fctzen zwei Step-Typen:
 
     
  • script (f\u00fchrt ein hinterlegtes Skript aus)
    •  
  • wait (wartet waitSeconds)
    •  
 
Bei Fehler in einem Script-Step wird die Kette abgebrochen.
"},{"location":"pipeline/post-encode-scripts/#testlaufe","title":"Testl\u00e4ufe","text":"
     
  • Skript testen: POST /api/settings/scripts/:id/test
    •  
  • Kette testen: POST /api/settings/script-chains/:id/test
    •  
 
Ergebnisse enthalten Erfolg/Exit-Code, Laufzeit und stdout/stderr.
"},{"location":"pipeline/workflow/","title":"Workflow & Zust\u00e4nde","text":"
Ripster steuert den Ablauf als Zustandsmaschine.
"},{"location":"pipeline/workflow/#zustandsdiagramm-vereinfacht","title":"Zustandsdiagramm (vereinfacht)","text":"
flowchart LR\n    A[Bereit] --> B[Medium erkannt]\n    B --> C[Analyse]\n    C --> D[Metadatenauswahl]\n    D --> E[Startbereit]\n    E --> F[Rippen]\n    E --> G[Mediainfo-Pruefung]\n    G --> H[Warte auf Auswahl]\n    H --> G\n    G --> I[Bereit zum Encodieren]\n    I --> J[Encodieren]\n    J --> K[Fertig]\n    J --> L[Fehler]\n    F --> L\n    F --> M[Abgebrochen]
"},{"location":"pipeline/workflow/#statusliste-gui-anzeige","title":"Statusliste (GUI-Anzeige)","text":"Status in der GUI Bedeutung Bereit Wartet auf Disc Medium erkannt Disc wurde erkannt Analyse MakeMKV-Analyse l\u00e4uft Metadatenauswahl Metadaten m\u00fcssen best\u00e4tigt werden Warte auf Auswahl Playlist-Auswahl ist erforderlich Warte auf Auswahl auch f\u00fcr RAW-Entscheidung bei vorhandenen Quelldaten genutzt Startbereit kurzer \u00dcbergang vor Start Rippen MakeMKV-Rip l\u00e4uft Mediainfo-Pruefung Titel/Spuren werden ausgewertet Bereit zum Encodieren Review ist bereit Encodieren HandBrake l\u00e4uft CD-Metadatenauswahl CD-Metadaten m\u00fcssen best\u00e4tigt werden CD-Startbereit CD-Job wartet auf Start CD-Analyse CD-Track-/Strukturaufbereitung CD-Rippen Audio-CD-Rip l\u00e4uft CD-Encodieren CD-Encode l\u00e4uft Fertig erfolgreich abgeschlossen Abgebrochen manuell oder technisch abgebrochen Fehler fehlgeschlagen"},{"location":"pipeline/workflow/#typische-pfade","title":"Typische Pfade","text":""},{"location":"pipeline/workflow/#standardfall-kein-vorhandenes-raw","title":"Standardfall (kein vorhandenes RAW)","text":"
     
  1. Medium erkannt
    2.  
  2. Analyse + Metadaten
    3.  
  3. Rippen
    4.  
  4. Mediainfo-Pruefung
    5.  
  5. Bereit zum Encodieren
    6.  
  6. Encodieren
    7.  
  7. Fertig
    8.  
"},{"location":"pipeline/workflow/#vorhandenes-raw","title":"Vorhandenes RAW","text":"
Startbereit springt direkt zu Mediainfo-Pruefung (kein neuer Rip).
"},{"location":"pipeline/workflow/#mehrdeutige-blu-ray-playlist","title":"Mehrdeutige Blu-ray-Playlist","text":"
Mediainfo-Pruefung -> Warte auf Auswahl bis Playlist best\u00e4tigt wurde.
"},{"location":"pipeline/workflow/#vorhandenes-raw-mit-nutzerentscheidung","title":"Vorhandenes RAW mit Nutzerentscheidung","text":"
Metadatenauswahl -> Warte auf Auswahl bis Entscheidung f\u00fcr Weiterverarbeitung (continue) oder Neustart getroffen wurde.
"},{"location":"pipeline/workflow/#cd-flow","title":"CD-Flow","text":"
CD-Metadatenauswahl -> CD-Startbereit -> CD-Rippen -> CD-Encodieren -> Fertig
"},{"location":"pipeline/workflow/#queue-verhalten","title":"Queue-Verhalten","text":"
Wenn der Wert Parallele Jobs erreicht ist:
 
     
  • neue Starts werden als Queue-Eintr\u00e4ge abgelegt
    •  
  • die Queue kann zus\u00e4tzlich Nicht-Job-Eintr\u00e4ge enthalten (Skript, Kette, Warten)
    •  
  • Reihenfolge ist per UI/API \u00e4nderbar
    •  
"},{"location":"pipeline/workflow/#abbruch-wiederaufnahme-neustart","title":"Abbruch, Wiederaufnahme, Neustart","text":"
     
  • Abbrechen: laufenden Job stoppen oder Queue-Eintrag entfernen
    •  
  • Retry Rippen: Fehler-/Abbruch-Job erneut starten
    •  
  • RAW neu encodieren: aus vorhandenem RAW neu encodieren
    •  
  • Review neu starten: Review aus RAW neu aufbauen
    •  
  • Encode neu starten: Encoding mit letzter best\u00e4tigter Auswahl neu starten
    •  
"},{"location":"tools/","title":"Anhang: Externe Tools","text":"
Ripster orchestriert externe CLI-Tools. Dieser Abschnitt erkl\u00e4rt deren Rolle im Gesamtsystem.
 
     
  •  
     MakeMKV
     
    Disc-Analyse und Ripping.
     
     MakeMKV
     
    •  
  •  
     HandBrake
     
    Video-Encoding inklusive Preset-Logik.
     
     HandBrake
     
    •  
  •  
     MediaInfo
     
    Track-/Containeranalyse f\u00fcr Review und Auswahl.
     
     MediaInfo
     
    •  
"},{"location":"tools/handbrake/","title":"HandBrake","text":"
Ripster verwendet HandBrakeCLI f\u00fcr Scan und Encode.
"},{"location":"tools/handbrake/#verwendete-aufrufe","title":"Verwendete Aufrufe","text":""},{"location":"tools/handbrake/#scan-review-aufbau","title":"Scan (Review-Aufbau)","text":"
HandBrakeCLI --scan --json -i <input> -t 0\n
"},{"location":"tools/handbrake/#encode-vereinfacht","title":"Encode (vereinfacht)","text":"
HandBrakeCLI \\\n  -i <input> \\\n  -o <output> \\\n  -t <titleId> \\\n  -Z \"<preset>\" \\\n  <extra-args> \\\n  -a <audioTrackIds|none> \\\n  -s <subtitleTrackIds|none>\n
 
Optional erg\u00e4nzt Ripster:
 
     
  • --subtitle-burned=<id>
    •  
  • --subtitle-default=<id>
    •  
  • --subtitle-forced=<id> oder --subtitle-forced
    •  
"},{"location":"tools/handbrake/#presets-auslesen","title":"Presets auslesen","text":"
Ripster liest Presets mit:
 
HandBrakeCLI -z\n
"},{"location":"tools/handbrake/#relevante-felder-in-settings","title":"Relevante Felder in Settings","text":"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\u00e4ndige Ausgabe l\u00f6schen unvollst\u00e4ndige Ausgabe bei Neustart l\u00f6schen"},{"location":"tools/handbrake/#fortschritts-parsing","title":"Fortschritts-Parsing","text":"
Ripster parst HandBrake-Stderr (Prozent/ETA/Detail) und sendet WebSocket-Progress (PIPELINE_PROGRESS).
"},{"location":"tools/handbrake/#troubleshooting","title":"Troubleshooting","text":"
     
  • Preset nicht gefunden: Preset-Namen mit HandBrakeCLI -z pr\u00fcfen
    •  
  • sehr langsames Encoding: Preset/Extra-Args pr\u00fcfen (z. B. --encoder-preset)
    •  
 
Das Produktions-Installer-Script install.sh bietet eine Option zur Installation eines geb\u00fcndelten HandBrakeCLI-Binaries mit NVDEC-Unterst\u00fctzung (NVIDIA GPU-Dekodierung). Diese Option erscheint interaktiv w\u00e4hrend der Installation.
"},{"location":"tools/makemkv/","title":"MakeMKV","text":"
Ripster nutzt makemkvcon f\u00fcr Disc-Analyse und Rip.
"},{"location":"tools/makemkv/#verwendete-aufrufe","title":"Verwendete Aufrufe","text":""},{"location":"tools/makemkv/#analyse","title":"Analyse","text":"
makemkvcon -r info <source>\n
 
<source> ist typischerweise:
 
     
  • disc:<index> (Auto-Modus)
    •  
  • dev:/dev/sr0 (explicit)
    •  
  • file:<path> (Datei/Ordner-Analyse)
    •  
"},{"location":"tools/makemkv/#rip-mkv-modus","title":"Rip (MKV-Modus)","text":"
makemkvcon mkv <source> <title-or-all> <rawDir> [--minlength=...] [...extraArgs]\n
"},{"location":"tools/makemkv/#rip-backup-modus","title":"Rip (Backup-Modus)","text":"
makemkvcon backup <source> <rawDir> --decrypt\n
"},{"location":"tools/makemkv/#registrierungsschlussel-optional","title":"Registrierungsschl\u00fcssel (optional)","text":"
Wenn in Settings ein MakeMKV Key gesetzt ist, synchronisiert Ripster ihn nach:
 
~/.MakeMKV/settings.conf\n
 
Format:
 
app_Key = \"product-key\"\n
 
Zus\u00e4tzlich zeigt die UI unterhalb des Feldes den aktuellen Betakey an, der per Button in das Eingabefeld \u00fcbernommen werden kann.
"},{"location":"tools/makemkv/#relevante-felder-in-settings","title":"Relevante Felder in Settings","text":"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\u00fcr Analyse MakeMKV Rip Extra Args (Blu-ray/DVD) Zusatzargumente f\u00fcr Rip"},{"location":"tools/makemkv/#hinweise","title":"Hinweise","text":"
     
  • Blu-ray-Backups werden oft f\u00fcr robuste Playlist-Analyse genutzt.
    •  
  • MakeMKV-Ausgaben werden geparst und als makemkvInfo im Job gespeichert.
    •  
"},{"location":"tools/mediainfo/","title":"MediaInfo","text":"
Ripster nutzt mediainfo zur JSON-Analyse von Medien-Dateien.
"},{"location":"tools/mediainfo/#aufruf","title":"Aufruf","text":"
mediainfo --Output=JSON <input>\n
 
Der Input ist typischerweise eine RAW-Datei oder ein vom Workflow gew\u00e4hlter Inputpfad.
"},{"location":"tools/mediainfo/#verwendung-in-ripster","title":"Verwendung in Ripster","text":"
     
  • Track-/Codec-Metadaten f\u00fcr Review-Plan
    •  
  • Fallback-Informationen in bestimmten Analysepfaden
    •  
  • Persistenz als mediainfoInfo im Job
    •  
"},{"location":"tools/mediainfo/#relevante-settings","title":"Relevante Settings","text":"Key Bedeutung mediainfo_command CLI-Binary mediainfo_extra_args_bluray / _dvd profilspezifische Zusatzargumente"},{"location":"tools/mediainfo/#troubleshooting","title":"Troubleshooting","text":"
     
  • JSON-Test: mediainfo --Output=JSON <datei>
    •  
  • unbekannte Sprache erscheint oft als und (undetermined)
    •  
"},{"location":"workflows/","title":"Workflows aus Nutzersicht","text":"
Diese Seite beschreibt die produktiven Abl\u00e4ufe als Handbuch: welche Entscheidung an welcher Stelle f\u00e4llt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
"},{"location":"workflows/#gemeinsame-grundlagen","title":"Gemeinsame Grundlagen","text":""},{"location":"workflows/#statuskette-im-normalfall","title":"Statuskette im Normalfall","text":"
Medium erkannt -> Analyse -> Metadatenauswahl -> Startbereit -> Rippen -> Mediainfo-Pruefung -> Bereit zum Encodieren -> Encodieren -> Fertig
 
Abweichungen:
 
     
  • bei Blu-ray/DVD mit n\u00f6tiger Playlistwahl: Mediainfo-Pruefung -> Warte auf Auswahl -> zur\u00fcck in Mediainfo-Pruefung
    •  
  • bei vorhandenem RAW: Startbereit springt direkt in Review/Pr\u00fcfung ohne neuen Laufwerks-Rip
    •  
  • bei Fehler/Abbruch: Fehler oder Abgebrochen mit Wiederanlauf-Aktionen
    •  
"},{"location":"workflows/#job-und-container-typen","title":"Job- und Container-Typen","text":"Typ Zweck Was enth\u00e4lt der Typ? Normaler Disc-Job Einzel-Film oder einzelne Disc RAW-Pfad, Output-Pfad, Logs, Review dvd_series_container logischer Serien-Container (pro Serie/Staffel) Metadatenanker, aggregierter Status \u00fcber Kinder dvd_series_child einzelne Serien-Disc oder Serien-Episode-Job eigentliche RAW-/Encode-Arbeit multipart_movie_container logischer Multipart-Film-Container Zusammenfassung f\u00fcr mehrere Film-Discs multipart_movie_child einzelne Disc innerhalb Multipart-Film Disc-spezifische RAW-/Encode-Daten 
Wichtig:
 
     
  • Container sind prim\u00e4r Ordnungs- und Statusobjekte.
    •  
  • Dateien (RAW/Output) h\u00e4ngen an den Child-Jobs.
    •  
"},{"location":"workflows/#workflow-a-film-blu-raydvd","title":"Workflow A: Film (Blu-ray/DVD)","text":""},{"location":"workflows/#1-disc-analysieren-und-film-metadaten-wahlen","title":"1) Disc analysieren und Film-Metadaten w\u00e4hlen","text":"
     
  1. Im Ripper Analyse starten.
    2.  
  2. Im Metadaten-Dialog Film ausw\u00e4hlen (OMDb bzw. manuelle Film-Metadaten).
    3.  
  3. Auswahl \u00fcbernehmen.
    4.  
 
Wirkung:
 
     
  • der Job wird als Film-Workflow gef\u00fchrt
    •  
  • Film-Fingerprint f\u00fcr Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
    •  
"},{"location":"workflows/#2-duplikatfall-entscheiden","title":"2) Duplikatfall entscheiden","text":"
Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
 
     
  1. \u00dcbernahme erzwingen (allow_new): neuer unabh\u00e4ngiger Film-Job
    2.  
  2. Multipart movie: neuer Job wird mit bestehendem Job in einem Multipart-Container verkn\u00fcpft
    3.  
 
Bei Multipart gilt:
 
     
  • beide Discs brauchen unterschiedliche Disc-Nummer
    •  
  • gleiche Disc-Nummer blockiert den Vorgang (MULTIPART_DISC_ALREADY_EXISTS)
    •  
"},{"location":"workflows/#3-raw-verzeichnis-entsteht","title":"3) RAW-Verzeichnis entsteht","text":"
Ordnername basiert auf Metadaten plus Job-ID:
 
     
  • Incomplete_<Titel> (<Jahr>) - RAW - job-<id>
    •  
 
Zustandswechsel des RAW-Ordners:
 
     
  • beim Start: Incomplete_...
    •  
  • nach erfolgreichem Rip: Rip_Complete_...
    •  
  • nach erfolgreichem Encode: Prefix wird entfernt (final)
    •  
"},{"location":"workflows/#4-review-und-encode","title":"4) Review und Encode","text":"
In Bereit zum Encodieren:
 
     
  • Titel w\u00e4hlen
    •  
  • Audio-/Subtitle-Spuren festlegen
    •  
  • optional User-Preset
    •  
  • optional Pre-/Post-Encode-Skripte oder Ketten
    •  
 
Beim Start:
 
     
  • tempor\u00e4re Ausgabe in Incomplete_job-<id>/<Datei>.<ext>
    •  
  • nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
    •  
"},{"location":"workflows/#workflow-b-serie-blu-raydvd","title":"Workflow B: Serie (Blu-ray/DVD)","text":""},{"location":"workflows/#1-serienmodus-aktivieren","title":"1) Serienmodus aktivieren","text":"
     
  1. Disc analysieren.
    2.  
  2. Im Metadaten-Dialog Serienmetadaten w\u00e4hlen (TMDb-basiert).
    3.  
  3. Disc-Nummer setzen (Pflicht, ab 1).
    4.  
 
Wirkung:
 
     
  • Workflow-Kind wird series
    •  
  • Seriencontainer wird gesucht/angelegt
    •  
  • aktueller Job wird als dvd_series_child darunter gef\u00fchrt
    •  
"},{"location":"workflows/#2-seriencontainer-und-disc-konflikte","title":"2) Seriencontainer und Disc-Konflikte","text":"
Beim Speichern wird gepr\u00fcft:
 
     
  • existiert f\u00fcr Serie/Staffel bereits ein Container?
    •  
  • existiert in diesem Container bereits dieselbe Disc-Nummer?
    •  
 
Wenn ja, wird blockiert (SERIES_DISC_ALREADY_EXISTS).
"},{"location":"workflows/#3-serien-raw-pfad","title":"3) Serien-RAW-Pfad","text":"
F\u00fcr Serien wird ein eigener RAW-Pfad bevorzugt:
 
     
  • Blu-ray: raw_dir_bluray_series (Fallback: raw_dir_bluray)
    •  
  • DVD: raw_dir_dvd_series (Fallback: raw_dir_dvd)
    •  
 
RAW-Namensbasis enth\u00e4lt Staffel/Disc (SxDy) und wird ebenfalls mit den Prefix-Phasen gef\u00fchrt:
 
     
  • Incomplete_... -> Rip_Complete_... -> final
    •  
"},{"location":"workflows/#4-serien-review-und-episoden-ausgabe","title":"4) Serien-Review und Episoden-Ausgabe","text":"
Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
 
     
  • Einzel-Episode: Episode-Template
    •  
  • Multi-Episode-Titel: Multi-Episode-Template
    •  
 
Ausgabepfad:
 
     
  • Root: series_dir_* (Fallback auf movie_dir_*)
    •  
  • Dateiname/Unterordner aus Serien-Template
    •  
"},{"location":"workflows/#5-multi-episode-disc-als-batch","title":"5) Multi-Episode-Disc als Batch","text":"
Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
 
     
  • Ripster erzeugt Episode-Child-Jobs
    •  
  • der urspr\u00fcngliche Disc-Job dient als Batch-Anker
    •  
  • RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
    •  
"},{"location":"workflows/#workflow-c-multipart-film","title":"Workflow C: Multipart-Film","text":""},{"location":"workflows/#wann-dieser-flow-gedacht-ist","title":"Wann dieser Flow gedacht ist","text":"
     
  • gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
    •  
  • Zusammengeh\u00f6rigkeit soll in Historie und Detailansichten sichtbar sein
    •  
"},{"location":"workflows/#ablauf","title":"Ablauf","text":"
     
  1. Film-Metadaten w\u00e4hlen.
    2.  
  2. Duplikatdialog -> Multipart movie.
    3.  
  3. Disc-Nummern f\u00fcr bestehenden und neuen Job festlegen.
    4.  
 
Wirkung:
 
     
  • multipart_movie_container wird angelegt oder wiederverwendet
    •  
  • beteiligte Jobs werden multipart_movie_child
    •  
  • Container f\u00fchrt gemeinsame Metadaten, Kinder f\u00fchren je Disc die eigentlichen Artefakte
    •  
"},{"location":"workflows/#workflow-d-vorhandenes-raw-raw-import","title":"Workflow D: Vorhandenes RAW / RAW-Import","text":""},{"location":"workflows/#fall-1-raw-bereits-vorhanden-bei-metadatenubernahme","title":"Fall 1: RAW bereits vorhanden bei Metadaten\u00fcbernahme","text":"
Nach Metadaten-\u00dcbernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
 
M\u00f6glichkeiten:
 
     
  • vorhandenes RAW weiterverwenden (kein neuer Rip)
    •  
  • RAW l\u00f6schen/ignorieren und neu rippen
    •  
"},{"location":"workflows/#fall-2-orphan-raw-aus-database","title":"Fall 2: Orphan-RAW aus /database","text":"
     
  1. In Database RAW pr\u00fcfen.
    2.  
  2. Bei orphan RAW Job anlegen.
    3.  
  3. Job wird in Historie erzeugt und wie \"Disk analysieren aus RAW\" weiterverarbeitet.
    4.  
"},{"location":"workflows/#workflow-e-nachbearbeitung-bestehender-jobs","title":"Workflow E: Nachbearbeitung bestehender Jobs","text":"
In Historie (Detaildialog):
 Aktion Wirkung OMDb neu zuordnen Metadaten neu schreiben, Folder-Rename wird best effort angesto\u00dfen Review neu starten Titel-/Spurpr\u00fcfung aus aktuellem RAW neu aufbauen RAW neu encodieren Encode erneut aus vorhandenem RAW starten Encode neu starten letzte best\u00e4tigte Review-Einstellungen wiederverwenden Retry Rippen Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden"},{"location":"workflows/#wo-landet-was-artefakt-matrix","title":"Wo landet was? (Artefakt-Matrix)","text":"Artefakt Film Serie Multipart RAW raw_dir_* bevorzugt raw_dir_*_series pro Child-Job im normalen Film-RAW-Schema Finale Ausgabe movie_dir_* + Film-Template series_dir_* (Fallback movie_dir_*) + Serien-Templates pro Child-Job normaler Film-Output Container-Datensatz nein ja (dvd_series_container) ja (multipart_movie_container) L\u00f6schvorschau in Historie einzelner Job oder Related Scope Container-/Child-bezogen mit Pfadauswahl Container-/Child-bezogen mit Pfadauswahl"},{"location":"workflows/#queue-verhalten-im-alltag","title":"Queue-Verhalten im Alltag","text":"
Die Startfreigabe h\u00e4ngt an vier Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • Audio CDs: Queue-Reihenfolge \u00fcberspringen
    •  
 
Praxis:
 
     
  • Film/Video- und Audio/CD laufen in getrennten Lanes
    •  
  • Gesamtlimit begrenzt beide gemeinsam
    •  
  • Queue kann neben Jobs auch Skript, Kette, Warten enthalten
    •  
"}]}
\ No newline at end of file
diff --git a/site/sitemap.xml b/site/sitemap.xml
index 82eb4be..07aff8a 100644
--- a/site/sitemap.xml
+++ b/site/sitemap.xml
@@ -2,186 +2,182 @@
 
     
          https://mboehmlaender.github.io/ripster/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/converter/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/crons/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/downloads/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/history/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/pipeline/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/runtime-activities/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/settings/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/api/websocket/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/appendix/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/architecture/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/architecture/backend/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/architecture/database/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/architecture/frontend/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/architecture/overview/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/configuration/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/configuration/environment/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/configuration/settings-reference/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/deployment/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/deployment/development/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/deployment/production/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/getting-started/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/getting-started/configuration/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/getting-started/installation/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/getting-started/prerequisites/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/getting-started/quickstart/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/audiobooks/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/converter/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/database/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/downloads/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/history/
-         2026-04-21
-    
-    
-         https://mboehmlaender.github.io/ripster/gui/jobs/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/ripper/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/gui/settings/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/pipeline/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/pipeline/encoding/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/pipeline/playlist-analysis/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/pipeline/post-encode-scripts/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/pipeline/workflow/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/tools/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/tools/handbrake/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/tools/makemkv/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/tools/mediainfo/
-         2026-04-21
+         2026-05-08
     
     
          https://mboehmlaender.github.io/ripster/workflows/
-         2026-04-21
+         2026-05-08
     
 
\ No newline at end of file
diff --git a/site/sitemap.xml.gz b/site/sitemap.xml.gz
index 316fb3eb2f18f74605f61d833ec72612a1431276..c2c50cc92b170ec6deba02746c69abeeceaa0821 100644
GIT binary patch
delta 511
zcmVABzYGfG7Qt2OfWc4c(Bqw>?4o0J6lygk@2aXuEm)(MeMjyY@io
zV*OeCK++WH!^`{RcMGJ96pqznv#)j#EIAD4WA*m>r+%(px`)G@dP
ztc&1i4W5is#uzX&rHd{^#0VY(=u)IPFiub#%eWvTD4RyY6HCxirdXlRWJh34j3`U^
zu1JvVAUA;JIYA*5y%D1XR|tQNGi-X3OHs~A;yah49g;h5L0I*0&gKs
zl*~&7PK($gD
zPo5MjBqs7%Tl`>x>ysHl8)OoOXnw>`o30J6lyoMlmyXuEm)(MeMjyY@io
zV*OeCKvI;bS(mfsL%b-o
zSr@_48ax@Nj4@zlN>^Qoh!H#n(4|OoV4R>fmT^HwP&SQ(Czhb4OtC_r$&SF97*U4s
zRgoasK~4b6bAm!BdLu>&t`L73XV~;6m!h1r#CI-7J0xe`g0Sl0$hmvQ%bX0$t*8_X
z2n&j#CJ0;#(j(^93C@t@-l*u&4x*>4u68~!I9R|_EQTj0adZziwXPhH
zLiYRrSQw<{ePL8F$yWb6p&FqkRqA}}o6p(eeZW#LatQ&=X
z?z&;9=dK&XAL^CWAoZy2m-@M?{u{zO!Q;8H0F>y>)yp=iO)&nNu>=D}5}uompw3o?
zxdf_}(s=fyn4>X~&)VV#6I`Fn2-+Z%Fihj3jsXr0hBN7bJUsIgzH$3VjPCvc0w<0z
H9vJ`t2Hy%w

diff --git a/site/tools/handbrake/index.html b/site/tools/handbrake/index.html
index 7b0a2fc..f323d2c 100644
--- a/site/tools/handbrake/index.html
+++ b/site/tools/handbrake/index.html
@@ -1,4 +1,4 @@
- HandBrake - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
HandBrake
 
Ripster verwendet HandBrakeCLI für Scan und Encode.
 
 
Verwendete Aufrufe
 
Scan (Review-Aufbau)
 
HandBrakeCLI --scan --json -i <input> -t 0
+ HandBrake - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
HandBrake
 
Ripster verwendet HandBrakeCLI für Scan und Encode.
 
 
Verwendete Aufrufe
 
Scan (Review-Aufbau)
 
HandBrakeCLI --scan --json -i <input> -t 0
 
 
Encode (vereinfacht)
 
HandBrakeCLI \
   -i <input> \
   -o <output> \
diff --git a/site/tools/index.html b/site/tools/index.html
index 209bb04..10a9a65 100644
--- a/site/tools/index.html
+++ b/site/tools/index.html
@@ -1 +1 @@
- Anhang: Externe Tools - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Externe Tools
 
Ripster orchestriert externe CLI-Tools. Dieser Abschnitt erklärt deren Rolle im Gesamtsystem.
 
 
     
  •  
     MakeMKV
     
     
    Disc-Analyse und Ripping.
     
     MakeMKV
     
    •  
  •  
     HandBrake
     
     
    Video-Encoding inklusive Preset-Logik.
     
     HandBrake
     
    •  
  •  
     MediaInfo
     
     
    Track-/Containeranalyse für Review und Auswahl.
     
     MediaInfo
     
    •  
 
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Anhang: Externe Tools - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Anhang: Externe Tools
 
Ripster orchestriert externe CLI-Tools. Dieser Abschnitt erklärt deren Rolle im Gesamtsystem.
 
 
     
  •  
     MakeMKV
     
     
    Disc-Analyse und Ripping.
     
     MakeMKV
     
    •  
  •  
     HandBrake
     
     
    Video-Encoding inklusive Preset-Logik.
     
     HandBrake
     
    •  
  •  
     MediaInfo
     
     
    Track-/Containeranalyse für Review und Auswahl.
     
     MediaInfo
     
    •  
 
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/tools/makemkv/index.html b/site/tools/makemkv/index.html
index 16fd801..77ba14e 100644
--- a/site/tools/makemkv/index.html
+++ b/site/tools/makemkv/index.html
@@ -1,5 +1,6 @@
- MakeMKV - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
MakeMKV
 
Ripster nutzt makemkvcon für Disc-Analyse und Rip.
 
 
Verwendete Aufrufe
 
Analyse
 
makemkvcon -r info <source>
+ MakeMKV - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
MakeMKV
 
Ripster nutzt makemkvcon für Disc-Analyse und Rip.
 
 
Verwendete Aufrufe
 
Analyse
 
makemkvcon -r info <source>
 
 
<source> ist typischerweise:
 
     
  • disc:<index> (Auto-Modus)
    •  
  • dev:/dev/sr0 (explicit)
    •  
  • file:<path> (Datei/Ordner-Analyse)
    •  
 
Rip (MKV-Modus)
 
makemkvcon mkv <source> <title-or-all> <rawDir> [--minlength=...] [...extraArgs]
 
 
Rip (Backup-Modus)
 
makemkvcon backup <source> <rawDir> --decrypt
-
 
 
Registrierungsschlüssel (optional)
 
Wenn in Settings ein MakeMKV Key gesetzt ist, führt Ripster vor Analyse/Rip aus:
 
makemkvcon reg <key>
-
 
 
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.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+
 
 
Registrierungsschlüssel (optional)
 
Wenn in Settings ein MakeMKV Key gesetzt ist, synchronisiert Ripster ihn nach:
 
~/.MakeMKV/settings.conf
+
 
Format:
 
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.
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/tools/mediainfo/index.html b/site/tools/mediainfo/index.html
index 3fdfa29..c45486e 100644
--- a/site/tools/mediainfo/index.html
+++ b/site/tools/mediainfo/index.html
@@ -1,2 +1,2 @@
- MediaInfo - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
MediaInfo
 
Ripster nutzt mediainfo zur JSON-Analyse von Medien-Dateien.
 
 
Aufruf
 
mediainfo --Output=JSON <input>
+ MediaInfo - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
MediaInfo
 
Ripster nutzt mediainfo zur JSON-Analyse von Medien-Dateien.
 
 
Aufruf
 
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)
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
diff --git a/site/workflows/index.html b/site/workflows/index.html
index 50392a0..06fdd39 100644
--- a/site/workflows/index.html
+++ b/site/workflows/index.html
@@ -1 +1 @@
- Workflows aus Nutzersicht - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Workflows aus Nutzersicht
 
Diese Seite beschreibt die produktiven Abläufe als Handbuch: welche Entscheidung an welcher Stelle fällt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
 
Gemeinsame Grundlagen
 
Statuskette im Normalfall
 
Medium erkannt -> Analyse -> Metadatenauswahl -> Startbereit -> Rippen -> Mediainfo-Pruefung -> Bereit zum Encodieren -> Encodieren -> Fertig
 
Abweichungen:
 
     
  • bei Blu-ray/DVD mit nötiger Playlistwahl: Mediainfo-Pruefung -> Warte auf Auswahl -> zurück in Mediainfo-Pruefung
    •  
  • bei vorhandenem RAW: Startbereit springt direkt in Review/Prüfung ohne neuen Laufwerks-Rip
    •  
  • bei Fehler/Abbruch: Fehler oder Abgebrochen mit Wiederanlauf-Aktionen
    •  
 
Job- und Container-Typen
 
  
 Typ Zweck Was enthält der Typ? 
   
 Normaler Disc-Job Einzel-Film oder einzelne Disc RAW-Pfad, Output-Pfad, Logs, Review 
 
 dvd_series_container logischer Serien-Container (pro Serie/Staffel) Metadatenanker, aggregierter Status über Kinder 
 
 dvd_series_child einzelne Serien-Disc oder Serien-Episode-Job eigentliche RAW-/Encode-Arbeit 
 
 multipart_movie_container logischer Multipart-Film-Container Zusammenfassung für mehrere Film-Discs 
 
 multipart_movie_child einzelne Disc innerhalb Multipart-Film Disc-spezifische RAW-/Encode-Daten 
  
 
Wichtig:
 
     
  • Container sind primär Ordnungs- und Statusobjekte.
    •  
  • Dateien (RAW/Output) hängen an den Child-Jobs.
    •  
 
Workflow A: Film (Blu-ray/DVD)
 
1) Disc analysieren und Film-Metadaten wählen
 
     
  1. Im Ripper Analyse starten.
    2.  
  2. Im Metadaten-Dialog Film auswählen (OMDb bzw. manuelle Film-Metadaten).
    3.  
  3. Auswahl übernehmen.
    4.  
 
Wirkung:
 
     
  • der Job wird als Film-Workflow geführt
    •  
  • Film-Fingerprint für Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
    •  
 
2) Duplikatfall entscheiden
 
Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
 
     
  1. Übernahme erzwingen (allow_new): neuer unabhängiger Film-Job
    2.  
  2. Multipart movie: neuer Job wird mit bestehendem Job in einem Multipart-Container verknüpft
    3.  
 
Bei Multipart gilt:
 
     
  • beide Discs brauchen unterschiedliche Disc-Nummer
    •  
  • gleiche Disc-Nummer blockiert den Vorgang (MULTIPART_DISC_ALREADY_EXISTS)
    •  
 
3) RAW-Verzeichnis entsteht
 
Ordnername basiert auf Metadaten plus Job-ID:
 
     
  • Incomplete_<Titel> (<Jahr>) - RAW - job-<id>
    •  
 
Zustandswechsel des RAW-Ordners:
 
     
  • beim Start: Incomplete_...
    •  
  • nach erfolgreichem Rip: Rip_Complete_...
    •  
  • nach erfolgreichem Encode: Prefix wird entfernt (final)
    •  
 
4) Review und Encode
 
In Bereit zum Encodieren:
 
     
  • Titel wählen
    •  
  • Audio-/Subtitle-Spuren festlegen
    •  
  • optional User-Preset
    •  
  • optional Pre-/Post-Encode-Skripte oder Ketten
    •  
 
Beim Start:
 
     
  • temporäre Ausgabe in Incomplete_job-<id>/<Datei>.<ext>
    •  
  • nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
    •  
 
Workflow B: Serie (Blu-ray/DVD)
 
1) Serienmodus aktivieren
 
     
  1. Disc analysieren.
    2.  
  2. Im Metadaten-Dialog Serienmetadaten wählen (TMDb-basiert).
    3.  
  3. Disc-Nummer setzen (Pflicht, ab 1).
    4.  
 
Wirkung:
 
     
  • Workflow-Kind wird series
    •  
  • Seriencontainer wird gesucht/angelegt
    •  
  • aktueller Job wird als dvd_series_child darunter geführt
    •  
 
2) Seriencontainer und Disc-Konflikte
 
Beim Speichern wird geprüft:
 
     
  • existiert für Serie/Staffel bereits ein Container?
    •  
  • existiert in diesem Container bereits dieselbe Disc-Nummer?
    •  
 
Wenn ja, wird blockiert (SERIES_DISC_ALREADY_EXISTS).
 
3) Serien-RAW-Pfad
 
Für Serien wird ein eigener RAW-Pfad bevorzugt:
 
     
  • Blu-ray: raw_dir_bluray_series (Fallback: raw_dir_bluray)
    •  
  • DVD: raw_dir_dvd_series (Fallback: raw_dir_dvd)
    •  
 
RAW-Namensbasis enthält Staffel/Disc (SxDy) und wird ebenfalls mit den Prefix-Phasen geführt:
 
     
  • Incomplete_... -> Rip_Complete_... -> final
    •  
 
4) Serien-Review und Episoden-Ausgabe
 
Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
 
     
  • Einzel-Episode: Episode-Template
    •  
  • Multi-Episode-Titel: Multi-Episode-Template
    •  
 
Ausgabepfad:
 
     
  • Root: series_dir_* (Fallback auf movie_dir_*)
    •  
  • Dateiname/Unterordner aus Serien-Template
    •  
 
5) Multi-Episode-Disc als Batch
 
Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
 
     
  • Ripster erzeugt Episode-Child-Jobs
    •  
  • der ursprüngliche Disc-Job dient als Batch-Anker
    •  
  • RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
    •  
 
Workflow C: Multipart-Film
 
Wann dieser Flow gedacht ist
 
     
  • gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
    •  
  • Zusammengehörigkeit soll in Historie und Detailansichten sichtbar sein
    •  
 
Ablauf
 
     
  1. Film-Metadaten wählen.
    2.  
  2. Duplikatdialog -> Multipart movie.
    3.  
  3. Disc-Nummern für bestehenden und neuen Job festlegen.
    4.  
 
Wirkung:
 
     
  • multipart_movie_container wird angelegt oder wiederverwendet
    •  
  • beteiligte Jobs werden multipart_movie_child
    •  
  • Container führt gemeinsame Metadaten, Kinder führen je Disc die eigentlichen Artefakte
    •  
 
Workflow D: Vorhandenes RAW / RAW-Import
 
Fall 1: RAW bereits vorhanden bei Metadatenübernahme
 
Nach Metadaten-Übernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
 
Möglichkeiten:
 
     
  • vorhandenes RAW weiterverwenden (kein neuer Rip)
    •  
  • RAW löschen/ignorieren und neu rippen
    •  
 
Fall 2: Orphan-RAW aus /database
 
     
  1. In Database RAW prüfen.
    2.  
  2. Bei orphan RAW Job anlegen.
    3.  
  3. Job wird in Historie erzeugt und wie "Disk analysieren aus RAW" weiterverarbeitet.
    4.  
 
Workflow E: Nachbearbeitung bestehender Jobs
 
In Historie (Detaildialog):
 
  
 Aktion Wirkung 
   
 OMDb neu zuordnen Metadaten neu schreiben, Folder-Rename wird best effort angestoßen 
 
 Review neu starten Titel-/Spurprüfung aus aktuellem RAW neu aufbauen 
 
 RAW neu encodieren Encode erneut aus vorhandenem RAW starten 
 
 Encode neu starten letzte bestätigte Review-Einstellungen wiederverwenden 
 
 Retry Rippen Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden 
  
 
Wo landet was? (Artefakt-Matrix)
 
  
 Artefakt Film Serie Multipart 
   
 RAW raw_dir_* bevorzugt raw_dir_*_series pro Child-Job im normalen Film-RAW-Schema 
 
 Finale Ausgabe movie_dir_* + Film-Template series_dir_* (Fallback movie_dir_*) + Serien-Templates pro Child-Job normaler Film-Output 
 
 Container-Datensatz nein ja (dvd_series_container) ja (multipart_movie_container) 
 
 Löschvorschau in Historie einzelner Job oder Related Scope Container-/Child-bezogen mit Pfadauswahl Container-/Child-bezogen mit Pfadauswahl 
  
 
Queue-Verhalten im Alltag
 
Die Startfreigabe hängt an vier Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • Audio CDs: Queue-Reihenfolge überspringen
    •  
 
Praxis:
 
     
  • Film/Video- und Audio/CD laufen in getrennten Lanes
    •  
  • Gesamtlimit begrenzt beide gemeinsam
    •  
  • Queue kann neben Jobs auch Skript, Kette, Warten enthalten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file
+ Workflows aus Nutzersicht - Ripster      
 
  
   
 
 
 
 
 
 
  
 
 
 
 
 
Workflows aus Nutzersicht
 
Diese Seite beschreibt die produktiven Abläufe als Handbuch: welche Entscheidung an welcher Stelle fällt, welche Objekte dabei entstehen (Job, Container, Child-Job) und welche Dateien in welchen Ordnern landen.
 
Gemeinsame Grundlagen
 
Statuskette im Normalfall
 
Medium erkannt -> Analyse -> Metadatenauswahl -> Startbereit -> Rippen -> Mediainfo-Pruefung -> Bereit zum Encodieren -> Encodieren -> Fertig
 
Abweichungen:
 
     
  • bei Blu-ray/DVD mit nötiger Playlistwahl: Mediainfo-Pruefung -> Warte auf Auswahl -> zurück in Mediainfo-Pruefung
    •  
  • bei vorhandenem RAW: Startbereit springt direkt in Review/Prüfung ohne neuen Laufwerks-Rip
    •  
  • bei Fehler/Abbruch: Fehler oder Abgebrochen mit Wiederanlauf-Aktionen
    •  
 
Job- und Container-Typen
 
  
 Typ Zweck Was enthält der Typ? 
   
 Normaler Disc-Job Einzel-Film oder einzelne Disc RAW-Pfad, Output-Pfad, Logs, Review 
 
 dvd_series_container logischer Serien-Container (pro Serie/Staffel) Metadatenanker, aggregierter Status über Kinder 
 
 dvd_series_child einzelne Serien-Disc oder Serien-Episode-Job eigentliche RAW-/Encode-Arbeit 
 
 multipart_movie_container logischer Multipart-Film-Container Zusammenfassung für mehrere Film-Discs 
 
 multipart_movie_child einzelne Disc innerhalb Multipart-Film Disc-spezifische RAW-/Encode-Daten 
  
 
Wichtig:
 
     
  • Container sind primär Ordnungs- und Statusobjekte.
    •  
  • Dateien (RAW/Output) hängen an den Child-Jobs.
    •  
 
Workflow A: Film (Blu-ray/DVD)
 
1) Disc analysieren und Film-Metadaten wählen
 
     
  1. Im Ripper Analyse starten.
    2.  
  2. Im Metadaten-Dialog Film auswählen (OMDb bzw. manuelle Film-Metadaten).
    3.  
  3. Auswahl übernehmen.
    4.  
 
Wirkung:
 
     
  • der Job wird als Film-Workflow geführt
    •  
  • Film-Fingerprint für Duplikaterkennung wird gebildet (IMDb oder Titel/Jahr)
    •  
 
2) Duplikatfall entscheiden
 
Wenn Film mit gleichem Fingerprint bereits existiert, gibt es zwei Wege:
 
     
  1. Übernahme erzwingen (allow_new): neuer unabhängiger Film-Job
    2.  
  2. Multipart movie: neuer Job wird mit bestehendem Job in einem Multipart-Container verknüpft
    3.  
 
Bei Multipart gilt:
 
     
  • beide Discs brauchen unterschiedliche Disc-Nummer
    •  
  • gleiche Disc-Nummer blockiert den Vorgang (MULTIPART_DISC_ALREADY_EXISTS)
    •  
 
3) RAW-Verzeichnis entsteht
 
Ordnername basiert auf Metadaten plus Job-ID:
 
     
  • Incomplete_<Titel> (<Jahr>) - RAW - job-<id>
    •  
 
Zustandswechsel des RAW-Ordners:
 
     
  • beim Start: Incomplete_...
    •  
  • nach erfolgreichem Rip: Rip_Complete_...
    •  
  • nach erfolgreichem Encode: Prefix wird entfernt (final)
    •  
 
4) Review und Encode
 
In Bereit zum Encodieren:
 
     
  • Titel wählen
    •  
  • Audio-/Subtitle-Spuren festlegen
    •  
  • optional User-Preset
    •  
  • optional Pre-/Post-Encode-Skripte oder Ketten
    •  
 
Beim Start:
 
     
  • temporäre Ausgabe in Incomplete_job-<id>/<Datei>.<ext>
    •  
  • nach Erfolg Verschiebung in finalen Zielpfad aus Film-Template
    •  
 
Workflow B: Serie (Blu-ray/DVD)
 
1) Serienmodus aktivieren
 
     
  1. Disc analysieren.
    2.  
  2. Im Metadaten-Dialog Serienmetadaten wählen (TMDb-basiert).
    3.  
  3. Disc-Nummer setzen (Pflicht, ab 1).
    4.  
 
Wirkung:
 
     
  • Workflow-Kind wird series
    •  
  • Seriencontainer wird gesucht/angelegt
    •  
  • aktueller Job wird als dvd_series_child darunter geführt
    •  
 
2) Seriencontainer und Disc-Konflikte
 
Beim Speichern wird geprüft:
 
     
  • existiert für Serie/Staffel bereits ein Container?
    •  
  • existiert in diesem Container bereits dieselbe Disc-Nummer?
    •  
 
Wenn ja, wird blockiert (SERIES_DISC_ALREADY_EXISTS).
 
3) Serien-RAW-Pfad
 
Für Serien wird ein eigener RAW-Pfad bevorzugt:
 
     
  • Blu-ray: raw_dir_bluray_series (Fallback: raw_dir_bluray)
    •  
  • DVD: raw_dir_dvd_series (Fallback: raw_dir_dvd)
    •  
 
RAW-Namensbasis enthält Staffel/Disc (SxDy) und wird ebenfalls mit den Prefix-Phasen geführt:
 
     
  • Incomplete_... -> Rip_Complete_... -> final
    •  
 
4) Serien-Review und Episoden-Ausgabe
 
Beim Review werden Episoden-/Titelzuordnungen genutzt. Je nach Auswahl:
 
     
  • Einzel-Episode: Episode-Template
    •  
  • Multi-Episode-Titel: Multi-Episode-Template
    •  
 
Ausgabepfad:
 
     
  • Root: series_dir_* (Fallback auf movie_dir_*)
    •  
  • Dateiname/Unterordner aus Serien-Template
    •  
 
5) Multi-Episode-Disc als Batch
 
Wenn mehrere Episoden-Titel aus einer Disc encodiert werden:
 
     
  • Ripster erzeugt Episode-Child-Jobs
    •  
  • der ursprüngliche Disc-Job dient als Batch-Anker
    •  
  • RAW-Finalisierung erfolgt erst, wenn alle Episode-Encodes abgeschlossen sind
    •  
 
Workflow C: Multipart-Film
 
Wann dieser Flow gedacht ist
 
     
  • gleicher Film auf mehreren Discs (z. B. Disc 1/Disc 2)
    •  
  • Zusammengehörigkeit soll in Historie und Detailansichten sichtbar sein
    •  
 
Ablauf
 
     
  1. Film-Metadaten wählen.
    2.  
  2. Duplikatdialog -> Multipart movie.
    3.  
  3. Disc-Nummern für bestehenden und neuen Job festlegen.
    4.  
 
Wirkung:
 
     
  • multipart_movie_container wird angelegt oder wiederverwendet
    •  
  • beteiligte Jobs werden multipart_movie_child
    •  
  • Container führt gemeinsame Metadaten, Kinder führen je Disc die eigentlichen Artefakte
    •  
 
Workflow D: Vorhandenes RAW / RAW-Import
 
Fall 1: RAW bereits vorhanden bei Metadatenübernahme
 
Nach Metadaten-Übernahme erkennt Ripster passende RAW-Ordner und setzt den Job auf Entscheidungsstatus.
 
Möglichkeiten:
 
     
  • vorhandenes RAW weiterverwenden (kein neuer Rip)
    •  
  • RAW löschen/ignorieren und neu rippen
    •  
 
Fall 2: Orphan-RAW aus /database
 
     
  1. In Database RAW prüfen.
    2.  
  2. Bei orphan RAW Job anlegen.
    3.  
  3. Job wird in Historie erzeugt und wie "Disk analysieren aus RAW" weiterverarbeitet.
    4.  
 
Workflow E: Nachbearbeitung bestehender Jobs
 
In Historie (Detaildialog):
 
  
 Aktion Wirkung 
   
 OMDb neu zuordnen Metadaten neu schreiben, Folder-Rename wird best effort angestoßen 
 
 Review neu starten Titel-/Spurprüfung aus aktuellem RAW neu aufbauen 
 
 RAW neu encodieren Encode erneut aus vorhandenem RAW starten 
 
 Encode neu starten letzte bestätigte Review-Einstellungen wiederverwenden 
 
 Retry Rippen Rip/Analyse neu starten; alter Job-RAW kann bereinigt werden 
  
 
Wo landet was? (Artefakt-Matrix)
 
  
 Artefakt Film Serie Multipart 
   
 RAW raw_dir_* bevorzugt raw_dir_*_series pro Child-Job im normalen Film-RAW-Schema 
 
 Finale Ausgabe movie_dir_* + Film-Template series_dir_* (Fallback movie_dir_*) + Serien-Templates pro Child-Job normaler Film-Output 
 
 Container-Datensatz nein ja (dvd_series_container) ja (multipart_movie_container) 
 
 Löschvorschau in Historie einzelner Job oder Related Scope Container-/Child-bezogen mit Pfadauswahl Container-/Child-bezogen mit Pfadauswahl 
  
 
Queue-Verhalten im Alltag
 
Die Startfreigabe hängt an vier Settings:
 
     
  • Max. parallele Film/Video Encodes
    •  
  • Max. parallele Audio CD Jobs
    •  
  • Max. Encodes gesamt
    •  
  • Audio CDs: Queue-Reihenfolge überspringen
    •  
 
Praxis:
 
     
  • Film/Video- und Audio/CD laufen in getrennten Lanes
    •  
  • Gesamtlimit begrenzt beide gemeinsam
    •  
  • Queue kann neben Jobs auch Skript, Kette, Warten enthalten
    •  
 
 
   
  
  
 
 
 
    
\ No newline at end of file