0.13.1-4 release snapshot

docs/gui/converter.md

@@ -0,0 +1,91 @@
+# Converter
+
+Die Converter-Seite ermöglicht das Konvertieren vorhandener Audio- und Video-Dateien sowie das Verarbeiten von Audiobooks (AAX/M4B).
+
+---
+
+## Überblick
+
+Der Converter arbeitet mit einem konfigurierbaren Eingangsordner (`converter_raw_dir`). Dateien werden dort abgelegt (manuell oder per Upload) und dann als Converter-Jobs in die Pipeline eingereiht.
+
+---
+
+## Datei-Explorer
+
+Der Datei-Explorer zeigt den Inhalt des `converter_raw_dir` als Baumstruktur.
+
+### Verfügbare Aktionen
+
+| Aktion | Beschreibung |
+|---|---|
+| **Upload** | Dateien direkt aus dem Browser hochladen (bis zu 50 Dateien) |
+| **Ordner erstellen** | Neuen Unterordner anlegen |
+| **Umbenennen** | Datei oder Ordner umbenennen |
+| **Verschieben** | Datei oder Ordner in einen anderen Unterordner verschieben |
+| **Löschen** | Datei oder Ordner löschen (unwiderruflich) |
+| **Scannen** | Eingangsordner manuell neu scannen |
+
+### Dateiauswahl
+
+Dateien können per Checkbox ausgewählt werden. Aus der Auswahl lassen sich Jobs erstellen:
+
+- **Ein Job pro Datei** — jede Datei wird als eigenständiger Job angelegt
+- **Gemeinsamer Job (Audio)** — mehrere Audio-Dateien werden zu einem gemeinsamen Job zusammengefasst
+
+Erlaubte Dateiendungen werden in den Settings unter `Converter > Erlaubte Datei-Endungen*` als Checkboxen konfiguriert.
+
+---
+
+## Jobs erstellen und konfigurieren
+
+Nach der Auswahl und Job-Erstellung erscheinen die Jobs in der Job-Liste.
+
+### Job-Konfiguration
+
+Jeder Job kann konfiguriert werden:
+
+- **Medientyp:** Video, Audio oder Audiobook
+- **Ausgabeformat:** z. B. `mkv`, `mp4`, `m4b`, `mp3`, `flac`
+- **HandBrake-Preset:** für Video-Konvertierung
+- **Track-Auswahl:** Video-, Audio- und Untertitel-Spuren
+- **Metadaten:** Titel, Autor, Jahr (für Audiobooks)
+- **MusicBrainz-Suche:** automatische Metadaten-Suche für Audiodateien
+
+### Job-Start
+
+Jobs starten sofort oder reihen sich in die Queue ein (abhängig von `Parallele Jobs`).
+
+---
+
+## Auto-Scan (Polling)
+
+Wenn in den Settings `Converter > Auto-Scan (Polling)` aktiviert ist, wird der Eingangsordner automatisch in regelmäßigen Abständen gescannt. Neue Dateien werden in der DB erfasst und im Explorer angezeigt.
+
+Das Scan-Intervall wird unter `Converter > Polling-Intervall (Sekunden)` konfiguriert (Standard: 300 Sekunden).
+
+---
+
+## Audiobook-Verarbeitung
+
+Für AAX-Dateien (Audible) ist folgendes erforderlich:
+
+1. AAX-Datei in den Eingangsordner hochladen
+2. Job mit Medientyp `Audiobook` erstellen
+3. Activation Bytes müssen verfügbar sein (werden beim ersten Mal abgefragt und gecacht)
+4. Ausgabeformat wählen: M4B (empfohlen), MP3 oder FLAC
+5. Kapitel-Splitting konfigurieren (optional)
+
+---
+
+## Einstellungen
+
+| Setting | Pfad in GUI |
+|---|---|
+| Eingangsordner | `Settings > Pfade > Converter Raw-Ordner` |
+| Videoausgabe | `Settings > Pfade > Converter Ausgabe (Video)` |
+| Audioausgabe | `Settings > Pfade > Converter Ausgabe (Audio)` |
+| Erlaubte Endungen | `Settings > Converter > Erlaubte Datei-Endungen*` |
+| Auto-Scan | `Settings > Converter > Auto-Scan (Polling)` |
+| Scan-Intervall | `Settings > Converter > Polling-Intervall (Sekunden)` |
+| Output-Template Video | `Settings > Pfade > Output-Template (Video)` |
+| Output-Template Audio | `Settings > Pfade > Output-Template (Audio)` |