Comment créer votre propre extension Kodi : Exemple avec une extension pour chaînes YouTube

Comment créer votre propre extension Kodi : Exemple avec une extension pour chaînes YouTube

Kodi est une plateforme multimédia incroyablement polyvalente, et l’une de ses forces réside dans la possibilité de créer vos propres extensions. Si vous êtes curieux de savoir comment ajouter une touche personnelle à Kodi, cet article vous guidera pas à pas pour créer une extension qui permet d’extraire et de lire des chaînes YouTube.

Pourquoi créer une extension Kodi ?

Créer votre propre extension Kodi peut avoir plusieurs avantages :

• Personnalisation : Ajoutez des fonctionnalités spécifiques à vos besoins.
• Contrôle : Organisez vos contenus favoris, comme des chaînes YouTube ou des flux vidéo.
• Apprentissage : Découvrez le fonctionnement des scripts Python et l’écosystème Kodi.

Dans cet exemple, nous allons créer une extension qui liste et lit des chaînes YouTube en utilisant leurs URL.

Étape 1 : Préparez la structure de votre extension

Commencez par créer un dossier pour votre extension. Voici à quoi doit ressembler la structure du projet :

plugin.video.youtube_channels/
├── addon.xml
├── default.py
└── resources/
    └── settings.xml

Étape 2 : Configurez le fichier addon.xml

Le fichier addon.xml est le point de départ de toute extension Kodi. Il contient les métadonnées essentielles comme l’identifiant, le nom et la version de l’extension. Voici un exemple :

<addon id="plugin.video.youtube_channels" version="1.0.0" name="YouTube Channels" provider-name="VotreNom">
    <requires>
        <import addon="xbmc.python" version="3.0.0" />
    </requires>
    <extension point="xbmc.python.pluginsource" library="default.py" />
    <extension point="xbmc.addon.metadata">
        <summary lang="fr">Une extension pour accéder à vos chaînes YouTube préférées.</summary>
        <description lang="fr">Ajoutez vos chaînes YouTube favorites et regardez-les directement depuis Kodi.</description>
        <platform>all</platform>
    </extension>
</addon>

Étape 3 : Créez le fichier default.py

Le fichier default.py contient la logique principale de l’extension. Dans cet exemple, nous allons lister des chaînes YouTube et permettre à l’utilisateur de les lire directement.

import xbmcplugin
import xbmcgui
import sys
import urllib.parse

# Liste des chaînes YouTube
CHANNELS = [
    {"name": "Tech Channel", "url": "https://www.youtube.com/channel/XYZ"},
    {"name": "Cooking Channel", "url": "https://www.youtube.com/channel/XYZ2"},
    {"name": "Music Channel", "url": "https://www.youtube.com/channel/XYZ3"}
]

def list_channels():
    """
    Affiche la liste des chaînes YouTube.
    """
    for channel in CHANNELS:
        list_item = xbmcgui.ListItem(label=channel["name"])
        url = f"{sys.argv[0]}?action=play&url={urllib.parse.quote_plus(channel['url'])}"
        xbmcplugin.addDirectoryItem(handle=int(sys.argv[1]), url=url, listitem=list_item, isFolder=False)
    xbmcplugin.endOfDirectory(int(sys.argv[1]))

def play_channel(url):
    """
    Lit une chaîne YouTube en utilisant le plugin officiel de YouTube.
    """
    youtube_url = f"plugin://plugin.video.youtube/play/?video_id={extract_video_id(url)}"
    xbmcplugin.setResolvedUrl(handle=int(sys.argv[1]), succeeded=True, listitem=xbmcgui.ListItem(path=youtube_url))

def extract_video_id(url):
    """
    Extrait l'ID de la chaîne ou de la vidéo à partir de l'URL YouTube.
    """
    if "channel/" in url:
        return url.split("channel/")[1]
    elif "watch?v=" in url:
        return url.split("watch?v=")[1]
    return ""

def router(paramstring):
    """
    Route les actions en fonction des paramètres.
    """
    params = dict(urllib.parse.parse_qsl(paramstring))
    if params:
        if params["action"] == "play":
            play_channel(params["url"])
    else:
        list_channels()

if __name__ == "__main__":
    router(sys.argv[2][1:])

Étape 4 : Testez votre extension

1. Zippez votre extension :
   Placez tous les fichiers dans un dossier, zippez-le et donnez-lui un nom, par exemple plugin.video.youtube_channels.zip.
2. Installez l’extension dans Kodi :

• Ouvrez Kodi.
• Allez dans Add-ons > Installer depuis un fichier zip.
• Sélectionnez votre fichier .zip pour installer l’extension.

1. Profitez de vos chaînes YouTube :
   Accédez à l’extension et cliquez sur une chaîne pour la lire. Elle sera ouverte via le plugin YouTube de Kodi.

Étape 5 : Personnalisez votre extension

Vous pouvez enrichir l’extension en :

• Ajoutant plus de chaînes.
• Catégorisant les chaînes par thèmes (par exemple, technologie, cuisine, musique).
• Intégrant une API pour récupérer dynamiquement les chaînes.

Créer une extension Kodi est une excellente opportunité de personnaliser votre expérience multimédia. En suivant cet exemple, vous pouvez facilement créer une extension fonctionnelle et même la développer davantage selon vos besoins. 🎉