0.13.1-4 release snapshot

docs/gui/converter.md

@@ -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*` 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)` |

docs/gui/database.md

@@ -0,0 +1,29 @@
+# Database (Expert)
+
+`/database` ist eine erweiterte Ansicht für Power-User und Recovery-Fälle.
+
+## Zugriff
+
+- Route direkt aufrufen: `/database`
+- nicht Teil der Standard-Navigation
+
+## Bereiche
+
+### `Gefundene RAW-Einträge`
+
+Listet RAW-Ordner, die keinen zugehörigen Job-Eintrag haben.
+
+Aktionen:
+
+- `RAW prüfen` (Scan der konfigurierten RAW-Pfade)
+- `Job anlegen` (Orphan-RAW in Historie importieren)
+
+## Typischer Einsatz
+
+- nach manuellen Dateioperationen
+- nach Migrationen oder Recovery
+- wenn RAW-Dateien vorhanden sind, aber kein Historieneintrag existiert
+
+## Vorsicht
+
+Diese Seite erlaubt Eingriffe mit direkter Auswirkung auf Datenbestand und Historie. Vor Lösch- oder Importaktionen Pfade und Zieljob sorgfältig prüfen.

docs/gui/downloads.md

@@ -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.

docs/gui/history.md

@@ -0,0 +1,62 @@
+# Historie
+
+Die Seite `Historie` ist für Suche, Prüfung und Nachbearbeitung bestehender Jobs.
+
+## Hauptansicht
+
+Filter und Werkzeuge:
+
+- Suche (Titel/IMDb)
+- Status-Filter
+- Medium-Filter (`Blu-ray`, `DVD`, `Sonstiges`)
+- Sortierung
+- Listen-/Grid-Layout
+
+Jeder Eintrag zeigt:
+
+- Poster, Titel, Jahr, IMDb
+- Medium-Indikator
+- Status
+- Start/Ende
+- Verfügbarkeit von RAW/Movie
+- Ratings (wenn OMDb-Daten vorhanden)
+
+Klick auf einen Eintrag öffnet die Detailansicht.
+
+---
+
+## Job-Detaildialog
+
+Bereiche:
+
+- Film-Infos + OMDb-Details
+- Job-Infos (Status, Pfade, Erfolgsflags, Fehler)
+- hinterlegte Encode-Auswahl
+- ausgeführter HandBrake-Befehl
+- strukturierte JSON-Blöcke (OMDb/MakeMKV/MediaInfo/EncodePlan/HandBrake)
+- Log-Ladefunktionen (`Tail`, `Vollständig`)
+
+## Typische Aktionen im Detaildialog
+
+- `OMDb neu zuordnen`
+- `Encode neu starten`
+- `Review neu starten`
+- `RAW neu encodieren`
+- `RAW löschen`, `Movie löschen`, `Beides löschen`
+- `Historieneintrag löschen`
+- bei Queue-Lock: `Aus Queue löschen`
+
+## Wann welche Aktion?
+
+| Ziel | Aktion |
+|---|---|
+| Metadaten korrigieren | `OMDb neu zuordnen` |
+| mit gleicher bestätigter Auswahl neu encodieren | `Encode neu starten` |
+| Titel-/Spurprüfung komplett neu berechnen | `Review neu starten` |
+| aus vorhandenem RAW erneut encodieren | `RAW neu encodieren` |
+| Speicher freigeben | Dateilöschaktionen |
+
+## Logs
+
+- `Tail laden (800)` für schnelle Fehleranalyse
+- `Vollständiges Log laden` für vollständige Nachverfolgung

docs/gui/index.md

