Konfiguration DE
🌐 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.
| 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) |
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).
Die fünf eingebauten Quellen — AniWorld (Anime), SerienStream (Serien), FilmPalast (Filme), MegaKino (Filme & Serien) und hanime (Erwachsene / 18+, standardmäßig aus) — 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).
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 SerienStream 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. MegaKino (Neu/Beliebt × Filme/Serien) und hanime (Neu/Trending) lassen sich genauso sortieren und ein-/ausschalten.
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,megakino,hanime |
Reihenfolge der Quellen-Blöcke auf der Startseite |
| Bereichsreihenfolge (AniWorld) | home_section_order_aniworld |
new,popular |
Ob Neu oder Beliebt zuerst kommt |
| Bereichsreihenfolge (SerienStream) | home_section_order_sto |
new,popular |
Ob Neu oder Beliebt zuerst kommt |
| Bereichsreihenfolge (MegaKino) | home_section_order_megakino |
new_movies,popular_movies,new_series,popular_series |
Reihenfolge der vier MegaKino-Bereiche |
| Bereichsreihenfolge (hanime) | home_section_order_hanime |
new,trending |
Reihenfolge der hanime-Bereiche |
| 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 (SerienStream) | source_show_new_sto |
1 |
Bereich „Neue Serien" ein-/ausblenden |
| Beliebt anzeigen (SerienStream) | source_show_popular_sto |
1 |
Bereich „Beliebte Serien" ein-/ausblenden |
| Neue Filme anzeigen (MegaKino) | source_show_new_movies_megakino |
1 |
MegaKino-Bereich „Neue Filme" ein-/ausblenden |
| Beliebte Filme anzeigen (MegaKino) | source_show_popular_movies_megakino |
1 |
MegaKino-Bereich „Beliebte Filme" ein-/ausblenden |
| Neue Serien anzeigen (MegaKino) | source_show_new_series_megakino |
1 |
MegaKino-Bereich „Neue Serien" ein-/ausblenden |
| Beliebte Serien anzeigen (MegaKino) | source_show_popular_series_megakino |
1 |
MegaKino-Bereich „Beliebte Serien" ein-/ausblenden |
| Neu anzeigen (hanime) | source_show_new_hanime |
1 |
hanime-Bereich „Neu" ein-/ausblenden |
| Trending anzeigen (hanime) | source_show_trending_hanime |
1 |
hanime-Bereich „Trending" ein-/ausblenden |
| AniWorld aktiv | source_enabled_aniworld |
1 |
AniWorld auf der Startseite anzeigen/laden |
| SerienStream aktiv | source_enabled_sto |
1 |
SerienStream auf der Startseite anzeigen/laden |
| FilmPalast aktiv | source_enabled_filmpalast |
1 |
FilmPalast auf der Startseite anzeigen/laden |
| MegaKino aktiv | source_enabled_megakino |
1 |
MegaKino auf der Startseite anzeigen/laden |
| hanime aktiv | source_enabled_hanime |
0 |
hanime (18+) anzeigen/laden — standardmäßig aus, Aktivierung erfordert Altersbestätigung |
| Deaktivierte aus Suche ausblenden | sources_hide_in_search |
0 |
Deaktivierte Quellen auch in Suchergebnissen überspringen |
| 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.
| 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.
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.
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 alle Quellen-Seiten (aniworld.to, serienstream.to, filmpalast.to, megakino.to, hanime.tv). Er prüft nicht nur die Erreichbarkeit, sondern ob die echte Seite antwortet: aufgelöste IPs werden mit ihrem CDN-Anbieter beschriftet (z. B. Cloudflare), und eine ISP-/CUII-Sperrseite wird als solche erkannt, statt als erreichbar zu gelten. Dieselbe Prüfung treibt das UpTime-Monitoring an.
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 |
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).
| 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 |
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.