1.0.0 docs

docs/getting-started/configuration.md

@@ -4,99 +4,148 @@ Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.
 
 ## Ziel der Ersteinrichtung
 
-Vor dem ersten Job müssen drei Dinge stabil sein:
+Vor dem ersten Job sollten fünf Bereiche sauber gesetzt sein:
 
-1. Pfade stimmen (RAW, Output, Logs)
-2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
-3. Metadatenzugänge funktionieren (OMDb, optional TMDb/MusicBrainz)
+1. Pfade und Templates
+2. Laufwerk und Disc-Erkennung
+3. Metadatenzugang über TMDb
+4. Encode-Standards und Queue-Regeln
+5. optionale Automatisierung und Benachrichtigungen
 
 ## Empfohlene Reihenfolge
 
-### 1) Basis in `Settings -> Konfiguration`
+### 1. Basis in `Settings -> Konfiguration`
 
-Setze zuerst:
+Prüfe zuerst diese Kernfelder:
 
-- `Raw-Ordner` und `Film-/Serien-Ordner`
+- RAW- und Zielordner für Blu-ray, DVD, CD, Audiobooks und Converter
 - `Log Ordner`
+- `TMDb Read Access Token`
 - `MakeMKV Kommando`, `HandBrake Kommando`, `Mediainfo Kommando`
-- `OMDb API Key`
+- `FFmpeg Kommando`, `FFprobe Kommando`, `cdparanoia Kommando`, `mkvmerge Kommando`, falls du die jeweiligen Workflows nutzt
 
-Dann speichern.
+Danach speichern.
 
-### 2) Profile pro Medium festziehen
+### 2. Pfade und Templates bewusst festlegen
 
-Ripster löst viele Werte profilspezifisch auf (`bluray`, `dvd`, `cd`, `audiobook`).
+Wichtig für den Alltag:
 
-Pflichtprüfung:
+- Film-Workflows nutzen `raw_dir_*`, `movie_dir_*` und `output_template_*`
+- Serien-Workflows nutzen zusätzlich `raw_dir_*_series`, `series_dir_*` und die Episode-/Multi-Episode-Templates
+- Audiobooks nutzen `raw_dir_audiobook`, `movie_dir_audiobook`, `audiobook_raw_template`, `output_template_audiobook`, `output_chapter_template_audiobook`
+- Converter nutzt `converter_raw_dir`, `converter_movie_dir`, `converter_audio_dir` und die beiden Converter-Templates
+- Downloads nutzen `download_dir`
 
-- RAW-Pfade je Profil
-- Output-Pfade je Profil
-- HandBrake-Preset je Profil
-- Output-Templates je Profil
+Wenn du auf NAS, USB oder andere Benutzer/Gruppen schreiben willst, prüfe auch die jeweiligen `*_owner`-Felder.
 
-Für Serien zusätzlich:
+### 3. Laufwerk und automatische Erkennung prüfen
 
-- `RAW-Ordner (Blu-ray/DVD Serie)`
-- `Serien-Ordner (Blu-ray/DVD)`
-- Serien-Templates (Episode/Multi-Episode)
+Relevant:
 
-### 3) Queue-Verhalten definieren
+- `Laufwerksmodus`
+- `Explizite Laufwerke`, falls du nicht mit Auto-Discovery arbeiten willst
+- `Automatische Disk-Erkennung`
+- `Polling Intervall (ms)` im Expertenmodus
+- `Laufwerk nach Rip auswerfen`
 
-Stelle ein:
+Empfehlung:
 
-- `Max. parallele Film/Video Encodes`
+- Einzelnes Standardlaufwerk: `auto`
+- mehrere stabile Laufwerke oder ungewöhnliche Device-Mappings: `Explizite Laufwerke`
+
+### 4. TMDb und Metadatenverhalten festlegen
+
+Relevant:
+
+- `TMDb Read Access Token`
+- `Film-Sprache`
+- `Fallback Sprache`
+- `Coverart-Nachladen aktiv`
+- `Coverart-Prüfintervall (Stunden)`
+- `NFO nach Encode erzeugen`
+
+Diese Einstellungen wirken direkt in Metadatensuche, Serienzuordnung, Nachpflege von Covern und im finalen Output.
+
+### 5. Encode- und Review-Standards festlegen
+
+Für Video-Workflows besonders wichtig:
+
+- `Minimale Titellänge (Minuten)`
+- `TMDb Runtime-Abzug für Playlistfilter (%)`
+- `HandBrake Preset` und `HandBrake Extra Args` je Medium
+- `Review Audio-Sprachen (...)`
+- `Review UT-Sprachen (...)`
+- `Ausgabeformat`
+
+Praxis:
+
+- `Minimale Titellänge` filtert Bonusmaterial früh weg
+- `TMDb Runtime-Abzug ...` lockert bei problematischen Blu-rays die Laufzeitprüfung der Playlist-Kandidaten
+- Review-Sprachen bestimmen, welche Audio-/Untertitelspuren in der Review schon vorausgewählt sind
+
+### 6. Queue-Verhalten definieren
+
+Stelle diese vier Felder bewusst ein:
+
+- `Parallele Jobs`
 - `Max. parallele Audio CD Jobs`
