Erste Schritte DE

Erste Schritte

🌐 English · Deutsch

1. Ersteinrichtung (Setup-Token)

Beim allerersten Start existiert noch kein Admin-Konto. Die App generiert einen einmaligen Setup-Token (30 Minuten gültig) und gibt ihn im Terminal bzw. Docker-Log aus:

========================================================================
  ERSTEINRICHTUNG — Noch kein Admin-Konto vorhanden.
  Setup-Token: <token>
  Lokale Installation:
  Öffne http://localhost:<PORT>/setup?token=<token> im Browser.
  Docker Installation:
  Öffne http://<DockerHostIP>:<HostPort>/setup?token=<token> im Browser.
  Standardport ist 8080
  Der Token ist 30 Minuten gültig. Danach App neu starten.
========================================================================

Auf der Setup-Seite werden Benutzername, Passwort (min. 8 Zeichen) und UI-Sprache (Deutsch/Englisch) festgelegt. Der erste Benutzer ist automatisch Admin.

Alternative für Docker/Automation: Mit den Umgebungsvariablen MEDIAFORGE_WEB_ADMIN_USER und MEDIAFORGE_WEB_ADMIN_PASS wird das Admin-Konto beim ersten Start automatisch angelegt und die Setup-Seite übersprungen.

2. Grundeinstellungen prüfen

Unter Einstellungen (Zahnrad in der Sidebar, nur für Admins) sollten als Erstes gesetzt werden:

• Download-Pfad — Standard ist ~/Downloads
• Standard-Sprache — z. B. German Dub
• Standard-Provider — z. B. VOE

Alle Einstellungen werden in der Datenbank gespeichert; eine .env-Datei wird nicht mehr benötigt (Details: Konfiguration).

3. Erster Download

1. Auf der Startseite in die Suchleiste den Titel eingeben. Über die Quellen-Auswahl kann zwischen AniWorld (Anime), SerienStream (Serien), FilmPalast (Filme), MegaKino (Filme & Serien) und hanime (18+, standardmäßig aus) gewechselt werden.
2. Treffer anklicken — Staffeln und Episoden werden geladen.
3. Episoden auswählen, Sprache und Provider wählen, optional einen eigenen Zielpfad (Custom Path).
4. Download starten — der Auftrag landet in der Queue (Sidebar-Button „Queue“).

Die Queue verarbeitet einen Download nach dem anderen. Fortschritt, Geschwindigkeit und Fehler sind live in der Queue-Ansicht sichtbar (Download-System).

4. Captcha?

Manche Hoster zeigen gelegentlich ein Captcha. Die App öffnet dafür intern einen unsichtbaren Browser und blendet das Captcha direkt in der WebUI ein — es kann dort per Klick gelöst werden, der Download läuft danach automatisch weiter.

5. Was als Nächstes?

• AutoSync einrichten, damit neue Folgen automatisch geladen werden
• Benachrichtigungen aktivieren (Telegram, Discord, …)
• Integrationen mit Jellyfin/Plex oder Overseerr/Jellyseerr verbinden
• Die Bibliothek ansehen — inklusive In-Browser-Player