dopeIPTV

Aide

Tout est sur cette page, réponse ouverte. Tapez pour filtrer — la touche « / » amène au champ de recherche depuis n'importe où.

Installer et configurer

Comment l'installer sous Linux ?

Trois formats, tous autonomes — Python, Qt, libmpv et ffmpeg sont dans le téléchargement, il n'y a rien à installer à côté.

AppImage — celui à prendre en cas de doute. Il fonctionne sur n'importe quelle distribution :

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

.deb sous Debian ou Ubuntu :

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak :

flatpak install --user dopeIPTV-*.flatpak

Les trois existent en arm64, pour un Raspberry Pi ou un serveur ARM.

Comment l'installer sous macOS ?

Ouvrez le .dmg et glissez dopeIPTV dans Applications. Il faut macOS 15 ou plus récent, et l'application tourne sur Apple Silicon — la 1.2.10 est la dernière version avec une build Intel.

Le premier lancement est refusé parce que l'application n'est pas notarisée par Apple. Faites un clic droit dessus et choisissez Ouvrir, puis Ouvrir à nouveau dans la boîte de dialogue. Si cela ne suffit pas, voyez « macOS dit que l'application ne peut pas être ouverte » plus bas.

Comment l'installer sous Windows ?

Il n'y a pas d'installateur. Décompressez dopeIPTV-*-windows-x64.zip où vous voulez — votre dossier utilisateur convient, aucun droit administrateur n'est requis — et lancez dopeiptv.exe qui s'y trouve.

Il existe une build arm64 native pour les portables Snapdragon ; la build x64 y fonctionne aussi, en émulation et donc plus lentement.

Pour un raccourci dans le menu Démarrer ou sur le bureau : Paramètres → Interface → Maintenance → Créer un raccourci. Le README.txt du zip liste tout ce qu'il faut supprimer pour effacer l'application sans laisser de trace.

Comment connecter mon fournisseur ?

Au premier lancement, trois informations de votre compte Xtream Codes vous sont demandées :

  • Serveur — l'adresse avec le port, du type http://example.com:8080. Pas une URL de playlist complète, seulement l'hôte.
  • Nom d'utilisateur et Mot de passe — ceux fournis par votre fournisseur.

Ils sont enregistrés. Pour ajouter un autre compte plus tard, ou modifier celui-ci : Paramètres → Listes de lecture. Vous pouvez changer de liste en cours d'exécution ; favoris et historique restent séparés pour chacune.

Puis-je utiliser une liste M3U à la place ?

Oui. Choisissez M3U au moment d'ajouter une liste et collez l'adresse donnée par votre fournisseur.

Un compte Xtream tire davantage de l'application — replay, date d'expiration du compte, le guide du fournisseur — parce que cela vient d'une API qu'une liste M3U n'a pas. Une liste M3U se lit et peut recevoir sa propre adresse XMLTV pour le guide, ce qui comble l'essentiel de l'écart.

Puis-je essayer sans compte ?

Oui. L'assistant de configuration propose des chaînes de démonstration : quelques flux de test libres et publics de Mux, Apple et Bitmovin, pour voir l'application fonctionner avant de saisir quoi que ce soit. Ce sont des flux de test officiels, pas le service de qui que ce soit, et vous pouvez passer à une vraie liste quand vous voulez.

Regarder

Comment lancer une lecture ?

Double-cliquez dans la liste centrale, ou appuyez sur ▶ Lecture dans le panneau de droite. Choisir une autre chaîne remplace le flux sur place au lieu de démonter puis reconstruire le lecteur — c'est ce qui rend le zapping rapide.

Les boutons Précédent et Suivant de la barre du lecteur parcourent la liste où vous êtes — chaînes, épisodes d'une série, enregistrements ou historique.

Comment avancer et reculer ?

Pour les films, épisodes, enregistrements et replays — tout ce dont la durée est connue :

  • Passez le pointeur sur l'image : une barre de progression remonte, avec le temps écoulé, la durée totale et des boutons −10 s / +30 s.
  • Cliquez une fois sur la vidéo et utilisez les flèches : une pression saute dix secondes, maintenue elle avance en continu.

