ripster/docs/configuration/settings-reference.md

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