ripster/docs/gui/converter.md

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