Les chaînes en direct ne se parcourent pas et n'affichent volontairement aucune barre. Pour vous déplacer dans une chaîne en direct, il faut le timeshift — voir plus bas.

Plein écran et commandes

Double-cliquez sur l'image, ou appuyez sur F. Échap en sort — tout comme le bouton explicite Quitter le plein écran de la barre flottante, qui existe précisément pour que personne n'ait besoin de connaître Échap.

Les commandes et le pointeur disparaissent après quelques secondes d'immobilité et reviennent au moindre mouvement.

Puis-je déplacer la vidéo sur un second écran ?

Oui — détachez le lecteur dans sa propre fenêtre et placez-la où vous voulez.

Elle est sans cadre par défaut : glissez n'importe où sur l'image pour la déplacer. Clic droit pour « toujours au premier plan », une barre de titre, ou Quitter. Échap la ramène aussi. La fenêtre principale continue de fonctionner pendant ce temps.

Langue audio, sous-titres et réglages d'image

Le bouton de la barre du lecteur — il est aussi dans les commandes du plein écran — contient tout ce qui concerne le flux en cours :

  • Piste audio et piste de sous-titres
  • Décalage audio, quand le son n'est pas synchrone
  • Format d'image (16:9, 4:3, étiré, etc.)
  • Taille du tampon réseau
  • Stats for nerds : codecs, résolution, fréquence d'images, décodage matériel, synchro A/V, images perdues, cache et débit réseau, en direct par-dessus l'image

Une piste choisie est mémorisée, et pour une série elle est reprise à l'épisode suivant. Pour définir une préférence valable pour tous les flux, voyez Paramètres plus bas.

Raccourcis clavier

  • Espace — pause et reprise
  • F — plein écran, Échap pour sortir
  • ← / → — dix secondes, maintenir pour continuer
  • M — couper le son

Ils fonctionnent dans la fenêtre principale, en plein écran et dans la fenêtre détachée.

L'application retient-elle où je me suis arrêté ?

Oui, pour les films, les épisodes de série, les enregistrements et vos fichiers locaux. En relançant, elle demande s'il faut reprendre à cet endroit ou recommencer depuis le début.

Les positions très proches du début ou de la fin sont ignorées à dessein, pour ne pas proposer de reprendre quelque chose que vous veniez de commencer ou que vous aviez fini.

Guide, timeshift et enregistrement

D'où vient le guide des programmes ?

De votre fournisseur. Chaque chaîne en direct affiche dans la liste ce qui passe en ce moment, avec une barre de progression, et le panneau de détail indique ce qui suit.

Le guide est mis en cache sur le disque pour chaque liste, il est donc à l'écran dès le démarrage — la copie fraîche se télécharge en arrière-plan et la remplace. Si ce téléchargement échoue, le guide en cache reste plutôt que de vous laisser sans rien.

Y a-t-il un guide complet ?

Oui. Le bouton Guide de la barre latérale ouvre une grille de programmes consultable couvrant toutes les chaînes, avec une frise temporelle défilante. La recherche retrouve un programme par son nom sur toutes les chaînes.

Sur une chaîne avec replay, double-cliquer sur un programme déjà diffusé le lit depuis l'archive.

Le guide est faux, vide, ou pour le mauvais pays

Donnez à cette liste son propre guide plutôt que celui du fournisseur :

  1. Paramètres → Listes de lecture
  2. Sélectionnez la liste et modifiez-la
  3. Mettez une adresse XMLTV dans le champ de guide personnalisé

Elle remplace ce qu'envoie le fournisseur. L'application associe vos chaînes à ce guide par identifiant EPG d'abord, par nom de chaîne ensuite ; un guide d'une autre source tombe donc généralement juste.

Tout est décalé d'une ou deux heures

