0.12.0-17 Misc fixes

2026-03-30 19:15:23 +00:00
parent 5284dd2a43
commit c67ac593de
29 changed files with 1596 additions and 117 deletions
@@ -0,0 +1,290 @@
+# Converter API
+
+Endpunkte für den Datei-Converter: Datei-Explorer, Upload, Job-Verwaltung.
+
+Basis-Pfad: `/api/converter`
+
+---
+
+## Scan & Explorer
+
+### `GET /api/converter/tree`
+
+Vollständiger Verzeichnisbaum des `converter_raw_dir` (FS-basiert, keine DB).
+
+**Response:**
+
+```json
+{
+  "tree": [
+    {
+      "name": "filme",
+      "relPath": "filme",
+      "isDir": true,
+      "children": [
+        {
+          "name": "film.mkv",
+          "relPath": "filme/film.mkv",
+          "isDir": false,
+          "size": 10485760
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+### `GET /api/converter/browse?parent=relPath`
+
+DB-basierter Datei-Explorer. Gibt Einträge für einen Unterordner zurück.
+
+**Query-Parameter:**
+
+| Parameter | Typ | Beschreibung |
+|---|---|---|
+| `parent` | string | Relativer Pfad zum Unterordner (leer = Root) |
+
+**Response:**
+
+```json
+{
+  "entries": [
+    {
+      "id": 1,
+      "rel_path": "filme/film.mkv",
+      "is_dir": false,
+      "size": 10485760,
+      "job_id": null
+    }
+  ],
+  "rawDir": "/data/output/converter-raw"
+}
+```
+
+---
+
+### `POST /api/converter/scan`
+
+Manuellen Scan des `converter_raw_dir` auslösen. Aktualisiert `converter_scan_entries` in der DB.
+
+**Response:**
+
+```json
+{ "result": { "added": 3, "removed": 1 } }
+```
+
+---
+
+## Jobs erstellen
+
+### `POST /api/converter/jobs/from-selection`
+
+Jobs aus im Datei-Explorer ausgewählten Dateien erstellen.
+
+**Body:**
+
+```json
+{
+  "relPaths": ["filme/film.mkv", "musik/track.flac"],
+  "audioMode": "individual"
+}
+```
+
+| Feld | Typ | Beschreibung |
+|---|---|---|
+| `relPaths` | string[] | Relative Pfade der ausgewählten Dateien |
+| `audioMode` | string | `individual` (ein Job pro Datei) oder `shared` (ein gemeinsamer Job) |
+
+**Response:**
+
+```json
+{ "jobs": [{ "id": 42, "status": "READY_TO_START" }] }
+```
+
+---
+
+### `POST /api/converter/create-jobs`
+
+Jobs aus DB-Scan-Einträgen erstellen.
+
+**Body:**
+
+```json
+{
+  "entries": [
+    { "relPath": "filme/film.mkv", "converterMediaType": "video" }
+  ]
+}
+```
+
+---
+
+### `POST /api/converter/upload`
+
+Dateien hochladen (Multipart, max. 50 Dateien).
+
+**Form-Felder:**
+
+| Feld | Typ | Beschreibung |
+|---|---|---|
+| `files` | File[] | Hochzuladende Dateien |
+| `folderName` | string | (Optional) Ziel-Unterordner |
+
+**Response:**
+
+```json
+{
+  "folders": [{ "folderRelPath": "upload-2026-03-30", "fileCount": 2 }]
+}
+```
+
+---
+
+## Job-Verwaltung
+
+### `GET /api/converter/jobs`
+
+Alle Converter-Jobs zurückgeben.
+
+**Response:**
+
+```json
+{ "jobs": [{ "id": 42, "status": "READY_TO_START", "title": "film.mkv" }] }
+```
+
+---
+
+### `GET /api/converter/jobs/:jobId`
+
+Einzelnen Converter-Job abrufen.
+
+---
+
+### `POST /api/converter/jobs/:jobId/config`
+
+Konfigurationsentwurf für einen Job speichern (persistiert in `encode_plan_json`).
+
+**Body:** Partielles Konfig-Objekt (Ausgabeformat, Presets, Metadaten, Track-Auswahl).
+
+---
+
+### `POST /api/converter/jobs/:jobId/assign-files`
+
+Dateien einem bestehenden (noch nicht gestarteten) Job hinzufügen.
+
+**Body:**
+
+```json
+{ "relPaths": ["musik/track2.flac"] }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/remove-file`
+
+Datei aus einem Job entfernen (per relativer Pfad).
+
+**Body:**
+
+```json
+{ "relPath": "musik/track2.flac" }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/remove-input`
+
+Datei aus einem Job entfernen (per absolutem Eingabepfad).
+
+**Body:**
+
+```json
+{ "inputPath": "/data/output/converter-raw/musik/track2.flac" }
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/start`
+
+Job mit finaler Konfiguration starten.
+
+**Body:**
+
+```json
+{
+  "converterMediaType": "video",
+  "outputFormat": "mkv",
+  "userPreset": "H.264 MKV 1080p30",
+  "trackSelection": {},
+  "handBrakeTitleId": 1,
+  "audioFormatOptions": {}
+}
+```
+
+---
+
+### `POST /api/converter/jobs/:jobId/cancel`
+
+Laufenden Job abbrechen.
+
+---
+
+### `DELETE /api/converter/jobs/:jobId`
+
+Job aus der DB löschen.
+
+---
+
+## Datei-Operationen
+
+Alle Datei-Operationen arbeiten direkt auf dem Dateisystem (ohne DB-Aktualisierung). Ein anschließender Scan-Aufruf synchronisiert die DB.
+
+### `DELETE /api/converter/files`
+
+Datei oder Ordner löschen.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv" }
+```
+
+---
+
+### `POST /api/converter/files/rename`
+
+Datei oder Ordner umbenennen.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv", "newName": "film-neu.mkv" }
+```
+
+---
+
+### `POST /api/converter/files/move`
+
+Datei oder Ordner verschieben.
+
+**Body:**
+
+```json
+{ "relPath": "filme/film.mkv", "targetParentRelPath": "archiv" }
+```
+
+`targetParentRelPath = ""` verschiebt in das Root-Verzeichnis.
+
+---
+
+### `POST /api/converter/files/folder`
+
+Neuen Ordner anlegen.
+
+**Body:**
+
+```json
+{ "parentRelPath": "filme", "name": "neu" }
+```
@@ -0,0 +1,143 @@
+# Downloads API
+
+Endpunkte für die Download-Queue. Ausgabedateien aus der Job-Historie können als ZIP heruntergeladen werden.
+
+Basis-Pfad: `/api/downloads`
+
+---
+
+## `GET /api/downloads`
+
+Liste aller Download-Einträge plus Zusammenfassung.
+
+**Response:**
+
+```json
+{
+  "items": [
+    {
+      "id": "dl-42-raw",
+      "jobId": 42,
+      "target": "raw",
+      "status": "ready",
+      "archiveName": "Job_42_raw.zip",
+      "outputPath": null,
+      "createdAt": "2026-03-30T10:00:00.000Z",
+      "updatedAt": "2026-03-30T10:01:00.000Z",
+      "errorMessage": null
+    }
+  ],
+  "summary": {
+    "total": 3,
+    "pending": 1,
+    "processing": 0,
+    "ready": 1,
+    "failed": 1
+  }
+}
+```
+
+**Status-Werte:**
+
+| Status | Beschreibung |
+|---|---|
+| `pending` | In der Queue, noch nicht gestartet |
+| `processing` | ZIP wird gerade erstellt |
+| `ready` | ZIP fertig, Download verfügbar |
+| `failed` | Fehler bei der Erstellung |
+
+---
+
+## `GET /api/downloads/summary`
+
+Nur die Zusammenfassung der Download-Queue (ohne Item-Liste).
+
+**Response:**
+
+```json
+{
+  "summary": {
+    "total": 3,
+    "pending": 1,
+    "processing": 0,
+    "ready": 1,
+    "failed": 1
+  }
+}
+```
+
+---
+
+## `POST /api/downloads/history/:jobId`
+
+Job-Ausgabe in die Download-Queue einreihen.
+
+**Parameter:**
+
+| Parameter | Typ | Beschreibung |
+|---|---|---|
+| `jobId` | number | ID des Jobs in der Historie |
+
+**Body:**
+
+```json
+{
+  "target": "raw",
+  "outputPath": null
+}
+```
+
+| Feld | Typ | Default | Beschreibung |
+|---|---|---|---|
+| `target` | string | `raw` | `raw` (RAW-Dateien) oder `movie` (Ausgabedateien) |
+| `outputPath` | string | `null` | Optionaler expliziter Ausgabepfad |
+
+**Response (201 Created):**
+
+```json
+{
+  "created": true,
+  "id": "dl-42-raw",
+  "status": "pending",
+  "summary": { "total": 1, "pending": 1, "processing": 0, "ready": 0, "failed": 0 }
+}
+```
+
+Ist der Eintrag bereits vorhanden, wird `201` durch `200` ersetzt und `created: false` zurückgegeben.
+
+---
+
+## `GET /api/downloads/:id/file`
+
+Fertige ZIP-Datei herunterladen.
+
+**Parameter:**
+
+| Parameter | Typ | Beschreibung |
+|---|---|---|
+| `id` | string | Download-ID (z. B. `dl-42-raw`) |
+
+**Response:** Datei-Download (`Content-Disposition: attachment`).
+
+Schlägt fehl mit `404`, wenn kein Download-Eintrag mit dieser ID existiert oder die Datei noch nicht bereit ist.
+
+---
+
+## `DELETE /api/downloads/:id`
+
+Download-Eintrag löschen (auch fertige ZIP-Dateien werden vom Dateisystem entfernt).
+
+**Response:**
+
+```json
+{
+  "ok": true,
+  "summary": { "total": 2, "pending": 0, "processing": 0, "ready": 2, "failed": 0 }
+}
+```
+
+---
+
+## WebSocket
+
+Statusänderungen werden über `DOWNLOADS_UPDATED` in Echtzeit gemeldet. Vollständige Dokumentation: [WebSocket Events](websocket.md#downloads_updated).
@@ -54,11 +54,35 @@ API-Prefix: `/api`

    [:octicons-arrow-right-24: Cron API](crons.md)

-   :material-lightning-bolt: **WebSocket Events**
+-   :material-swap-horizontal: **Converter API**

    ---

-    Pipeline-, Queue-, Disk-, Settings-, Cron- und Monitoring-Events.
+    Datei-Explorer, Upload, Job-Verwaltung für den Converter.
+
+    [:octicons-arrow-right-24: Converter API](converter.md)
+
+-   :material-download: **Downloads API**
+
+    ---
+
+    Download-Queue für Ausgabedateien aus der Job-Historie.
+
+    [:octicons-arrow-right-24: Downloads API](downloads.md)
+
+-   :material-lightning-bolt: **Runtime Activities API**
+
+    ---
+
+    Laufende und abgeschlossene Aktivitäten (Skripte, Ketten, Cron, Tasks).
+
+    [:octicons-arrow-right-24: Runtime Activities](runtime-activities.md)
+
+-   :material-websocket: **WebSocket Events**
+
+    ---
+
+    Pipeline-, Queue-, Disk-, Settings-, Cron-, Converter- und Download-Events.

    [:octicons-arrow-right-24: WebSocket](websocket.md)

@@ -242,6 +242,48 @@ Wird ausgelöst, wenn eine Aktivität gestartet, aktualisiert oder abgeschlossen

 Vollständige Feldbeschreibung: [Runtime Activities API](runtime-activities.md).

+### CONVERTER_SCAN_UPDATE
+
+Wird nach einem Scan des Converter-Eingangsordners gesendet (manuell oder per Polling).
+
+```json
+{
+  "type": "CONVERTER_SCAN_UPDATE",
+  "payload": {
+    "entryCount": 12
+  }
+}
+```
+
+### DOWNLOADS_UPDATED
+
+Wird bei jeder Statusänderung in der Download-Queue gesendet.
+
+```json
+{
+  "type": "DOWNLOADS_UPDATED",
+  "payload": {
+    "reason": "ready",
+    "item": {
+      "id": "dl-1",
+      "jobId": 42,
+      "status": "ready",
+      "archiveName": "Job_42_movie.zip",
+      "createdAt": "2026-03-30T10:00:00.000Z"
+    },
+    "summary": {
+      "total": 3,
+      "pending": 1,
+      "processing": 0,
+      "ready": 1,
+      "failed": 1
+    }
+  }
+}
+```
+
+Mögliche `reason`-Werte: `queued`, `processing`, `ready`, `failed`, `deleted`.
+
 ---

 ## Reconnect-Verhalten
@@ -1,6 +1,42 @@
 # Backend-Services

-Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden.
+Das Backend ist in Services aufgeteilt, die von Express-Routen orchestriert werden. Seit v0.12.0 erfolgt die Medienverarbeitung über ein **Plugin-System**.
+
+---
+
+## Plugin-System (`src/plugins/`)
+
+Ab v0.12.0 ist die Pipeline modular aufgebaut. Jeder Medientyp wird von einem eigenen Plugin verwaltet.
+
+### Basisklassen
+
+- **`PluginBase.js`** — Abstrakte Basisklasse `SourcePlugin` mit Lifecycle-Methoden
+- **`PluginRegistry.js`** — Dynamische Plugin-Erkennung, prioritätsbasierte Auswahl, Settings-Schema-Aggregation
+- **`PluginContext.js`** — Ausführungskontext (Logger, Callbacks, Signals) für Plugin-Aufrufe
+
+### Plugin-Lifecycle
+
+Jedes Plugin implementiert die folgenden Methoden:
+
+| Methode | Beschreibung |
+|---|---|
+| `detect(discInfo)` | Medientyp-Erkennung |
+| `analyze(devicePath, job, ctx)` | Analyse / Metadaten-Extraktion |
+| `rip(job, ctx)` | Rohdaten-Extraktion |
+| `review(job, ctx)` | Optionale Vorschau-Vorbereitung |
+| `encode(job, ctx)` | Finales Encoding/Konvertierung |
+| `finalize(job, ctx)` | Nachbearbeitung |
+| `onCancel(job, ctx)` | Bereinigung bei Abbruch |
+| `onRetry(job, ctx)` | Zustand-Reset vor Retry |
+
+### Implementierte Plugins
+
+- **`BluRayPlugin.js`** — Blu-ray via MakeMKV (Backup-Modus)
+- **`DVDPlugin.js`** — DVD via MakeMKV (MKV-Modus)
+- **`CdPlugin.js`** — Audio-CD via cdparanoia + FFmpeg (experimentell)
+- **`AudiobookPlugin.js`** — AAX/M4B via FFmpeg mit Kapitel-Splitting
+- **`ConverterPlugin.js`** — Generische Audio/Video-Konvertierung via FFmpeg
+- **`VideoDiscPlugin.js`** — Gemeinsame Basis für Blu-ray/DVD (MediaInfo-Parsing)

 ---

@@ -11,10 +47,11 @@ Zentrale Workflow-Orchestrierung.
 Aufgaben:

 - Pipeline-State-Machine + Persistenz (`pipeline_state`)
- Disc-Analyse/Rip/Review/Encode
+- Disc-Analyse/Rip/Review/Encode via Plugin-Delegation
 - Queue-Management (Jobs + `script|chain|wait` Einträge)
 - Retry/Re-Encode/Restart-Flows
 - WebSocket-Broadcasts für State/Progress/Queue
+- Converter-Job-Verwaltung (`createConverterJobFromEntry`, `uploadConverterFiles`, `startConverterJob`)

 Wichtige Methoden:

@@ -29,6 +66,8 @@ Wichtige Methoden:
 - `restartEncodeWithLastSettings()`
 - `resumeReadyToEncodeJob()`
 - `enqueueNonJobEntry()`, `reorderQueue()`, `removeQueueEntry()`
+- `createConverterJobFromEntry()`, `createConverterJobsFromSelection()`
+- `uploadConverterFiles()`, `startConverterJob()`

 ---

@@ -57,9 +96,10 @@ Features:
 - `getCategorizedSettings()` für UI-Form
 - `setSettingValue()` / `setSettingsBulk()`
 - profilspezifische Auflösung (`resolveEffectiveToolSettings`)
- CLI-Config-Building für MakeMKV/HandBrake/MediaInfo
+- CLI-Config-Building für MakeMKV/HandBrake/MediaInfo/FFmpeg
 - HandBrake-Preset-Liste via `HandBrakeCLI -z`
 - MakeMKV-Registration-Command aus `makemkv_registration_key`
+- Pfadauflösung für alle Medienprofile inkl. Audiobook und Converter

 ---

@@ -77,6 +117,59 @@ Features:

 ---

+## `audiobookService.js`
+
+Audiobook-Verarbeitung (AAX/M4B).
+
+Features:
+
+- FFprobe-basierte Analyse (Kapitel, Metadaten)
+- FFmpeg-basiertes Encoding mit Kapitel-Splitting
+- Ausgabeformate: M4B, MP3, FLAC
+- Template-basierte Pfade (`{author}`, `{title}`, `{year}`, `{narrator}`, `{series}`, `{part}`)
+
+---
+
+## `activationBytesService.js`
+
+Verwaltung von Audible-Activation-Bytes für AAX-DRM-Handling.
+
+Features:
+
+- SHA-1-Prüfsumme der AAX-Datei berechnen
+- Activation Bytes in `aax_activation_bytes`-Tabelle cachen
+- Lookup via `audnexService` (wenn konfiguriert)
+
+---
+
+## `converterScanService.js`
+
+Dateisystem-Überwachung des Converter-Eingangsordners.
+
+Features:
+
+- Vollständiger FS-Baum (`getTree()`)
+- DB-basierter Datei-Explorer (`getEntries()`)
+- Manueller und automatischer Scan (Polling)
+- Pfad-Normalisierung mit Traversal-Schutz
+- WebSocket-Broadcast: `CONVERTER_SCAN_UPDATE`
+
+---
+
+## `downloadService.js`
+
+Download-Queue für Ausgabedateien aus der Historie.
+
+Features:
+
+- Job in Download-Queue einreihen (`enqueueHistoryJob`)
+- ZIP-Archiv aus Ausgabedateien erstellen (`archiver`)
+- Datei-Streaming via `res.download()`
+- WebSocket-Broadcast: `DOWNLOADS_UPDATED` bei Status-Änderungen
+- Download-Item löschen
+
+---
+
 ## `cronService.js`

 Integriertes Cron-System ohne externe Parser-Library.
@@ -124,6 +217,12 @@ Vollständige API-Dokumentation: [Runtime Activities API](../api/runtime-activit
 - `hardwareMonitorService.js` (CPU/RAM/GPU/Storage)
 - `websocketService.js` (Client-Registry + Broadcast)
 - `notificationService.js` (PushOver)
+- `cdRipService.js` (CD-Ripping mit cdparanoia)
+- `musicBrainzService.js` (MusicBrainz-Metadaten-Lookup)
+- `audnexService.js` (Audnex-API für Audiobook-Metadaten)
+- `coverArtRecoveryService.js` (Cover-Art-Wiederherstellung)
+- `thumbnailService.js` (Vorschaubild-Generierung)
+- `omdbService.js` (OMDb-Metadaten-Suche)
 - `logger.js` (rotierende Datei-Logs)

 ---
@@ -133,9 +232,10 @@ Vollständige API-Dokumentation: [Runtime Activities API](../api/runtime-activit
 Beim Start:

 1. DB init/migrate
-2. Pipeline-Init
+2. Pipeline-Init (inkl. Plugin-Registry)
 3. Cron-Init
 4. Express-Routes + Error-Handler
 5. WebSocket-Server auf `/ws`
 6. Hardware-Monitoring-Init
 7. Disk-Detection-Start
+8. Converter-Scan-Service-Init (Polling falls aktiviert)
@@ -10,6 +10,8 @@ Ripster verwendet SQLite (`backend/data/ripster.db`).
 settings_schema
 settings_values
 jobs
+job_lineage_artifacts
+job_output_folders
 pipeline_state
 scripts
 script_chains
@@ -17,6 +19,9 @@ script_chain_steps
 user_presets
 cron_jobs
 cron_run_logs
+aax_activation_bytes
+user_prefs
+converter_scan_entries
 ```

 ---
