1.0.0 docs

docs/gui/converter.md

@@ -1,19 +1,22 @@
 # Converter
 
-Die Seite `Converter` verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
+Die Seite `Converter` verarbeitet vorhandene Dateien ohne Laufwerks-Rip. Sie ist für Video-, Audio- und ISO-Dateien gedacht, die bereits auf dem System liegen oder hochgeladen werden.
 
 ## Betriebsmodell
 
-Der Converter arbeitet auf dem Eingangspfad `converter_raw_dir`:
+Der Converter arbeitet auf dem Eingangspfad `converter_raw_dir`.
 
-- Uploads landen dort
-- Explorer-Aktionen arbeiten dort
-- daraus werden Converter-Jobs erstellt
+Dort landen:
+
+- Uploads
+- neu angelegte Ordner
+- umbenannte oder verschobene Dateien
+- alle Dateien, aus denen später Converter-Jobs entstehen
 
 Wichtig:
 
-- Upload erzeugt nicht automatisch einen Job.
-- Joberstellung erfolgt explizit über Auswahl im Explorer.
+- Upload erzeugt nicht automatisch einen Job
+- die Joberstellung erfolgt bewusst aus der Explorer-Auswahl
 
 ## Datei-Explorer
 
@@ -23,17 +26,24 @@ Aktionen:
 
 | Aktion | Wirkung |
 |---|---|
-| `Upload` | Dateien werden in den Raw-Baum geschrieben |
-| `Ordner erstellen` | legt Unterordner im Raw-Baum an |
-| `Umbenennen` | benennt Datei/Ordner im Raw-Baum um |
-| `Verschieben` | verschiebt innerhalb des Raw-Baums |
-| `Löschen` | entfernt Datei/Ordner dauerhaft |
-| `Scannen` | synchronisiert Explorer und DB-Zuordnungen |
+| `Upload` | schreibt neue Dateien in den Converter-RAW-Baum |
+| `Ordner erstellen` | legt Unterordner an |
+| `Umbenennen` | benennt Datei oder Ordner um |
+| `Verschieben` | verschiebt Einträge innerhalb des Raw-Baums |
+| `Löschen` | entfernt Datei oder Ordner dauerhaft |
+| `Scannen` | synchronisiert Dateisystem und Converter-Datenbank |
 
-Upload-Regeln:
+### Upload- und Scan-Regeln
 
-- Dateiendung muss in `Erlaubte Datei-Endungen*` enthalten sein
-- bei Verstoß wird der Upload abgelehnt
+- Dateiendungen müssen in `Erlaubte Datei-Endungen` enthalten sein
+- neue Dateien erscheinen sofort nach manuellem Scan
+- mit Polling auch automatisch
+
+Relevante Settings:
+
+- `Erlaubte Datei-Endungen`
+- `Auto-Scan (Polling)`
+- `Polling-Intervall (Sekunden)`
 
 ## Joberstellung aus Explorer-Auswahl
 
@@ -44,65 +54,75 @@ Es gibt zwei Audio-Strategien:
 
 Verhalten:
 
-- Video/ISO werden grundsätzlich als Einzeljobs angelegt.
-- Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
+- Video und ISO werden immer als Einzeljobs angelegt
+- Audio kann als gemeinsamer Album-/Ordner-Job erzeugt werden
 
 Shared-Audio-Job:
 
 - hält mehrere `inputPaths`
-- kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
+- kann vor dem Start erweitert oder reduziert werden
 
 ## Job-Konfiguration
 
-Vor Start je Job einstellbar:
+Vor dem Start je Job einstellbar:
 
-- `converterMediaType` (`video`, `audio`, `iso`)
+- `converterMediaType`
 - `outputFormat`
 - Metadaten
-- Track-/Titelwahl (bei video/iso)
+- Track-/Titelwahl bei Video/ISO
+- User-Preset und HandBrake-Preset bei Video
 - Pre-/Post-Encode-Skripte und Ketten
 
 Spezifika:
 
-- Video/ISO laufen durch Mediainfo/Review ähnlich zum Disc-Flow.
-- Audio kann direkt mit Formatoptionen konfiguriert werden.
+- Video/ISO durchlaufen eine Review ähnlich zum Disc-Flow
+- Audio wird direkt über Format und Audio-Optionen konfiguriert
 
 ## Ausgabe-Pfade
 
-### Video/ISO
+### Video / ISO
 
-- Root: `converter_movie_dir`
+- Zielordner: `converter_movie_dir`
 - Dateiname: `Output-Template (Video)`
-- Endung: aus gewähltem Output-Format
+- Endung: aus dem gewählten Ausgabeformat
 
 ### Audio
 
-- Root: `converter_audio_dir`
+- Zielordner: `converter_audio_dir`
 - Dateiname/Ordner: `Output-Template (Audio)`
-- bei Shared-/Folder-Job: Ausgabe als Ordnerstruktur mit Trackdateien
-
-## Queue und Start
-
-Converter-Jobs laufen über dieselbe Pipeline-/Queue-Logik:
-
-- sofortiger Start wenn Limits frei
-- sonst Queue-Eintrag
-
-Parallelität richtet sich nach den globalen Encode-Limits in `Settings`.
-
-## Auto-Scan (Polling)
-
-Mit aktiviertem Polling:
-
-- `converter_raw_dir` wird zyklisch gescannt
-- neue Dateien erscheinen automatisch im Explorer
+- bei Shared- oder Folder-Jobs entsteht eine Ordnerstruktur mit mehreren Track-Dateien
 
 Relevante Settings:
 
-- `Auto-Scan (Polling)`
-- `Polling-Intervall (Sekunden)`
+- `converter_movie_dir`
+- `converter_audio_dir`
+- `converter_output_template_video`
+- `converter_output_template_audio`
+- `converter_movie_dir_owner`
+- `converter_audio_dir_owner`
+
+## Queue und Start
+
+Converter-Jobs laufen über dieselbe globale Pipeline-Queue wie Ripper und Audiobooks.
+
+Das bedeutet:
+
+- sofortiger Start, wenn Limits frei sind
+- sonst Einreihung in die Warteschlange
+
+Relevante Settings:
+
+- `Parallele Jobs`
+- `Max. Encodes gesamt (medienunabhängig)`
+
+## Typische Einsatzfälle
+
+- vorhandene MKV/MP4-Dateien mit neuem Preset encodieren
+- ISO-Dateien in einen Video-Workflow überführen
+- Musikdateien gesammelt in einen Audio-Ordner-Job packen
+- Medien auf anderem Storage per Upload oder Dateibaum vorbereiten
 
 ## Abgrenzung zu Audiobooks
 
-- `Converter`: beliebige Audio/Video/ISO-Dateien
-- `Audiobooks`: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
+- `Converter`: beliebige Audio-, Video- und ISO-Dateien
+- `Audiobooks`: spezialisierter AAX-Workflow mit Activation Bytes, Kapitelmetadaten und Kapiteltemplates