LM Gestion

Beyond TV XMLTV Importer : Installation et Configuration

XMLTV

Le format XMLTV est issu à partir d'un projet "Open Source" dont le principe est simple. Un utilitaire extrait les données de programmes à partir d'un site Web et sauvegarde ces données au format XML. Ces données XML peuvent ensuite être utilisées dans un programme destiné à les afficher.

Vous pouvez en apprendre plus sur XMLTV à cette adresse : http://membled.com/work/apps/xmltv 
Vous pouvez téléchargez les utilitaires permettant de récupérer les programmes à cette adresse : http://sourceforge.net/project/showfiles.php?group_id=39046

Installation

Etape 1 : Installez Beyond TV 3.4 ou une version plus récente et lancez l'assistant d'installation de Beyond TV. A la fin de l'installation vérifiez que vous pouvez voir correctement la télévision. 

Note : vous n'êtes pas obligé de configurer correctement vos chaînes dans Beyond TV, en effet l'importation XMLTV remplacera toutes vos chaînes.

Si vous utilisez une version de Beyond TV inférieure à la 3.5, vérifiez que vous avez désactivé les mises à jour automatiques des programmes télé "Snapstream.Net". Pour cela ouvrez l'utilitaire d'administration Web (Web Admin, http://localhost:8129) et choisissez "Settings" puis "Snapstream.Net Settings" et dans la rubrique "Allow Automatic Updates" choisissez "Disable" dans la liste déroulante.

Etape 2 : Obtenez vos données XMLTV à l'aide d'un utilitaire XMLTV récupérant les données de programmes à partir d'un site Web.

Etape 3 : Installez notre utilitaire d'importation XMLTV. Si vous ne l'avez pas encore fait, téléchargez notre utilitaire d'importation XMLTV. Lancez le logiciel d'installation et suivez les instructions de l'assistant d'installation. Lancez ensuite l'utilitaire d'importation, vous devriez obtenir l'assistant suivant :

Si vous ne souhaitez plus afficher l'assistant et retrouver par la suite l'interface classique cochez la case "ne plus afficher l'assistant". Cliquez ensuite sur "Suivant >"

Indiquez ici le chemin vers votre fichier XMLTV et l'éventuel mot de passe que vous aurez affecté à Beyond TV (à l'aide de son utilitaire d'administration Web Admin) puis cliquez sur "Suivant >"

Ici vous pouvez indiquez si vous le souhaitez le chemin vers votre grabber XMLTV ainsi que ses paramètres de ligne de commande. De cette manière si vous choisissez d'automatiser notre utilitaire, il se chargera au préalable de déclencher votre grabber pour qu'il récupère votre fichier XMLTV, cliquez ensuite sur "Suivant >".

Indiquez ici le décalage horaire de votre région par rapport au temps universel. Vous pouvez aussi indiquer à l'assistant qu'il doit utiliser l'heure d'été / d'hiver automatiquement. Normalement les paramètres sélectionnés par défaut devraient être corrects pour votre zone.

L'assistant vous affiche pour vous aider l'heure de diffusion d'un programme de votre fichier XMLTV, réglez les paramètres jusqu'à ce que l'heure de diffusion vous semble correcte, puis cliquez sur "Suivant >".

Choisissez une méthode de détection pour les programmes uniques. L'assistant vous suggère la méthode la plus appropriée en fonction des propriétés de votre fichier XMLTV. Si vous constatez après l'importation que beaucoup de programmes différents sont considérés comme étant les mêmes par Beyond TV, refaite une importation en modifiant la méthode (la plus sûre étant celle basée sur la date de diffusion).

La case à cocher "les programmes sans date de 1ère diffusion sont des rediffusions" doit être décochée, sauf si votre fichier XMLTV ne contient que des noeuds "<premiere>" qui identifie les 1ere diffusions et que tous les programmes sans ce noeud "<premiere>" sont bien des rediffusions. Dans le doute laissez cette case décochée.

Indiquez les mots clés pour identifier films, séries infos et sports, ainsi que les préfixes utilisés pour la numérotation des épisodes d'une série et cliquez sur "Suivant >".

Cliquez maintenant sur le bouton "Editer les Chaînes" pour créer les correspondances entre les chaînes de votre fichier XMLTV et les chaînes de Beyond TV. Vous devriez voir apparaître l'éditeur de bouquets et de chaînes comme ci-dessous :

A l'aide de l'éditeur de bouquets, créez vos bouquets de chaînes. Un bouquet est un regroupement de chaînes accessibles sur une même source vidéo (par ex: le tuner ou l'entrée vidéo composite).

Cet éditeur présente la liste des chaînes que notre utilitaire a trouvées dans votre fichier XMLTV. Pour chaque chaîne trouvée, vous devez spécifier :

  • Le nom de la chaîne tel qu'il apparaîtra dans Beyond TV (en particulier dans l'outil d'administration Web)
  • Le nom court de la chaîne tel qu'il apparaîtra dans Beyond TV (en particulier dans l'interface plein écran)
  • Le numéro de la chaîne, c'est à dire le numéro de chaîne utilisé pour capter la chaîne (par exemple 25 pour TF1 sur l'émetteur de la Tour Eiffel)
  • Si vous avez accès à des chaînes hautes définition aux USA (ATSC) vous pouvez alors ajouter le numéro majeur et le numéro mineur, ces numéros doivent être laissés vides dans tous les autres cas.
  • Le numéro du bouquet sur lequel vous souhaitez que la chaîne soit présente.