@@ -32,10 +37,38 @@ Zentrale Felder:
 - Pfade: `raw_path`, `output_path`, `encode_input_path`
 - Tool-Ausgaben: `makemkv_info_json`, `handbrake_info_json`, `mediainfo_info_json`, `encode_plan_json`
 - Kontrolle: `encode_review_confirmed`, `rip_successful`, `error_message`
+- Medientyp: `media_type` (`bluray|dvd|cd|audiobook|converter`)
+- Prüfsumme: `aax_checksum` (für AAX-Dateien)
 - Audit: `created_at`, `updated_at`

 ---

+## `job_lineage_artifacts`
+
+Verknüpft Jobs mit ihren Quell-Jobs (z. B. Re-Encode aus einem vorherigen Rip).
+
+Felder:
+
+- `job_id` — der abgeleitete Job
+- `source_job_id` — der Quell-Job
+- `artifact_type` — Art der Verknüpfung (z. B. `reencode`, `restart_review`)
+- `created_at`
+
+---
+
+## `job_output_folders`
+
+Verfolgt Ausgabepfade pro Job (mehrere Ausgaben möglich, z. B. bei Kapitel-Splitting).
+
+Felder:
+
+- `job_id`
+- `folder_path`
+- `label` — optionaler Bezeichner
+- `created_at`
+
+---
+
 ## `pipeline_state`

 Singleton-Tabelle (`id = 1`) für aktiven Snapshot:
