1.0.0 docs

docs/getting-started/quickstart.md

@@ -1,19 +1,25 @@
 # Erster Lauf
 
-Dieser Ablauf führt einen vollständigen Disc-Job von Erkennung bis fertiger Datei durch.
+Dieser Ablauf führt einen typischen Disc-Job von Erkennung bis fertiger Datei durch.
 
-## 1) Disc erkennen
+## 1. Disc erkennen
 
-1. `Ripper` öffnen.
-2. Disc einlegen.
-3. Auf `Medium erkannt` warten.
+1. `Ripper` öffnen
+2. Disc einlegen
+3. auf `Medium erkannt` warten
 
 Prüfen:
 
-- `Disk-Information` zeigt Device/Label.
-- Falls nicht: `Laufwerk neu lesen`.
+- `Disk-Information` zeigt Device, Label und Laufwerksstatus
+- falls nicht: `Laufwerk neu lesen`
 
-## 2) Analyse starten
+Relevante Settings:
+
+- `Laufwerksmodus`
+- `Automatische Disk-Erkennung`
+- `Polling Intervall (ms)`
+
+## 2. Analyse starten
 
 Aktion:
 
@@ -22,69 +28,124 @@ Aktion:
 Erwartung:
 
 - Status `Analyse`
-- danach Metadaten-Dialog
+- danach der Metadaten-Dialog
 
-## 3) Metadaten bestätigen
+Relevantes Setting:
+
+- `Minimale Titellänge (Minuten)` beeinflusst bereits, welche Titel/Playlists Ripster später als relevant betrachtet
+
+## 3. Metadaten in TMDb bestätigen
 
 Im Dialog:
 
-1. Treffer suchen/auswählen.
-2. Bei Serie zusätzlich Disc-Nummer setzen.
-3. `Auswahl übernehmen`.
+1. Treffer suchen oder filtern
+2. Film oder Serie auswählen
+3. bei Serien zusätzlich `Disc-Nummer` setzen
+4. `Auswahl übernehmen`
 
 Mögliche Abzweigungen:
 
-- Duplikatfilm -> `Übernahme erzwingen` oder `Multipart movie`
-- vorhandenes RAW -> Entscheidungsdialog (weiterverwenden oder neu rippen)
+- Duplikatfilm: `Übernahme erzwingen` oder `Multipart movie`
+- vorhandenes RAW: Entscheidungsdialog `weiterverwenden` oder `neu rippen`
 
-## 4) Rip/Review-Phase
+Relevante Settings:
 
-Normalfall:
+- `TMDb Read Access Token`
+- `Film-Sprache`
+- `Fallback Sprache`
 
-- `Startbereit` -> `Rippen` -> `Mediainfo-Pruefung`
+## 4. RAW- und Playlist-Entscheidungen
 
-Mögliche Alternativen:
+Je nach Disc-Situation geht es jetzt unterschiedlich weiter.
 
-- vorhandenes RAW: direkter Sprung in Prüfung
-- Blu-ray/DVD-Entscheidung nötig: `Warte auf Auswahl` für Playlist/Titel
+### Normalfall
 
-## 5) Encode-Review abschließen
+`Startbereit` -> `Rippen` -> `Mediainfo-Prüfung`
 
-Bei `Bereit zum Encodieren`:
+### Vorhandenes RAW
 
-- Titel festlegen
-- Audio-/Subtitle-Spuren prüfen
-- optional Preset auswählen
-- optional Pre-/Post-Skripte wählen
+Kein neuer Rip, sondern erst eine Entscheidung:
+
+- vorhandenes RAW weiterverwenden
+- RAW löschen und Rip neu starten
+- bei passenden Film-Konstellationen optional Multipart mit Orphan-RAW
+
+### Playlist- oder Titelauswahl erforderlich
+
+Bei bestimmten Blu-ray-/DVD-Fällen erscheint `Warte auf Auswahl`.
+
+Dann bestätigst du:
+
+- eine Playlist
+- oder einen/mehrere HandBrake-Titel
+
+Relevante Settings:
+
+- `Minimale Titellänge (Minuten)`
+- `TMDb Runtime-Abzug für Playlistfilter (%)`
+
+## 5. Encode-Review abschließen
+
+Bei `Bereit zum Encodieren` prüfst du:
+
+- Titelwahl
+- Audio-Spuren
+- Untertitel
+- User-Preset oder HandBrake-Preset
+- Pre-/Post-Encode-Skripte und Ketten
 
 Dann:
 
 - `Encoding starten`
 
-## 6) Encoding überwachen
+Relevante Settings:
+
+- `HandBrake Preset` und `HandBrake Extra Args` je Medium
+- `Review Audio-Sprachen (...)`
+- `Review UT-Sprachen (...)`
+- `Ausgabeformat`
+- Standard-Zuordnungen unter `Settings -> Encode-Presets`
+
+## 6. Encoding überwachen
 
 Während `Encodieren`:
 
 - Fortschritt/ETA im Ripper
-- Queue- und Runtime-Status beobachten
-- optional Logkontrolle in Historie
+- Queue-Status beobachten
+- bei Bedarf `Hardware`-Ansicht öffnen
 
-## 7) Ergebnis verifizieren
+Relevante Settings:
+
+- `Parallele Jobs`
+- `Max. parallele Audio CD Jobs`
+- `Max. Encodes gesamt (medienunabhängig)`
+- `Hardware Monitoring aktiviert`
+- `Hardware Monitoring Intervall (ms)`
+
+## 7. Ergebnis verifizieren
 
 Nach `Fertig`:
 
-1. `Historie` öffnen.
-2. Jobdetail prüfen.
-3. Output-Pfad und Log plausibilisieren.
+1. `Historie` öffnen
+2. Jobdetail prüfen
+3. Output-Pfad und Log kontrollieren
 
 Kontrollpunkte:
 
-- finale Datei am erwarteten Template-Pfad
-- RAW-Ordnerzustand finalisiert (kein `Incomplete_`)
+- finale Datei liegt am erwarteten Template-Pfad
+- RAW-Ordner ist finalisiert
+- optional `.nfo` wurde erzeugt, falls aktiviert
 
-## 8) Typische Folgeaktionen
+Relevante Settings:
 
-- falsche Metadaten: `OMDb neu zuordnen`
+- `output_template_*`
+- `series_dir_*` und Serien-Templates
+- `generate_nfo_after_encode`
+
+## 8. Typische Folgeaktionen
+
+- falsche TMDb-Zuordnung: `TMDb neu zuweisen`
 - andere Trackauswahl: `Review neu starten`
 - erneuter Encode aus RAW: `RAW neu encodieren`
 - gleicher Plan erneut: `Encode neu starten`
+- Rip erneut versuchen: `Retry Rippen`