131 lines
3.6 KiB
Markdown
131 lines
3.6 KiB
Markdown
# Ripster
|
||
|
||
**Halbautomatische Disc-Ripping-Plattform für DVDs und Blu-rays**
|
||
|
||
---
|
||
|
||
<div class="grid cards" markdown>
|
||
|
||
- :material-disc: **Automatisiertes Ripping**
|
||
|
||
---
|
||
|
||
Disc einlegen – Ripster erkennt sie automatisch und startet den Analyse-Workflow mit MakeMKV.
|
||
|
||
[:octicons-arrow-right-24: Workflow verstehen](pipeline/workflow.md)
|
||
|
||
- :material-movie-open: **Metadata-Integration**
|
||
|
||
---
|
||
|
||
Automatische Suche in der OMDb-Datenbank für Filmtitel, Poster und IMDb-IDs.
|
||
|
||
[:octicons-arrow-right-24: Konfiguration](getting-started/configuration.md)
|
||
|
||
- :material-cog: **Flexibles Encoding**
|
||
|
||
---
|
||
|
||
HandBrake-Encoding mit individueller Track-Auswahl für Audio- und Untertitelspuren.
|
||
|
||
[:octicons-arrow-right-24: Encode-Planung](pipeline/encoding.md)
|
||
|
||
- :material-history: **Job-Historie**
|
||
|
||
---
|
||
|
||
Vollständiges Audit-Trail aller Ripping-Jobs mit Logs und Re-Encode-Funktion.
|
||
|
||
[:octicons-arrow-right-24: History API](api/history.md)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## Was ist Ripster?
|
||
|
||
Ripster ist eine webbasierte Anwendung zur **halbautomatischen Digitalisierung** von DVDs und Blu-rays. Die Anwendung kombiniert bewährte Open-Source-Tools zu einem durchgängigen, komfortablen Workflow:
|
||
|
||
```
|
||
Disc einlegen → Erkennung → Analyse → Metadaten wählen → Rippen → Encodieren → Fertig
|
||
```
|
||
|
||
### Kernfunktionen
|
||
|
||
| Feature | Beschreibung |
|
||
|---------|-------------|
|
||
| **Echtzeit-Updates** | WebSocket-basierte Live-Statusanzeige ohne Reload |
|
||
| **Intelligente Playlist-Analyse** | Erkennt Blu-ray Playlist-Verschleierung (Fake-Playlists) |
|
||
| **Track-Auswahl** | Individuelle Auswahl von Audio- und Untertitelspuren |
|
||
| **Orphan-Recovery** | Import von bereits gerippten Dateien als Jobs |
|
||
| **PushOver-Benachrichtigungen** | Mobile Alerts bei Fertigstellung oder Fehlern |
|
||
| **DB-Korruptions-Recovery** | Automatische Quarantäne bei korrupten SQLite-Dateien |
|
||
| **Re-Encoding** | Erneutes Encodieren ohne neu rippen |
|
||
|
||
---
|
||
|
||
## Technologie-Stack
|
||
|
||
=== "Backend"
|
||
|
||
- **Node.js** >= 20.19.0 mit Express.js
|
||
- **SQLite3** mit automatischen Schema-Migrationen
|
||
- **WebSocket** (`ws`) für Echtzeit-Kommunikation
|
||
- Externe CLI-Tools: `makemkvcon`, `HandBrakeCLI`, `mediainfo`
|
||
|
||
=== "Frontend"
|
||
|
||
- **React** 18.3.1 mit React Router
|
||
- **Vite** 5.4.12 als Build-Tool
|
||
- **PrimeReact** 10.9.2 als UI-Bibliothek
|
||
- WebSocket-Client für Live-Updates
|
||
|
||
=== "Externe Tools"
|
||
|
||
| Tool | Zweck |
|
||
|------|-------|
|
||
| `makemkvcon` | Disc-Analyse & MKV/Backup-Ripping |
|
||
| `HandBrakeCLI` | Video-Encoding |
|
||
| `mediainfo` | Track-Informationen aus gerippten Dateien |
|
||
| OMDb API | Filmmetadaten (Titel, Poster, IMDb-ID) |
|
||
|
||
---
|
||
|
||
## Schnellstart
|
||
|
||
```bash
|
||
# 1. Repository klonen
|
||
git clone https://github.com/YOUR_GITHUB_USERNAME/ripster.git
|
||
cd ripster
|
||
|
||
# 2. Starten (Node.js >= 20 erforderlich)
|
||
./start.sh
|
||
|
||
# 3. Browser öffnen
|
||
open http://localhost:5173
|
||
```
|
||
|
||
!!! tip "Erste Schritte"
|
||
Die vollständige Installationsanleitung mit allen Voraussetzungen findest du unter [Erste Schritte](getting-started/index.md).
|
||
|
||
---
|
||
|
||
## Pipeline-Überblick
|
||
|
||
```mermaid
|
||
stateDiagram-v2
|
||
[*] --> IDLE
|
||
IDLE --> ANALYZING: Disc erkannt
|
||
ANALYZING --> METADATA_SELECTION: Analyse abgeschlossen
|
||
METADATA_SELECTION --> READY_TO_START: Metadaten bestätigt
|
||
READY_TO_START --> RIPPING: Start gedrückt
|
||
RIPPING --> MEDIAINFO_CHECK: MKV erstellt
|
||
MEDIAINFO_CHECK --> READY_TO_ENCODE: Tracks analysiert
|
||
READY_TO_ENCODE --> ENCODING: Encode bestätigt
|
||
ENCODING --> FINISHED: Encoding fertig
|
||
ENCODING --> ERROR: Fehler
|
||
RIPPING --> ERROR: Fehler
|
||
ERROR --> [*]
|
||
FINISHED --> [*]
|
||
```
|