XMLTV Importer pour SageTV : 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écharger les utilitaires (grabber) permettant de récupérer les programmes à cette adresse : http://sourceforge.net/project/showfiles.php?group_id=39046

Installation

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

Vous n'êtes pas obligé de configurer correctement vos chaînes dans SageTV, en effet l'importation XMLTV remplacera toutes vos chaînes. Cependant il est recommandé d'effectuer une recherche des chaînes pour obtenir au moins le numéro de chaîne (pour les tuners ATSC, DVB-T / DVB-S / DVB-C, les numéros de chaînes sont visibles dans le fichier .frq que SageTV créé après avoir recherché les chaînes).

Etape 2 : Obtenez vos données XMLTV à l'aide d'un grabber 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.

Stoppez SageTV et lancez le logiciel d'installation et suivez les instructions de l'assistant d'installation. Lancez ensuite l'utilitaire d'importation, vous obtenez l'écran d'accueil suivant :

L'écran d'accueil vous montre les tâches à accomplir dans l'ordre de haut en bas :

1. Indiquez l'emplacement de vos fichiers XMLTV et configurez éventuellement vos grabbers XMLTV
2. Créez les bouquets de chaînes que vous recevez
3. Editez les catégories et recommandations parentales
4. Créez des règles de 1ère diffusion / rediffusion (Vous n'utiliserez cette fonction qu'après avoir importé une première fois vos données, lorsque vous serez assez familier des concepts utilisés par XMLTV Importer)
5. Configurez d'autres options avancées
6. Décidez quand XMLTV Importer doit importer automatiquement votre guide télé (cette fonction n'est disponible que pour nos donateurs)
7. Mettez à jour votre guide télé SageTV

Fichiers XMLTV et Grabber

Vous devez tout d'abord indiquer à XMLTV Importer l'emplacement du ou des fichiers XMLTV que vous avez déjà téléchargés à l'aide de votre grabber XMLTV. Vous pouvez utiliser plus d'un fichier XMLTV comme source de données pour votre guide télé. Pour ajouter une source, cliquez sur le lien "Ajouter une nouvelle source XMLTV".

Donnez un nom à votre source XMLTV (ce nom est à usage interne uniquement) et tapez le chemin complet vers le fichier XMLTV ou utilisez le bouton "Parcourir..." pour le localiser.

Attention: si votre fichier XMLTV fait référence au DTD XMLTV, le DTD doit être placé dans le même dossier que votre fichier XMLTV (téléchargez le DTD XMLTV version 1.27)

Vous pouvez aussi, si vous le souhaitez, indiquer à XMLTV Importer l'emplacement de votre grabber XMLTV. De cette manière XMLTV Importer pourra lancer votre grabber avant d'effectuer l'import. Cliquez sur le bouton "Suivant >"

Indiquez ici vos paramètres de fuseau horaire. Vous devez entrez le nombre d'heures à soustraire des heures de diffusion des programmes présents dans votre fichiers XMLTV pour retrouver une heure en temps universel (UTC ou GMT). Vous devez aussi indiquer si votre fuseau utilise l'heure d'été. XMLTV Importer devrait déjà avoir sélectionné les valeurs qui correspondent au fuseau horaire utilisé sur votre PC. Pour vous aider à trouver les bons paramètres, XMLTV Importer affiche l'heure de diffusion d'un programme d'exemple, ajustez les différents paramètres jusqu'à ce que l'heure de diffusion soit correcte puis cliquez sur le bouton "Suivant >".

XMLTV Importer doit savoir comment différencier deux épisodes d'une même série. Pour ce faire, vous avez le choix entre trois options différentes. XMLTV Importer a sélectionné celle qui semblait la plus adaptée à vos données XMLTV.

Si après avoir importé vos données vous constatez que plusieurs épisodes sont les mêmes alors qu'ils devraient être différents, choisissez une autre méthode de différenciation.

La case à cocher "les programmes sans date de 1ère diffusion sont des rediffusions" doit être cochée si vous voulez que tous les programmes qui ne possèdent pas de date de 1ère diffusion dans votre fichier XMLTV soient considérés comme de vieux programmes et par conséquent des rediffusions. Si vous n'êtes pas sûr de vous, laissez cette case décochée, XMLTV Importer essaiera de lui même de déterminer si un programme est nouveau ou est une rediffusion (Si votre fichier XMLTV ne contient aucune information à propos des 1èr diff. ou rediff, alors tous les programmes commenceront par être des 1er diff. et au fur et à mesure des imports successifs vous verrez apparaître des rediffs.).

Bouquets de chaînes

Vous devez organiser vos chaînes en bouquets. Les bouquets sont des ensembles de chaînes que vous êtes en mesure de recevoir sur un tuner dans SageTV. Normalement vous devez créer autant de bouquet que vous avez de sources vidéos (une carte tuner peut recevoir plusieurs sources : par exemple entrée antenne et S/Video). Pour créer un nouveau bouquet, cliquez sur le lien "Ajouter un nouveau bouquet".

Vous devez tout d'abord décrire votre bouquet. Tous ces champs aideront d'autres utilisateurs à trouver un bouquet dans notre base de données en ligne:

• donnez un nom à votre bouquet (ce nom sera affiché dans SageTV)
• choisissez votre pays
• tapez ou sélectionnez votre région (la liste des régions est téléchargée depuis Internet, si vous ne trouvez pas votre région dans la liste, tapez là simplement dans le champ). Si votre bouquet concerne votre pays tout entier, sans distinction de région, laissez ce champ vide.
• sélectionnez le type de réception TV utilisé par ce bouquet (numérique / analogique / satellite / utilisation d'un décodeur etc...)
• éventuellement, sélectionnez ou tapez le nom du fournisseur de chaînes pour ce bouquet, ou la "marque" commerciale ou nom du bouquet.
• si vous créez un bouquet pour une source SageTV numérique (ATSC, DVB-T/S/C), vous pouvez indiquer quel fichier de fréquences est utilisé par SageTV pour ce bouquet. Ceci permettra à XMLTV Importer de vous proposer directement la bonne liste de chaînes avec leur numéro SageTV. Vous pouvez aussi télécharger un fichier de fréquences mis à jour depuis notre base de données en ligne, il remplacera votre actuel fichier de fréquences (redémarrez SageTV pour que les modification soient effectives)

Cliquez sur le bouton "Suivant> " pour créer la liste de chaînes. Vous devez ajouter toutes les chaînes que vous pouvez recevoir à travers la carte tuner qui sera utilisée avec ce bouquet. Vous pouvez ajouter les chaînes une par une en cliquant sur le bouton "Ajouter une chaîne" ou ajouter plusieurs chaînes en provenance d'une source externe.

Si vous cliquez sur le bouton "Ajoutez des chaînes" vous pouvez alors ajouter des chaînes depuis :

• Notre base de données en ligne : XMLTV Importer cherchera une liste de chaînes qui correspond aux caractéristiques de votre bouquet (Pays / Région etc...)
• Votre fichier XMLTV : XMLTV Importer affichera la liste de toutes les chaînes présentes dans votre fichier XMLTV
• Un autre bouquet déjà crée (ceci est utile quand plusieurs bouquets partagent les mêmes chaînes) 
• Les fichiers de scan de SageTV pour ATSC, DVB-T/S/C : XMLTV Importer affiche toutes les chaînes trouvées par SageTV lors de vos précédentes recherches de chaînes. 
• DVBViewer Recorder: XMLTV Importer affichera la liste des chaînes de chaque bouquet créé dans DVBViewer Recorder.

 Pour chaque chaîne dans la liste vous devez fournir:

• La référence de la chaîne (normalement crée pour vous ou identique à l'ID XMLTV)
• Le nom de la chaîne 
• Le nom court de la chaîne (il sera affiché dans SageTV)
• Le numéro physique de la chaîne; il est utilisé pour syntoniser la chaîne dans SageTV à travers votre carte de capture ou plug-in enregistreur
• Le numéro logique de la chaîne; il sera affiché dans le guide des programmes (si spécifié, sinon le numéro physique est utilisé)
• Le nombre d'heures à ajouter ou soustraire à chaque horaire de diffusion des programmes (à utiliser si vous souhaitez créer une chaîne "+1")
• Si la chaîne est une chaînes HD ou non et de fait autorise le marqueur "HD" pour les programmes (certaines sources XMLTV proposent le marqueur HD pour les programmes même si la chaîne ne diffuse pas en HD)
• L'ID XMLTV qui correspond aux données du guide pour cette chaîne 

Si vous dupliquez une chaîne pour être présente sur plusieurs bouquets et que vous souhaitez que SageTV considère que la chaîne est bien là même sur les deux bouquets et n'affiche donc cette chaîne qu'une seule fois dans votre guide, assurez vous de donner la même référence à la chaîne dupliquée.

Catégories et Recommandations parentales

L'éditeur de recommandations parentales vous présente toutes les recommandations trouvées dans votre fichier XMLTV. Pour que SageTV reconnaisse ces recommandations, vous devez sélectionner la recommandation SageTV approchante dans la liste déroulante. Vous pouvez également ajouter des détails concernant la nature de la recommandation (tels que le contenu du programme) dans le champ "Information complémentaire", cela peut s'avérer utile pour affiner vos restrictions parentales.

Vous pouvez aussi éditer les catégories trouvées dans votre fichier XMLTV. L'objectif de l'éditeur de catégories est de réduire et d'organiser les catégories. L'éditeur contient déjà les principales catégories recommandées (Film, Série, Sport, Infos etc...) vous ne pouvez pas les supprimer, vous pouvez cependant les ignorer (sauf Film et Série) et vous pouvez créer de nouvelles catégories.

Quand vous éditez une catégorie vous pouvez indiquer : 

• Son Nom : Ce nom sera affiché dans SageTV. Pour la catégorie "Movie", selon la version de SageTV utilisée (avec ou sans plug-in) il sera peut être nécessaire de la laisser en anglais.
• Les mots clés : saisissez ici plusieurs mots clés séparés par des virgules; quand XMLTV Importer trouve un de ces mots clés dans une catégorie XMLTV, il la remplacera par votre catégorie.
• Les mots clés d'exclusion : cette liste de mots clés séparés par des virgules empêchent une catégorie XMLTV d'être associée à votre catégorie si un de ces mots clés y est trouvé.
• Si vous voulez que tous les programmes appartenant à cette catégorie soient enregistrés par SageTV (sans distinction entre 1ère diffusion ou rediffusion) cochez la case "les programmes de cette catégorie sont génériques". En cochant cette case XMLTV Importer n'essaiera pas de trouver une date de 1ère diffusion pour le programme (lorsque le programme n'a pas de titre d'épisode). Ceci est particulièrement utile pour les programmes d'informations pour lesquels quasiment toutes les diffusions sont des 1ères diffusions. Si un des programmes de cette catégorie devait déroger à cette règle, vous pouvez toujours créer une règle pour ce programme.
• Si vous savez que tous les programmes de cette catégorie ne sont pas les même sur toutes vos chaînes, vous pouvez cocher la case "les programmes de cette catégorie ne sont pas les mêmes sur toutes les chaînes". En sélectionnant cette option, XMLTV Importer utilisera un identifiant unique pour le programme sur chaque chaîne, de cette manière un programme ayant le même nom "vu" (état "watched" SageTV) sur une chaîne ne sera pas marqué comme "vu" sur une autre.

Après avoir édité les mots clés, cliquez sur le bouton "Tester" pour voir le résultat de votre filtre, de cette manière vous pouvez affiner votre filtre de catégories facilement.

Vous remarquerez que vous ne pouvez pas éditer les mots clés pour la catégorie "Autre". Cette catégorie est en effet spéciale, elle regroupe toutes les catégories XMLTV qui ne peuvent être associées à une de vos catégories. Vous pouvez aussi utiliser le bouton "Tester" pour cette catégorie, ainsi vous pouvez repérer facilement les catégories XMLTV que vos mots clés ont laissé passer.

Vous pouvez ajouter / supprimer des sous catégories sur plusieurs niveaux. Cependant SageTV n'accepte que deux niveaux. Pour que vos catégories soit plus efficaces essayez d'utiliser les mêmes sous-catégories pour les films et séries par exemple.

Note: Après chaque import XMLTV Importer ajoute dans ses fichiers de log quelles catégories n'ont pas pu être associées à vos catégories (et ce pour les catégories de 1er niveau, ou pour des sous-catégories).

Règles pour 1ères diffusions / rediffusions

Si XMLTV Importer ne peut pas différencier deux épisodes d'une même série par manque d'information (par exemple tous les épisodes sont les mêmes et vous ne pouvez en enregistrer qu'un) vous pouvez créer des règles pour modifier le comportement de XMLTV Importer.

Pour créer une nouvelle règle, cliquez sur le lien "Ajouter une nouvelle règle", saisissez ensuite un mot clé pour chercher le programme pour lequel vous souhaitez créer un règle et cliquez sur le bouton "Chercher". Sélectionnez ensuite le programme dans la liste et cliquez sur le bouton "Suivant >". Pour votre règle vous pouvez choisir parmi les options suivantes :

• Sélectionnez "Ce programme est générique (pas de 1ère diff. ou rediff. tous les épisodes seront enregistrés)" pour forcer XMLTV Importer à ne gérer aucune notion de 1ère diff/rediff pour ce programme. Ceci est utile pour les programmes qui ne possèdent ni titre d'épisode, ni description permettant de différencier les épisodes. Vous utiliserez principalement cette option pour les programmes d'informations (journaux / météo etc...) qui sont censés être différents tous les jours.
• Sélectionnez "Ce programme comporte des 1ères diff., vous pouvez indiquer quand les 1ères diff. ont lieu" si vous savez que des 1ères diff. existent pour le programme. Vous pouvez également indiquer le jour et l'heure supposés des 1ères diff. (cochez un ou plusieurs jours de la semaine et renseignez l'heure). Si vous précisez le jour et l'heure des 1ères diff. vous pouvez aussi cocher la case "les programmes non compris dans l'intervalle de 1ère diff. seront des rediff.". Ceci obligera XMLTV Importer à considérer toutes les autres diffusions comme des rediff. des 1ères diff.
• Sélectionnez "Ce programme n'est pas le même sur toutes les chaînes" si vous savez que ce programme, bien que portant le même nom, n'est pas le même sur toutes les chaînes. Là encore cette option est surtout utile pour des programmes tels que les journaux, et seulement si vous voulez enregistrer tous les journaux de deux chaînes différentes. Il n'est généralement pas conseillé d'utiliser cette option.

Autres Options

Vous pouvez choisir ici d'autres options pour personnaliser votre guide télé telles que :

• Ajouter dans le titre du programme la note du programme en étoiles (si disponible dans votre fichier XMLTV)
• Ajouter un suffixe "HD" dans le titre du programme si celui-ci est diffusé en haute définition
• Ajouter un suffixe "VO" dans le titre du programme s'il est diffusé en langue étrangère
• Ajouter le numéro de saison / épisode / partie dans le titre de l'épisode (vous pouvez placer la numérotation avant ou après le titre d'épisode et personnaliser les préfixes Saison / Episode / Partie)
• Indiquez si vous souhaitez être prévenu par e-mail de toutes erreurs survenant durant l'import. Lorsque vous configurez votre serveur SMTP, cliquez sur le bouton "Test", si XMLTV Importer parvient à envoyer l'e-mail une marque verte apparaît à côté du bouton "Test".

Mise à jour automatique

Si vous avez effectué un don pour XMLTV Importer vous pouvez programmer l'import automatique de votre guide télé. Choisissez simplement le jour et l'heure de la semaine auxquels vous souhaitez importer automatiquement votre guide télé. XMLTV Importer lancera alors votre grabber et procédera automatiquement à l'import de vos données.

Si vous souhaitez que SageTV charge les données du guide immédiatement après l'import vous devez utiliser le Plug-in SageTV Web Server. Saisissez alors l'adresse du plug-in Web Server, le nom d'utilisateur et le mot de passe (une marque verte est affichée à côté de l'adresse si XMLTV Importer peut se connecter au plug-in Web Server avec succès) 

Note: Si vous n'avez pas indiqué quel est votre grabber XMLTV, vous devrez alors récupérer automatiquement votre fichier XMLTV mis à jour par vos propres moyens (bien sûr le fichier XMLTV doit être mis à jour avant que XMLTV Importer ne procède à l'import)

