Files
ripster/docs/configuration/settings-reference.md
T
michael c6d884dc3f
Deploy Docs to GitHub Pages / Build Documentation (push) Has been cancelled
Deploy Docs to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled
1.0.0 1.0.0 final
2026-06-12 09:48:45 +02:00

41 KiB
Raw Blame History

Einstellungsreferenz

Diese Seite beschreibt jede aktuelle Einstellung aus der Settings-GUI: was technisch passiert und warum man sie setzt.

Lesehilfe

  • Sichtbarkeit: Standard, Expertenmodus oder Ausgeblendet (nur API/DB).
  • Default: UI-/Schema-Default (sensible Werte werden als leer dargestellt).
  • Was passiert technisch?: direkte Wirkung im Backend/Pipeline-Verhalten.
  • Warum/Wann setzen?: Praxisgrund inkl. typischem Einsatzzweck.

Vollstaendige Feldliste

Kategorie: Benachrichtigungen

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
Expertenmodus ui_expert_mode boolean false Standard Schaltet erweiterte Einstellungen in der UI ein. Wird sofort einzeln gespeichert und beeinflusst Sichtbarkeit von Feldern/Kategorien. Wenn du selten benoetigte technische Felder sehen willst (z.B. Logging- oder CLI-Details).
PushOver aktiviert pushover_enabled boolean false Standard Master-Schalter für PushOver Versand. Wenn du aktive Laufzeit-Benachrichtigungen auf Mobilgeraete erhalten willst.
PushOver Token pushover_token string leer Standard Application Token für PushOver. Wenn Ripster in deine PushOver-App senden soll (Token aus PushOver-App-Config).
PushOver User pushover_user string leer Standard User-Key für PushOver. Wenn Benachrichtigungen an einen bestimmten PushOver-Account gehen sollen.
PushOver Device (optional) pushover_device string leer Expertenmodus Optionales Ziel-Device in PushOver. Wenn Nachrichten nur auf ein bestimmtes Endgeraet zugestellt werden sollen.
PushOver Titel-Präfix pushover_title_prefix string Ripster Standard Prefix im PushOver Titel. Wenn du Meldungen mehrerer Instanzen sauber unterscheiden willst (z.B. "Ripper-Wohnzimmer").
PushOver Priority pushover_priority number 0 Expertenmodus Priorität -2 bis 2. Wenn Meldungen bewusst leiser (niedrig) oder dringender (hoch) zugestellt werden sollen.
PushOver Timeout (ms) pushover_timeout_ms number 7000 Expertenmodus HTTP Timeout für PushOver Requests. Wenn PushOver bei schlechter Verbindung mehr oder weniger Zeit fuer den Request bekommen soll.
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). Wenn 'Bei manueller Auswahl senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Rip-Start senden pushover_notify_rip_started boolean true Standard Sendet beim Start des MakeMKV-Rips. Wenn 'Bei Rip-Start senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Encode-Start senden pushover_notify_encoding_started boolean true Standard Sendet beim Start von HandBrake. Wenn 'Bei Encode-Start senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Erfolg senden pushover_notify_job_finished boolean true Standard Sendet bei erfolgreich abgeschlossenem Job. Wenn 'Bei Erfolg senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Fehler senden pushover_notify_job_error boolean true Standard Sendet bei Fehlern in der Pipeline. Wenn 'Bei Fehler senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Abbruch senden pushover_notify_job_cancelled boolean true Standard Sendet wenn Job manuell abgebrochen wurde. Wenn 'Bei Abbruch senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Re-Encode Start senden pushover_notify_reencode_started boolean true Standard Sendet beim Start von RAW Re-Encode. Wenn 'Bei Re-Encode Start senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.
Bei Re-Encode Erfolg senden pushover_notify_reencode_finished boolean true Standard Sendet bei erfolgreichem RAW Re-Encode. Wenn 'Bei Re-Encode Erfolg senden' bewusst ein- oder ausgeschaltet werden soll, um den Ablauf an deine Umgebung anzupassen.

