0.16.1-1 release snapshot

2026-04-29 08:35:24 +00:00
parent 6115090da1
commit 901a3b1ad7
269 changed files with 127336 additions and 1 deletions
@@ -0,0 +1,108 @@
+# 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