Mise à jour du guide télé

Pour démarrer immédiatement l'import de votre guide télé, cliquez sur le bouton  "Démarrer Import". Pendant l'import vous pouvez suivre la progression de la conversion à l'aide des barres de progression. XMLTV Importer converti vos fichiers XMLTV en trois nouveaux fichiers XML (ou plus si vous avez plus d'un bouquet) qui seront enregistrés dans le dossier "C:\Documents and Settings\All Users\Application Data\LM Gestion\SageTV XMLTV Importer\GuideData" ou C:\ProgramData\LM Gestion\SageTV XMLTV Importer\GuideData pour Windows Vista.

Si vous cliquez sur le bouton "Annuler" vous pouvez annuler l'import en cours, cependant cliquer sur le bouton "Ok" ou fermer la fenêtre de XMLTV Importer n'annule pas l'import en cours.

Quand XMLTV Importer a terminé l'import,  votre guide télé est prêt à être chargé dans SageTV (si c'est la première fois, autrement SageTV effectuera la mise à jour de son guide toutes les 24h en utilisant les données produites par XMLTV Importer, ou immédiatement si vous utilisez le plug-in Web Server).

Pour ce faire, lancez SageTV et configurez vos tuners.

Pendant la configuration de vos tuners choisissez l'option XMLTV qui vous est proposée.

Puis choisissez l'option chaînes locales (les autres options fonctionneront aussi, cependant cette option vous évite une étape inutile).

Si l'assistant d'importation a été installé correctement, vous devriez voir les bouquets que vous avez crée dans l'assistant. Choisissez le bouquet qui correspond à votre source.

SageTV téléchargera alors les chaînes et les données de programmes (rapidement).

SageTV vous propose ensuite de rechercher les chaînes disponibles. A ce stade il n'est pas recommandé de le faire (la recherche des chaînes doit être effectuée avant l'import dans le seul but d'obtenir les numéros de chaînes à utiliser dans l'éditeur de chaînes).

Lorsque vous mettez à jour votre fichier XMLTV, vous devez alors lancez l'utilitaire d'importation XMLTV une fois (vous n'avez cependant plus à le configurer) ou bien utiliser la fonction de lancement automatique intégrée (réservée aux donateurs).

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