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