# Voraussetzungen - Ripster
Halbautomatische Disc-Ripping-Plattform für DVDs & Blu-rays mit HandBrake-Encoding
Author: Michael

Zum Inhalt

# 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)Ubuntu/DebianmacOS (Homebrew)

    # 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

    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
    sudo apt-get install -y nodejs

    node --version  # v20.x.x

    brew install node@20
    node --version  # v20.x.x

## Externe Tools

### MakeMKV

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

MakeMKV Download

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

HandBrake Download

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

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