Zum Inhalt

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. 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-<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).