Hilfe

Drei Formate, alle in sich abgeschlossen — Python, Qt, libmpv und ffmpeg stecken im Download, daneben ist nichts zu installieren.

AppImage — das richtige, wenn du unsicher bist. Es läuft auf jeder Distribution:

chmod +x dopeIPTV-*.AppImage
./dopeIPTV-*.AppImage

.deb unter Debian oder Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

Von allen dreien gibt es arm64-Builds für einen Raspberry Pi oder einen ARM-Server.

Öffne die .dmg und zieh dopeIPTV nach „Programme“. Nötig ist macOS 15 oder neuer, und die App läuft auf Apple Silicon — 1.2.10 war die letzte Version mit Intel-Build.

Der erste Start wird abgelehnt, weil die App nicht bei Apple notarisiert ist. Rechtsklick auf die App, Öffnen wählen, dann im Dialog noch einmal Öffnen. Hilft das nicht, siehe „macOS sagt, die App lässt sich nicht öffnen“ weiter unten.

Es gibt kein Installationsprogramm. Entpack dopeIPTV-*-windows-x64.zip, wohin du willst — dein Benutzerordner reicht, Administratorrechte sind nicht nötig — und starte darin dopeiptv.exe.

Für Snapdragon-Notebooks gibt es einen nativen arm64-Build; der x64-Build läuft dort ebenfalls, nur emuliert und damit langsamer.

Für eine Verknüpfung im Startmenü oder auf dem Desktop: Einstellungen → Oberfläche → Wartung → Verknüpfung anlegen. Die README.txt im Zip listet alles auf, was du löschst, wenn die App spurlos verschwinden soll.

Beim ersten Start fragt die App drei Dinge aus deinem Xtream-Codes-Konto ab:

• Server — die Adresse mit Port, etwa http://example.com:8080. Nicht die vollständige Playlist-URL, nur der Host.
• Benutzername und Passwort — die, die dein Anbieter dir gegeben hat.

Sie werden gespeichert. Ein weiteres Konto später hinzufügen oder dieses ändern: Einstellungen → Wiedergabelisten. Du kannst im laufenden Betrieb zwischen Listen wechseln; Favoriten und Verlauf werden je Liste getrennt gehalten.

Ja. Wähl beim Hinzufügen M3U und füg die Adresse deines Anbieters ein.

Ein Xtream-Konto holt mehr aus der App heraus — Catch-up, Ablaufdatum des Kontos, der Programmführer des Anbieters — weil das aus einer API kommt, die eine M3U-Liste nicht hat. Eine M3U-Liste spielt und kann eine eigene XMLTV-Adresse für das Programm bekommen, was den Unterschied größtenteils ausgleicht.

Ja. Der Einrichtungsassistent bietet Demokanäle an: eine Handvoll freier, öffentlicher Teststreams von Mux, Apple und Bitmovin, damit du die App arbeiten siehst, bevor du irgendetwas eintippst. Das sind offizielle Teststreams, nicht der Dienst von irgendjemandem, und du kannst jederzeit auf eine echte Playlist wechseln.

Doppelklick in der mittleren Liste, oder ▶ Wiedergabe im rechten Bereich. Ein anderer Kanal tauscht den Stream an Ort und Stelle aus, statt den Player abzureißen und neu aufzubauen — deshalb geht das Zappen schnell.

Die Tasten Zurück und Weiter in der Playerleiste gehen durch die Liste, in der du gerade bist — Kanäle, die Folgen einer Serie, Aufnahmen oder den Verlauf.

Bei Filmen, Folgen, Aufnahmen und Catch-up — allem mit bekannter Länge:

• Zeiger über das Bild bewegen: Eine Zeitleiste fährt hoch, mit verstrichener und Gesamtzeit und den Tasten −10 s / +30 s.
• Einmal ins Video klicken und die Pfeiltasten benutzen: Ein Tippen springt zehn Sekunden, Gedrückthalten spult durchgehend.

Livekanäle lassen sich nicht spulen und zeigen bewusst keine Zeitleiste. Um sich in einem Livekanal zu bewegen, brauchst du Timeshift — siehe unten.

