Files
ripster/docs/gui/converter.md
T
michael 43702b0138
Deploy Docs to GitHub Pages / Build Documentation (push) Has been cancelled
Deploy Docs to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled
0.12.0-19 Final Build
2026-04-07 19:12:40 +00:00

3.2 KiB

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)