Kategorie: Converter

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
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). Steuert sowohl Upload-Validierung als auch Converter-Scan-Filter. Wenn 'Erlaubte Datei-Endungen' vom Default abweichen soll.
Auto-Scan (Polling) converter_polling_enabled boolean false Standard Converter Raw-Ordner automatisch in regelmäßigen Abständen scannen. Wenn neue Dateien im Converter-Ordner automatisch erscheinen sollen, ohne manuellen Scan.
Polling-Intervall (Sekunden) converter_polling_interval number 300 Standard Intervall für automatischen Scan des Converter-Ordners. Wenn der Auto-Scan schneller (kleiner Wert) oder ressourcenschonender (groesserer Wert) laufen soll.

Kategorie: Laufwerk

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
Laufwerksmodus drive_mode select auto Standard Auto-Discovery oder explizites Device. Wenn du zwischen automatischer Laufwerkserkennung und fixer Device-Liste umschalten willst.
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. Wird als JSON gespeichert und vom Laufwerksdienst fuer explizite Zuordnung genutzt. Wenn auf dem Host mehrere Laufwerke stabil gemappt werden muessen (z.B. /dev/sr0=disc:0, /dev/sr1=disc:1).
Device Pfad drive_device path /dev/sr0 Ausgeblendet (nur API/DB) Nur für expliziten Modus, z.B. /dev/sr0. Wenn 'Device Pfad' vom Default abweichen soll.
MakeMKV Source Index makemkv_source_index number 0 Ausgeblendet (nur API/DB) Disc Index im Auto-Modus. Wenn 'MakeMKV Source Index' fuer Performance, Last oder Genauigkeit feinjustiert werden soll.
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. Wenn Discs nur manuell statt automatisch erkannt werden sollen.
Polling Intervall (ms) disc_poll_interval_ms number 4000 Expertenmodus Intervall für Disk-Erkennung. Wenn die Erkennung schneller reagieren oder weniger oft pollen soll.
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). Wenn ein Laufwerk nach erfolgreichem Rip direkt freigegeben/ausgeworfen werden soll.

Kategorie: Logging

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
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. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn Terminal-Logs bei Betrieb unter Service/SSH ein- oder ausgeschaltet werden sollen.
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. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn HTTP-Request-Logs im Terminal fuer API-Debugging gebraucht werden.
DEBUG im Terminal server_console_log_debug_enabled boolean true Expertenmodus Steuert DEBUG-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn detailreiche DEBUG-Logs im Terminal benoetigt werden (Fehlersuche).
INFO im Terminal server_console_log_info_enabled boolean true Expertenmodus Steuert INFO-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn normale INFO-Laufzeitmeldungen im Terminal sichtbar sein sollen.
WARN im Terminal server_console_log_warn_enabled boolean true Expertenmodus Steuert WARN-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn Warnungen im Terminal hervorgehoben bleiben sollen.
ERROR im Terminal server_console_log_error_enabled boolean true Expertenmodus Steuert ERROR-Meldungen in der Terminal-Ausgabe. Dateilogs bleiben unverändert. Aenderung wirkt direkt auf die Terminal-Logausgabe, Dateilogging bleibt erhalten. Wenn Fehler zwingend im Terminal sichtbar sein sollen.