@@ -0,0 +1,28 @@
+# GUI-Seiten
+
+Ripster hat fünf Hauptseiten in der Navigation plus eine Expert-Seite.
+
+## Seitenüberblick
+
+| Seite | Zweck |
+|---|---|
+| [Ripper](ripper.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 Disc-Jobs:** `Ripper`
+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
+
+- `Ripper`, `Settings`, `Historie`, `Converter` und `Downloads` sind direkt in der Kopfnavigation.
+- `Database` ist als Expert-Route verfügbar: `/database`.

docs/gui/ripper.md

@@ -0,0 +1,124 @@
+# Ripper
+
+Das Ripper ist die **Betriebszentrale** für laufende Jobs.
+
+## Aufbau der Seite
+
+Die Bereiche erscheinen in dieser Reihenfolge:
+
+1. `Hardware Monitoring`
+2. `Job Queue`
+3. `Skript- / Cron-Status`
+4. `Job Übersicht`
+5. `Disk-Information`
+
+---
+
+## 1) Hardware Monitoring
+
+Zeigt live:
+
+- CPU (gesamt + optional pro Kern)
+- RAM
+- GPU-Auslastung/Temperatur/VRAM
+- freien Speicher in den konfigurierten Pfaden
+
+Wichtig für den Betrieb:
+
+- Hohe Speicherauslastung oder fast volle Zielpfade früh erkennen
+- über `Settings` aktivierbar/deaktivierbar (`Hardware Monitoring aktiviert`)
+
+## 2) Job Queue
+
+Zwei Spalten:
+
+- `Laufende Jobs`
+- `Warteschlange`
+
+Mögliche Aktionen:
+
+- Queue per Drag-and-Drop umsortieren
+- Queue-Job entfernen (`X`)
+- zusätzliche Queue-Elemente einfügen (`+`):
+  - Skript
+  - Skriptkette
+  - Wartezeit
+
+Hinweis:
+
+- `Parallel` zeigt den Wert aus `Settings` -> `Parallele Jobs`.
+
+## 3) Skript- / Cron-Status
+
+Zeigt:
+
+- aktive Ausführungen (Skripte, Ketten, Cron)
+- zuletzt abgeschlossene Ausführungen
+
+Mögliche Aktionen:
+
+- laufende Ketten: `Nächster Schritt`
+- laufende Einträge: `Abbrechen`
+- Historie der Aktivitäten: `Liste leeren`
+
+## 4) Job Übersicht
+
+Kompakte Jobliste mit Status, Fortschritt, ETA. Klick auf einen Job klappt die Detailsteuerung auf.
+
+Im aufgeklappten Zustand erscheint die Karte `Pipeline-Status` mit allen zustandsabhängigen Aktionen.
+
+### Zustandsabhängige Hauptaktionen
+
+| Zustand | Typische Aktion |
+|---|---|
+| `Medium erkannt` / `Bereit` | `Analyse starten` |
+| `Metadatenauswahl` | `Metadaten öffnen` |
+| `Warte auf Auswahl` | Playlist wählen und `Playlist übernehmen` |
+| `Startbereit` | `Job starten` |
+| `Bereit zum Encodieren` | Tracks/Skripte prüfen, dann `Encoding starten` |
+| laufend (`Analyse`/`Rippen`/`Encodieren`) | `Abbrechen` |
+| `Fehler` / `Abgebrochen` | `Retry Rippen`, `Disk-Analyse neu starten` |
+
+Zusätzlich je nach Job:
+
+- `Review neu starten`
+- `Encode neu starten`
+- `Aus Queue löschen`
+
+### Titel-/Spurprüfung (`Bereit zum Encodieren`)
+
+Im selben Block siehst du:
+
+- Auswahl des Encode-Titels
+- Audio-/Subtitle-Trackauswahl
+- User-Preset-Auswahl
+- Pre-/Post-Encode-Skripte und Ketten
+- Preview des finalen HandBrakeCLI-Befehls
+
+## 5) Disk-Information
+
+Zeigt aktuelles Laufwerk und Disc-Metadaten (`Pfad`, `Modell`, `Disc-Label`, `Mount`).
+
+Aktionen:
+
+- `Laufwerk neu lesen`
+- `Disk neu analysieren`
+- `Metadaten-Modal öffnen`
+
+---
+
+## Wichtige Dialoge im Ripper
+
+### Metadaten auswählen
+
+- OMDb-Suche + Ergebnisliste
+- manuelle Eingabe als Fallback
+- `Auswahl übernehmen` startet den nächsten Pipeline-Schritt
+
+### Abbruch-Bereinigung
+
+Nach Abbruch kann Ripster optional fragen, ob erzeugte RAW- oder Movie-Dateien gelöscht werden sollen.
+
+### Queue-Eintrag einfügen
+
+Erstellt gezielt einen Skript-, Ketten- oder Warte-Eintrag an einer bestimmten Queue-Position.

docs/gui/settings.md

@@ -0,0 +1,92 @@
+# Settings
+
+Die Seite `Settings` steuert Konfiguration und Automatisierung.
+
+## Tabs im Überblick
+
+| Tab | Zweck |
+|---|---|
+| `Konfiguration` | alle Kernsettings (Pfade, Tools, Monitoring, Metadaten, Queue, Benachrichtigungen) |
+| `Scripte` | einzelne Bash-Skripte verwalten und testen |
+| `Skriptketten` | Sequenzen aus Skript- und Warte-Schritten bauen |
+| `Encode-Presets` | benutzerdefinierte Presets für das Review im Ripper |
+| `Cronjobs` | zeitgesteuerte Skript-/Kettenausführung |
+
+---
+
+## Tab `Konfiguration`
+
+Wichtiges Bedienmuster:
+
+1. Werte ändern
+2. `Änderungen speichern`
+3. bei Bedarf `Änderungen verwerfen` oder `Neu laden`
+
+Zusätzlich:
+
+- `PushOver Test` sendet eine Testnachricht
+- Änderungen werden erst nach Speichern wirksam
+- Tool-Preset-Felder bieten HandBrake-Presetauswahl direkt im Formular
+
+## Tab `Scripte`
+
+Funktionen:
+
+- Skript anlegen, bearbeiten, löschen
+- Skript testen (`Test`)
+- Reihenfolge per Drag-and-Drop
+
+Praxis:
+
+- Reihenfolge ist wichtig, weil ausgewählte Skripte später sequentiell abgearbeitet werden.
+- Testresultate zeigen Exit-Code, Dauer und stdout/stderr.
+
+## Tab `Skriptketten`
+
+Funktionen:
+
+- Kette anlegen/bearbeiten/löschen
+- Kette testen
+- Reihenfolge der Ketten per Drag-and-Drop
+
+Im Ketten-Editor:
+
+- Bausteine links (`Warten`, vorhandene Skripte)
+- Schritte rechts per Klick oder Drag-and-Drop hinzufügen
+- Schrittreihenfolge im Canvas ändern
+
+## Tab `Encode-Presets`
+
+Ein Preset bündelt:
+
+- optional HandBrake-Preset (`-Z`)
+- optionale Extra-Args
+- Medientyp (`Universell`, `Blu-ray`, `DVD`, `Sonstiges`)
+
+Verwendung:
+
+- Diese Presets erscheinen später im Ripper im Review (`Bereit zum Encodieren`).
+
+## Tab `Cronjobs`
+
+Funktionen:
+
+- Cronjob anlegen und bearbeiten
+- Quelle wählen: Skript oder Skriptkette
+- Cron-Ausdruck validieren
+- `Jetzt ausführen`
+- Logs je Cronjob anzeigen
+- `Aktiviert` und `Pushover` toggeln
+
+Hilfen:
+
+- Beispiele für Cron-Ausdrücke direkt im Dialog
+- Link zu `crontab.guru` im Editor
+
+---
+
+## Empfehlung für stabile Nutzung
+
+1. Erst `Konfiguration` sauber setzen
+2. dann Skripte/Ketten testen
+3. danach Cronjobs aktivieren