Doppelklick aufs Bild oder F. Esc verlässt es — und ebenso die ausdrückliche Schaltfläche Vollbild beenden in der schwebenden Leiste, die genau dafür da ist, dass niemand Esc kennen muss.

Bedienelemente und Mauszeiger blenden sich nach ein paar Sekunden Stillstand aus und kommen bei der kleinsten Bewegung zurück.

Ja — lös den Player in ein eigenes Fenster und zieh es, wohin du willst.

Das Fenster ist standardmäßig rahmenlos: Zieh es an einer beliebigen Stelle des Bildes. Rechtsklick für „immer im Vordergrund“, Titelleiste oder Beenden. Esc holt es ebenfalls zurück. Das Hauptfenster arbeitet währenddessen weiter.

Die ⚙-Taste in der Playerleiste — sie ist auch in den Vollbild-Bedienelementen — enthält alles zum laufenden Stream:

• Tonspur und Untertitelspur
• Tonverzögerung, wenn der Ton nicht passt
• Seitenverhältnis (16:9, 4:3, gestreckt und so weiter)
• Größe des Netzwerkpuffers
• Stats for nerds: Codecs, Auflösung, Bildrate, Hardwaredekodierung, A/V-Synchronität, verworfene Bilder, Cache und Netzwerktempo, live über dem Bild

Eine gewählte Spur wird gemerkt, und bei einer Serie übernimmt sie die nächste Folge. Willst du stattdessen eine Vorgabe für alle Streams, siehe Einstellungen weiter unten.

• Leertaste — Pause und weiter
• F — Vollbild, Esc zum Verlassen
• ← / → — zehn Sekunden spulen, gedrückt halten spult weiter
• M — stumm

Sie gelten im Hauptfenster, im Vollbild und im ausgelösten Fenster gleichermaßen.

Ja, bei Filmen, Serienfolgen, Aufnahmen und deinen eigenen lokalen Dateien. Startest du etwas erneut, fragt die App, ob sie fortsetzen oder von vorn beginnen soll.

Positionen ganz nah am Anfang oder Ende werden bewusst ignoriert, damit nichts fortgesetzt werden soll, das du gerade erst begonnen oder tatsächlich zu Ende gesehen hast.

Von deinem Anbieter. Jeder Livekanal in der Liste zeigt mit Fortschrittsbalken, was gerade läuft, und der Detailbereich zeigt, was als Nächstes kommt.

Das Programm wird je Playlist auf der Platte zwischengespeichert und steht deshalb sofort beim Start auf dem Schirm — die frische Fassung lädt im Hintergrund und ersetzt sie. Schlägt der Download fehl, bleibt die gespeicherte Fassung stehen, statt dich ohne alles zurückzulassen.

Ja. Die Schaltfläche Programm in der Seitenleiste öffnet ein durchsuchbares Raster über alle Kanäle, mit einer Zeitleiste zum Blättern. Die Suche findet eine Sendung über alle Kanäle hinweg am Namen.

Bei einem Kanal mit Catch-up spielt ein Doppelklick auf eine bereits gelaufene Sendung sie aus dem Archiv ab.

Gib dieser Playlist ein eigenes Programm statt dem des Anbieters:

1. Einstellungen → Wiedergabelisten
2. Playlist auswählen und bearbeiten
3. Eine XMLTV-Adresse in das Feld für den eigenen Programmführer eintragen

Sie ersetzt, was der Anbieter schickt. Die App ordnet deine Kanäle diesem Programm zuerst über die EPG-ID und danach über den Kanalnamen zu, deshalb passt auch ein Programm aus anderer Quelle meist.

Manche Anbieter veröffentlichen Zeiten, die nicht zu dem passen, was sie tatsächlich senden. Zwei getrennte Korrekturen liegen unter Einstellungen → Wiedergabe:

• EPG-Versatz verschiebt jede Zeit, die das Programm anzeigt.
• Replay-Versatz verschiebt, wo Catch-up und Timeshift zu spielen beginnen, ohne die Programmliste anzurühren.