Kategorie: Metadaten

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
TMDb Read Access Token tmdb_api_read_access_token string leer Standard Read Access Token für Serien-Metadaten über TheMovieDB (TMDb). Wird von TMDb-Service und Serienzuordnung in Analyse/Metadaten-Dialog genutzt. Wenn TMDb-Metadaten (Suche/Zuordnung/Serienepisoden) verlässlich funktionieren sollen.
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. Wird von TMDb-Service und Serienzuordnung in Analyse/Metadaten-Dialog genutzt. Wenn bevorzugt deutsche, englische oder andere lokalisierte Metadaten genutzt werden sollen.
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. Wird von TMDb-Service und Serienzuordnung in Analyse/Metadaten-Dialog genutzt. Wenn bei fehlender Primärsprache automatisch andere Sprachversionen ausprobiert werden sollen.
Coverart-Nachladen aktiv coverart_recovery_enabled boolean true Standard Wenn aktiv, werden fehlende Coverarts automatisch in Intervallen geprüft und nachgeladen. Aenderung aktualisiert den Coverart-Recovery-Scheduler. Wenn fehlende Cover später automatisch nachgezogen werden sollen.
Coverart-Prüfintervall (Stunden) coverart_recovery_interval_hours number 6 Standard Intervall für automatische Prüfung fehlender Coverarts in Stunden. Aenderung aktualisiert den Coverart-Recovery-Scheduler. Wenn der Nachlade-Job haeufiger oder seltener laufen soll.
NFO nach Encode erzeugen generate_nfo_after_encode boolean false Standard Erstellt nach erfolgreichem Encode automatisch eine .nfo-Datei neben der Ausgabedatei. Wird nach erfolgreichem Encode in der Historie/Pipeline ausgewertet. Wenn neben der Ausgabedatei automatisch eine .nfo fuer Media-Center erzeugt werden soll.

Kategorie: Monitoring

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
Hardware Monitoring aktiviert hardware_monitoring_enabled boolean true Standard Master-Schalter: aktiviert/deaktiviert das komplette Hardware-Monitoring (Polling + Berechnung + WebSocket-Updates). Aenderung triggert Re-Konfiguration des Hardware-Monitoring-Dienstes. Wenn CPU/RAM/GPU/Speicher live sichtbar sein sollen.
Hardware Monitoring Intervall (ms) hardware_monitoring_interval_ms number 5000 Expertenmodus Polling-Intervall für CPU/RAM/GPU/Storage-Metriken. Aenderung triggert Re-Konfiguration des Hardware-Monitoring-Dienstes. Wenn Monitoring häufiger aktualisiert oder Last reduziert werden soll.