-- `Max. Encodes gesamt`
-- optional `Audio CDs: Queue-Reihenfolge überspringen`
+- `Max. Encodes gesamt (medienunabhängig)`
+- `Audio CDs: Queue-Reihenfolge überspringen`
 
-Damit steuerst du Durchsatz, Priorität und Lastverteilung.
+Damit steuerst du, wie aggressiv Ripster mehrere Jobs gleichzeitig startet.
 
-### 4) Metadatenquellen absichern
+### 7. Optional: User-Presets und Standard-Zuordnungen
 
-Film:
+Unter `Settings -> Encode-Presets` kannst du:
 
-- OMDb-Key prüfen
+- eigene HandBrake-User-Presets anlegen
+- Standard-Zuordnungen für `Blu-ray Film`, `Blu-ray Serie`, `DVD Film`, `DVD Serie` setzen
 
-Serien:
+Diese Defaults wirken später in der Review automatisch vorbefüllend.
 
-- TMDb Read Access Token setzen
-- Sprache/Fallback-Sprachen festlegen
+### 8. Optional: Benachrichtigungen
 
-CD/Audiodaten:
+Prüfe:
 
-- `MusicBrainz aktiviert` nach Bedarf
+- `PushOver aktiviert`
+- Token/User/optional Device
+- Event-Toggles wie `Bei manueller Auswahl senden`, `Bei Rip-Start senden`, `Bei Erfolg senden`
 
-### 5) Optional: Benachrichtigungen
+Danach in `Settings` den Button `PushOver Test` ausführen.
 
-- PushOver-Zugangsdaten setzen
-- `PushOver Test` ausführen
-- Event-Toggles pro Phase prüfen
+### 9. Optional: Automatisierung
 
-### 6) Optional: Automatisierung
+Erst wenn die Grundkonfiguration stabil ist:
 
-1. Skripte testen
-2. Skriptketten bauen/testen
-3. Cronjobs erst danach aktivieren
+1. Skripte anlegen und testen
+2. Skriptketten aufbauen
+3. Cronjobs aktivieren
 
-## Funktionsprüfung (Kurztest)
+## Funktionsprüfung
 
-1. Disc in `Ripper` erkennen lassen.
-2. `Analyse starten`.
-3. Metadaten übernehmen.
-4. Bis `Bereit zum Encodieren` laufen.
-5. Encode starten und Abschluss in `Historie` prüfen.
+Ein sinnvoller Kurztest:
+
+1. Disc in `Ripper` erkennen lassen
+2. `Analyse starten`
+3. TMDb-Metadaten übernehmen
+4. ggf. Playlist-/RAW-Entscheidung durchlaufen
+5. bis `Bereit zum Encodieren` kommen
+6. Encode starten
+7. Ergebnis in `Historie` prüfen
 
 ## Typische Konfigurationsfehler
 
 | Symptom | Häufige Ursache |
 |---|---|
-| Job bleibt früh auf Fehler | Toolkommando falsch oder nicht im PATH |
-| RAW/Output landet am falschen Ort | Profilpfade nicht gesetzt, Fallback greift |
-| Serienausgabe landet bei Filmen | Serienpfade/Serientemplates fehlen |
-| Queue verhält sich unerwartet | Gesamtlimit und Lane-Limits widersprechen sich |
+| Disc wird nicht erkannt | Laufwerksmodus oder Auto-Erkennung passt nicht |
+| Playlist-Auswahl wirkt unplausibel | `Minimale Titellänge` oder `TMDb Runtime-Abzug ...` ist zu streng/zu locker |
+| falsche Spuren sind in der Review vorausgewählt | Review-Sprachfilter oder HandBrake-Args greifen unerwartet |
+| Ausgabe landet am falschen Ort | Profilpfade oder Templates greifen über Fallback |
+| Queue verhält sich unerwartet | `Parallele Jobs`, CD-Limit und Gesamtlimit widersprechen sich |
 
 ## Weiter
 
 - [Erster Lauf](quickstart.md)
 - [GUI-Seiten](../gui/index.md)
 - [Workflows aus Nutzersicht](../workflows/index.md)
+- [Alle Einstellungen](../configuration/settings-reference.md)