0.14.0-4 Docs
This commit is contained in:
+75
-52
@@ -1,85 +1,108 @@
|
||||
# Converter
|
||||
|
||||
Die Converter-Seite ermöglicht das Konvertieren vorhandener Audio- und Video-Dateien.
|
||||
Die Seite `Converter` verarbeitet bereits vorhandene Dateien (Video, Audio, ISO) ohne Laufwerks-Rip.
|
||||
|
||||
---
|
||||
## Betriebsmodell
|
||||
|
||||
## Überblick
|
||||
Der Converter arbeitet auf dem Eingangspfad `converter_raw_dir`:
|
||||
|
||||
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.
|
||||
- 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 Datei-Explorer zeigt den Inhalt des `converter_raw_dir` als Baumstruktur.
|
||||
Der Explorer zeigt den kompletten Baum unter `converter_raw_dir`.
|
||||
|
||||
### Verfügbare Aktionen
|
||||
Aktionen:
|
||||
|
||||
| Aktion | Beschreibung |
|
||||
| Aktion | Wirkung |
|
||||
|---|---|
|
||||
| **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 |
|
||||
| `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 |
|
||||
|
||||
### Dateiauswahl
|
||||
Upload-Regeln:
|
||||
|
||||
Dateien können per Checkbox ausgewählt werden. Aus der Auswahl lassen sich Jobs erstellen:
|
||||
- Dateiendung muss in `Erlaubte Datei-Endungen*` enthalten sein
|
||||
- bei Verstoß wird der Upload abgelehnt
|
||||
|
||||
- **Ein Job pro Datei** — jede Datei wird als eigenständiger Job angelegt
|
||||
- **Gemeinsamer Job (Audio)** — mehrere Audio-Dateien werden zu einem gemeinsamen Job zusammengefasst
|
||||
## Joberstellung aus Explorer-Auswahl
|
||||
|
||||
Erlaubte Dateiendungen werden in den Settings unter `Converter > Erlaubte Datei-Endungen*` als Checkboxen konfiguriert.
|
||||
Es gibt zwei Audio-Strategien:
|
||||
|
||||
---
|
||||
1. `Ein Job pro Datei`
|
||||
2. `Gemeinsamer Job (Audio)`
|
||||
|
||||
## Jobs erstellen und konfigurieren
|
||||
Verhalten:
|
||||
|
||||
Nach der Auswahl und Job-Erstellung erscheinen die Jobs in der Job-Liste.
|
||||
- Video/ISO werden grundsätzlich als Einzeljobs angelegt.
|
||||
- Audio kann als Shared-Job mit mehreren Eingabedateien erzeugt werden.
|
||||
|
||||
### Job-Konfiguration
|
||||
Shared-Audio-Job:
|
||||
|
||||
Jeder Job kann konfiguriert werden:
|
||||
- hält mehrere `inputPaths`
|
||||
- kann vor Start erweitert/reduziert werden (nur Audio-Dateien)
|
||||
|
||||
- **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-Konfiguration
|
||||
|
||||
### Job-Start
|
||||
Vor Start je Job einstellbar:
|
||||
|
||||
Jobs starten sofort oder reihen sich in die Queue ein (abhängig von `Parallele Jobs`).
|
||||
- `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)
|
||||
|
||||
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.
|
||||
Mit aktiviertem Polling:
|
||||
|
||||
Das Scan-Intervall wird unter `Converter > Polling-Intervall (Sekunden)` konfiguriert (Standard: 300 Sekunden).
|
||||
- `converter_raw_dir` wird zyklisch gescannt
|
||||
- neue Dateien erscheinen automatisch im Explorer
|
||||
|
||||
---
|
||||
Relevante Settings:
|
||||
|
||||
## Hinweis zu Audiobooks
|
||||
- `Auto-Scan (Polling)`
|
||||
- `Polling-Intervall (Sekunden)`
|
||||
|
||||
Der dedizierte AAX-/Audiobook-Flow ist auf der Seite [Audiobooks](audiobooks.md) dokumentiert.
|
||||
## Abgrenzung zu Audiobooks
|
||||
|
||||
---
|
||||
|
||||
## 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)` |
|
||||
- `Converter`: beliebige Audio/Video/ISO-Dateien
|
||||
- `Audiobooks`: dedizierter AAX-Workflow mit Kapitel-/Audiobook-Metadaten
|
||||
|
||||
Reference in New Issue
Block a user