Kategorie: Pfade

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
Raw Ausgabeordner (Blu-ray) raw_dir_bluray path leer Standard Optionaler RAW-Zielpfad nur für Blu-ray. Leer = Fallback auf "Raw Ausgabeordner". Wenn 'Raw Ausgabeordner (Blu-ray)' vom Default abweichen soll.
Raw Ausgabeordner (DVD) raw_dir_dvd path leer Standard Optionaler RAW-Zielpfad nur für DVD. Leer = Fallback auf "Raw Ausgabeordner". Wenn 'Raw Ausgabeordner (DVD)' vom Default abweichen soll.
CD RAW-Ordner raw_dir_cd path leer Standard Basisordner für rohe CD-WAV-Dateien (cdparanoia-Output). Leer = Standardpfad (data/output/cd). Wenn 'CD RAW-Ordner' vom Default abweichen soll.
Audiobook RAW-Ordner raw_dir_audiobook path leer Standard Basisordner für hochgeladene AAX-Dateien. Leer = Standardpfad (data/output/audiobook-raw). Wenn 'Audiobook RAW-Ordner' vom Default abweichen soll.
Serien-Ordner (Blu-ray) series_dir_bluray path leer Standard Zielordner für Blu-ray-Serienfolgen. Leer = Standardpfad (data/output/series). Wenn 'Serien-Ordner (Blu-ray)' vom Default abweichen soll.
Film Ausgabeordner (Blu-ray) movie_dir_bluray path leer Standard Optionaler Encode-Zielpfad nur für Blu-ray. Leer = Fallback auf "Film Ausgabeordner". Wenn 'Film Ausgabeordner (Blu-ray)' vom Default abweichen soll.
Film Ausgabeordner (DVD) movie_dir_dvd path leer Standard Optionaler Encode-Zielpfad nur für DVD. Leer = Fallback auf "Film Ausgabeordner". Wenn 'Film Ausgabeordner (DVD)' vom Default abweichen soll.
Serien-Ordner (DVD) series_dir_dvd path leer Standard Zielordner für DVD-Serienfolgen. Leer = Standardpfad (data/output/series). Wenn 'Serien-Ordner (DVD)' vom Default abweichen soll.
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. Wenn 'CD Output-Ordner' vom Default abweichen soll.
Audiobook Output-Ordner movie_dir_audiobook path leer Standard Zielordner für encodierte Audiobook-Dateien. Leer = Standardpfad (data/output/audiobooks). Wenn 'Audiobook Output-Ordner' vom Default abweichen soll.
Download ZIP-Ordner download_dir path leer Standard Zielordner für vorbereitete ZIP-Downloads. Leer = Standardpfad (data/downloads). Leere Werte nutzen automatisch den Installations-Defaultpfad. Wenn RAW/Output/Download auf andere Datentraeger verschoben werden sollen (z.B. grosse HDD/NAS).
Externe Speicher external_storage_paths path [] Standard Wird links unter "Freie Speicher" angezeigt. Wenn 'Externe Speicher' vom Default abweichen soll.
Log Ordner log_dir path installationsabhaengig Standard Basisordner für Logs. Job-Logs liegen direkt hier, Backend-Logs in /backend. Wird zur Laufzeit angewendet; bei ungueltigem Pfad faellt Ripster auf Fallback-Logpfad zurueck. Wenn Logs auf ein anderes Medium sollen (z.B. persistentes NAS/SSD statt Standardpfad).
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. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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). Leere Werte nutzen automatisch den Installations-Defaultpfad. Wenn RAW/Output/Download auf andere Datentraeger verschoben werden sollen (z.B. grosse HDD/NAS).
Converter Ausgabe (Video) converter_movie_dir path leer Standard Ausgabepfad für konvertierte Video-Dateien. Leer = Standardpfad (data/output/converted-movies). Leere Werte nutzen automatisch den Installations-Defaultpfad. Wenn RAW/Output/Download auf andere Datentraeger verschoben werden sollen (z.B. grosse HDD/NAS).
Converter Ausgabe (Audio) converter_audio_dir path leer Standard Ausgabepfad für konvertierte Audio-Dateien. Leer = Standardpfad (data/output/converted-audio). Leere Werte nutzen automatisch den Installations-Defaultpfad. Wenn RAW/Output/Download auf andere Datentraeger verschoben werden sollen (z.B. grosse HDD/NAS).
Output-Template (Video) converter_output_template_video string {title} Standard Dateiname-Template für konvertierte Video-Dateien (ohne Endung). Platzhalter: {title}, {year}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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}. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.
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). Wenn 'RAW-Ordner (Blu-ray Serie)' vom Default abweichen soll.
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). Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
RAW-Ordner (DVD Serie) raw_dir_dvd_series path leer Standard RAW-Zielpfad für DVD-Serien. Leer = gleicher Pfad wie RAW-Ordner (DVD). Wenn 'RAW-Ordner (DVD Serie)' vom Default abweichen soll.
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). Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wird beim Anlegen/Finalisieren per chown auf Zielpfade angewendet. Greift bei ZIP-Ordner, Archivdatei und Metadatei. Wenn Dateien/Ordner nicht dem Service-User gehoeren sollen (z.B. NAS-Freigaben). Beispiel: media:media.
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. Wenn Ausgabe-/Ordnernamen standardisiert werden sollen. Beispiel: Serien nach Staffel oder Kapitel in Unterordner strukturieren.

Kategorie: Tools

