Dream4K IPTV Manager

Dokumentation & Benutzerhandbuch

Quick Start

1

Account hinzufügen

Gehe zu Accounts und füge deine Xtream Codes Zugangsdaten hinzu

2

Playlist erstellen

Gehe zu Playlists und erstelle deine erste Playlist

3

Kanäle hinzufügen

Gehe zu Channels, lade Kanäle und ziehe sie in deine Playlist

4

M3U-URL kopieren

Kopiere die M3U-URL und füge sie in deinen IPTV-Player ein

Features

Account-Verwaltung

Mehrere Xtream Codes Accounts verwalten

Benutzerdefinierte Playlists

Eigene Playlists mit Drag & Drop erstellen

Live-Suche

Echtzeit-Filterung in Kanälen

Automatische Updates

Konfigurierbare Update-Intervalle

M3U Export

Dynamische Playlists als URL

HDHomeRun Emulation

Kompatibel mit Plex, Emby, Jellyfin

Account-Verwaltung

Account hinzufügen

  1. Navigiere zu Accounts
  2. Klicke auf "Account hinzufügen"
  3. Gib die Xtream Codes Zugangsdaten ein:
    • Name (z.B. "Mein IPTV")
    • Base URL (z.B. "http://example.com:8080")
    • Username
    • Password
    • Output Format (TS oder M3U8)
  4. Klicke auf "Speichern"
  5. Optional: Klicke auf "Test" um die Verbindung zu prüfen

Die Kanäle werden automatisch im Hintergrund geladen. Dies kann einige Minuten dauern.

Playlist-Verwaltung

1. Neue Playlist erstellen

  1. Navigiere zu Playlists
  2. Klicke auf "Neue Playlist"
  3. Gib einen Namen ein (z.B. "Sport HD")
  4. Optional: Füge eine Beschreibung hinzu
  5. Klicke auf "Erstellen"

2. Kanäle zur Playlist hinzufügen

  1. Klicke bei der Playlist auf "Bearbeiten"
  2. Wähle einen Account aus
  3. Die Kategorien werden automatisch geladen
  4. Wähle eine Kategorie (optional)
  5. Klicke auf "Channels laden"
  6. Nutze die Live-Suche um Kanäle zu filtern
  7. Füge Kanäle zur Playlist hinzu:
    • Drag & Drop: Ziehe Kanäle von links nach rechts
    • Plus-Button: Klicke auf das grüne [+] Icon

3. Playlist bearbeiten

  • Sortieren: Ziehe Kanäle in der Playlist nach oben/unten
  • Umbenennen: Klicke auf [✏️] um Namen/Logo zu ändern
  • Entfernen: Klicke auf [❌] um Kanal zu entfernen

4. Playlist exportieren

  1. Gehe zurück zu Playlists
  2. Kopiere die M3U-URL mit dem [📋] Button
  3. Füge die URL in deinen IPTV-Player ein

Kanal-Verwaltung

Filter verwenden

  • Account auswählen: Kategorien werden automatisch geladen
  • Kategorie filtern: Nur verfügbar wenn Account gewählt
  • API-Suche: Sucht in der Datenbank
  • Live-Suche: Filtert geladene Kanäle in Echtzeit
  • Sortierung: Nach Name oder Kategorie

Tipp: Nutze die Live-Suche um schnell bestimmte Kanäle zu finden (z.B. "HD", "4K", "Sport")

URLs & Export

M3U Playlists

Benutzerdefinierte Playlist:

http://localhost:8000/playlist/custom/{playlist_id}.m3u

Ersetze {playlist_id} mit der ID deiner Playlist (z.B. 1, 2, 3...)

Alle Kanäle:

http://localhost:8000/playlist.m3u

Bestimmter Account:

http://localhost:8000/playlist/{account_id}.m3u

EPG XML

EPG für Playlist (empfohlen):

http://localhost:8000/epg/playlist/{playlist_id}.xml

Nur EPG-Daten für Kanäle in der Playlist - kleinere Datei, schnelleres Laden

EPG für alle Accounts:

http://localhost:8000/epg.xml

Verwende diese URL in deinem IPTV-Player für Programminformationen

EPG für bestimmten Account:

http://localhost:8000/epg/{account_id}.xml

HDHomeRun (für Plex, Emby, Jellyfin)

Benutzerdefinierte Playlist:

http://localhost:8000/playlist/{playlist_id}/discover.json

Nur Kanäle aus dieser Playlist in der richtigen Reihenfolge

Alle Kanäle:

http://localhost:8000/discover.json

Alle Kanäle aus allen Accounts

Tipps & Tricks

Effiziente Playlist-Erstellung

  • • Kategorien nutzen um Kanäle zu reduzieren
  • • Live-Suche für schnelles Finden
  • • Drag & Drop für mehrere Kanäle

Mehrere Playlists

  • • Sport-Playlist für Live-Events
  • • Filme-Playlist für Filmabende
  • • Favoriten für meistgesehene Kanäle

IPTV-Player Empfehlungen

Desktop

  • • VLC Media Player
  • • Kodi (PVR IPTV Simple)
  • • Perfect Player