Si vous le souhaitez vous pouvez ajouter des chaînes supplémentaires à vos bouquets, pour cela choisissez pour chaque chaîne supplémentaire :

  • Un identifiant (similaire à ceux que vous avez dans votre fichier XMLTV)
  • Un nom et nom court
  • Le numéro de la chaîne
  • Le bouquet sur lequel placer la chaîne
  • Si la chaîne doit reprendre les programmes d'une chaîne existante.
  • Un décalage horaire (en heures) pour créer des chaines "+1"

Les chaînes supplémentaires sont surtout utiles si vous souhaitez ajouter des chaînes non présentes dans votre fichier XMLTV ou bien dupliquer des chaînes sur plusieurs bouquets.

Si vous dupliquez des chaînes sur plusieurs bouquets et que vous souhaitez que Beyond TV considère les chaînes ainsi dupliquées comme unique (vous ne voyez la chaîne qu'une seule fois dans votre guide des programmes), vous devez faire en sorte que les chaînes dupliquées possèdent toutes les mêmes identifiant et le même numéro de chaîne.

Nouveau : Si vous utilisez Beyond TV version 3.5 ou supérieure, vous pouvez désormais associer à chaque source vidéo de Beyond TV un des bouquets de chaînes que vous venez de créer. Pour cela cliquez sur l'onglet "Sources Vidéos" de l'éditeur de chaînes.

Vous pouvez aussi éditer les catégories de votre fichier XMLTV. Le but de l'éditeur de catégories est de diminuer le nombres de catégories et de les consolider (par ex. au lieu d'avoir "Film, drame" et "Film, dramatique", vous créez une seule catégorie "Film / Drame"). L'éditeur vous propose des catégories de premier niveau recommandées (Film, Série, Sport, Infos etc...) vous ne pouvez pas les supprimer, mais vous pouvez les ignorer (sauf : Film et Série) et créer de nouvelles catégories de premier niveau.

Quand vous éditez une catégorie vous pouvez spécifier :

  • Son nom : c'est un nom purement interne (un identifiant en quelque sorte). Vous ne pouvez pas le changer pour les catégories prédéfinies. Ce nom n'est pas utilisé en dehors de l'uitilitaire d'importation.
  • Son nom d'affichage : c'est le nom qui sera affiché dans Beyond TV.
  • Les mots clés : vous pouvez taper ici une liste de mots clés séparés par des virgules. Lorsqu'une catégorie XMLTV contient l'un de ces mots clés alors elle sera associée à votre nouvelle catégorie.
  • Les mots clés d'exclusion : vous pouvez taper ici une liste de mots clés séparés par des virgules. Lorsqu'une catégorie XMLTV contient l'un de ces mots clés alors elle ne pourra être associée à votre nouvelle catégorie (même si elle correspond aux autres mots clés).

Après avoir édité vos listes de mots clés, cliquez sur le bouton "Test" pour voir le résultat de votre filtre. De cette manière vous pouvez facilement l'améliorer.