Sie sind getrennt, weil Anbieter diese beiden Dinge unabhängig voneinander falsch machen.

Manche Anbieter halten von jedem Kanal ein paar Tage Aufzeichnung vor. Wo deiner das tut, bekommt der Kanal in der Liste eine ⏪-Markierung, und der Detailbereich nennt die Tiefe des Archivs in Tagen.

Fehlt die Markierung, bietet der Anbieter für diesen Kanal kein Archiv an. Das ist seine Einstellung, und nichts in der App kann sie einschalten.

Drück die ⏪-Taste im Player — sie ist auch in den Vollbild-Bedienelementen — oder mach einen Rechtsklick auf den Kanal und wähl Timeshift. Dann von Anfang an wählen.

Abgespielt wird ein Stück des Archivs, es spult also wie ein Film: Zeitleiste und Pfeiltasten arbeiten darin beide.

Ja. Das Timeshift-Menü listet vergangene Sendungen nach Tagen gruppiert — Doppelklick auf eine, um sie zu sehen. Du kannst auch in festen Schritten zurückspringen, und diese Schritte richten sich danach, wie tief das Archiv deines Anbieters tatsächlich ist, von dreißig Minuten bis zu einer Woche.

Manche Anbieter nehmen eine Archivanfrage an und liefern stillschweigend den Livestream. Die App prüft das und sagt Bescheid, statt dich glauben zu lassen, du sähest gestern.

Zwei Wege:

• Die REC-Taste im Player, für das, was gerade läuft.
• Rechtsklick auf einen beliebigen Kanal → Aufnehmen, für einen, den du nicht siehst.

Ohne gewählte Länge läuft die Aufnahme, bis du sie stoppst. Eine Aufnahme lässt sich ansehen, während sie noch geschrieben wird.

Beides ja. Das REC-Menü bietet 30 Minuten, 1, 2 oder 4 Stunden, und eine geplante Aufnahme nimmt eine Start- und eine Stoppzeit.

Geplante Aufträge überstehen einen Neustart der App, aber die App muss laufen, wenn sie fällig werden — sie ist ein Programm, kein Hintergrunddienst. Aufnahmen → Aktiv & geplant zeigt, was ansteht.

Nicht, wenn du den Kanal aufnimmst, den du gerade siehst: Dabei wird der Stream des Players mitgeschnitten, das kostet nichts zusätzlich und funktioniert auch mit den üblichen Konten, die nur einen Stream gleichzeitig erlauben.

Einen anderen Kanal aufzunehmen — oder ein geplanter Auftrag, der später startet — öffnet dagegen eine eigene Verbindung zum Anbieter.

Eines noch zur Aufnahme im Player: Sie wird beim Stoppen fertiggestellt, also beenden das Anhalten der Wiedergabe, ein Kanalwechsel oder ein Streamfehler sie.

Ja, auf zwei Ebenen. Einstellungen → Aufnahme nimmt eine Größenbegrenzung für alle Aufnahmen — eine Zahl plus MB, GB oder TB. Und das REC-Menü im Player hat eine schnelle Grenze nur für die laufende Sitzung, von 250 MB bis 10 GB.

Dort, wo du es unter Einstellungen → Aufnahme festlegst. Der Bereich Aufnahmen in der Seitenleiste blättert darin, mit Unterordnern als Kategorien: Ordner anlegen, umbenennen, Dinge zwischen ihnen verschieben und mehrere auf einmal zum Löschen auswählen.

Ein eigenes Fenster, das 2, 4, 6 oder 9 Livekanäle gleichzeitig in einem Raster zeigt, jeder ein eigenständiger Stream. Sie dürfen aus verschiedenen Playlists und sogar von verschiedenen Konten kommen.

Öffne es über die Seitenleiste; die Rastergröße liegt unter Einstellungen → Multiview. Doppelklick auf ein Fenster maximiert es.

Klick ein Fenster an, um ihm den Ton zu geben — ein roter Rahmen markiert das, was du hörst.

