0.16.1-1 release snapshot

docs/gui/settings.md

@@ -0,0 +1,107 @@
+# Settings
+
+Die Seite `Settings` steuert alle Betriebsparameter von Ripster: Pfade, Tools, Queue-Limits, Metadatenquellen, Automatisierung.
+
+## Tab-Überblick
+
+| Tab | Hauptzweck |
+|---|---|
+| `Konfiguration` | globale und profilspezifische Laufzeitsettings |
+| `Scripte` | einzelne Skripte verwalten und testen |
+| `Skriptketten` | mehrstufige Abläufe aus Skript/Warten |
+| `Encode-Presets` | wiederverwendbare HandBrake-Profile für Review |
+| `Cronjobs` | zeitgesteuerte Ausführung von Skript/Kette |
+
+## Tab `Konfiguration`
+
+### Bedienprinzip
+
+1. Werte ändern.
+2. `Änderungen speichern`.
+3. erst danach sind Werte für neue Aktionen wirksam.
+
+Zusätzliche Bedienhilfen:
+
+- `Neu laden` verwirft lokale Formzustände
+- `Änderungen verwerfen` setzt auf zuletzt gespeicherten Stand
+- `PushOver Test` validiert Benachrichtigungszugang sofort
+
+### Was wirkt unmittelbar, was erst bei neuem Job?
+
+- Queue-/Parallelität wirkt auf neue Queue-Entscheidungen und Pump-Läufe.
+- Tool-/Pfad-/Template-Änderungen wirken vollständig auf neu gestartete Schritte.
+- Bereits laufende Prozesse übernehmen Änderungen in der Regel nicht rückwirkend.
+
+### Welche Bereiche im Alltag kritisch sind
+
+| Bereich | Kritisch für |
+|---|---|
+| `Pfade` | wo RAW, finale Ausgaben, Converter/Audiobook-Dateien landen |
+| `Tools` | ob Analyze/Rip/Encode ausführbar sind |
+| `Metadaten` | Film-/Serienzuordnung und Episode-Mapping |
+| `Queue-Limits` | Durchsatz und Reihenfolgeverhalten |
+| `Monitoring` | Sichtbarkeit von Last und Speicherengpässen |
+| `Benachrichtigungen` | PushOver-Ereignisse je Pipelinephase |
+
+## Tab `Scripte`
+
+Funktionen:
+
+- anlegen, bearbeiten, löschen
+- testen (`Test`)
+- sortieren
+
+Testausführung liefert:
+
+- Exit-Code
+- Dauer
+- stdout/stderr
+
+Wichtig:
+
+- Nur erfolgreiche Skripte sollten in produktive Pre-/Post-Listen übernommen werden.
+
+## Tab `Skriptketten`
+
+Ketten bestehen aus Schritten:
+
+- `Skript`
+- `Warten`
+
+Typischer Einsatz:
+
+- externe Hooks vor/nach Encode
+- gestaffelte Abläufe mit Pausen
+
+In der Queue erscheinen Ketten als eigene Einträge und werden dort ausgeführt.
+
+## Tab `Encode-Presets`
+
+Ein Preset bündelt:
+
+- optionales HandBrake-Preset (`-Z`)
+- optionale Extra-Args
+- Medienziel (Universell/Blu-ray/DVD/Sonstiges)
+
+Im Ripper-Review kannst du Presets pro Job auswählen, statt Parameter jedes Mal neu zu setzen.
+
+## Tab `Cronjobs`
+
+Funktionen:
+
+- Cronjob anlegen und bearbeiten
+- Quelle wählen (`Skript` oder `Skriptkette`)
+- Cron-Ausdruck prüfen
+- `Jetzt ausführen`
+- Job-Logs ansehen
+- Aktivierung/Pushover toggeln
+
+Empfehlung:
+
+1. Skript/Kette manuell testen.
+2. Dann Cron aktivieren.
+3. Erste automatische Läufe aktiv im Runtime-Status kontrollieren.
+
+## Verbindung zur Einstellungsreferenz
+
+Die vollständige Wirkung jeder einzelnen Einstellung steht in [Einstellungsreferenz](../configuration/settings-reference.md).