Initial commit mit MkDocs-Dokumentation
This commit is contained in:
137
docs/tools/handbrake.md
Normal file
137
docs/tools/handbrake.md
Normal file
@@ -0,0 +1,137 @@
|
||||
# HandBrake
|
||||
|
||||
HandBrake encodiert die rohen MKV-Dateien in das gewünschte Format. Ripster nutzt `HandBrakeCLI`.
|
||||
|
||||
---
|
||||
|
||||
## Verwendeter Befehl
|
||||
|
||||
```bash
|
||||
HandBrakeCLI \
|
||||
--input "/mnt/raw/Film_t00.mkv" \
|
||||
--output "/mnt/movies/Film (2010).mkv" \
|
||||
--preset "H.265 MKV 1080p30" \
|
||||
--audio 1,2 \
|
||||
--aencoder copy:ac3,ffaac \
|
||||
--subtitle 1 \
|
||||
--subtitle-default 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Presets
|
||||
|
||||
HandBrake verwendet **Presets** für vorkonfigurierte Encoding-Einstellungen.
|
||||
|
||||
### Empfohlene Presets
|
||||
|
||||
| Preset | Codec | Auflösung | Für |
|
||||
|--------|-------|----------|-----|
|
||||
| `H.265 MKV 1080p30` | HEVC/H.265 | 1080p | Beste Qualität/Größe |
|
||||
| `H.265 MKV 720p30` | HEVC/H.265 | 720p | Kleinere Dateien |
|
||||
| `H.264 MKV 1080p30` | AVC/H.264 | 1080p | Breiteste Kompatibilität |
|
||||
| `HQ 1080p30 Surround` | HEVC/H.265 | 1080p | Hohe Qualität mit Surround |
|
||||
|
||||
### Alle Presets anzeigen
|
||||
|
||||
```bash
|
||||
HandBrakeCLI --preset-list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Audio-Encoding
|
||||
|
||||
### Copy-kompatible Codecs
|
||||
|
||||
HandBrake kann folgende Codecs direkt kopieren (kein Qualitätsverlust):
|
||||
|
||||
| Codec | `--aencoder` Wert |
|
||||
|-------|-----------------|
|
||||
| AC-3 | `copy:ac3` |
|
||||
| AAC | `copy:aac` |
|
||||
| MP3 | `copy:mp3` |
|
||||
| TrueHD | `copy:truehd` |
|
||||
| E-AC-3 | `copy:eac3` |
|
||||
|
||||
### Transcoding
|
||||
|
||||
Codecs die nicht kopiert werden können, werden zu AAC transcodiert:
|
||||
|
||||
| Original | Transcodiert zu |
|
||||
|---------|----------------|
|
||||
| DTS | AAC (`ffaac`) |
|
||||
| DTS-HD | AAC (`ffaac`) |
|
||||
|
||||
---
|
||||
|
||||
## Extra-Argumente
|
||||
|
||||
Über die Einstellung `handbrake_extra_args` können beliebige HandBrake-Argumente hinzugefügt werden:
|
||||
|
||||
```
|
||||
# Cropping deaktivieren
|
||||
--crop 0:0:0:0
|
||||
|
||||
# Loose Anamorphic
|
||||
--loose-anamorphic
|
||||
|
||||
# Bestimmte Qualität setzen
|
||||
--quality 20
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fortschritts-Parsing
|
||||
|
||||
Ripster parst die HandBrake-Ausgabe auf stderr für die Fortschrittsanzeige:
|
||||
|
||||
```
|
||||
Encoding: task 1 of 1, 73.50 % (45.23 fps, avg 44.12 fps, ETA 00h12m34s)
|
||||
```
|
||||
|
||||
`progressParsers.js` extrahiert:
|
||||
- Prozentzahl
|
||||
- Aktuelle FPS
|
||||
- ETA
|
||||
|
||||
---
|
||||
|
||||
## Konfiguration in Ripster
|
||||
|
||||
| Einstellung | Beschreibung |
|
||||
|------------|-------------|
|
||||
| `handbrake_command` | Pfad/Befehl für `HandBrakeCLI` |
|
||||
| `handbrake_preset` | Preset-Name |
|
||||
| `handbrake_extra_args` | Zusätzliche CLI-Argumente |
|
||||
| `output_extension` | Dateiendung der Ausgabe |
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### HandBrake findet Preset nicht
|
||||
|
||||
```bash
|
||||
# Preset-Liste anzeigen
|
||||
HandBrakeCLI --preset-list 2>&1 | grep -i "h.265"
|
||||
```
|
||||
|
||||
Preset-Namen sind case-sensitive!
|
||||
|
||||
### Encoding sehr langsam
|
||||
|
||||
```bash
|
||||
# CPU-Encoding-Preset anpassen (schneller = schlechtere Qualität)
|
||||
handbrake_extra_args = --encoder-preset fast
|
||||
```
|
||||
|
||||
Verfügbare Presets: `ultrafast`, `superfast`, `veryfast`, `faster`, `fast`, `medium`, `slow`, `slower`, `veryslow`
|
||||
|
||||
### GPU-Encoding nutzen (NVIDIA)
|
||||
|
||||
```
|
||||
handbrake_preset = H.265 NVENC 1080p
|
||||
```
|
||||
|
||||
Erfordert HandBrake-Build mit NVENC-Unterstützung und NVIDIA-GPU.
|
||||
31
docs/tools/index.md
Normal file
31
docs/tools/index.md
Normal file
@@ -0,0 +1,31 @@
|
||||
# Externe Tools
|
||||
|
||||
Ripster ist ein **Orchestrator** – die eigentliche Arbeit erledigen diese bewährten Open-Source-Tools:
|
||||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- :material-disc: **MakeMKV**
|
||||
|
||||
---
|
||||
|
||||
Disc-Analyse und Ripping. Erstellt MKV-Dateien oder vollständige Backups.
|
||||
|
||||
[:octicons-arrow-right-24: MakeMKV](makemkv.md)
|
||||
|
||||
- :material-film: **HandBrake**
|
||||
|
||||
---
|
||||
|
||||
Video-Encoding mit umfangreichen Preset-Optionen.
|
||||
|
||||
[:octicons-arrow-right-24: HandBrake](handbrake.md)
|
||||
|
||||
- :material-information: **MediaInfo**
|
||||
|
||||
---
|
||||
|
||||
Analyse von Track-Informationen in Mediendateien.
|
||||
|
||||
[:octicons-arrow-right-24: MediaInfo](mediainfo.md)
|
||||
|
||||
</div>
|
||||
118
docs/tools/makemkv.md
Normal file
118
docs/tools/makemkv.md
Normal file
@@ -0,0 +1,118 @@
|
||||
# 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.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
108
docs/tools/mediainfo.md
Normal file
108
docs/tools/mediainfo.md
Normal file
@@ -0,0 +1,108 @@
|
||||
# MediaInfo
|
||||
|
||||
MediaInfo analysiert die Track-Struktur von Mediendateien. Ripster nutzt es nach dem Ripping um Audio- und Untertitelspuren zu identifizieren.
|
||||
|
||||
---
|
||||
|
||||
## Verwendeter Befehl
|
||||
|
||||
```bash
|
||||
mediainfo --Output=JSON /path/to/raw/film.mkv
|
||||
```
|
||||
|
||||
Gibt vollständige Track-Informationen als JSON zurück.
|
||||
|
||||
---
|
||||
|
||||
## Ausgabe-Struktur
|
||||
|
||||
```json
|
||||
{
|
||||
"media": {
|
||||
"track": [
|
||||
{
|
||||
"@type": "General",
|
||||
"Duration": "8885.042",
|
||||
"Format": "Matroska"
|
||||
},
|
||||
{
|
||||
"@type": "Video",
|
||||
"Format": "HEVC",
|
||||
"Width": "1920",
|
||||
"Height": "1080",
|
||||
"FrameRate": "23.976"
|
||||
},
|
||||
{
|
||||
"@type": "Audio",
|
||||
"StreamOrder": "1",
|
||||
"Format": "TrueHD",
|
||||
"Channels": "8",
|
||||
"Language": "en"
|
||||
},
|
||||
{
|
||||
"@type": "Audio",
|
||||
"StreamOrder": "2",
|
||||
"Format": "AC-3",
|
||||
"Channels": "6",
|
||||
"Language": "de"
|
||||
},
|
||||
{
|
||||
"@type": "Text",
|
||||
"StreamOrder": "1",
|
||||
"Format": "UTF-8",
|
||||
"Language": "de"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Verarbeitung in Ripster
|
||||
|
||||
`encodePlan.js` verarbeitet die MediaInfo-Ausgabe:
|
||||
|
||||
1. **Track-Extraktion**: Alle Audio- und Untertitel-Tracks werden extrahiert
|
||||
2. **Sprach-Normalisierung**: Sprachcodes werden auf ISO 639-3 normalisiert
|
||||
3. **Codec-Klassifizierung**: Bestimmt ob Codec kopiert oder transcodiert werden kann
|
||||
4. **Track-Labels**: Benutzerfreundliche Bezeichnungen (z.B. "Deutsch (AC-3, 5.1)")
|
||||
|
||||
### Track-Label-Format
|
||||
|
||||
```
|
||||
{Sprache} ({Format}, {Kanäle})
|
||||
```
|
||||
|
||||
Beispiele:
|
||||
- `Deutsch (AC-3, 5.1)`
|
||||
- `English (TrueHD, 7.1)`
|
||||
- `Français (AC-3, 2.0)`
|
||||
|
||||
---
|
||||
|
||||
## Konfiguration in Ripster
|
||||
|
||||
| Einstellung | Beschreibung |
|
||||
|------------|-------------|
|
||||
| `mediainfo_command` | Pfad/Befehl für `mediainfo` |
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### MediaInfo gibt kein JSON aus
|
||||
|
||||
```bash
|
||||
# Version prüfen
|
||||
mediainfo --Version
|
||||
|
||||
# JSON-Ausgabe testen
|
||||
mediainfo --Output=JSON /path/to/test.mkv
|
||||
```
|
||||
|
||||
MediaInfo >= 17.10 wird empfohlen.
|
||||
|
||||
### Sprache als "und" angezeigt
|
||||
|
||||
`und` steht für "undetermined" – die Sprache ist in der MKV-Datei nicht getaggt. Dies ist bei manchen Rips normal. Der Track wird trotzdem angezeigt und kann manuell ausgewählt werden.
|
||||
Reference in New Issue
Block a user