0.14.0-4 Docs

docs/gui/settings.md

@@ -1,92 +1,107 @@
 # Settings
 
-Die Seite `Settings` steuert Konfiguration und Automatisierung.
+Die Seite `Settings` steuert alle Betriebsparameter von Ripster: Pfade, Tools, Queue-Limits, Metadatenquellen, Automatisierung.
 
-## Tabs im Überblick
+## Tab-Überblick
 
-| Tab | Zweck |
+| Tab | Hauptzweck |
 |---|---|
-| `Konfiguration` | alle Kernsettings (Pfade, Tools, Monitoring, Metadaten, Queue, Benachrichtigungen) |
-| `Scripte` | einzelne Bash-Skripte verwalten und testen |
-| `Skriptketten` | Sequenzen aus Skript- und Warte-Schritten bauen |
-| `Encode-Presets` | benutzerdefinierte Presets für das Review im Ripper |
-| `Cronjobs` | zeitgesteuerte Skript-/Kettenausführung |
-
----
+| `Konfiguration` | globale und profilspezifische Laufzeitsettings |
+| `Scripte` | einzelne Skripte verwalten und testen |
+| `Skriptketten` | mehrstufige Abläufe aus Skript/Warten |
+| `Encode-Presets` | wiederverwendbare HandBrake-Profile für Review |
+| `Cronjobs` | zeitgesteuerte Ausführung von Skript/Kette |
 
 ## Tab `Konfiguration`
 
-Wichtiges Bedienmuster:
+### Bedienprinzip
 
-1. Werte ändern
-2. `Änderungen speichern`
-3. bei Bedarf `Änderungen verwerfen` oder `Neu laden`
+1. Werte ändern.
+2. `Änderungen speichern`.
+3. erst danach sind Werte für neue Aktionen wirksam.
 
-Zusätzlich:
+Zusätzliche Bedienhilfen:
 
-- `PushOver Test` sendet eine Testnachricht
-- Änderungen werden erst nach Speichern wirksam
-- Tool-Preset-Felder bieten HandBrake-Presetauswahl direkt im Formular
+- `Neu laden` verwirft lokale Formzustände
+- `Änderungen verwerfen` setzt auf zuletzt gespeicherten Stand
+- `PushOver Test` validiert Benachrichtigungszugang sofort
+
+### Was wirkt unmittelbar, was erst bei neuem Job?
+
+- Queue-/Parallelität wirkt auf neue Queue-Entscheidungen und Pump-Läufe.
+- Tool-/Pfad-/Template-Änderungen wirken vollständig auf neu gestartete Schritte.
+- Bereits laufende Prozesse übernehmen Änderungen in der Regel nicht rückwirkend.
+
+### Welche Bereiche im Alltag kritisch sind
+
+| Bereich | Kritisch für |
+|---|---|
+| `Pfade` | wo RAW, finale Ausgaben, Converter/Audiobook-Dateien landen |
+| `Tools` | ob Analyze/Rip/Encode ausführbar sind |
+| `Metadaten` | Film-/Serienzuordnung und Episode-Mapping |
+| `Queue-Limits` | Durchsatz und Reihenfolgeverhalten |
+| `Monitoring` | Sichtbarkeit von Last und Speicherengpässen |
+| `Benachrichtigungen` | PushOver-Ereignisse je Pipelinephase |
 
 ## Tab `Scripte`
 
 Funktionen:
 
-- Skript anlegen, bearbeiten, löschen
-- Skript testen (`Test`)
-- Reihenfolge per Drag-and-Drop
+- anlegen, bearbeiten, löschen
+- testen (`Test`)
+- sortieren
 
-Praxis:
+Testausführung liefert:
 
-- Reihenfolge ist wichtig, weil ausgewählte Skripte später sequentiell abgearbeitet werden.
-- Testresultate zeigen Exit-Code, Dauer und stdout/stderr.
+- Exit-Code
+- Dauer
+- stdout/stderr
+
+Wichtig:
+
+- Nur erfolgreiche Skripte sollten in produktive Pre-/Post-Listen übernommen werden.
 
 ## Tab `Skriptketten`
 
-Funktionen:
+Ketten bestehen aus Schritten:
 
-- Kette anlegen/bearbeiten/löschen
-- Kette testen
-- Reihenfolge der Ketten per Drag-and-Drop
+- `Skript`
+- `Warten`
 
-Im Ketten-Editor:
+Typischer Einsatz:
 
-- Bausteine links (`Warten`, vorhandene Skripte)
-- Schritte rechts per Klick oder Drag-and-Drop hinzufügen
-- Schrittreihenfolge im Canvas ändern
+- externe Hooks vor/nach Encode
+- gestaffelte Abläufe mit Pausen
+
+In der Queue erscheinen Ketten als eigene Einträge und werden dort ausgeführt.
 
 ## Tab `Encode-Presets`
 
 Ein Preset bündelt:
 
-- optional HandBrake-Preset (`-Z`)
+- optionales HandBrake-Preset (`-Z`)
 - optionale Extra-Args
-- Medientyp (`Universell`, `Blu-ray`, `DVD`, `Sonstiges`)
+- Medienziel (Universell/Blu-ray/DVD/Sonstiges)
 
-Verwendung:
-
-- Diese Presets erscheinen später im Ripper im Review (`Bereit zum Encodieren`).
+Im Ripper-Review kannst du Presets pro Job auswählen, statt Parameter jedes Mal neu zu setzen.
 
 ## Tab `Cronjobs`
 
 Funktionen:
 
 - Cronjob anlegen und bearbeiten
-- Quelle wählen: Skript oder Skriptkette
-- Cron-Ausdruck validieren
+- Quelle wählen (`Skript` oder `Skriptkette`)
+- Cron-Ausdruck prüfen
 - `Jetzt ausführen`
-- Logs je Cronjob anzeigen
-- `Aktiviert` und `Pushover` toggeln
+- Job-Logs ansehen
+- Aktivierung/Pushover toggeln
 
-Hilfen:
+Empfehlung:
 
-- Beispiele für Cron-Ausdrücke direkt im Dialog
-- Link zu `crontab.guru` im Editor
+1. Skript/Kette manuell testen.
+2. Dann Cron aktivieren.
+3. Erste automatische Läufe aktiv im Runtime-Status kontrollieren.
 
----
+## Verbindung zur Einstellungsreferenz
 
-## Empfehlung für stabile Nutzung
-
-1. Erst `Konfiguration` sauber setzen
-2. dann Skripte/Ketten testen
-3. danach Cronjobs aktivieren
+Die vollständige Wirkung jeder einzelnen Einstellung steht in [Einstellungsreferenz](../configuration/settings-reference.md).