Files
ripster/docs/gui/settings.md
T
michael 9b38d78042
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-rc1 Docs
2026-05-08 09:01:17 +02:00

168 lines
5.1 KiB
Markdown

# Settings
Die Seite `Settings` ist das zentrale Kontrollpanel für Laufzeitverhalten, Automatisierung und Expertenfunktionen.
## Tab-Überblick
| Tab | Zweck |
|---|---|
| `Konfiguration` | Alle fachlichen Settings (Pfade, Tools, Laufwerk, Metadaten, Monitoring, Benachrichtigungen, Converter) |
| `Scripte` | Einzelne Bash-Skripte pflegen, testen und sortieren |
| `Skriptketten` | Mehrstufige Sequenzen aus `Skript` und `Warten` bauen und testen |
| `Encode-Presets` | Benutzer-Presets und Standard-Zuordnungen für Blu-ray/DVD-Workflows |
| `Cronjobs` | Zeitgesteuerte Jobs auf Basis Skript/Skriptkette |
## Tab `Konfiguration`
### Bedienlogik
1. Felder ändern.
2. `Änderungen speichern` klicken.
3. Erst dann werden Änderungen persistiert und für neue Pipeline-Schritte wirksam.
Aktionen in der Toolbar:
- `Änderungen speichern`: schreibt nur geänderte Felder als Bulk-Update.
- `Änderungen verwerfen`: setzt den Formularzustand auf zuletzt geladen/zum Server gespeicherten Stand zurück.
- `Neu laden`: lädt Kategorien + Werte erneut vom Backend.
- `PushOver Test`: sendet eine Testnachricht mit aktuellen PushOver-Werten.
- `Coverarts prüfen`: startet die manuelle Coverart-Recovery.
- `Expertenmodus`: wird sofort gespeichert (nicht Teil des normalen Bulk-Speicherns).
### Wichtige UI-Verhalten
- Jede Einstellung zeigt `Gespeichert` oder `Ungespeichert` direkt am Feld.
- Pflichtfelder sind mit `*` markiert.
- Bei Validierungsfehlern wird pro Feld ein Fehlertext angezeigt und Speichern blockiert.
- Tool-Kommandos (`makemkv_command`, `mediainfo_command`, `handbrake_command`, `ffmpeg_command`, `ffprobe_command`, `cdparanoia_command`, `mkvmerge_command`) sind im Formular schreibgeschützt markiert.
- Einige Felder sind abhängig vom Expertenmodus sichtbar.
### Kategorie `Pfade`: Besondere Interaktion
Die Pfad-Kategorie hat eine eigene Darstellung:
- Tabelle `Effektive Pfade`: zeigt die aktuell tatsächlich aufgelösten Laufzeitpfade inkl. Fallbacks.
- Accordion je Bereich (`Blu-ray`, `DVD`, `CD / Audio`, `Audiobook`, `Converter`, `Downloads`, optional `Externe Speicher`, `Logs`).
- Für Pfadfelder mit Owner-Pendant (`*_owner`) erscheint direkt darunter das Feld `Eigentümer (user:gruppe)`.
- Owner-Felder sind deaktiviert, solange der zugehörige Pfad leer ist.
### Spezial-Editoren in der Konfiguration
- `drive_devices`: JSON-Array wird über UI-Editor gepflegt (Pfad + MakeMKV-Index je Laufwerk).
- `external_storage_paths`: Liste aus `Name` + `Pfad` (für Anzeige freier externer Speicher).
- `converter_scan_extensions`: Checkbox-Raster der erlaubten Endungen; mindestens eine Endung muss aktiv bleiben.
- `makemkv_registration_key`: zusätzlicher Betakey-Hinweis mit `übernehmen`-Button.
### Laufwerks-Infobox innerhalb `Laufwerk`
In der Kategorie `Laufwerk` wird eine Live-Tabelle erkannter optischer Laufwerke angezeigt:
- `Neu einlesen` lädt Laufwerksinfos neu.
- Im Expertenmodus: `Freigeben` pro Laufwerk und `Alle Laufwerke freigeben`.
## Tab `Scripte`
Funktionen:
- Skript anlegen (Inline-Editor)
- Skript bearbeiten (Dialog)
- Skript löschen (mit Bestätigung)
- Skript testen
- Reihenfolge per Drag-and-Drop ändern
Testergebnis enthält:
- Erfolg/Fehler
- Exit-Code
- Timeout-Info
- Dauer
- stdout/stderr
## Tab `Skriptketten`
Skriptketten bestehen aus Schritten:
- `Skript`
- `Warten (Sekunden)`
Funktionen:
- Ketten anlegen/bearbeiten/löschen
- Reihenfolge der Ketten per Drag-and-Drop
- Kette testen
- Schritte in der Kette per Drag-and-Drop neu anordnen
Im Ketteneditor:
- linke Palette (`Systemblöcke`, `Scripte`)
- rechte Canvas mit Drop-Zonen
- pro Warte-Schritt konfigurierbare Sekunden
## Tab `Encode-Presets`
Bereiche:
1. `Standard-Zuordnungen` (Slots)
2. `Preset-Liste` (CRUD)
### Standard-Zuordnungen
Es gibt vier persistente Slots:
- `bluray_movie`
- `bluray_series`
- `dvd_movie`
- `dvd_series`
Die Auswahl ist medientyp-kompatibel gefiltert. Nicht kompatible oder fehlende bereits gespeicherte IDs werden weiterhin sichtbar gemacht, damit bestehende Zuordnungen nachvollziehbar bleiben.
### Preset-Inhalt
Ein Preset umfasst:
- Name
- Medientyp (`all`, `bluray`, `dvd`)
- HandBrake-Preset (`-Z`)
- Extra Args
- optionale Beschreibung
## Tab `Cronjobs`
Funktionen:
- Cronjob erstellen/bearbeiten/löschen
- Debounced Validierung des Cron-Ausdrucks
- Quelle wählen: `Skript` oder `Skriptkette`
- Aktiv- und PushOver-Toggle je Job
- `Jetzt ausführen`
- Lauf-Logs öffnen
Die Seite zeigt zusätzlich Live-Status laufender Cron-Aktivitäten (Runtime Activities).
## Expertenbereich: Activation Bytes Cache
Der Activation-Bytes-Block wird nur im Expertenmodus angezeigt und nur wenn Einträge vorhanden sind.
Er zeigt:
- AAX-Checksum
- Activation Bytes
- Speicherzeitpunkt
## Validierungshinweise für Template-Felder
Template-Felder akzeptieren nur:
- Buchstaben/Ziffern
- Leerzeichen
- `_` und `-`
- Platzhalter in `{...}` bzw. `${...}`
- `/` für Ordnertrennung
Nicht erlaubt sind z. B. unvollständige geschweifte Klammern oder sonstige Sonderzeichen.
## Siehe auch
- [Einstellungsreferenz](../configuration/settings-reference.md)
- [Ripper](ripper.md)