Rechtsklick auf ein beliebiges Fenster für: stumm, Ton- und Untertitelspur, verschieben oder mit einem anderen tauschen, oder entfernen. Ein Kanal mit Catch-up bekommt in seinem Fenster eine eigene Archiv-Zeitleiste, du kannst also einen Kanal zurückspulen, während die anderen live bleiben.

Weil es das tut — eine pro Fenster. Die meisten IPTV-Konten erlauben nur ein bis zwei Streams gleichzeitig, ein Raster mit neun Fenstern wird von den meisten Anbietern also schlicht abgewiesen.

Die App sagt das einmal, bevor du es an einer Wand fehlschlagender Streams merkst. Siehst du „Verbindungslimit erreicht“, liegt es meist daran.

Rechtsklick auf einen Kanal, Film oder eine Folge → An Chromecast senden …, dann das Gerät wählen. Livekanäle gehen als HLS raus, was ein Cast-Empfänger erwartet.

Casting beendet die lokale Wiedergabe — beides zusammen wäre eine zweite Verbindung zu deinem Anbieter. Eine Leiste über dem Player nennt Gerät und Inhalt, mit Stopptaste. Startest du etwas in der App, endet damit auch der Cast und die Wiedergabe kommt zurück.

Manche Kanäle sind gewöhnliches H.264-Video mit Dolby Digital Plus-Ton. Ein Chromecast, der kein Ultra oder Google TV ist, hat dafür keinen Decoder und weist den Stream ab, ohne zu sagen warum.

Die App wandelt solche Streams auf diesem Rechner um und liefert das Ergebnis im eigenen Netz aus: Das Video wird unangetastet durchkopiert — nur der Ton wird neu kodiert, was billig ist — und das passiert erst, nachdem das Gerät den Stream tatsächlich abgelehnt hat. Einen Kanal, den dein Gerät kann, bekommt es immer unverändert vom Anbieter.

Dafür wird ffmpeg gebraucht, das in jedem paketierten Download steckt.

Einstellungen → Trakt. Du legst auf trakt.tv eine Anwendung an, fügst die beiden Schlüssel ein, die du bekommst, und bestätigst im Browser, der sich öffnet.

Danach wird gescrobbelt, was du siehst, und Watchlist und Verlauf lassen sich in der App durchblättern. Deine eigenen lokalen Dateien werden ebenfalls gescrobbelt, sofern TMDB die Datei erkennen konnte.

Ja. Lokale Dateien in der Seitenleiste blättert durch Ordner, die du unter Einstellungen → Lokale Dateien hinzufügst.

Eine Netzwerkfreigabe, die dein System bereits eingebunden hat, erscheint von selbst — eine gvfs-SMB-Einbindung unter Linux, eine Freigabe unter /Volumes auf macOS, ein verbundenes Laufwerk unter Windows. Für die App sind das gewöhnliche Pfade, es steckt also kein SMB-Client darin, der sich danebenbenehmen könnte.

Beides, umschaltbar in der mittleren Spalte.

• Ordner zeigt den Baum genau so, wie er auf der Platte liegt.
• Bibliothek liest die Dateinamen und baut daraus Serien mit Staffeln und Folgen, Filme unter „Filme“ — dieselbe Form wie die Bereiche des Anbieters.

Von TMDB, für alles, was sich über Name und Jahr zuordnen lässt. Was sich nicht zuordnen lässt, bekommt ein Standbild aus dem Video selbst, und Musik ihr Cover aus den Tags der Datei oder einem Coverbild im Ordner.

Bei einer Datei ohne Jahr und ohne Release-Tag im Namen wird nie geraten. Das ist Absicht: ein falsches Poster ist schlimmer als ein Vorschaubild. Benenn die Datei mit Jahr um, wenn sie zugeordnet werden soll.

Ja. Alben stehen zusammen, Interpret, Album und Titel kommen aus den Tags, und es gibt eine Warteschlange: einen Titel anhängen, einen ganzen Ordner einreihen oder etwas als Nächstes spielen. Am Ende eines Titels geht es von selbst weiter.

Dazu gibt es eine Visualisierung und einen Zehnband-Equalizer.