Vous remarquerez que vous ne pouvez pas éditer les mots clés de la catégorie "Other" (Autre). Ceci s'explique par le fait que cette catégorie sert uniquement à recueillir toutes les catégories XMLTV qui ne correspondent à aucune des autres catégories de l'éditeur. De cette manière vous savez précisément ce que vous devez ajouter / modifier.

Vous pouvez ajouter / supprimer des sous-catégories, de cette manière vous pouvez créer la classification qui vous semble la plus pertinente. Cependant Beyond TV ne comprend que deux niveau : une catégorie principale et une sous-catégorie. Il est donc recommandé de se contenter de deux niveaux. Pour plus d'éfficacité, essayez d'utiliser les même sous-catégories pour "Film" et "Série", ainsi que pour "Magazine" et "Educationnal" (Documentaire).

Remarque : après chaque importation, vous trouverez dans l'observateur d'évenements de Windows deux "informations" qui vous indiqueront quelles catégories XMLTV ne peuvent être associées à l'une de vos catégories principales et quelles catégories XMLTV peuvent être associées à une catégorie principale, mais ne peuvent l'être à une sous-catégorie. Ceci vous permettra d'ajuster votre liste de catégories au fil du temps.

Lorsque vous avez terminé d'éditer la liste des chaînes et vos catégories, cliquez sur le bouton "Mettre à jour", votre liste de chaînes et de bouquets est sauvegardée et vous retournerez à l'assistant, cliquez sur le bouton "Suivant >".

Si vous avez fait un don pour notre logiciel, vous pouvez créer ici un tâche planifiée pour automatiser la mise à jour de Beyond TV, lorsque vous avez choisi votre plan, cliquez sur le bouton "Suivant >".

Note : vous devez aussi automatiser votre utilitaire XMLTV chargé de télécharger votre fichier XMLTV (et de planifier cette tâche avant celle que vous venez de créer pour mettre à jour le guide des programmes de Beyond TV)

Lors de l'importation les barres de progression vous informeront de l'état du transfert de vos données dans Beyond TV, vous devriez voir le nom de chaque chaîne traitée s'afficher. Notre utilitaire transforme alors votre fichier XMLTV en trois nouveaux fichiers XML (ou plus si vous avez plus d'un bouquet de chaînes) qui seront placés dans le dossier de configuration de Beyond TV (dans le dossier "C:\Documents and Settings\All Users\Application Data\SnapStream\Beyond TV\3rdPartyGuideData").

A la fin de la transformation, notre utilitaire demande à Beyond TV de charger ces nouvelles données de programmes.

La fin de l'importation vous sera signifiée par l'affichage du message "Importation terminée" au dessus de la barre de progression principale.

Pour vérifier que Beyond TV a bien importé les nouvelles données de programme, consultez les logs de Beyond TV, vous devriez voir apparaître ceci dans les logs :

Cliquez ensuite sur le bouton "Suivant >"

Si vous utilisez une version de Beyond TV inférieur à 3.5, vous devez ensuite indiquer à Beyond TV qu'il doit utiliser les nouvelles données de programme qu'il aura chargé. Pour cela ouvrez l'utilitaire d'administration Web de Beyond TV (Web Admin, http://localhost:8129 ), puis choisissez "Settings", puis "Audio and Video Inputs".

Editez la source qui est utilisé avec les données de programme et cliquez sur "Edit Settings", et dans la rubrique "Tuning Settings", choisissez le "Lineup" "Snapstream.Net Lineup" dans la liste déroulante (ou un des bouquets de chaîne que vous avez créé dans l'éditeur), comme indiqué sur la figure ci-dessous :

Avec les versions de Beyond TV 3.5 ou supérieures, normalement l'utilitaire d'importation XMLTV a déjà associé vos bouquets XMLTV à vos sources vidéos (si vous avez renseigné cette information dans l'éditeur de chaînes). Vous pouvez néanmoins vérifier que tout est configuré comme il se doit dans le Web Admin de Beyond TV comme indiqué ci-dessus.

Si vous rencontrez des problèmes, n'hésitez pas à consulter la FAQ.



(c) 2008 LM Gestion