@@ -89,6 +122,45 @@ Benannte HandBrake-Preset-Sets:

 ---

+## `aax_activation_bytes`
+
+Cache für Audible-Activation-Bytes (AAX-DRM).
+
+Felder:
+
+- `checksum` — SHA-1-Prüfsumme der AAX-Datei (Primärschlüssel)
+- `activation_bytes` — Hex-String der Activation Bytes
+- `created_at`
+
+---
+
+## `user_prefs`
+
+Benutzer-spezifische Einstellungen (Key-Value).
+
+Felder:
+
+- `key`
+- `value`
+- `updated_at`
+
+---
+
+## `converter_scan_entries`
+
+DB-seitige Erfassung gescannter Dateien im Converter-Eingangsordner.
+
+Felder:
+
+- `rel_path` — relativer Pfad zum `converter_raw_dir`
+- `is_dir` — Verzeichnis-Flag
+- `size` — Dateigröße in Bytes
+- `modified_at` — Datei-Änderungsdatum
+- `job_id` — zugewiesener Converter-Job (falls vorhanden)
+- `scanned_at`
+
+---
+
 ## Migration/Recovery

 Beim Start werden Schema und Settings-Metadaten automatisch abgeglichen.
@@ -107,6 +179,8 @@ Bei korruptem SQLite-File:
 sqlite3 backend/data/ripster.db

 .mode table