Certains fournisseurs publient des horaires qui ne correspondent pas à ce qu'ils diffusent réellement. Deux corrections distinctes sont dans Paramètres → Lecture :

  • Le décalage EPG déplace toutes les heures affichées par le guide.
  • Le décalage de replay déplace l'endroit où le replay et le timeshift commencent, sans toucher aux horaires affichés.

Ils sont séparés parce que les fournisseurs se trompent sur l'un indépendamment de l'autre.

Qu'est-ce que le timeshift et le replay ?

Certains fournisseurs conservent quelques jours d'enregistrement de chaque chaîne. Là où le vôtre le fait, la chaîne porte un repère dans la liste, et le panneau de détail indique la profondeur de l'archive en jours.

Sans ce repère, le fournisseur ne propose pas d'archive pour cette chaîne. C'est son réglage, et rien dans l'application ne peut l'activer.

Comment voir quelque chose qui a déjà commencé ?

Appuyez sur le bouton du lecteur — il est aussi dans les commandes du plein écran — ou faites un clic droit sur la chaîne et choisissez Timeshift. Puis prenez depuis le début.

Ce qui est lu est un morceau de l'archive : cela se parcourt comme un film, la barre de progression et les flèches fonctionnent.

Puis-je revenir à hier ?

Oui. Le menu timeshift liste les programmes passés groupés par jour — double-cliquez sur l'un d'eux pour le voir. Vous pouvez aussi reculer par pas fixes, et ces pas s'adaptent à la profondeur réelle de l'archive de votre fournisseur, de trente minutes à une semaine.

Certains fournisseurs acceptent une demande d'archive et servent silencieusement le direct à la place. L'application le vérifie et vous le dit, plutôt que de vous laisser croire que vous regardez hier.

Comment enregistrer ?

Deux entrées :

  • Le bouton REC du lecteur, pour ce que vous regardez.
  • Clic droit sur n'importe quelle chaîne → Enregistrer, pour une que vous ne regardez pas.

Sans durée choisie, l'enregistrement continue jusqu'à ce que vous l'arrêtiez. Un enregistrement peut être regardé pendant qu'il s'écrit encore.

Puis-je fixer une durée, ou programmer ?

Les deux. Le menu REC propose 30 minutes, 1, 2 ou 4 heures, et un enregistrement programmé prend une heure de début et une heure de fin.

Les tâches programmées survivent au redémarrage de l'application, mais celle-ci doit tourner au moment prévu — c'est un programme, pas un service en arrière-plan. Enregistrements → Actifs et programmés montre ce qui est en attente.

L'enregistrement consomme-t-il ma seconde connexion ?

Pas si vous enregistrez la chaîne que vous regardez : c'est le flux du lecteur qui est dérivé, cela ne coûte rien de plus et fonctionne avec les comptes habituels qui n'autorisent qu'un flux à la fois.

Enregistrer une autre chaîne, ou une tâche programmée qui démarre plus tard, ouvre en revanche sa propre connexion au fournisseur.

Une chose à savoir sur l'enregistrement depuis le lecteur : il est finalisé à l'arrêt, donc arrêter la lecture, zapper ou une erreur de flux y met fin.

Puis-je éviter qu'un enregistrement remplisse le disque ?

Oui, à deux niveaux. Paramètres → Enregistrement accepte une limite de taille valable pour tous les enregistrements — un nombre suivi de Mo, Go ou To. Et le menu REC du lecteur a une limite rapide pour la session en cours seulement, de 250 Mo à 10 Go.

Où sont mes enregistrements ?

Là où vous l'indiquez dans Paramètres → Enregistrement. La section Enregistrements de la barre latérale les parcourt, avec les sous-dossiers comme catégories : créer des dossiers, renommer, déplacer, et sélectionner plusieurs éléments pour les supprimer d'un coup.

Multivue, cast et Trakt

Qu'est-ce que la multivue ?

Une fenêtre séparée affichant 2, 4, 6 ou 9 chaînes en direct à la fois dans une grille, chacune étant un flux indépendant. Elles peuvent venir de listes différentes, et même de comptes différents.