Sie wurde verschoben, umbenannt, oder ihre Freigabe ist nicht eingebunden. Der Verlauf sagt, was davon, und bietet an, den Eintrag zu entfernen, statt still zu scheitern.

Ist es eine Freigabe: einbinden und noch einmal versuchen — der Eintrag funktioniert dann wieder wie zuvor.

Einstellungen → Oberfläche. Die Oberfläche ist in 27 Sprachen übersetzt und wechselt sofort, ohne Neustart. Arabisch, Persisch, Hebräisch und Urdu spiegeln das gesamte Layout.

Im selben Reiter liegen fünf Farbschemata und sieben Akzentfarben, die sofort greifen.

Einstellungen → Wiedergabe legt fest, was passieren soll, ohne dass du jedes Mal fragst:

• Bevorzugte Tonsprache
• Untertitel an oder aus, mit erster und zweiter Wunschsprache
• Standard-Seitenverhältnis und Netzwerkpuffer
• Wie früh die Karte „Nächste Folge“ erscheint — aus, oder eine bis zehn Minuten

Das ⚙-Menü im Player überschreibt jede davon weiterhin für den laufenden Stream.

Ja. Eine PIN schützt gesperrte Kategorien und gesperrte Favoritengruppen. Eine gesperrte Gruppe verrät nicht einmal, welche Kanäle darin liegen, bevor die PIN eingegeben ist — sie verbirgt den Inhalt, nicht nur die Wiedergabe.

Die PIN wird gesalzen und gehasht gespeichert, nicht im Klartext.

Rechtsklick auf einen Kanal, Film oder eine Serie zum Umbenennen oder Ausblenden. Das Ergebnis ist praktisch deine eigene bearbeitete Playlist, je Playlist gespeichert, und Standardkanäle wiederherstellen … stellt alles genau so wieder her, wie der Anbieter es schickt.

Ganze Kategorien lassen sich über das Kontextmenü der Kategorie ausblenden, umbenennen oder sperren. Die Kanäle einer ausgeblendeten Kategorie fehlen auch in „Alle“.

Leg unter Einstellungen → Wiedergabelisten so viele Listen an, wie du magst, und wechsle im laufenden Betrieb. Jede behält eigene Favoriten, eigenen Verlauf, eigene ausgeblendete Kanäle und Umbenennungen.

Jede kann außerdem eine eigene XMLTV-Adresse und einen eigenen Aktualisierungsplan haben — nie, beim Start, alle 2, 6 oder 12 Stunden, täglich oder wöchentlich.

Das Log macht aus „geht nicht“ etwas Behebbares, und Zugangsdaten werden automatisch daraus maskiert — es lässt sich also gefahrlos an ein Issue hängen.

Starte die App aus einem Terminal mit gesetztem DOPEIPTV_LOG_FILE, dann schreibt sie zusätzlich zum Bildschirm eine Datei dorthin.

Linux — AppImage

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log ./dopeIPTV-*.AppImage

Linux — .deb oder pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log \
  /Applications/dopeIPTV.app/Contents/MacOS/dopeiptv

Windows — PowerShell, im entpackten Ordner

$env:DOPEIPTV_LOG_FILE="$env:TEMP\dopeiptv.log"
.\dopeiptv.exe

Ruf den Fehler hervor, schließ die App und häng die Datei an. Für sehr viel mehr Detail setz DOPEIPTV_LOG=debug vor denselben Befehl.

Starte sie aus einem Terminal — die Antwort darüber nennt den genauen Befehl für dein System — und lies, was sie ausgibt. Das benennt die Ursache öfter als nicht.

Die paketierten Builds bringen alles Nötige mit. Hast du aus dem Quelltext mit pipx installiert, brauchst du zusätzlich mpv und ffmpeg aus deiner Distribution:

sudo apt install mpv ffmpeg     # Debian/Ubuntu
sudo dnf install mpv ffmpeg     # Fedora
sudo pacman -S mpv ffmpeg       # Arch

Der eingebettete Player bekommt keine Videofläche.

