Un guide TV vide est le problème IPTV le plus courant après la lecture elle-même, et ce n'est presque jamais un seul bug. Ce sont six pannes différentes qui aboutissent toutes au même écran blanc. Prises dans cet ordre, vous saurez normalement laquelle vous concerne en deux minutes.
D'abord : est-ce que ça a chargé, ou est-ce que ça a été associé ?
Ce sont deux étapes distinctes et elles échouent pour des raisons totalement différentes. L'application télécharge et analyse d'abord un fichier XMLTV — c'est le chargement. Ensuite elle doit décider à quelle chaîne de votre playlist appartient chaque entrée du guide — c'est l'association. Un guide peut charger parfaitement et n'afficher rien du tout.
Dans OneTV Connect, ouvrez Réglages → Guide TV (EPG). La source affiche une date de dernière mise à jour et un nombre de programmes. Cela vous dit quelle moitié du tuyau vous êtes en train de déboguer :
- Aucune date de mise à jour, ou zéro programme — problème de chargement. Voyez les sections 1 et 2.
- Des milliers de programmes mais un guide vide — problème d'association. Allez directement à la section 3.
La plupart des gens qui se battent depuis une heure avec un guide vide sont dans le second cas et continuent de ressaisir l'URL, ce qui ne peut rien changer.
1. L'URL ne renvoie pas du XML
Une URL XMLTV doit répondre par le document XML lui-même. Trois choses tournent mal régulièrement :
- Le lien pointe vers une page web, pas vers un fichier. Si vous l'avez copié
depuis la barre d'adresse d'un site qui référence des guides, vous avez peut-être une page de
téléchargement. Ouvrez l'URL dans un navigateur : vous devez voir du XML brut commençant par
<tv>, ou un téléchargement de fichier — pas une page mise en forme avec des boutons. - L'URL redirige vers une page de connexion. Les sources qui exigent un compte
répondent souvent par une page HTML d'authentification avec un code HTTP 200 : rien ne
ressemble à une erreur. L'analyseur ne trouve alors aucun élément
<programme>et annonce zéro. - C'est du http:// sur un hôte passé en https://. Essayez d'abord la forme https ; un ancien point d'entrée http répond souvent par une redirection que le téléchargement du guide ne suit pas.
Dans l'app, collez l'adresse dans Réglages → Guide TV (XMLTV) → URL XMLTV (epg.xml), puis utilisez Forcer le rechargement de l'EPG (vider le cache) plutôt qu'un simple rechargement. Un rechargement normal peut recevoir une réponse « non modifié » depuis le cache, ce qui est exactement ce qu'on ne veut pas en testant une URL qu'on vient de changer.
2. Le fichier est trop lourd, ou compressé autrement que prévu
Les fichiers XMLTV nationaux sont volumineux. Une semaine complète pour une centaine de chaînes
dépasse couramment des dizaines de mégaoctets non compressés — c'est pourquoi presque toutes
les sources proposent une variante gzip, dont l'URL se termine par .xml.gz au lieu
de .xml. Préférez-la : elle se télécharge plusieurs fois plus vite et risque
beaucoup moins d'expirer sur la pile réseau d'un appareil TV.
Si une source propose des fichiers par pays ou par bouquet, prenez le plus étroit. Un guide contenant douze mille chaînes quand votre playlist en compte trois cents coûte du téléchargement, du temps d'analyse et de la mémoire à chaque rafraîchissement, sans rien apporter. Cela compte davantage sur une box que sur un téléphone : le matériel TV a bien moins de marge mémoire, et un guide surdimensionné est une cause classique d'application qui se relance pendant le téléchargement.
3. Ça a chargé, mais rien ne correspond à vos chaînes
C'est le gros morceau. Votre playlist et votre guide sont deux documents indépendants, écrits par deux personnes différentes, et ils doivent s'accorder sur un identifiant par chaîne.
Dans la M3U, chaque chaîne porte un attribut tvg-id. Dans le fichier XMLTV, chaque
chaîne est déclarée avec un attribut id. Un programme est rattaché à une chaîne
par cet identifiant. Si votre playlist dit tvg-id="TF1" et que le guide déclare
id="TF1.fr", les deux ne se rencontreront jamais, quelle que soit la qualité des
fichiers.
OneTV Connect essaie plusieurs stratégies avant d'abandonner : l'identifiant exact d'abord,
puis une comparaison de noms normalisés qui ignore la casse, les accents et les suffixes
habituels HD, FHD et 4K. Cela règle automatiquement la
majorité des chaînes. Pour le reste, appui long sur une chaîne puis Associer à l'EPG
pour choisir vous-même la bonne entrée. Les associations manuelles se synchronisent entre vos
appareils via iCloud : vous le faites une fois, pas une fois par appareil.
Pour comprendre ce que fait l'association et pourquoi elle rate certaines chaînes, dix minutes bien investies : comment marche vraiment l'association tvg-id et tvg-name.
4. Le guide est là mais s'arrête au bout de quelques heures
Un guide qui affiche la soirée puis plus rien signifie généralement que la source ne publie qu'une fenêtre courte — certaines publient 24 ou 48 heures, pas une semaine. C'est une propriété de la source, pas un réglage qu'on peut augmenter.
Cela peut aussi vouloir dire que la source publie plusieurs jours mais que le fichier a été tronqué au téléchargement, typiquement sur une connexion instable. Si un rechargement manuel sur un bon réseau fait soudain apparaître trois jours de plus, c'était ça.
Dans les deux cas, la solution pratique est d'ajouter une deuxième source. Les sources s'empilent au lieu de se remplacer : une source plus profonde comble derrière une source mieux associée mais plus courte.
5. Tout est décalé d'un nombre entier d'heures
Si les programmes sont les bons mais commencent une heure trop tôt ou trop tard, avec le même décalage partout, c'est un bug de fuseau horaire dans la source, pas quelque chose qui vient de votre appareil.
Un horodatage XMLTV ressemble à 20260804203000 +0200 : quatorze chiffres d'heure
locale, puis le décalage par rapport à UTC. Un fichier correct permet à n'importe quel client
de convertir vers le fuseau du spectateur. Deux choses cassent ça — une source qui omet
complètement le décalage (le client doit deviner), et une source qui écrit l'heure locale mais
indique toujours +0000, ce qui est silencieusement faux la majeure partie de
l'année en Europe.
On ne peut pas corriger ça côté client sans casser les sources qui, elles, sont correctes. La solution est d'utiliser une autre source pour les chaînes concernées. Si le décalage a changé d'exactement une heure le dernier dimanche de mars ou d'octobre, vous avez trouvé une source qui ne gère pas l'heure d'été.
6. Le guide charge, mais affiche les programmes de la veille
Deux causes très différentes donnent le même symptôme. Soit le rafraîchissement ne tourne pas, soit il tourne et c'est la source qui n'a pas été mise à jour.
Regardez la date de dernière mise à jour dans Réglages → Guide TV (EPG). Si elle date de plusieurs jours, le rafraîchissement automatique n'aboutit pas — le plus souvent parce que l'appareil n'est jamais resté allumé et connecté assez longtemps. Si la date est récente mais le contenu périmé, c'est la source qui publie un vieux fichier, et aucun rechargement n'y changera rien.
Quand il faut vraiment repartir de zéro, Effacer les données EPG dans les réglages de stockage supprime le guide enregistré, de sorte que le chargement suivant ne peut rien réutiliser. À sortir après un changement de source, pas comme habitude : recharger entièrement un guide national est un gros téléchargement.
Questions fréquentes
Pourquoi mon guide est-il vide alors que l'EPG indique qu'il a chargé ?
Le fichier a bien été téléchargé et analysé, mais aucun de ses identifiants de chaîne ne correspond aux chaînes de votre playlist. Le guide n'est pas absent : il est rattaché à des identifiants que votre playlist n'utilise pas. Comparez les tvg-id de votre M3U aux attributs id du fichier XMLTV.
À quelle fréquence rafraîchir une source EPG ?
Toutes les 12 à 24 heures suffit pour un guide qui couvre plusieurs jours. Plus souvent, on retélécharge surtout le même fichier, et sur un abonnement qui limite les connexions cela entre en concurrence avec la lecture. Forcez un rechargement manuel quand vous savez que la grille vient de changer, par exemple avant un week-end sportif.
Mon guide affiche des horaires décalés d'une ou deux heures.
C'est un problème de fuseau horaire, pas de chargement. Les horodatages XMLTV portent leur propre décalage UTC, et certaines sources publient une heure locale avec un décalage faux ou absent. Si tout est décalé d'un nombre entier d'heures, la source est en cause : essayez-en une autre pour ces chaînes.
Puis-je utiliser plusieurs sources EPG en même temps ?
Oui, et c'est souvent la bonne réponse. Les sources s'empilent au lieu de se remplacer : la première qui possède un programme pour une chaîne et un horaire donnés l'emporte, les autres comblent les trous. Une source nationale plus une source sport couvre la majorité des installations.
Toujours vide après ces six points ? Les chances sont écrasantes qu'il s'agisse de la section 3, et que la réponse soit une association manuelle sur la poignée de chaînes qui vous importent vraiment. Si vous préférez repartir d'une source connue pour s'associer proprement, voyez où trouver une source XMLTV pour votre pays, ou comparez avec l'option intégrée dans EPG Xtream ou XMLTV. Le replay et le timeshift dépendent eux aussi d'un guide correct : régler ce point rapporte deux fois.