Introduction #
Par défaut, seules les notes fournies par le site themoviedb.org sont affichées sur nos médias dans Kodi. Si nous désirons afficher des notations supplémentaires, nous devons nous procurer une clé API personnelle OMDb.
Ce tutoriel vous indique:
- Comment obtenir votre clé
- Comment activer votre clé
- Quoi faire si vous rencontrez un problème lors de l’activation
- À quel endroit inscrire votre clé pour que Kodi en tienne compte
- Comment agir intelligemment et de façon responsable😉
- Comment utiliser votre clé dans Kodi
Se procurer la clé #
Vous pouvez obtenir votre clé personnelle gratuitement en vous rendant à l’adresse suivante:
Le site est en anglais. Alors voici la page que vous verrez:
- Activez la case ou il est inscrit ”FREE! (1,000 daily limit)”
Ceci vous permettra d’obtenir gratuitement 1000 requêtes API par jour depuis votre clé personnelle. Ce qui est amplement suffisant pour un usage normal dans Kodi:
Une fois la case activée, des cases supplémentaires feront leur apparition. Vous devrez y inscrire les informations demandées:
Vous devez donc:
- Inscrire votre adresse Email VALIDE (vous recevrez votre API sur cet Email)
- Votre Prénom
- Votre Nom
- L’usage que vous allez faire de cette clé API.
Pour exemple, voici ce que j’inscris et je n’ai jamais eu de problème:
Bien entendu, il faut appuyer sur le bouton ”Submit” une fois que nous avons terminé d’inscrire nos informations. 😉
- Tout de suite après avoir appuyé sur ”Submit”, vous verrez le message suivant faire son apparition:
En français, il est inscrit:
Un lien de vérification pour activer votre clé a été envoyé à l’adresse email que vous avez donné.
Donc, rendez vous a votre boîte de réception et regardez pour le email de confirmation.
- Il devrait porter le titre: API Key et avoir été envoyé par: The OMDb API
Si vous ne le voyez pas dans votre boîte de réception, regardez dans vos SPAM (ou pourriels). Il est possible que le mail ait été filtré par votre serveur de courriers.
- À l’ouverture du email, vous pourrez y lire ceci:
Activer la clé #
Bien que j’ai fait en sorte que vous voyez l’inscription ”xxxxx” là ou sont présents les informations concernant la clé API que j’ai demandé, voici ce qui est important pour vous:
- Encadré numéro 1: Il s’agit de votre clé API personnelle. Celle dont vous aurez besoin un peu plus bas dans ce tuto. 📌Prenez-la en note!
- Encadré numéro 2: Il s’agit du lien d’activation de votre clé API personnelle. Vous devez cliquer sur ce lien afin d’activer votre clé API personnelle.
Effectivement, bien que vous soyez déjà en possession de votre clé API personnelle OMDb, celle-ci ne sera fonctionnelle seulement une fois que vous l’aurez activé.
- Donc, cliquez sur votre lien d’activation.
Vous serez dirigé vers une page blanche, mais tout en haut, on vous confirmera que votre clé est maintenant activée!
Vous avez terminé 🥳
Vous n’avez rien d’autre à faire, votre clé API personnelle OMDb est maintenant activée.
📌Je vous suggère de conserver ce email afin d’avoir une trace de votre clé. Il n’est pas possible de faire la demande une seconde fois avec le même email.
📌Si vous perdez votre clé, faudra ensuite en demander une nouvelle depuis un email différent que celui avec lequel une clé a déjà été demandée!
Ne reste plus qu’à aller l’inscrire à l’endroit approprié afin de pouvoir l’utiliser dans Kodi. C’est ce que nous allons faire dans la prochaine étape de ce tuto 👇
Erreur lors de l'activation #
Si ça ne fonctionne pas lorsque vous cliquez sur le lien d’activation:
📌Il est possible que la sécurité de votre serveur de courrier empêche l’action.
Dans ce cas:
- Sélectionnez l’adresse donnée dans votre email de confirmation
- Copiez-la avec un clic droit à l’aide de votre souris
- Puis collez-la ensuite manuellement dans la barre d’adresse de votre navigateur.
- Appuyez sur ”ENTER”
Vous serez alors dirigé vers une page blanche, mais tout en haut, on vous confirmera que votre clé est maintenant activée!
Vous avez terminé 🥳
Vous n’avez rien d’autre à faire, votre clé API personnelle OMDb est maintenant activée.
📌Je vous suggère de conserver ce email afin d’avoir une trace de votre clé. Il n’est pas possible de faire la demande une seconde fois avec le même email.
📌Si vous perdez votre clé, faudra ensuite en demander une nouvelle depuis un email différent que celui avec lequel une clé a déjà été demandée!
Ne reste plus qu’à aller l’inscrire à l’endroit approprié afin de pouvoir l’utiliser dans Kodi. C’est ce que nous allons faire dans la prochaine étape de ce tuto 👇
Ou inscrire la clé #
Cette étape est très simple 👍
Afin de pouvoir profiter de la présence de notations supplémentaires sur nos affiches de films et séries, il faut simplement aller inscrire la clé que nous avons obtenu à l’étape précédente de ce tuto. Pour se faire:
- Rendez-vous dans les paramètres de l’addon TMDb-Helper, et sélectionnez l’onglet ”Clés API”:
Il ne vous reste plus qu’a y inscrire votre clé à l’endroit demandé !
Ensuite, n’oubliez pas d’appuyer sur ”OK” afin que l’addon tienne compte de votre modification.
C’est terminé 🥳
Vous avez fait toutes les étapes nécessaires afin de profiter de la présence de notations supplémentaires sur la fenêtre d’information de vos médias.
📌Il est possible que le changement ne soit pas visible immédiatement après avoir inscrit votre clé à l’endroit indiqué.
C’est normal. Ceci est dû aux caches.
- Vous pouvez choisir d’être patient et que les caches se renouvellent automatiquement (Sage décision! Bravo!! puisque le cache est notre ami) 😉❤️
- Ou bien, vous pouvez choisir d’aller vider vos caches qui sont liés à ces informations depuis l’addon TMDb-Helper. (Mais ceci est inutile. Surtout si les étapes ci-haut ont été accomplies sans que vous ayez rencontré de problème. Vous verrez rapidement le changement sans avoir recours à cette solution)
Si malgré tout vous ne voulez pas attendre pour voir vos nouvelles notations sur la fenêtre d’information de vos médias, voici comment aller raffraîchir les infos depuis l’addon TMDb-Helper 👇
Rafraîchir les infos des médias #
Rendez-vous dans les paramètres de TMDb-Helper et descendez jusqu’à l’onglet ”Expert”:
Depuis la fenêtre d’options, descendez plus bas afin de vous rendre à ”supprimez le cache”:
Depuis le popup, appuyez:
- Supprimer OMDb Cache
Et une fois l’opération effectuée, appuyer sur:
- Supprimer Item Details Cache
Une fois que vous aurez terminé, redémarrez Kodi et les notations supplémentaires devraient maintenant faire leurs apparitions👍
De mémoire(puisque que je n’ai pas vidé mes caches dans l’unique but de faire ce tuto😉) un message d’avertissement fait son apparition lorsque nous appuyons sur l’une ou l’autre de ces options.
C’est que le développeur de l’addon TMDb-Helper nous demande de s’assurer que l’action que nous désirons effectuer est vraiment nécessaire. Il nous mentionne que son addon a été programmé pour effectuer seul cette requête lorsque cela est nécessaire.
- Si c’est le cas, si vous êtes dans l’obligation de vider ces caches, alors il faut simplement appuyer sur ”Oui” (ou OK?) et le cache sera vidé pour l’option choisie.
Agir intelligemment #
📌Je me permet cette demande personnelle qui me tient vraiment à coeur:
C’est important de comprendre que nous avons la chance d’avoir accès GRATUITEMENT à des addons extraordinaires. Ces addons nous offrent la possibilité d’accéder à tout un univers de possibilités grâce à des APIs qu’ils mettent à notre disposition. Non seulement les APIs d’utilisateurs comme nous sont utilisées, mais des APIs de développeurs le sont également.
Et ces APIs développeurs sont directement intégrés aux addons que nous utilisons. Donc, nous en profitons sans même le savoir.
- Plus nous supprimons le cache de ces APIs INUTILEMENT, plus le nombre de requêtes effectuées est important.
- Plus cela se produit souvent, plus l’addon qui en est responsable court le risque de se voir BLACKLISTÉ par les services qui procurent ces APIs 😱
Alors SVP: utilisez ces fonctions UNIQUEMENT lorsque vous rencontrez un problème de cache et / ou le plus RAREMENT possible.
Si vous vous dites ”Pas grave, ce n’est que moi… l’impact est minime”. Et bien imaginez si tout le monde se dit la même chose que vous, combien les répercussions seront importantes…
Malheureusement, il s’agit déjà d’un phénomène répendu dont les développeurs doivent faire face car beaucoup d’utilisateurs ont ce type de réflexion égoïste😞
SVP, ne faisons pas partie de cette catégorie de personnes….
Merci de votre collaboration. Je suis convaincu que tous les alKODIques sont des personnes intelligentes qui utilisent les addons Kodi de façon responsable 💯😉❤️😘
Utilisation de la clé #
Maintenant, lorsque vous naviguerez dans:
- Les divers menus de votre médiathèque locale
- Les divers menus de l’addon TMDb-Helper
- Les divers widgets que vous avez ajouté à votre accueil Kodi
- Les divers menus de vos addons présents sur votre installation Kodi (exemple: vStream)
Vous pourrez profiter d’un affichage de ce genre, dépendamment du skin que vous utilisez:
- Widget ”Plein écran” (skin AH2):
- Widget ”Lecture en cours” – créé avec l’addon vStream:
- Navigation dans le menu ”Derniers ajouts” de la source Pastebin (addon vStream):
- Fenêtre d’information d’un film (skin AH2):
Même que plus d’informations seront présentes, dépendamment que le film en question ait gagné des récompenses, ou figure parmi les Top IMDb, etc…
Par exemple, pour le film ”Le Parrain”:
On peut voir, en plus des notations supplémentaires:
- Que le film est en 2e position du Top IMDb
- Que le film est gagnant de 3 oscars
- Qu’il a la certification ”Fresh” accordé par Rotten Tomatoes
Pour les séries, c’est pareil. Vous verrez des informations supplémentaires dépendamment de la popularité et des prix gagnés par cette dernière.
Par exemple, si on affiche les informations de la série ”Les Soprano”:
Ici on peut voir que la série:
- Est en 10e position du classement Top IMDb
- A été récipiendaire à 21 reprises d’un prix Emmy Award
Pour plus d’information concernant les notations et certifications données depuis le site Rotten Tomatoes:
- Voir notre article qui en explique les détails: Rotten Tomatoes
Conclusion #
Ce tutoriel met en évidence l’intégration faite depuis l’addon TMDb-Helper afin d’utiliser la clé API OMDb.
Sachez que si le skin que vous utilisez ne possède pas l’intégration TMDb-Helper, votre clé API est quand-même valide, mais devra être inscrite dans l’addon qui fourni les métadonnées de médias pour votre skin.
Habituellement, on retrouve l’intégration OMDb depuis:
- l’addon TMDb-Helper
- l’addon Embuary Info
- le script ” metadatautils” (devenu rare depuis les nouvelles versions kodi – v.18 et supérieures)
Le skin que vous utilisez indiquera la dépendance nécessaire pour l’affichage des notations supplémentaires.👍
Support #
Si vous avez besoin d’aide ou avez des questions en lien avec ce sujet traité dans ce document ou cet addon, n’hésitez-pas à utiliser l’un ou l’autre de ces outils que nous mettons à votre disposition:
- Forum dédié à TMDb-Helper
- Portail de support personnel
- Formulaire ”Question rapide”
- Bloc commentaires ci-bas 👇
Commentaires
Bien que l’obtention de la clé API OMDb soit gratuite, il est aussi possible d’Obtenir une version payante afin d’avoir droit a plus d’appels depuis notre clé.
Par défaut: 1000 appels sont possibles chaque jour (24 heures) – ce qui est amplement suffisant pour un usage normal.
La version payante donne droit, selon le forfait choisi, jusqu’à 1 millions d’appels par jour. Ceci est utile, par exemple, dans le cas ou vous avez plusieurs installations Kodi qui utilisent la même clé.
Pour obtenir la version payante, il suffit de cliquer sur le lien Pateon depuis cette page: https://www.omdbapi.com/
– Ensuite souscrire à un abonnement proposé.
👉 Perso, il y a quelques années j’ai souscri à l’abonnement de base au coût de 2$ CAD par mois (équivaut à environ 1.30 Euro par mois).
– Ceci me donne droit à 250 000 appels par jour et jamais je n’ai eu de message popup comme quoi j’avais atteint mon quota quotidien 👍
Merci beaucoup! je pensais que ces notations étaient liées à une skin.
Top et très utile comme d’hab!
Merci à toi de ce gentil commentaire…
De savoir que nos tutos sont utiles est la plus belle récompense que l’on puisse recevoir ❤️