Files
ripster/docs/tools/makemkv.md
2026-03-06 11:21:25 +00:00

161 lines
4.6 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.
# MakeMKV
MakeMKV analysiert und rippt DVDs und Blu-rays. Ripster nutzt `makemkvcon` (die CLI-Version).
---
## Verwendete Befehle
### Disc-Analyse
```bash
makemkvcon -r --cache=1 info disc:0
```
Gibt alle Titel und Playlists der eingelegten Disc aus. Ripster parst diese Ausgabe um die verfügbaren Tracks und Playlists zu bestimmen.
**Parameter:**
- `-r` Maschinen-lesbares Ausgabeformat
- `--cache=1` Minimaler Disc-Cache
- `info disc:0` Informationsabfrage für erstes Laufwerk
### MKV-Modus (Standard)
```bash
makemkvcon mkv disc:0 all /path/to/raw/ \
--minlength=900 \
-r
```
Erstellt MKV-Dateien aus allen Titeln, die länger als 15 Minuten sind.
**Parameter:**
- `mkv` MKV-Ausgabemodus
- `disc:0` Erstes Disc-Laufwerk
- `all` Alle passenden Titel (nicht nur einen bestimmten)
- `--minlength=900` Mindestlänge in Sekunden (entspricht 15 Minuten)
### Backup-Modus
```bash
makemkvcon backup disc:0 /path/to/raw/backup/ \
--decrypt \
-r
```
Erstellt ein vollständiges Disc-Backup mit Menüs.
**Parameter:**
- `backup` Backup-Modus
- `--decrypt` Verschlüsselung entfernen
---
## Ausgabeformat
MakeMKV gibt Fortschritt und Status in einem strukturierten Format aus:
```
PRGV:current,total,max → Fortschrittsbalken-Werte
PRGT:code,id,"Beschreibung" → Aktueller Task
PRGC:code,id,"Beschreibung" → Aktueller Sub-Task
MSG:code,flags,count,"Text" → Nachricht
```
Ripster's `progressParsers.js` parst diese Ausgabe für die Live-Fortschrittsanzeige.
---
## LibDriveIO-Modus (Pflicht)
!!! danger "Laufwerk muss im LibDriveIO-Modus betrieben werden"
MakeMKV greift auf Discs über **LibDriveIO** zu eine Bibliothek, die direkt auf Rohdaten des Laufwerks zugreift und den Standard-OS-Treiber umgeht. Ohne diesen Modus kann MakeMKV verschlüsselte Blu-rays (insbesondere UHD) **nicht lesen**.
### Was ist LibDriveIO?
LibDriveIO ist MakeMKVs interne Treiberschicht für den direkten Laufwerkszugriff. Sie ermöglicht:
- Lesen von verschlüsselten Blu-ray-Sektoren (AACS, BD+, AACS2)
- Zugriff auf Disc-Strukturen, die über Standard-OS-APIs nicht erreichbar sind
- UHD-Blu-ray-Entschlüsselung ohne externe Bibliotheken
### Voraussetzungen für den LibDriveIO-Modus
Das Laufwerk muss **LibDriveIO-kompatibel** sein und entsprechend betrieben werden:
1. **Kompatibles Laufwerk** Nicht alle Laufwerke unterstützen den Rohdatenzugriff. UHD-kompatible Laufwerke (z. B. LG, Pioneer bestimmter Firmware-Versionen) sind erforderlich.
2. **Laufwerk-Berechtigungen** Der Prozess benötigt direkten Zugriff auf das Blockdevice:
```bash
sudo chmod a+rw /dev/sr0
# oder dauerhaft über udev-Regel
```
3. **Kein OS-seitiger Disc-Mount** Das Laufwerk darf beim Ripping **nicht** durch das OS automatisch gemountet sein (AutoMount deaktivieren):
```bash
# Automount temporär deaktivieren (GNOME)
gsettings set org.gnome.desktop.media-handling automount false
```
### How-To: LibDriveIO einrichten
Die vollständige Anleitung zur Einrichtung und zu kompatiblen Laufwerken findet sich im offiziellen MakeMKV-Forum:
[:octicons-link-external-24: MakeMKV Forum LibDriveIO How-To](https://www.makemkv.com/forum/viewtopic.php?t=18856){ .md-button }
!!! tip "Prüfen ob LibDriveIO aktiv ist"
In der MakeMKV-Ausgabe erscheint beim Laufwerkszugriff `LibDriveIO` statt `LibMMMBD`, wenn der direkte Modus aktiv ist.
---
## MakeMKV-Lizenz
MakeMKV ist **Beta-Software** und kostenlos für den persönlichen Gebrauch während der Beta-Phase. Eine Beta-Lizenz ist regelmäßig im [MakeMKV-Forum](https://www.makemkv.com/forum/viewtopic.php?t=1053) verfügbar.
Ohne gültige Lizenz können Blu-rays nicht entschlüsselt werden.
### Lizenz eintragen
Die Lizenz wird in den MakeMKV-Einstellungen eingetragen (GUI) oder direkt in:
```
~/.MakeMKV/settings.conf
```
```
app_Key = "XXXX-XXXX-XXXX-XXXX-XXXX"
```
---
## Konfiguration in Ripster
| Einstellung | Beschreibung |
|------------|-------------|
| `makemkv_command` | Pfad/Befehl für `makemkvcon` |
| `makemkv_min_length_minutes` | Mindest-Titellänge (Standard: 15 Min) |
| `makemkv_backup_mode` | Backup-Modus statt MKV |
---
## Troubleshooting
### MakeMKV erkennt Disc nicht
```bash
# Laufwerk-Berechtigungen prüfen
ls -la /dev/sr0
sudo chmod a+rw /dev/sr0
# Oder Benutzer zur Gruppe cdrom hinzufügen
sudo usermod -a -G cdrom $USER
```
### Langer Analyseprozess
Blu-ray-Analyse kann bei Discs mit vielen Playlists 5+ Minuten dauern. Dies ist normal.
### Fehlermeldung: "LibMMBD"
LibMMBD ist MakeMKVs interne Verschlüsselungsbibliothek. Bei Fehlern die MakeMKV-Version aktualisieren.