# Converter

Die Seite `Converter` verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.

## Betriebsmodell

Der Converter arbeitet auf dem Eingangspfad `converter_raw_dir`:

- Uploads landen dort
- Explorer-Aktionen arbeiten dort
- daraus werden Converter-Jobs erstellt

Wichtig:

- Upload erzeugt nicht automatisch einen Job.
- Joberstellung erfolgt explizit über Auswahl im Explorer.

## Datei-Explorer

Der Explorer zeigt den kompletten Baum unter `converter_raw_dir`.

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-Regeln:

- Dateiendung muss in `Erlaubte Datei-Endungen*` enthalten sein
- bei Verstoß wird der Upload abgelehnt

## Joberstellung aus Explorer-Auswahl

Es gibt zwei Audio-Strategien:

1. `Ein Job pro Datei`
2. `Gemeinsamer Job (Audio)`

Verhalten:

- Video/ISO werden grundsätzlich als Einzeljobs angelegt.
- Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.

Shared-Audio-Job:

- hält mehrere `inputPaths`
- kann vor Start erweitert/reduziert werden (nur Audio-Dateien)

## Job-Konfiguration

Vor Start je Job einstellbar:

- `converterMediaType` (`video`, `audio`, `iso`)
- `outputFormat`
- Metadaten
- Track-/Titelwahl (bei video/iso)
- Pre-/Post-Encode-Skripte und Ketten

Spezifika:

- Video/ISO laufen durch Mediainfo/Review ähnlich zum Disc-Flow.
- Audio kann direkt mit Formatoptionen konfiguriert werden.

## Ausgabe-Pfade

### Video/ISO

- Root: `converter_movie_dir`
- Dateiname: `Output-Template (Video)`
- Endung: aus gewähltem Output-Format

### Audio

- Root: `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

Relevante Settings:

- `Auto-Scan (Polling)`
- `Polling-Intervall (Sekunden)`

## Abgrenzung zu Audiobooks

- `Converter`: beliebige Audio/Video/ISO-Dateien
- `Audiobooks`: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten