0.14.0-4 Docs

2026-04-21 14:52:30 +00:00
parent c27a81cdb1
commit ccd6c3ab2a
29 changed files with 999 additions and 691 deletions
@@ -1,71 +1,102 @@
 # Ersteinrichtung

-Nach der Installation erfolgt die tägliche Konfiguration fast vollständig in der GUI unter `Settings`.
+Diese Seite ist die Betriebs-Checkliste vor dem ersten produktiven Lauf.

-## Ziel
+## Ziel der Ersteinrichtung

-Vor dem ersten echten Job müssen Pfade, Tools und Metadatenzugriff sauber gesetzt sein.
+Vor dem ersten Job müssen drei Dinge stabil sein:

-## Reihenfolge (empfohlen)
+1. Pfade stimmen (RAW, Output, Logs)
+2. Tools sind aufrufbar (MakeMKV, HandBrake, MediaInfo)
+3. Metadatenzugänge funktionieren (OMDb, optional TMDb/MusicBrainz)

-### 1. `Settings` -> Tab `Konfiguration`
+## Empfohlene Reihenfolge

-Setze zuerst diese Pflichtwerte:
+### 1) Basis in `Settings -> Konfiguration`

-| Bereich | Wichtige Felder |
+Setze zuerst:
+
+- `Raw-Ordner` und `Film-/Serien-Ordner`
+- `Log Ordner`
+- `MakeMKV Kommando`, `HandBrake Kommando`, `Mediainfo Kommando`
+- `OMDb API Key`
+
+Dann speichern.
+
+### 2) Profile pro Medium festziehen
+
+Ripster löst viele Werte profilspezifisch auf (`bluray`, `dvd`, `cd`, `audiobook`).
+
+Pflichtprüfung:
+
+- RAW-Pfade je Profil
+- Output-Pfade je Profil
+- HandBrake-Preset je Profil
+- Output-Templates je Profil
+
+Für Serien zusätzlich:
+
+- `RAW-Ordner (Blu-ray/DVD Serie)`
+- `Serien-Ordner (Blu-ray/DVD)`
+- Serien-Templates (Episode/Multi-Episode)
+
+### 3) Queue-Verhalten definieren
+
+Stelle ein:
+
+- `Max. parallele Film/Video Encodes`
+- `Max. parallele Audio CD Jobs`
+- `Max. Encodes gesamt`
+- optional `Audio CDs: Queue-Reihenfolge überspringen`
+
+Damit steuerst du Durchsatz, Priorität und Lastverteilung.
+
+### 4) Metadatenquellen absichern
+
+Film:
+
+- OMDb-Key prüfen
+
+Serien:
+
+- TMDb Read Access Token setzen
+- Sprache/Fallback-Sprachen festlegen
+
+CD/Audiodaten:
+
+- `MusicBrainz aktiviert` nach Bedarf
+
+### 5) Optional: Benachrichtigungen
+
+- PushOver-Zugangsdaten setzen
+- `PushOver Test` ausführen
+- Event-Toggles pro Phase prüfen
+
+### 6) Optional: Automatisierung
+
+1. Skripte testen
+2. Skriptketten bauen/testen
+3. Cronjobs erst danach aktivieren
+
+## Funktionsprüfung (Kurztest)
+
+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.
+
+## Typische Konfigurationsfehler
+
+| Symptom | Häufige Ursache |
 |---|---|
-| Pfade | `Raw Ausgabeordner`, `Film Ausgabeordner`, `Log Ordner` |
-| Tools | `MakeMKV Kommando`, `HandBrake Kommando`, `Mediainfo Kommando` |
-| Metadaten | `OMDb API Key`, optional `OMDb Typ` |
-
-Danach `Änderungen speichern`.
-
-### 2. Medienprofile prüfen
-
-Wenn du Blu-ray und DVD unterschiedlich behandeln willst, pflege die profilbezogenen Felder:
-
- `*_bluray`
- `*_dvd`
- optional `*_other`
-
-Typische Beispiele:
-
- `HandBrake Preset` (Blu-ray und DVD)
- `Raw Ausgabeordner` (Blu-ray und DVD)
- `Dateiname Template` (Blu-ray und DVD)
-
-### 3. Queue und Monitoring festlegen
-
- `Parallele Jobs` für den gleichzeitigen Durchsatz
- `Hardware Monitoring aktiviert` + `Hardware Monitoring Intervall (ms)` für Live-Metriken im Ripper
-
-### 4. Optional: Push-Benachrichtigungen
-
-In den Benachrichtigungsfeldern setzen:
-
- `PushOver aktiviert`
- `PushOver Token`
- `PushOver User`
-
-Dann über `PushOver Test` direkt prüfen.
-
-## 2-Minuten-Funktionstest
-
-1. `Ripper` öffnen
-2. Disc einlegen
-3. `Analyse starten`
-4. Metadaten übernehmen
-5. Bis `Bereit zum Encodieren` laufen lassen
-
-Wenn diese Schritte funktionieren, ist die Grundkonfiguration korrekt.
-
-## Wenn Werte nicht gespeichert werden
-
- Feld mit Fehler markieren lassen (rote Validierung im Formular)
- Pfadangaben und numerische Werte prüfen
- bei Tool-Pfaden direkt CLI-Aufruf im Terminal testen
+| 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 |

 ## Weiter

 - [Erster Lauf](quickstart.md)
- [GUI-Seiten im Detail](../gui/index.md)
+- [GUI-Seiten](../gui/index.md)
+- [Workflows aus Nutzersicht](../workflows/index.md)