Initial commit mit MkDocs-Dokumentation

2026-03-04 14:18:33 +00:00
parent 6115090da1
commit 31d3e36597
97 changed files with 27518 additions and 1 deletions
--- a/docs/getting-started/prerequisites.md
+++ b/docs/getting-started/prerequisites.md
@@ -0,0 +1,158 @@
+# 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