# 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)` |
