Files
ripster/docs/getting-started/quickstart.md

145 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Schnellstart
Nach der [Installation](installation.md) und [Konfiguration](configuration.md) kannst du sofort mit dem ersten Rip beginnen.
---
## 1. Ripster starten
```bash
cd ripster
./start.sh
```
Öffne [http://localhost:5173](http://localhost:5173) im Browser.
---
## 2. Dashboard
Das Dashboard zeigt den aktuellen Pipeline-Status:
```
Status: IDLE Bereit
Warte auf Disc...
```
---
## 3. Disc einlegen
Lege eine DVD oder Blu-ray in das Laufwerk ein. Ripster erkennt die Disc automatisch (Polling-Intervall konfigurierbar, Standard: 5 Sekunden) und wechselt in den Status **ANALYZING**.
!!! tip "Manuelle Analyse"
Falls die Disc nicht automatisch erkannt wird, kann über die API eine manuelle Analyse ausgelöst werden:
```bash
curl -X POST http://localhost:3001/api/pipeline/analyze
```
---
## 4. Analyse abwarten
MakeMKV analysiert die Disc-Struktur. Dieser Vorgang dauert je nach Disc **30 Sekunden bis 5 Minuten**.
Der Fortschritt wird live im Dashboard angezeigt.
---
## 5. Metadaten auswählen
Nach der Analyse öffnet sich der **Metadaten-Dialog**:
1. **Titel suchen**: Gib den Filmtitel in die Suchleiste ein
2. **Ergebnis auswählen**: Wähle den passenden Film aus der OMDb-Liste
3. **Playlist wählen** *(nur Blu-ray)*: Bei Blu-rays mit mehreren Playlists zeigt Ripster eine Analyse der wahrscheinlich korrekten Playlist an
4. **Bestätigen**: Klicke auf "Bestätigen"
!!! info "Playlist-Obfuskierung"
Einige Blu-rays enthalten absichtlich viele Fake-Playlists. Ripster analysiert diese automatisch und schlägt die wahrscheinlich korrekte Playlist vor.
---
## 6. Ripping starten
Nach der Metadaten-Auswahl wechselt der Status zu **READY_TO_START**.
Klicke auf **"Starten"** MakeMKV beginnt mit dem Ripping.
**Typische Dauer:**
- DVD: 2040 Minuten
- Blu-ray: 45120 Minuten
---
## 7. Encode-Review
Nach dem Ripping analysiert MediaInfo die Track-Struktur. Im **Encode-Review** kannst du:
- **Audio-Tracks** auswählen (z. B. Deutsch + Englisch)
- **Untertitel-Tracks** auswählen
- Überflüssige Tracks deaktivieren
Klicke auf **"Encodierung bestätigen"**.
---
## 8. Encoding
HandBrake encodiert die Datei mit dem konfigurierten Preset.
**Fortschrittsanzeige:**
- Aktueller Prozentsatz
- Geschätzte Restzeit (ETA)
- Encoding-Geschwindigkeit (FPS)
---
## 9. Fertig!
Status wechselt zu **FINISHED**. Die encodierte Datei liegt im konfigurierten `movie_dir`.
```
/mnt/nas/movies/
└── Inception (2010).mkv ← Fertige Datei
```
!!! success "PushOver-Benachrichtigung"
Falls PushOver konfiguriert ist, erhältst du eine Push-Benachrichtigung auf dein Mobilgerät.
---
## Workflow-Zusammenfassung
```
Disc einlegen
ANALYZING (MakeMKV analysiert)
METADATA_SELECTION (Titel & Playlist wählen)
READY_TO_START → [Starten]
RIPPING (MakeMKV rippt)
MEDIAINFO_CHECK (Track-Analyse)
READY_TO_ENCODE → [Bestätigen]
ENCODING (HandBrake encodiert)
FINISHED ✓
```
---
## Was tun bei Fehlern?
Falls ein Job in den Status **ERROR** wechselt:
1. Klicke auf **"Details"** im Dashboard
2. Prüfe die Log-Ausgabe
3. Klicke auf **"Retry"** um den Job erneut zu versuchen
Logs findest du auch in der [History-Seite](http://localhost:5173/history).