Ouvrez-la depuis la barre latérale ; la taille de la grille est dans Paramètres → Multivue. Double-cliquez sur une vignette pour l'agrandir.

Quelle fenêtre j'entends, et comment en changer une ?

Cliquez sur une fenêtre pour lui donner le son — un liseré rouge marque celle que vous entendez.

Clic droit sur n'importe laquelle pour : couper le son, piste audio et sous-titres, la déplacer ou l'échanger avec une autre, ou la retirer. Une chaîne avec replay obtient sa propre frise d'archive dans sa vignette : vous pouvez donc rembobiner une chaîne pendant que les autres restent en direct.

Pourquoi la multivue annonce-t-elle plusieurs connexions ?

Parce qu'elle en utilise plusieurs — une par fenêtre. La plupart des comptes IPTV n'autorisent qu'un ou deux flux simultanés : une grille de neuf sera donc tout simplement refusée par la plupart des fournisseurs.

L'application le dit une fois, avant que vous ne le découvriez par un mur de flux en échec. Si vous voyez « limite de connexions atteinte », c'est généralement pour cela.

Comment caster vers un Chromecast ?

Clic droit sur une chaîne, un film ou un épisode → Caster vers Chromecast…, puis choisissez l'appareil. Les chaînes en direct sont envoyées en HLS, ce qu'attend un récepteur Cast.

Le cast arrête la lecture locale — les deux ensemble feraient une seconde connexion chez votre fournisseur. Un bandeau au-dessus du lecteur nomme l'appareil et ce qui y passe, avec un bouton d'arrêt. Lancer quelque chose dans l'application met aussi fin au cast et rend la lecture.

Le téléviseur refuse une chaîne

Certaines chaînes sont de la vidéo H.264 ordinaire avec de l'audio Dolby Digital Plus. Un Chromecast qui n'est ni un Ultra ni un Google TV n'a pas de décodeur pour cela et rejette le flux sans dire pourquoi.

L'application convertit ces flux sur cet ordinateur et sert le résultat sur votre propre réseau : la vidéo est recopiée telle quelle — seul l'audio est réencodé, ce qui coûte peu — et cela n'arrive qu'après que l'appareil a effectivement refusé le flux. Une chaîne que votre appareil sait lire reçoit toujours le flux d'origine du fournisseur, inchangé.

Cela nécessite ffmpeg, présent dans chaque téléchargement empaqueté.

Comment connecter Trakt ?

Paramètres → Trakt. Vous créez une application sur trakt.tv, collez les deux clés qu'elle vous donne, et autorisez dans le navigateur qui s'ouvre.

Ensuite, ce que vous regardez est scrobblé, et votre liste de suivi et votre historique se consultent dans l'application. Vos fichiers locaux sont scrobblés eux aussi, dès lors que TMDB a pu identifier le fichier.

Vos propres fichiers

Puis-je regarder mes propres fichiers ?

Oui. Fichiers locaux dans la barre latérale parcourt les dossiers que vous ajoutez dans Paramètres → Fichiers locaux.

Un partage réseau déjà monté par votre système apparaît tout seul — un montage SMB gvfs sous Linux, un partage sous /Volumes sur macOS, un lecteur connecté sous Windows. Pour l'application ce sont des chemins ordinaires : il n'y a donc pas de client SMB à l'intérieur qui puisse mal se comporter.

Dossiers ou bibliothèque ?

Les deux, avec un sélecteur dans la colonne centrale.

  • Dossiers montre l'arborescence exactement telle qu'elle est sur le disque.
  • Bibliothèque lit les noms de fichiers et en construit des séries avec saisons et épisodes, les films sous Films — la même forme que les sections du fournisseur.

D'où viennent les affiches ?

De TMDB, pour tout ce qui peut être identifié par nom et année. Ce qui ne peut pas l'être reçoit une image extraite de la vidéo elle-même, et la musique prend sa pochette dans les tags du fichier ou dans une image du dossier.