Mobile

  • • IPTV Smarters Pro (iOS/Android)
  • • GSE Smart IPTV (iOS/Android)
  • • TiviMate (Android - Premium empfohlen)

Smart TV

  • • Plex (HDHomeRun)
  • • Emby (HDHomeRun)
  • • Jellyfin (HDHomeRun)

Setup-Anleitungen

TiviMate (Android)

  1. Öffne TiviMate und gehe zu Settings → Playlists
  2. Klicke auf "Add Playlist"
  3. Wähle "URL" als Quelle
  4. Gib die M3U-URL ein: http://deine-ip:8000/playlist/custom/1.m3u
  5. Gib einen Namen ein (z.B. "Meine Playlist")
  6. Klicke auf "Next"
  7. Füge die EPG-URL hinzu: http://deine-ip:8000/epg.xml
  8. Klicke auf "Next" und dann "Done"

Tipp: Ersetze "localhost" mit der IP-Adresse deines Servers (z.B. 192.168.1.100)

Plex (HDHomeRun)

  1. Gehe zu Playlists und kopiere die HDHomeRun URL
  2. Öffne Plex und gehe zu Settings → Live TV & DVR
  3. Klicke auf "Set Up Plex DVR"
  4. Plex sollte automatisch das HDHomeRun-Gerät finden
  5. Falls nicht, gib die URL manuell ein: http://deine-ip:8000/playlist/1
  6. Wähle das Gerät aus und klicke auf "Continue"
  7. Wähle dein Land und klicke auf "Continue"
  8. Plex lädt die Kanäle aus deiner Playlist automatisch
  9. Klicke auf "Continue" und dann "Done"

Hinweis: Jede Playlist hat ihre eigene HDHomeRun URL. Die Kanäle werden in der Reihenfolge deiner Playlist angezeigt.

VLC Media Player

  1. Öffne VLC Media Player
  2. Gehe zu Medien → Netzwerkstream öffnen
  3. Gib die M3U-URL ein: http://localhost:8000/playlist/custom/1.m3u
  4. Klicke auf "Wiedergabe"
  5. Die Playlist wird in der Wiedergabeliste angezeigt

Hinweis: VLC unterstützt kein EPG. Für EPG nutze einen dedizierten IPTV-Player.

EPG-Verwaltung (Intelligentes Mapping)

Neu! Automatisches EPG-Mapping mit Fuzzy-Matching für bessere EPG-Abdeckung

Was ist EPG-Mapping?

EPG (Electronic Program Guide) zeigt das TV-Programm in deinem IPTV-Player an. Oft fehlen EPG-IDs oder sind falsch zugeordnet. Das intelligente EPG-Mapping löst dieses Problem automatisch.

Automatisches Bulk-Mapping

  1. Gehe zu EPG-Verwaltung
  2. Wähle einen Account im EPG-Abdeckung Tab
  3. Prüfe die Statistiken (z.B. "1.452 sichtbar / 26.951 gesamt")
  4. Klicke auf "Automatisches Bulk-Mapping starten"
  5. Das System matched automatisch alle Channels mit EPG-Daten

Ergebnis: Channels werden automatisch mit passenden EPG-IDs verknüpft (Confidence-Score: 70-100%)

Manuelle EPG-Zuordnung

  1. Gehe zu Channels
  2. Bearbeite einen Channel (Stift-Icon in der Playlist)
  3. Klicke bei EPG-ID auf den "Vorschläge" Button
  4. Wähle aus den Top-10 Vorschlägen (sortiert nach Ähnlichkeit)
  5. Speichere die Änderungen

Farbcodierung: Grün (>80%), Gelb (60-80%), Grau (<60%)

Wie funktioniert Fuzzy-Matching?

Beispiel 1: ARD HD

  • Channel-Name: "ARD HD"
  • Normalisiert zu: "ard" (HD entfernt)
  • Matched mit EPG: "Das Erste HD" → 95% Ähnlichkeit

Beispiel 2: Sky Sport 1 FHD

  • Channel-Name: "Sky Sport 1 FHD"
  • Normalisiert zu: "sky sport 1" (FHD entfernt)
  • Matched mit EPG: "Sky Sport 1 HD" → 98% Ähnlichkeit

EPG-Quellen verwalten

Du kannst externe EPG-Quellen hinzufügen (z.B. XMLTV-Datenbanken):

  1. Gehe zu EPG-Verwaltung
  2. Wechsle zum EPG-Quellen Tab
  3. Klicke auf "EPG-Quelle hinzufügen"
  4. Gib Name, URL und Priorität ein
  5. Höhere Priorität = wird zuerst verwendet

Verfügbare EPG-Channels durchsuchen

Sieh alle verfügbaren EPG-Channels aus deinen Accounts:

  1. Gehe zu EPG-Verwaltung
  2. Wechsle zum Verfügbare EPG-Channels Tab
  3. Wähle einen Account oder "Alle Accounts"
  4. Nutze die Suche um bestimmte EPG-Channels zu finden

Tipp: Führe Bulk-Mapping nach jedem Account-Update durch, um neue Channels automatisch zu mappen!

Support & Hilfe

Bei Fragen oder Problemen kannst du:

  • Die Dokumentation durchlesen
  • Die Einstellungen überprüfen
  • Die Logs in der Konsole ansehen