Konfiguration DE

Konfiguration

🌐 English · Deutsch

Alle Einstellungen werden in der WebUI vorgenommen und in der SQLite-Datenbank gespeichert (app_settings-Tabelle). Eine .env-Datei wird nicht mehr benötigt.

Migration: Existiert noch ein altes ~/.aniworld/.env, werden dessen Werte beim ersten Start einmalig in die Datenbank importiert (vorhandene DB-Werte werden nicht überschrieben). Danach kann die Datei über Einstellungen → Legacy .env direkt aus der UI gelöscht werden.

Beim Start schreibt die App alle gespeicherten DB-Settings zusätzlich in die Prozess-Umgebung (ANIWORLD_*), sodass intern beide Wege identisch funktionieren. Umgebungsvariablen sind weiterhin nützlich für die Erstkonfiguration per Docker — von der UI gespeicherte Werte haben Vorrang.

Allgemeine Einstellungen (Settings-Seite, nur Admin)

Einstellung	DB-Key	Env-Variable	Standard	Beschreibung
Download-Pfad	download_path	ANIWORLD_DOWNLOAD_PATH	~/Downloads	Basisordner für alle Downloads
Sprachen-Trennung	lang_separation	ANIWORLD_LANG_SEPARATION	0	Pro Sprache ein Unterordner (german-dub, english-sub, …)
English Sub deaktivieren	disable_english_sub	ANIWORLD_DISABLE_ENGLISH_SUB	0	Blendet English Sub aus (relevant für „All Languages“-Sync)
FilmPalast-Unterordner	filmpalast_movie_subfolder	FILMPALAST_MOVIE_SUBFOLDER	0	Filme in eigenen Unterordner legen
Standard-Sprache	download_language	ANIWORLD_LANGUAGE	German Dub	Vorauswahl beim Download
Standard-Provider	download_provider	ANIWORLD_PROVIDER	VOE	Vorauswahl beim Download
Namensvorlage	naming_template	ANIWORLD_NAMING_TEMPLATE	siehe unten	Dateinamen-Schema
Web-Base-URL	web_base_url	ANIWORLD_WEB_BASE_URL	leer	Öffentliche URL hinter Reverse Proxy (aktiviert u. a. Secure-Cookies bei https://)
Medien-Statistik	media_stats_enabled	ANIWORLD_MEDIA_STATS_ENABLED	0	Fügt der Statistikseite eine Kategorie Media hinzu (Film-/Serien-/Episodenzahlen aus der Mediathek)
Debug-Modus	debug_mode	ANIWORLD_DEBUG_MODE	0	Ausführliches Logging — wirkt live, ohne Neustart (Ein und Aus). Beim Start mit --debug ist der Schalter fest aktiviert und ausgegraut (mit Hinweis).
Web-Konsole	web_console	ANIWORLD_WEB_CONSOLE	0	Zeigt eine schreibgeschützte, SSH-artige Konsole der Live-Ausgabe der App/FFmpeg direkt auf der Einstellungsseite (nur Admin)

Namensvorlage (Naming Template)

Standard:

{title} ({year}) [imdbid-{imdbid}]/Season {season}/{title} S{season}E{episode}.mkv

Verfügbare Platzhalter: {title}, {year}, {imdbid}, {season}, {episode}. Das Schema ist Jellyfin-/Plex-kompatibel (Ordner pro Serie, Season XX-Unterordner, SxxExx-Dateinamen).

AutoSync-Einstellungen

Einstellung	DB-Key	Standard	Werte
Sync-Intervall	sync_schedule	0 (aus)	1min, 30min, 1h, 2h, 4h, 8h, 12h, 16h, 24h
Zeitplan-Modus	sync_mode	interval	interval oder weekly (Wochenplan)
Wochentage (Wochenplan)	sync_days	0,1,2,3,4,5,6	Komma-Liste, 0=Mo … 6=So
Uhrzeiten (Wochenplan)	sync_times	06:00	Komma-Liste HH:MM, eine oder mehrere
Sync-Sprache	sync_language	German Dub	Alle Sprachen + All Languages
Sync-Provider	sync_provider	VOE	Aktive Provider
Pfad nicht erreichbar	sync_path_unavailable_action	skip	skip oder hold
Fehler-Wiederholungen	sync_error_retries	0	0–10
Wiederholungs-Abstand	sync_error_retry_time	5min	0min–5min
Adaptiver Auto-Sync	sync_adaptive_enabled	0	0 / 1
↳ Pausieren nach	sync_adaptive_pause_after	4w	2w–8w (Wochen ohne neue Episode)
↳ Erneut prüfen (Wert)	sync_adaptive_retry_value	2	2–12
↳ Erneut prüfen (Einheit)	sync_adaptive_retry_unit	days	days, weeks, months

Im Wochenplan-Modus ersetzen sync_days + sync_times das feste Intervall; ein Job läuft dann an den gewählten Wochentagen zu jeder gesetzten Uhrzeit (Nachhol-Lauf, falls die App zur Uhrzeit aus war). Details zur Funktionsweise: AutoSync.

Download-Verlauf

Einstellung	DB-Key	Standard	Werte
Aufbewahrung	history_retention_days	30	0 (unbegrenzt), 7, 30, 90, 180, 365 (Tage)

Verlaufseinträge, die älter als der gewählte Zeitraum sind, werden automatisch gelöscht (Bereinigung läuft etwa stündlich im Hintergrund). Details: Download-Verlauf.

Custom Paths (zusätzliche Download-Ziele)

Unter Einstellungen können benannte Zusatzpfade angelegt werden (z. B. ein NAS-Mount). Beim Download und bei AutoSync-Jobs kann dann pro Auftrag ein Custom Path gewählt werden. Pfade, die von Queue-Einträgen oder Sync-Jobs verwendet werden, lassen sich nicht löschen.

DNS-Einstellungen

Falls die Streaming-Seiten vom eigenen ISP-DNS blockiert werden, kann ein alternativer Resolver gewählt werden — wirkt sofort, ohne Neustart:

Modus	Server
system	Betriebssystem-DNS (Standard)
cloudflare	1.1.1.1 (DoH)
google	8.8.8.8 (DoH)
quad9	9.9.9.9 (DoH)
custom	Eigene Server-IP

Die Umstellung wirkt auf zwei Ebenen: HTTP-Anfragen der App nutzen DNS-over-HTTPS (niquests), und socket.getaddrinfo wird gepatcht, damit auch Subprozesse wie FFmpeg den gewählten Server verwenden. Ein eingebauter DNS-Test prüft die Erreichbarkeit von aniworld.to, s.to und filmpalast.to.

Syncplay

Konfiguriert einen Syncplay-Server für die Gemeinsam-ansehen-Funktion im Player (Web-UI → Wiedergabe & Streaming). Der Server betreibt pro Zuschauer einen echten Syncplay-Client, daher synchronisiert die Wiedergabe auch mit Desktop-Nutzern (mpv/VLC).

Einstellung	DB-Schlüssel	Env-Variable	Standard	Beschreibung
Serveradresse	syncplay_server	ANIWORLD_SYNCPLAY_SERVER	leer	Hostname des Syncplay-Servers (Funktion ist ausgeblendet, wenn leer)
Port	syncplay_port	ANIWORLD_SYNCPLAY_PORT	8999	Port des Syncplay-Servers
TLS verwenden	syncplay_tls	ANIWORLD_SYNCPLAY_TLS	0	Verbindung über TLS
Server-Passwort	syncplay_password	ANIWORLD_SYNCPLAY_PASSWORD	leer	Optionales Server-Passwort

Automatische Updates (Selbst-Update)

Unter Einstellungen → Updates kann sich die App selbst aktualisieren und den Release-Kanal wechseln. Der 24-h-Update-Check zeigt nur einen Hinweis; dies ist die eigentliche Installations-Seite.

Einstellung	DB-Schlüssel	Standard	Beschreibung
Auto-Update	auto_update_enabled	0	Verfügbares Update automatisch installieren
Wochentage	auto_update_days	0,1,2,3,4,5,6	Kommaliste, 0=Mo … 6=So
Uhrzeit	auto_update_time	03:00	HH:MM — wann die geplante Installation läuft

Wenn aktiviert, wird ein verfügbares Update automatisch zur gewählten Uhrzeit an den gewählten Wochentagen installiert; die App startet sich selbst neu, laufende Downloads werden danach fortgesetzt.

Release-Kanal (stabil ↔ dev): Du kannst zwischen der stabilen Version und dem dev-Kanal wechseln (neueste Commits aus dem models-Branch — kann instabil sein). Beim Wechsel wird die gewählte Version sofort installiert.

Welche Installationen können sich selbst aktualisieren: pip (Release & Dev) und pipx-Installationen unterstützen Selbst-Update und Kanalwechsel. Docker, eingefrorene (PyInstaller) und unbekannte Installationen können sich nicht selbst aktualisieren — die UI zeigt stattdessen einen Hinweis (Docker über dein Image/Compose aktualisieren, siehe Docker).

Watchdog (hängende Downloads)

Einstellung	DB-Key / Env	Standard	Beschreibung
Hard-Timeout	watchdog_hang_timeout / ANIWORLD_HANG_TIMEOUT	1800 s	Maximale Gesamtdauer eines Episoden-Downloads
Stall-Timeout	watchdog_stall_timeout / ANIWORLD_STALL_TIMEOUT	3600 s	Abbruch, wenn so lange kein Fortschritt

Nur per Umgebungsvariable

Einige Optionen existieren ausschließlich als Env-Variable (relevant v. a. für Docker):

Variable	Beschreibung
ANIWORLD_WEB_ADMIN_USER / ANIWORLD_WEB_ADMIN_PASS	Admin-Konto beim ersten Start automatisch anlegen
ANIWORLD_HTTPS	1 = Secure-Cookies erzwingen (hinter TLS-Proxy)
ANIWORLD_REDIS_URL	Redis als Storage für das Login-Rate-Limit (sonst In-Memory)
ANIWORLD_VAPID_PRIVATE_KEY / ANIWORLD_VAPID_PUBLIC_KEY / ANIWORLD_VAPID_CLAIMS_EMAIL	Eigene Web-Push-Schlüssel (sonst automatisch generiert)
ANIWORLD_INSTALL_FOLDER	Ablageort für automatisch geladene Binaries (Standard ~/.aniworld)

Weitere Einstellungsbereiche haben eigene Seiten: Authentifizierung (SSO/OIDC), Benachrichtigungen, Integrationen (Jellyfin/Plex/Seerr/MediaScan/CineInfo), Encoding und Anime4K-Upscaling.