-SELECT id, status, title, created_at FROM jobs ORDER BY created_at DESC;
+SELECT id, status, title, media_type, created_at FROM jobs ORDER BY created_at DESC;
 SELECT key, value FROM settings_values ORDER BY key;
+SELECT checksum, activation_bytes FROM aax_activation_bytes;
+SELECT rel_path, job_id FROM converter_scan_entries;
 ```
@@ -13,10 +13,11 @@ Pipeline-Steuerung:
 - Status/Progress/ETA
 - Metadaten-Dialog
 - Playlist-Entscheidung
- Review-Panel
+- Review-Panel (Track-Auswahl)
 - Queue-Interaktion (reorder/add/remove)
 - Job-Aktionen (Start/Cancel/Retry/Re-Encode)
 - Hardware-Monitoring-Anzeige
+- Aktivitäts-Tracking (Skripte, Ketten, Cron)

 ### `SettingsPage.jsx`

@@ -36,15 +37,46 @@ Historie:
 - OMDb-Nachzuweisung
 - Re-Encode/Restart-Workflows

+### `ConverterPage.jsx`
+
+Datei-Converter:
+
+- Datei-Explorer des Converter-Eingangsordners (Baum-Ansicht)
+- Upload von Audio/Video-Dateien (bis zu 50 Dateien gleichzeitig)
+- Dateiverwaltung: Umbenennen, Verschieben, Löschen, Ordner erstellen
+- Jobs aus Dateiauswahl erstellen
+- Converter-Job-Konfiguration (Ausgabeformat, Preset, Tracks)
+- Job-Start, Abbruch, Löschung
+- Automatischer Scan-Status
+
+### `DownloadsPage.jsx`
+
+Download-Queue:
+
+- Ausgabedateien aus der Job-Historie in die Queue einreihen
+- Download-Status verfolgen (ausstehend, wird verarbeitet, bereit, fehlgeschlagen)
+- Dateien als ZIP herunterladen
+- Download-Einträge löschen
+
+### `DatabasePage.jsx`
+
+Expert-Modus:
+
+- Tabellarische Rohsicht der Job-Datenbank
+- Orphan-RAW-Import
+
 ---

 ## Wichtige Komponenten

- `PipelineStatusCard.jsx`
- `MetadataSelectionDialog.jsx`
- `MediaInfoReviewPanel.jsx`
- `JobDetailDialog.jsx`
- `CronJobsTab.jsx`
+- `PipelineStatusCard.jsx` — Pipeline-Status-Anzeige mit Progress
+- `MetadataSelectionDialog.jsx` — OMDb-Metadaten-Auswahl
+- `MediaInfoReviewPanel.jsx` — Track-Auswahl-Interface (Video/Audio/Untertitel)
+- `JobDetailDialog.jsx` — Job-Detailansicht mit Logs
+- `CronJobsTab.jsx` — Cron-Job-Verwaltung
+- `DynamicSettingsForm.jsx` — Schema-gesteuertes Einstellungsformular
+- `ConverterJobCard.jsx` — Converter-Job-Darstellung
+- `CdRipConfigPanel.jsx` — Konfiguration für Audio-CD-Ripping

 ---

@@ -68,6 +100,9 @@ In `App.jsx` werden u. a. verarbeitet:
 - `PIPELINE_QUEUE_CHANGED`
 - Disk erkannt / Disk entfernt
 - `HARDWARE_MONITOR_UPDATE`
+- `DOWNLOADS_UPDATED`
+- `CONVERTER_SCAN_UPDATE`
+- `RUNTIME_ACTIVITY_CHANGED`

 ---

@@ -13,16 +13,31 @@ Viele Felder sind pro Medientyp getrennt vorhanden:
 - Blu-ray
 - DVD
 - Sonstiges
+- Audiobook (neu ab v0.12.0)

 ---

 ## Template-Platzhalter

-Datei-/Ordner-Templates unterstützen:
+### Video-Templates
+- `${title}` — Titel
+- `${year}` — Erscheinungsjahr
+- `${imdbId}` — IMDb-ID

- `${title}`
- `${year}`
- `${imdbId}`
+### Audiobook-Templates
+- `{author}` — Autor
+- `{title}` — Titel
+- `{year}` — Erscheinungsjahr
+- `{narrator}` — Sprecher
+- `{series}` — Buchreihe
+- `{part}` — Teil-Nummer
+- `{format}` — Ausgabeformat
+
+### Converter-Templates (Video)
+- `{title}`, `{year}`
+
+### Converter-Templates (Audio)
+- `{artist}`, `{title}`, `{album}`, `{year}`, `{trackNr}`

 Nicht gesetzte Werte werden zu `unknown`.

@@ -47,6 +62,17 @@ Nicht gesetzte Werte werden zu `unknown`.
 | `Eigentümer Film-Ordner (DVD)` | string | `null` |
 | `Eigentümer Film-Ordner (Sonstiges)` | string | `null` |
 | `Log Ordner` | path | `data/logs` |
+| `Audiobook RAW-Ordner` | path | `null` |
+| `Eigentümer Audiobook RAW-Ordner` | string | `null` |
+| `Audiobook Output-Ordner` | path | `null` |
+| `Eigentümer Audiobook Output-Ordner` | string | `null` |
+| `Output Template (Audiobook)` | string | `{author}/{author} - {title} ({year})` |
+| `Audiobook RAW Template` | string | `{author} - {title} ({year})` |
+| `Converter Raw-Ordner` | path | `null` |
+| `Converter Ausgabe (Video)` | path | `null` |
+| `Converter Ausgabe (Audio)` | path | `null` |
+| `Output-Template (Video)` | string | `{title}` |
+| `Output-Template (Audio)` | string | `{artist} - {title}` |

 ---

@@ -57,6 +83,7 @@ Nicht gesetzte Werte werden zu `unknown`.
 | `Laufwerksmodus` | select | `auto` | `Auto Discovery` oder `Explizites Device` |
 | `Device Pfad` | path | `/dev/sr0` | relevant bei `Explizites Device` |
 | `MakeMKV Source Index` | number | `0` | Disc-Index im Auto-Modus |
+| `Disc Auto-Erkennung aktiviert` | boolean | `true` | Automatische Disc-Erkennung per Polling |
 | `Polling Intervall (ms)` | number | `4000` | 1000..60000 |

 ---
@@ -79,6 +106,8 @@ Nicht gesetzte Werte werden zu `unknown`.
 | `Mediainfo Kommando` | string | `mediainfo` |
 | `Minimale Titellaenge (Minuten)` | number | `60` |
 | `HandBrake Kommando` | string | `HandBrakeCLI` |
+| `FFmpeg Kommando` | string | `ffmpeg` |
+| `FFprobe Kommando` | string | `ffprobe` |
 | `Encode-Neustart: unvollständige Ausgabe löschen` | boolean | `true` |
 | `Parallele Jobs` | number | `1` |

@@ -112,6 +141,16 @@ Nicht gesetzte Werte werden zu `unknown`.

 ---

+## Kategorie: Converter
+
+| Feldname in der GUI | Typ | Default | Hinweis |
+|---|---|---|---|
+| `Erlaubte Datei-Endungen` | string | `mkv,mp4,m2ts,iso,avi,mov,flac,mp3,aac,wav,m4a,ogg,opus` | Komma-getrennt, ohne Punkt |
+| `Auto-Scan (Polling)` | boolean | `false` | Converter-Ordner automatisch scannen |
+| `Polling-Intervall (Sekunden)` | number | `300` | 30..86400 |
+
+---
+
 ## Kategorie: Metadaten

 | Feldname in der GUI | Typ | Default |
@@ -0,0 +1,91 @@
+# 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` 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)` |
@@ -0,0 +1,53 @@
+# Downloads
+
+Die Downloads-Seite ermöglicht es, Ausgabedateien aus abgeschlossenen Jobs als ZIP-Archiv herunterzuladen.
+
+---
+
+## Überblick
+
+Jobs, die in der Historie abgeschlossen sind, können in die Download-Queue eingereiht werden. Ripster erstellt daraus ein ZIP-Archiv, das direkt im Browser heruntergeladen werden kann.
+
+---
+
+## Download-Queue
+
+Die Queue zeigt alle aktuellen Download-Einträge mit ihrem Status:
+
+| Status | Beschreibung |
+|---|---|
+| **Ausstehend** | In der Queue, ZIP-Erstellung noch nicht gestartet |
+| **Wird verarbeitet** | ZIP-Archiv wird gerade erstellt |
+| **Bereit** | ZIP fertig, Download-Button verfügbar |
+| **Fehlgeschlagen** | Fehler bei der ZIP-Erstellung |
+
+---
+
+## Download einreihen
+
+Downloads können über die **Historie** eingereiht werden:
+
+1. Job in der Historie öffnen
+2. **Download einreihen** wählen
+3. Ziel auswählen: `RAW-Dateien` oder `Ausgabedateien`
+4. Den Eintrag in der Downloads-Queue verfolgen
+
+---
+
+## Download starten
+
+Sobald der Status **Bereit** angezeigt wird, kann die ZIP-Datei mit dem Download-Button heruntergeladen werden.
+
+ZIP-Dateinamen folgen dem Muster: `Job_<id>_<target>.zip`
+
+---
+
+## Einträge löschen
+
+Abgeschlossene oder fehlerhafte Einträge können einzeln gelöscht werden. Die dazugehörige ZIP-Datei wird dabei ebenfalls vom Server entfernt.
+
+---
+
+## Echtzeit-Updates
+
+Die Downloads-Seite aktualisiert sich automatisch per WebSocket (`DOWNLOADS_UPDATED`). Statusänderungen (z. B. von `Wird verarbeitet` zu `Bereit`) werden ohne Seiten-Reload angezeigt.
@@ -1,6 +1,6 @@
 # GUI-Seiten

-Ripster hat drei Hauptseiten in der Navigation plus eine Expert-Seite.
+Ripster hat fünf Hauptseiten in der Navigation plus eine Expert-Seite.

 ## Seitenüberblick

@@ -9,16 +9,20 @@ Ripster hat drei Hauptseiten in der Navigation plus eine Expert-Seite.
 | [Dashboard](dashboard.md) | Live-Betrieb: Pipeline, Queue, Aktivitäten, Disc-Infos |
 | [Settings](settings.md) | Konfiguration, Skripte, Ketten, Presets, Cronjobs |
 | [Historie](history.md) | abgeschlossene/laufende Jobs durchsuchen und nachbearbeiten |
+| [Converter](converter.md) | Audio/Video-Dateien konvertieren, Datei-Explorer, Upload |
+| [Downloads](downloads.md) | Ausgabedateien als ZIP herunterladen |
 | [Database (Expert)](database.md) | tabellarische Rohsicht inkl. Orphan-RAW-Import |

 ## Empfohlene Nutzung im Alltag

-1. **Start eines neuen Jobs:** `Dashboard`
-2. **Regeln/Automatisierung anpassen:** `Settings`
-3. **Ergebnisse prüfen oder Jobs nachbearbeiten:** `Historie`
-4. **Sonderfälle/Recovery:** `Database`
+1. **Start eines neuen Disc-Jobs:** `Dashboard`
+2. **Dateien konvertieren oder Audiobooks verarbeiten:** `Converter`
+3. **Regeln/Automatisierung anpassen:** `Settings`
+4. **Ergebnisse prüfen oder Jobs nachbearbeiten:** `Historie`
+5. **Dateien herunterladen:** `Downloads`
+6. **Sonderfälle/Recovery:** `Database`

 ## Hinweise zur Navigation

- `Dashboard`, `Settings`, `Historie` sind direkt in der Kopfnavigation.
+- `Dashboard`, `Settings`, `Historie`, `Converter` und `Downloads` sind direkt in der Kopfnavigation.
 - `Database` ist als Expert-Route verfügbar: `/database`.