speedyhome/iptv-proxy repository overview

⁠IPTV-Proxy

Senderliste, EPG und Mediathek aus dem eigenen Xtream-Codes-Zugang für Emby⁠ und andere Media-Server. Die App liest die Sender deines Anbieters ein, filtert und sortiert sie und stellt sie im Heimnetz bereit. Die Bedienung erfolgt über eine deutschsprachige Weboberfläche.

Die App enthält keine Sender, Streams, Zugänge oder sonstigen Inhalte. Du brauchst eigene, rechtmäßig genutzte Quellen.

⁠Funktionen

• M3U-Playlist, XMLTV-EPG und HDHomeRun-Tuner für Emby
• Filter nach Ländern, Gruppen und Sendern, eigene Reihenfolge und Namen, deutsche Standard-Sortierung
• EPG-Zuordnung, weitere XMLTV-Quellen, Senderlogos
• Optional: Satellit über SAT>IP oder DVBViewer Media Server
• Optional: Filme und Serien des Anbieters als .strm-Bibliothek, eigene Medien nach HEVC umwandeln (Intel-Grafik)
• Optional: WireGuard-Tunnel, E-Mail-Benachrichtigung
• Passwortschutz mit optionalem zweitem Faktor

⁠Schnellstart

Voraussetzung: Linux x86_64 (amd64) mit Docker und Docker Compose.

mkdir iptv-proxy && cd iptv-proxy
mkdir config && sudo chown 1000:1000 config   # die App läuft als Benutzer 1000

Ohne diesen Schritt kann die App nichts speichern.

docker-compose.yml anlegen:

services:
  iptv-proxy:
    image: speedyhome/iptv-proxy:latest
    container_name: iptv-proxy
    restart: unless-stopped
    init: true
    ports:
      - "8787:8787"
      # - "45000-45015:45000-45015/udp"  # nur für Satellit über SAT>IP
    volumes:
      - ./config:/config
      # - /pfad/zu/filmen:/media/Filme            # nur für „Sichern“
      # - /pfad/zu/serien:/media/Serien           # nur für „Sichern“
      # - /pfad/zu/aufnahmen:/media/Recordings    # nur für „Sichern“ aus „Verpasst“
    # devices:
    #   - /dev/dri:/dev/dri  # nur mit Intel-Grafik für „Umwandeln“
    # group_add:
    #   - "105"              # Gruppe „render“ des Servers: getent group render
    extra_hosts:
      - "host.docker.internal:host-gateway"  # Emby auf demselben Rechner
    environment:
      TZ: Europe/Berlin

docker compose up -d

Danach:

1. http://<IP-des-Servers>:8787/ im Browser öffnen und unter Einstellungen zuerst ein Passwort für die Oberfläche setzen.
2. Unter Einstellungen → Quellen den eigenen Xtream-Codes-Zugang eintragen.
3. In Emby als Tuner HDHomeRun mit http://<IP-des-Servers>:8787 einrichten, oder als M3U http://<IP-des-Servers>:8787/playlist.m3u und als XMLTV http://<IP-des-Servers>:8787/epg.xml.

Update: docker compose pull && docker compose up -d. Der Ordner config/ bleibt erhalten.

Sicherheit: Port 8787 nicht ins Internet freigeben. Die App ist für das Heimnetz gedacht.

⁠Freeware

IPTV-Proxy ist kostenlos und läuft ohne Lizenz, ohne Zeitlimit und ohne Anmeldung. Add-ins sind nicht im Image enthalten; nur sie brauchen eine Lizenz.

☕ Dir gefällt die App? Spendier mir einen Kaffee: paypal.me/speedyhome⁠. Die Spende ist freiwillig und begründet keinen Anspruch auf Gegenleistungen, Support oder Funktionen.

⁠Rechtlicher Hinweis und Haftungsausschluss

Stand: November 2026. Diese Bedingungen gelten für das Herunterladen und die Nutzung der Software.

