159 lines
3.3 KiB
Markdown
159 lines
3.3 KiB
Markdown
# Voraussetzungen
|
||
|
||
Bevor du Ripster installierst, stelle sicher, dass folgende Software auf deinem System verfügbar ist.
|
||
|
||
---
|
||
|
||
## System-Anforderungen
|
||
|
||
| Anforderung | Mindestversion | Empfohlen |
|
||
|------------|----------------|-----------|
|
||
| **Betriebssystem** | Linux / macOS | Ubuntu 22.04+ |
|
||
| **Node.js** | 20.19.0 | 20.x LTS |
|
||
| **RAM** | 4 GB | 8 GB+ |
|
||
| **Festplatte** | 50 GB frei | 500 GB+ (für Roh-MKVs) |
|
||
|
||
---
|
||
|
||
## Node.js
|
||
|
||
Ripster benötigt **Node.js >= 20.19.0**.
|
||
|
||
=== "nvm (empfohlen)"
|
||
|
||
```bash
|
||
# nvm installieren
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
|
||
|
||
# Node.js 20 installieren
|
||
nvm install 20
|
||
nvm use 20
|
||
|
||
# Version prüfen
|
||
node --version # v20.x.x
|
||
```
|
||
|
||
=== "Ubuntu/Debian"
|
||
|
||
```bash
|
||
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
|
||
sudo apt-get install -y nodejs
|
||
|
||
node --version # v20.x.x
|
||
```
|
||
|
||
=== "macOS (Homebrew)"
|
||
|
||
```bash
|
||
brew install node@20
|
||
node --version # v20.x.x
|
||
```
|
||
|
||
---
|
||
|
||
## Externe Tools
|
||
|
||
### MakeMKV
|
||
|
||
!!! warning "Lizenz erforderlich"
|
||
MakeMKV ist für den persönlichen Gebrauch kostenlos (Beta-Lizenz), benötigt aber eine gültige Lizenz.
|
||
|
||
```bash
|
||
# Ubuntu/Debian - PPA verwenden
|
||
sudo add-apt-repository ppa:heyarje/makemkv-beta
|
||
sudo apt-get update
|
||
sudo apt-get install makemkv-bin makemkv-oss
|
||
|
||
# Installierte Version prüfen
|
||
makemkvcon --version
|
||
```
|
||
|
||
[:octicons-link-external-24: MakeMKV Download](https://www.makemkv.com/download/){ .md-button }
|
||
|
||
### HandBrake CLI
|
||
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo add-apt-repository ppa:stebbins/handbrake-releases
|
||
sudo apt-get update
|
||
sudo apt-get install handbrake-cli
|
||
|
||
# Version prüfen
|
||
HandBrakeCLI --version
|
||
|
||
# macOS
|
||
brew install handbrake
|
||
```
|
||
|
||
[:octicons-link-external-24: HandBrake Download](https://handbrake.fr/downloads2.php){ .md-button }
|
||
|
||
### MediaInfo
|
||
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo apt-get install mediainfo
|
||
|
||
# macOS
|
||
brew install mediainfo
|
||
|
||
# Version prüfen
|
||
mediainfo --Version
|
||
```
|
||
|
||
---
|
||
|
||
## Disc-Laufwerk
|
||
|
||
Ripster benötigt ein physisches **DVD- oder Blu-ray-Laufwerk**.
|
||
|
||
!!! info "Blu-ray unter Linux"
|
||
Für Blu-ray-Ripping unter Linux wird zusätzlich `libaacs` benötigt. MakeMKV bringt jedoch eine eigene Entschlüsselung mit, daher ist dies in den meisten Fällen nicht erforderlich.
|
||
|
||
```bash
|
||
# Laufwerk prüfen
|
||
ls /dev/sr*
|
||
# oder
|
||
lsblk | grep rom
|
||
```
|
||
|
||
---
|
||
|
||
## OMDb API-Key
|
||
|
||
Ripster verwendet die [OMDb API](https://www.omdbapi.com/) für Filmmetadaten.
|
||
|
||
1. Registriere dich kostenlos auf [omdbapi.com](https://www.omdbapi.com/apikey.aspx)
|
||
2. Bestätige deine E-Mail-Adresse
|
||
3. Notiere deinen API-Key – du gibst ihn später in den Einstellungen ein
|
||
|
||
---
|
||
|
||
## Optionale Voraussetzungen
|
||
|
||
### PushOver (Benachrichtigungen)
|
||
|
||
Für mobile Push-Benachrichtigungen bei Fertigstellung oder Fehlern:
|
||
|
||
- App kaufen auf [pushover.net](https://pushover.net) (~5 USD einmalig)
|
||
- **User Key** und **API Token** notieren
|
||
|
||
### SSH-Zugang (Deployment)
|
||
|
||
Für Remote-Deployment via `deploy-ripster.sh`:
|
||
|
||
```bash
|
||
# sshpass installieren
|
||
sudo apt-get install sshpass
|
||
```
|
||
|
||
---
|
||
|
||
## Checkliste
|
||
|
||
- [ ] Node.js >= 20.19.0 installiert (`node --version`)
|
||
- [ ] `makemkvcon` installiert (`makemkvcon --version`)
|
||
- [ ] `HandBrakeCLI` installiert (`HandBrakeCLI --version`)
|
||
- [ ] `mediainfo` installiert (`mediainfo --Version`)
|
||
- [ ] DVD/Blu-ray Laufwerk vorhanden (`ls /dev/sr*`)
|
||
- [ ] OMDb API-Key beschafft
|