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 ~/.mediaforge/.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 (MEDIAFORGE_*), 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	MEDIAFORGE_DOWNLOAD_PATH	~/Downloads	Basisordner für alle Downloads
Sprachen-Trennung	lang_separation	MEDIAFORGE_LANG_SEPARATION	0	Pro Sprache ein Unterordner (german-dub, english-sub, …)
English Sub deaktivieren	disable_english_sub	MEDIAFORGE_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	MEDIAFORGE_LANGUAGE	German Dub	Vorauswahl beim Download
Standard-Provider	download_provider	MEDIAFORGE_PROVIDER	VOE	Vorauswahl beim Download
Namensvorlage	naming_template	MEDIAFORGE_NAMING_TEMPLATE	siehe unten	Dateinamen-Schema
Web-Base-URL	web_base_url	MEDIAFORGE_WEB_BASE_URL	leer	Öffentliche URL hinter Reverse Proxy (aktiviert u. a. Secure-Cookies bei https://)
Medien-Statistik	media_stats_enabled	MEDIAFORGE_MEDIA_STATS_ENABLED	0	Fügt der Statistikseite eine Kategorie Media hinzu (Film-/Serien-/Episodenzahlen aus der Mediathek)
Debug-Modus	debug_mode	MEDIAFORGE_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	MEDIAFORGE_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).

Quellen (Startseite & Suche)

Die drei eingebauten Quellen — AniWorld (Anime), S.TO (Serien) und FilmPalast (Filme) — lassen sich auf der Settings-Seite sortieren und ein-/ausschalten. Alle Optionen werden global in der Datenbank gespeichert und sind nur für Admins verfügbar. Sie haben keine Umgebungsvariable (nur DB).

Reihenfolge & Bereiche (Einstellungen → Design)

Unter Einstellungen → Design → Reihenfolge der Quellen legst du fest, in welcher Reihenfolge die Quellen auf der Startseite erscheinen — entweder per Ziehen der Zeilen oder über die Hoch/Runter-Pfeile. Für AniWorld und S.TO kannst du zusätzlich:

• die Bereiche Neu und Beliebt unabhängig voneinander ein- oder ausschalten und
• wählen, ob Neu oder Beliebt zuerst angezeigt wird.

Sind beide Bereiche einer Quelle ausgeschaltet, wird ihr gesamter Block auf der Startseite ausgeblendet.

Quellen aktivieren / deaktivieren (Einstellungen → Quellen)

Im Tab Quellen schaltest du jede Quelle einzeln an oder aus. Eine deaktivierte Quelle wird auf der Startseite nicht mehr geladen oder angezeigt. Die Option „Deaktivierte Quellen auch aus den Suchergebnissen ausblenden" entfernt deaktivierte Quellen zusätzlich aus der Suche.

Einstellung	DB-Key	Standard	Beschreibung
Reihenfolge der Quellen	home_source_order	aniworld,sto,filmpalast	Reihenfolge der Quellen-Blöcke auf der Startseite
Bereichsreihenfolge (AniWorld)	home_section_order_aniworld	new,popular	Ob Neu oder Beliebt zuerst kommt
Bereichsreihenfolge (S.TO)	home_section_order_sto	new,popular	Ob Neu oder Beliebt zuerst kommt
Neu anzeigen (AniWorld)	source_show_new_aniworld	1	Bereich „Neue Animes" ein-/ausblenden
Beliebt anzeigen (AniWorld)	source_show_popular_aniworld	1	Bereich „Beliebte Animes" ein-/ausblenden
Neu anzeigen (S.TO)	source_show_new_sto	1	Bereich „Neue Serien" ein-/ausblenden
Beliebt anzeigen (S.TO)	source_show_popular_sto	1	Bereich „Beliebte Serien" ein-/ausblenden
AniWorld aktiv	source_enabled_aniworld	1	AniWorld auf der Startseite anzeigen/laden
S.TO aktiv	source_enabled_sto	1	S.TO auf der Startseite anzeigen/laden
FilmPalast aktiv	source_enabled_filmpalast	1	FilmPalast auf der Startseite anzeigen/laden
Deaktivierte aus Suche ausblenden	sources_hide_in_search	0	Deaktivierte Quellen auch in Suchergebnissen überspringen

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	MEDIAFORGE_SYNCPLAY_SERVER	leer	Hostname des Syncplay-Servers (Funktion ist ausgeblendet, wenn leer)
Port	syncplay_port	MEDIAFORGE_SYNCPLAY_PORT	8999	Port des Syncplay-Servers
TLS verwenden	syncplay_tls	MEDIAFORGE_SYNCPLAY_TLS	0	Verbindung über TLS
Server-Passwort	syncplay_password	MEDIAFORGE_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 / MEDIAFORGE_HANG_TIMEOUT	1800 s	Maximale Gesamtdauer eines Episoden-Downloads
Stall-Timeout	watchdog_stall_timeout / MEDIAFORGE_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
MEDIAFORGE_WEB_ADMIN_USER / MEDIAFORGE_WEB_ADMIN_PASS	Admin-Konto beim ersten Start automatisch anlegen
MEDIAFORGE_HTTPS	1 = Secure-Cookies erzwingen (hinter TLS-Proxy)
MEDIAFORGE_REDIS_URL	Redis als Storage für das Login-Rate-Limit (sonst In-Memory)
MEDIAFORGE_VAPID_PRIVATE_KEY / MEDIAFORGE_VAPID_PUBLIC_KEY / MEDIAFORGE_VAPID_CLAIMS_EMAIL	Eigene Web-Push-Schlüssel (sonst automatisch generiert)
MEDIAFORGE_INSTALL_FOLDER	Ablageort für automatisch geladene Binaries (Standard ~/.mediaforge)

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