Freeware. Die Software wird unentgeltlich und ohne Kaufvertrag bereitgestellt. Sie darf privat genutzt werden. Rechte am Programm verbleiben beim Herausgeber. Verändern, Dekompilieren und Weiterverkauf sind nicht gestattet, soweit das Gesetz sie nicht zwingend erlaubt. Es besteht kein Anspruch auf Pflege, Updates, Support oder dauerhafte Verfügbarkeit.

Keine Inhalte, Verantwortung der Nutzer. Die Software ist ein reines technisches Werkzeug. Sie enthält keine Sender, Streams, Filme, Zugangsdaten oder Links auf solche Inhalte, und der Herausgeber stellt weder Inhalte noch Zugänge bereit oder vermittelt sie. Du allein entscheidest, welche Quellen du einträgst, und bist dafür verantwortlich, dass du sie rechtmäßig nutzt. Das betrifft insbesondere Urheberrecht, Empfangs- und Abonnementbedingungen sowie die Regeln deines Landes. Die Nutzung für nicht lizenzierte Streams oder zum Umgehen technischer Schutzmaßnahmen ist untersagt. Die Software darf nicht verwendet werden, um Inhalte an Dritte weiterzuverbreiten.

Keine Gewähr. Die Software wird so bereitgestellt, wie sie ist. Der Herausgeber übernimmt keine Gewähr dafür, dass sie fehlerfrei, sicher, ununterbrochen oder für einen bestimmten Zweck nutzbar ist oder mit Diensten Dritter dauerhaft zusammenarbeitet. Das gilt für alle Funktionen, die Dateien verändern, verschieben oder löschen (zum Beispiel Umwandeln, Umbenennen und Bibliothekspflege). Lege vorher Sicherungen an.

Haftung. Der Herausgeber haftet nur für Vorsatz und grobe Fahrlässigkeit. Unberührt bleiben die Haftung für Schäden an Leben, Körper oder Gesundheit, für arglistig verschwiegene Mängel sowie nach zwingenden gesetzlichen Vorschriften wie dem Produkthaftungsgesetz. Soweit das Gesetz es zulässt, ist jede weitere Haftung ausgeschlossen, insbesondere für Datenverlust, Sperrung oder Kündigung von Zugängen, Ansprüche Dritter und Folgeschäden aus der Nutzung.

Dienste Dritter. Für Dienste, die du einbindest (etwa IPTV-Anbieter, VPN, E-Mail, Metadaten- und Logo-Quellen oder KI-Anbieter), gelten deren eigene Bedingungen. Der Herausgeber hat darauf keinen Einfluss und übernimmt dafür keine Verantwortung. Beim Abruf von Senderlogos und Metadaten stellt die App Verbindungen zu diesen Diensten her.

Marken. Alle genannten Marken und Sendernamen gehören ihren jeweiligen Inhabern. Dieses Projekt steht in keiner Verbindung zu Emby, zu Sendern oder zu Anbietern und wird von ihnen weder unterstützt noch geprüft.

Drittkomponenten. Das Image enthält unter anderem Python, FFmpeg und weitere Debian-Pakete sowie wireproxy⁠. Für sie gelten ausschließlich ihre eigenen Lizenzen (unter anderem GPL/LGPL). Die Lizenztexte der Debian-Pakete liegen im Image unter /usr/share/doc/, die Quellen sind über die Debian-Archive erhältlich. Die Bedingungen oben schränken diese Lizenzen nicht ein.

Mit dem Herunterladen oder Starten akzeptierst du diese Bedingungen. Wenn du sie nicht akzeptierst, nutze die Software nicht. Es gilt deutsches Recht, soweit dem keine zwingenden Verbraucherschutzvorschriften entgegenstehen. Sollte eine Bestimmung unwirksam sein, bleiben die übrigen wirksam.

⁠Legal notice (English summary)

Free of charge, provided "as is", without warranty of any kind. This software contains no channels, streams or credentials. You are solely responsible for using only sources you are legally entitled to use. Using it for unlicensed streams or to circumvent technical protection measures is prohibited. To the extent permitted by law, liability is limited to intent and gross negligence; mandatory statutory liability remains unaffected. Not affiliated with Emby, any broadcaster or any provider. Third-party components remain under their own licenses. The German text above prevails.