GUI-Feld Key Typ Default Sichtbarkeit Was passiert technisch? Warum/Wann setzen?
MakeMKV Kommando makemkv_command string makemkvcon Expertenmodus Pfad oder Befehl für makemkvcon. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
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. Wenn MakeMKV-Features ohne Trial-Limit genutzt werden sollen (inkl. Betakey-Usecase).
Mediainfo Kommando mediainfo_command string mediainfo Expertenmodus Pfad oder Befehl für mediainfo. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
Minimale Titellänge (Minuten) makemkv_min_length_minutes number 60 Standard Filtert kurze Titel beim Rip. Wenn kurze Bonus-/Trailer-Titel automatisch ausgefiltert werden sollen.
HandBrake Kommando handbrake_command string HandBrakeCLI Expertenmodus Pfad oder Befehl für HandBrakeCLI. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
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. Wenn bei Encode-Neustart alte, unvollstaendige Dateien sicher entfernt werden sollen.
Parallele Jobs pipeline_max_parallel_jobs number 1 Standard Maximale Anzahl parallel laufender Jobs. Weitere Starts landen in der Queue. Aenderung beeinflusst Queue-Pump und Startentscheidungen fuer neue Jobs. Wenn Durchsatz und CPU-Last fuer Videojobs ausbalanciert werden sollen.
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. Aenderung beeinflusst Queue-Pump und Startentscheidungen fuer neue Jobs. Wenn mehrere Audio-CD-Jobs parallel erlaubt/begrenzt werden sollen.
Script-Test Timeout (ms) script_test_timeout_ms number 0 Expertenmodus Timeout fuer Script-Tests in den Settings. 0 = kein Timeout. Wird beim Testlauf von Scripts in Settings angewendet. Wenn Script-Tests bei Haengern automatisch abgebrochen werden sollen.
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. Aenderung beeinflusst Queue-Pump und Startentscheidungen fuer neue Jobs. Wenn ein harter Deckel fuer alle Encodes zusammen gelten soll.
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. Aenderung beeinflusst Queue-Pump und Startentscheidungen fuer neue Jobs. Wenn Audio-CD-Jobs nicht hinter langen Video-Warteschlangen blockieren sollen.
cdparanoia Kommando cdparanoia_command string cdparanoia Expertenmodus Pfad oder Befehl für cdparanoia. Wird als Fallback genutzt wenn kein individuelles Kommando gesetzt ist. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
FFmpeg Kommando ffmpeg_command string ffmpeg Standard Pfad oder Befehl für ffmpeg. Wird für Audiobook-Encoding genutzt. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
FFprobe Kommando ffprobe_command string ffprobe Standard Pfad oder Befehl für ffprobe. Wird für Audiobook-Metadaten und Kapitel genutzt. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).
Mediainfo Extra Args mediainfo_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für mediainfo (Blu-ray). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
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. Wenn fuer 'MakeMKV Rip Modus' ein anderes Standardverhalten benoetigt wird.
MakeMKV Analyze Extra Args makemkv_analyze_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für Analyze (Blu-ray). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
MakeMKV Rip Extra Args makemkv_rip_extra_args_bluray string leer Expertenmodus Zusätzliche CLI-Parameter für Rip (Blu-ray). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
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. Wenn ein bevorzugtes Standard-Preset fuer Blu-ray nicht jedes Mal manuell gewaehlt werden soll.
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-ma... Standard Zusätzliche CLI-Argumente (Blu-ray). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
Review Audio-Sprachen (Blu-ray Film) handbrake_review_audio_languages_bluray_movie string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Audio-Spuren bei Blu-ray-Filmen. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Audio-Auswahl vorgeben. Wenn bei Blu-ray-Filmen im Review nicht mehr alle Audio-Spuren vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review UT-Sprachen (Blu-ray Film) handbrake_review_subtitle_languages_bluray_movie string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Untertiteln bei Blu-ray-Filmen. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Subtitle-Auswahl vorgeben. Wenn bei Blu-ray-Filmen im Review nicht mehr alle Untertitel vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review Audio-Sprachen (Blu-ray Serie) handbrake_review_audio_languages_bluray_series string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Audio-Spuren bei Blu-ray-Serien. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Audio-Auswahl vorgeben. Wenn bei Blu-ray-Serien im Review nicht mehr alle Audio-Spuren vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review UT-Sprachen (Blu-ray Serie) handbrake_review_subtitle_languages_bluray_series string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Untertiteln bei Blu-ray-Serien. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Subtitle-Auswahl vorgeben. Wenn bei Blu-ray-Serien im Review nicht mehr alle Untertitel vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Ausgabeformat output_extension_bluray select mkv Standard Dateiendung für finale Datei (Blu-ray). Wenn finale Blu-ray-Dateien standardmaessig als MKV oder MP4 ausgegeben werden sollen.
Mediainfo Extra Args mediainfo_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für mediainfo (DVD). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
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. Wenn fuer 'MakeMKV Rip Modus' ein anderes Standardverhalten benoetigt wird.
MakeMKV Analyze Extra Args makemkv_analyze_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für Analyze (DVD). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
MakeMKV Rip Extra Args makemkv_rip_extra_args_dvd string leer Expertenmodus Zusätzliche CLI-Parameter für Rip (DVD). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
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. Wenn ein bevorzugtes Standard-Preset fuer DVD nicht jedes Mal manuell gewaehlt werden soll.
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-ma... Standard Zusätzliche CLI-Argumente (DVD). Wenn du das CLI-Verhalten feinjustieren willst (Codec, Sprache, Untertitel, Analyse-Optionen).
Review Audio-Sprachen (DVD Film) handbrake_review_audio_languages_dvd_movie string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Audio-Spuren bei DVD-Filmen. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Audio-Auswahl vorgeben. Wenn bei DVD-Filmen im Review nicht mehr alle Audio-Spuren vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review UT-Sprachen (DVD Film) handbrake_review_subtitle_languages_dvd_movie string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Untertiteln bei DVD-Filmen. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Subtitle-Auswahl vorgeben. Wenn bei DVD-Filmen im Review nicht mehr alle Untertitel vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review Audio-Sprachen (DVD Serie) handbrake_review_audio_languages_dvd_series string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Audio-Spuren bei DVD-Serien. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Audio-Auswahl vorgeben. Wenn bei DVD-Serien im Review nicht mehr alle Audio-Spuren vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Review UT-Sprachen (DVD Serie) handbrake_review_subtitle_languages_dvd_series string leer Standard Kommagetrennte Sprachliste für die Review-Vorauswahl von Untertiteln bei DVD-Serien. Beispiel: de,en,jp. Greift nur, wenn Preset/Extra Args keine Subtitle-Auswahl vorgeben. Wenn bei DVD-Serien im Review nicht mehr alle Untertitel vorausgewählt werden sollen, sondern nur bestimmte Sprachen.
Ausgabeformat output_extension_dvd select mkv Standard Dateiendung für finale Datei (DVD). Wenn finale DVD-Dateien standardmaessig als MKV oder MP4 ausgegeben werden sollen.
mkvmerge Kommando mkvmerge_command string mkvmerge Standard Pfad oder Befehl für mkvmerge. Wird für Multipart-Movie-Merges genutzt. Wenn ein Tool nicht im PATH liegt oder eine feste Binary genutzt werden soll (voller Pfad).

Spezielle Werteformate

  • Eigentümer (user:gruppe): z.B. media:media oder 1000:1000.
  • drive_devices (JSON): [{"path":"/dev/sr0","makemkvIndex":0},{"path":"/dev/sr1","makemkvIndex":1}]
  • external_storage_paths (JSON): [{"name":"USB HDD","path":"/mnt/usb-hdd"}]
  • converter_scan_extensions: kommagetrennt, ohne Punkt, z.B. mkv,mp4,flac,mp3.
  • Template-Felder: erlauben Platzhalter ({...} / ${...}) und / fuer Unterordner.

Hinweis zu ausgeblendeten Feldern

Die Keys drive_device, makemkv_source_index, makemkv_rip_mode_bluray, makemkv_rip_mode_dvd liegen im Schema, werden aber bewusst nicht im normalen Formular angezeigt.