Installation DE

Installation

🌐 English · Deutsch

Voraussetzungen

Komponente	Anforderung
Python	≥ 3.9
FFmpeg	Muss installiert und im PATH verfügbar sein
Betriebssystem	Windows, macOS, Linux (oder Docker)

FFmpeg ist zwingend erforderlich — ohne FFmpeg funktionieren Downloads nicht. Unter Windows lädt die App mpv.exe bei Bedarf automatisch herunter; FFmpeg kann z. B. über winget install Gyan.FFmpeg installiert werden.

Beim ersten Start lädt die App außerdem automatisch einen Patchright-Chromium-Browser herunter. Dieser wird für das Lösen von Captchas benötigt (siehe Download-System).

Python installieren

Falls python --version keine Version 3.9 oder neuer anzeigt, zuerst Python installieren:

• Windows: winget install Python.Python.3.12 — oder von python.org herunterladen und im Installer „Add python.exe to PATH“ anhaken.
• macOS: brew install python (über Homebrew) oder der Installer von python.org.
• Linux: über den Paketmanager, z. B. sudo apt install python3 python3-pip (Debian/Ubuntu), sudo dnf install python3 python3-pip (Fedora) oder sudo pacman -S python python-pip (Arch).

Überprüfen:

python --version    # oder: python3 --version
pip --version       # oder: pip3 --version

Wird python unter Windows direkt nach der Installation „nicht gefunden“, das Terminal schließen und neu öffnen, damit der aktualisierte PATH geladen wird. Unter macOS/Linux ggf. python3 / pip3 verwenden.

Installation über pip (empfohlen)

# Letztes stabiles Release
pip install mrx-aniworld

# Update auf die neueste Version
pip install --upgrade mrx-aniworld

Entwicklungsversion (models-Branch)

pip install --upgrade "mrx-aniworld @ git+https://github.com/TheMRX13/MRX-AniWorld-Downloader.git@models"

Dev-Installationen zeigen in der UI eine Version wie 2.5.3-dev+abc1234 (Basisversion + Commit-Hash). Der eingebaute Update-Checker vergleicht bei Dev-Installationen den Commit-Hash mit dem neuesten Commit des models-Branches, bei Release-Installationen die Versionsnummer mit dem neuesten GitHub-Release.

Starten

# Standard: WebUI auf http://localhost:8080, Browser öffnet automatisch
aniworld

# Eigener Port
aniworld -wP 9090

# Für LAN, Docker oder Reverse Proxy auf allen Interfaces lauschen
aniworld -wH 0.0.0.0

# Kombiniert
aniworld -wH 0.0.0.0 -wP 9090

Alle Start-Parameter

Flag	Beschreibung
-wP / --web-port	Port der Web-UI (Standard: 8080)
-wH / --web-host	Host/IP zum Binden (Standard: 127.0.0.1)
-wN / --no-browser	Browser beim Start nicht automatisch öffnen
-d / --debug	Debug-Logging aktivieren

Mehr gibt es nicht — alle weiteren Einstellungen werden in der WebUI vorgenommen (Konfiguration).

Hinweis zur Sicherheit: Wird ein anderer Host als 127.0.0.1 gebunden, ist die UI aus dem Netzwerk erreichbar. Die Authentifizierung ist standardmäßig aktiv; trotzdem sollte die Instanz nicht ungeschützt ins Internet exponiert werden (Authentifizierung).

Docker

Für Container-Deployment siehe die eigene Seite Docker.

Datenverzeichnis

Alle Konfigurationsdaten, die SQLite-Datenbank und Hilfsdateien liegen unter ~/.aniworld/:

Datei	Zweck
aniworld.db	SQLite-Datenbank (Settings, Queue, Benutzer, …)
.flask_secret	Geheimer Schlüssel für Sessions & Settings-Verschlüsselung
aniworld.pid	Instanz-Lock (Warnung bei Doppelstart)
vapid_keys.json	Automatisch erzeugte Web-Push-Schlüssel
keyword_ids.json	TMDB-Keyword-Export (nur bei aktivierter erweiterter Suche)

Nächster Schritt

→ Erste Schritte: Setup-Token, Admin-Konto und der erste Download.