Files
ripster/docs/gui/converter.md
T
michael 5e24c6b9cc
Deploy Docs to GitHub Pages / Build Documentation (push) Has been cancelled
Deploy Docs to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled
1.0.0 docs
2026-06-12 10:38:45 +02:00

129 lines
3.2 KiB
Markdown

# Converter
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`.
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
- die Joberstellung erfolgt bewusst aus der Explorer-Auswahl
## Datei-Explorer
Der Explorer zeigt den kompletten Baum unter `converter_raw_dir`.
Aktionen:
| Aktion | Wirkung |
|---|---|
| `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- und Scan-Regeln
- 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
Es gibt zwei Audio-Strategien:
1. `Ein Job pro Datei`
2. `Gemeinsamer Job (Audio)`
Verhalten:
- 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 dem Start erweitert oder reduziert werden
## Job-Konfiguration
Vor dem Start je Job einstellbar:
- `converterMediaType`
- `outputFormat`
- Metadaten
- Track-/Titelwahl bei Video/ISO
- User-Preset und HandBrake-Preset bei Video
- Pre-/Post-Encode-Skripte und Ketten
Spezifika:
- Video/ISO durchlaufen eine Review ähnlich zum Disc-Flow
- Audio wird direkt über Format und Audio-Optionen konfiguriert
## Ausgabe-Pfade
### Video / ISO
- Zielordner: `converter_movie_dir`
- Dateiname: `Output-Template (Video)`
- Endung: aus dem gewählten Ausgabeformat
### Audio
- Zielordner: `converter_audio_dir`
- Dateiname/Ordner: `Output-Template (Audio)`
- bei Shared- oder Folder-Jobs entsteht eine Ordnerstruktur mit mehreren Track-Dateien
Relevante Settings:
- `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- und ISO-Dateien
- `Audiobooks`: spezialisierter AAX-Workflow mit Activation Bytes, Kapitelmetadaten und Kapiteltemplates