Un fichier sans année et sans balise de release dans son nom n'est jamais deviné. C'est délibéré : une mauvaise affiche est pire qu'une vignette. Renommez le fichier en y mettant l'année si vous voulez qu'il soit reconnu.

Lit-elle la musique ?

Oui. Les albums sont regroupés, artiste, album et titre viennent des tags, et il y a une file d'attente : ajouter une piste, mettre un dossier entier à la suite, ou lire quelque chose ensuite. Elle passe à la piste suivante toute seule.

Il y a aussi une visualisation et un égaliseur à dix bandes.

Un fichier de l'historique refuse de se lire

Il a été déplacé, renommé, ou son partage n'est pas monté. L'historique dit lequel, et propose de retirer l'entrée, au lieu d'échouer en silence.

S'il s'agit d'un partage, montez-le et réessayez — l'entrée refonctionnera comme avant.

Paramètres

Langue et apparence

Paramètres → Interface. L'interface est traduite en 27 langues et change immédiatement, sans redémarrage. L'arabe, le persan, l'hébreu et l'ourdou inversent toute la mise en page.

Le même onglet propose cinq thèmes de couleurs et sept couleurs d'accent, appliqués en direct.

Réglages par défaut pour tous les flux

Paramètres → Lecture définit ce qui doit se passer sans que vous le demandiez à chaque fois :

  • Langue audio préférée
  • Sous-titres activés ou non, avec une première et une seconde langue préférée
  • Format d'image et tampon réseau par défaut
  • À quel moment la carte « Épisode suivant » apparaît — jamais, ou de une à dix minutes avant

Le menu ⚙ du lecteur peut toujours passer outre pour le flux en cours.

Puis-je mettre des choses hors de portée des autres ?

Oui. Un code PIN protège les catégories et les groupes de favoris verrouillés. Un groupe verrouillé ne révèle même pas quelles chaînes il contient tant que le code n'est pas saisi — il cache le contenu, pas seulement la lecture.

Le code est stocké salé et haché, pas en clair.

Puis-je masquer ou renommer des chaînes ?

Clic droit sur n'importe quelle chaîne, film ou série pour la renommer ou la masquer. Le résultat est en pratique votre propre liste retouchée, enregistrée par liste, et Restaurer les chaînes par défaut… remet tout exactement comme le fournisseur l'envoie.

Des catégories entières peuvent être masquées, renommées ou verrouillées depuis leur menu contextuel. Les chaînes d'une catégorie masquée sont aussi exclues de « Tout ».

Plusieurs fournisseurs à la fois

Ajoutez autant de listes que vous voulez dans Paramètres → Listes de lecture et passez de l'une à l'autre en cours d'exécution. Chacune garde ses favoris, son historique, ses chaînes masquées et ses renommages.

Chacune peut aussi avoir sa propre adresse XMLTV et son propre rythme d'actualisation — jamais, au démarrage, toutes les 2, 6 ou 12 heures, chaque jour ou chaque semaine.

Quand quelque chose cloche

Comment obtenir un journal ?

Le journal transforme « ça ne marche pas » en quelque chose de réparable, et les identifiants en sont masqués automatiquement : il peut donc être joint à un ticket sans risque.

Lancez l'application depuis un terminal avec DOPEIPTV_LOG_FILE défini et elle en écrit un là, en plus de l'affichage.

Linux — AppImage

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

Linux — .deb ou pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

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

Windows — PowerShell, dans le dossier décompressé

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

Reproduisez le problème, fermez l'application et joignez le fichier. Pour bien plus de détail, ajoutez DOPEIPTV_LOG=debug devant la même commande.

L'application ne démarre pas

Lancez-la depuis un terminal — la réponse ci-dessus donne la commande exacte pour votre système — et lisez ce qu'elle affiche. Cela nomme la cause bien plus souvent qu'autrement.

