Le guide est vide : comment en trouver la cause

Un guide vide a 3 causes possibles. Séparez-les avant de changer quoi que ce soit, parce que le correctif diffère pour chacune et que 2 d’entre elles ne sont pas des réglages.

Le fichier n’est pas arrivé. Le fichier est arrivé et n’a pas pu être lu. Le fichier est arrivé, a été lu, et rien dedans ne correspondait à vos chaînes.

La troisième est de loin la plus fréquente.

D’abord : regardez-vous au bon endroit ?#

Sur une console, vérifiez ceci avant tout le reste. La grille des programmes vit à l’intérieur de la TV en direct, pas comme destination à part. Syntonisez une chaîne, ouvrez la couche des programmes, et les gâchettes font défiler un jour à la fois.

L’entrée Guide TV autonome dans la navigation de la console est un espace réservé. L’ouvrir et n’y rien trouver ne dit rien sur vos données de guide. Cela piège les gens assez souvent pour être la première chose à écarter.

Cause 1 : le fichier n’est pas arrivé#

Vos appareils téléchargent les fichiers de guide directement. Nos serveurs ne les récupèrent jamais pour vous, ce qui est une règle délibérée plutôt qu’une limitation, et cela a une conséquence diagnostique : un guide qui fonctionne sur une machine et pas sur une autre est un problème de réseau local, pas un problème de compte.

Testez-le en ouvrant l’URL du guide dans un navigateur sur la machine qui échoue. Si le fichier s’y télécharge, l’application peut aussi l’atteindre. Sinon, le problème est en dehors de l’application.

Vérifiez aussi la forme du conteneur. 5 sont acceptées :

.xml     .xmltv     .gz     .zip     .xz

Une URL qui répond par une page d’erreur HTML échoue d’une manière qui ressemble à un guide vide.

Cause 2 : le fichier est arrivé et n’a pas pu être lu#

Moins fréquent qu’autrefois, et bon à connaître parce que l’échec est spectaculaire.

Un jeu de 51 vrais fichiers de guide a révélé 3 défauts distincts. Je ne m’attendais pas à ce qu’un seul octet fasse tomber le guide entier d’un fournisseur, et chacun des 3 en était capable. Une esperluette non échappée dans un titre de programme. Un fichier déclarant UTF-8 dans son en-tête tout en portant des octets Latin-1 dans son corps. Un caractère de contrôle égaré dans une description.

Les 3 sont maintenant réparés plutôt que fatals, et les réparations sont comptées, donc un fichier qui a eu besoin d’être rafistolé le dit au lieu de fonctionner en silence. Sur une version récente, cette cause est improbable.

Une forme reste à vérifier : un guide compressé tronqué en transit se décompresse partiellement et vous donne la moitié d’un guide, ce qui se lit comme « certaines chaînes ont des données et d’autres non ». Cela a son propre article : un guide qui s’arrête à mi-chemin.

Cause 3 : rien n’a correspondu#

C’est la réponse la plupart du temps, et ce n’est un défaut d’aucun des deux fichiers.

Un guide est joint à votre liste de chaînes par identifiant. Votre playlist dit qu’une chaîne est tvg-id="bbc1.uk", et votre fichier de guide doit contenir une chaîne dont l’identifiant est exactement celui-là. Si la playlist de votre fournisseur utilise une convention et votre guide une autre, la jointure ne produit rien, alors que les deux fichiers sont individuellement parfaits.

playlist   #EXTINF:-1 tvg-id="bbc1.uk",BBC One HD
guide      <channel id="BBCOne.uk">      -> no match, no schedule
guide      <channel id="bbc1.uk">        -> match

Les symptômes qui pointent ici : les chaînes se lisent bien, le guide est vierge pour toutes ou pour un groupe, et le fichier de guide est manifestement volumineux quand vous le téléchargez. Cette combinaison est un problème de correspondance à chaque fois.

Deux correctifs. Si votre fournisseur publie son propre XMLTV, utilisez-le : ses identifiants correspondent à sa playlist par construction. Sinon, utilisez le remplacement par chaîne, accessible via Corriger le guide dans l’en-tête d’aperçu de la TV en direct, et pointez une chaîne vers la bonne entrée de guide à la main. Ce remplacement existe parce que la correspondance automatique ne peut pas toujours gagner. Une correction est stockée sur la chaîne plutôt que sur la source et synchronisée avec votre compte, donc corriger une chaîne une fois la corrige sur chaque appareil et pour chaque fournisseur qui la propose.

Pendant que vous y êtes#

Deux états de configuration produisent un guide lent plutôt qu’absent.

Le mode global accepte jusqu’à 15 URL. Chaque grand guide national que vous ajoutez est un fichier que votre appareil télécharge et analyse avant que le guide soit complet, donc plusieurs d’entre eux donnent un guide qui se remplit progressivement. Le mode par pays avertit au-delà de 5 pays pour la même raison.

Et un premier lancement avec une grande source prend du temps : environ 77 842 titres répartis sur quelque 444 catégories, c’est beaucoup à indexer. Pendant les premières minutes, un guide encore en cours de remplissage est identique à un guide vide.

Pour ce que le fichier est censé contenir, ce qu’est XMLTV. Si le guide est là mais que les horaires sont faux, c’est un problème différent avec une cause précise : pourquoi les horaires du guide sont décalés.