ripster/docs/getting-started/prerequisites.md

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.

# 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{ .md-button }

HandBrake CLI

# 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{ .md-button }

MediaInfo

# 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.

# Laufwerk prüfen
ls /dev/sr*
# oder
lsblk | grep rom

---

OMDb API-Key

Ripster verwendet die OMDb API für Filmmetadaten.

1. Registriere dich kostenlos auf omdbapi.com
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 (~5 USD einmalig)
• User Key und API Token notieren

SSH-Zugang (Deployment)

Für Remote-Deployment via deploy-ripster.sh:

# 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