Les builds empaquetées embarquent tout ce qu'il faut. Si vous avez installé depuis les sources avec pipx, il vous faut en plus mpv et ffmpeg de votre distribution :

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

Le son est là mais pas l'image

Le lecteur intégré n'obtient pas de surface vidéo.

  1. Ouvrez ⚙ → Stats for nerds et regardez si des images arrivent — cela sépare un problème de flux d'un problème d'affichage.
  2. Sous Wayland, essayez Paramètres → Lecture → Utiliser le backend X11 puis redémarrez l'application.
  3. Lancez depuis un terminal et cherchez les lignes mentionnant GL ou mpv.

macOS dit que l'application ne peut pas être ouverte

Elle n'est pas encore notarisée par Apple. Faites un clic droit dessus et choisissez Ouvrir, puis Ouvrir dans la boîte de dialogue — ou autorisez-la dans Réglages Système → Confidentialité et sécurité → Ouvrir quand même.

Si macOS dit plutôt que l'application est « endommagée », c'est l'attribut de quarantaine posé au téléchargement. Retirez-le :

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

Aucun de ces avertissements ne signifie qu'il y a un problème avec l'application — seulement que la build n'est pas signée, ce qui demande un certificat Apple payant.

Defender a supprimé dopeiptv.exe

Un faux positif. Deux de ses causes ont été corrigées en 1.2.10 : le lanceur est désormais compilé depuis les sources au lieu d'être le binaire prêt à l'emploi pour lequel les antivirus ont des signatures, et l'exécutable porte une vraie ressource de version.

Si votre moteur le signale encore, autorisez le dossier dans votre antivirus et signalez le faux positif à Microsoft — c'est ce qui finit par régler le problème pour tout le monde, pas seulement pour vous.

Une chaîne ne se lit pas

L'application interroge le fournisseur et vous dit pourquoi en clair au lieu d'afficher une erreur nue : compte expiré, limite de connexions atteinte, flux absent, serveur injoignable, et ainsi de suite.

Si les autres chaînes marchent, c'est celle-là. Si rien ne marche, regardez Paramètres → Listes de lecture — le panneau du compte affiche la date d'expiration et le nombre de connexions autorisées.

« Limite de connexions atteinte »

Votre compte autorise un certain nombre de flux simultanés et ils sont tous pris. Par ordre de probabilité :

  1. La multivue est ouverte — chaque fenêtre est une connexion.
  2. Un enregistrement d'une autre chaîne tourne.
  3. Un autre appareil ou une autre personne utilise le compte.
  4. Une session précédente n'a pas encore expiré chez le fournisseur ; attendre une minute suffit souvent.

Enregistrer la chaîne que vous regardez ne compte pas comme une seconde connexion.

Linux : la barre des tâches affiche une icône vide

Sous Wayland, GNOME et KDE prennent l'icône d'une fenêtre dans une entrée de bureau correspondante et ignorent ce que l'application définit elle-même. Un AppImage n'a pas d'entrée de ce genre tant que rien ne l'installe.

  1. L'application propose d'en ajouter une au premier démarrage. Acceptez — puis redémarrez-la, car la fenêtre ouverte garde l'icône avec laquelle elle a démarré.
  2. Le même réglage est dans Paramètres → Lecture si vous aviez refusé.
  3. Si l'icône n'apparaît toujours pas, un cache d'icônes périmé la masque. GTK lit ce fichier au lieu du dossier :
rm ~/.local/share/icons/hicolor/icon-theme.cache

Installée depuis le .deb, l'entrée est déjà là et rien de tout cela ne s'applique.

« Ouvrir dans une application externe » ne fait rien

Cette option lance un mpv ou un vlc autonome de votre système : l'un des deux doit donc être installé — le lecteur intégré n'a besoin de rien de plus et n'est pas concerné.

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

Vous ne trouvez pas ? Ouvrez un ticket sur GitHub. Indiquez la version affichée dans Paramètres → À propos et joignez le journal — la réponse « Comment obtenir un journal ? » ci-dessus donne la commande exacte pour votre système.