1. Öffne ⚙ → Stats for nerds und sieh nach, ob überhaupt Bilder ankommen — das trennt ein Streamproblem von einem Anzeigeproblem.
2. Unter Wayland: Einstellungen → Wiedergabe → Über X11-Backend starten ausprobieren und die App neu starten.
3. Aus einem Terminal starten und nach Zeilen mit GL oder mpv suchen.

Sie ist noch nicht bei Apple notarisiert. Rechtsklick auf die App, Öffnen wählen, dann im Dialog Öffnen — oder sie unter Systemeinstellungen → Datenschutz & Sicherheit → Dennoch öffnen freigeben.

Sagt macOS stattdessen, die App sei „beschädigt“, ist das die Quarantäne-Markierung vom Download. Entfern sie:

xattr -dr com.apple.quarantine /Applications/dopeIPTV.app

Keine der beiden Warnungen heißt, dass mit der App etwas nicht stimmt — nur, dass der Build nicht signiert ist, wofür ein kostenpflichtiges Apple-Zertifikat nötig wäre.

SmartScreen kennt den Herausgeber nicht, weil der Build nicht signiert ist — dafür bräuchte es ein kostenpflichtiges Zertifikat. Klick auf Weitere Informationen und dann Trotzdem ausführen.

Ein Fehlalarm. Zwei seiner Ursachen wurden in 1.2.10 behoben: Der Starter wird jetzt aus dem Quelltext kompiliert, statt der vorgebauten Standardvariante zu sein, für die Virenscanner Signaturen führen, und die ausführbare Datei trägt eine richtige Versionsressource.

Schlägt deine Engine trotzdem an: den Ordner in deinem Virenscanner freigeben und den Fehlalarm an Microsoft melden — das ist es, was ihn am Ende für alle abstellt, nicht nur für dich.

Die App fragt beim Anbieter nach und sagt im Klartext, woran es liegt, statt einen nackten Fehler zu zeigen: Konto abgelaufen, Verbindungslimit erreicht, Stream fehlt, Server nicht erreichbar und so weiter.

Spielen andere Kanäle, liegt es an diesem einen. Spielt gar nichts, sieh unter Einstellungen → Wiedergabelisten nach — der Kontobereich zeigt Ablaufdatum und die erlaubte Anzahl Verbindungen.

Dein Konto erlaubt eine bestimmte Zahl gleichzeitiger Streams, und alle sind belegt. Nach Wahrscheinlichkeit:

1. Multiview ist offen — jedes Fenster ist eine Verbindung.
2. Eine Aufnahme eines anderen Kanals läuft.
3. Ein anderes Gerät oder eine andere Person benutzt das Konto.
4. Eine frühere Sitzung ist beim Anbieter noch nicht abgelaufen; eine Minute warten hilft oft.

Den Kanal aufzunehmen, den du gerade siehst, zählt nicht als zweite Verbindung.

Unter Wayland nehmen GNOME und KDE das Symbol eines Fensters aus einem passenden Desktop-Eintrag und ignorieren, was das Programm selbst setzt. Ein AppImage hat keinen solchen Eintrag, bis ihn etwas anlegt.

1. Die App bietet beim ersten Start an, einen anzulegen. Sag ja — und starte die App danach neu, denn das offene Fenster behält das Symbol, mit dem es geöffnet wurde.
2. Derselbe Schalter liegt unter Einstellungen → Wiedergabe, falls du abgelehnt hast.
3. Erscheint das Symbol immer noch nicht, verdeckt es ein veralteter Symbol-Cache. GTK liest diese Datei statt des Ordners:

rm ~/.local/share/icons/hicolor/icon-theme.cache

Bei der Installation über das .deb ist der Eintrag bereits da und nichts davon trifft zu.

Diese Option startet ein eigenständiges mpv oder vlc aus deinem System, eines davon muss also installiert sein — der eingebaute Player braucht nichts zusätzlich und ist davon nicht betroffen.

sudo apt install mpv vlc        # Debian/Ubuntu
sudo dnf install mpv vlc        # Fedora
sudo pacman -S mpv vlc          # Arch