Comment installer Kodi sur Apple TV ? L’application n’est pas proposée directement dans l’App Store de tvOS. Il faut donc utiliser un Mac, Xcode et une version officielle de Kodi adaptée à tvOS, puis signer le fichier avant de le transférer sur l’Apple TV. La procédure concerne surtout les modèles Apple TV HD et Apple TV 4K.
Quels modèles d’Apple TV sont compatibles ?
Kodi ne s’installe pas de la même manière sur toutes les générations. La procédure décrite ici vise les appareils capables d’exécuter une version récente de tvOS :
- Apple TV HD, également appelée Apple TV de quatrième génération ;
- Apple TV 4K de première génération ;
- Apple TV 4K de deuxième génération ;
- Apple TV 4K de troisième génération, sous réserve de la compatibilité de la version tvOS choisie.
L’Apple TV de troisième génération et les modèles antérieurs ne permettent pas d’installer Kodi avec cette méthode. Vérifiez le modèle depuis Réglages > Général > Informations. Notez aussi la version de tvOS installée : elle servira à choisir le bon fichier Kodi.
Ce qu’il faut préparer avant l’installation
La méthode nécessite un Mac récent, car Xcode fonctionne uniquement sous macOS. Prévoyez également un câble USB-C si vous utilisez une Apple TV HD. L’Apple TV 4K ne possède pas de port USB : elle se relie au Mac par le réseau local.
Voici les éléments à réunir :
- un Mac connecté à Internet ;
- Xcode téléchargé depuis le Mac App Store ;
- un identifiant Apple ;
- une Apple TV reliée au même réseau que le Mac ;
- le fichier Kodi destiné à tvOS, téléchargé depuis le site officiel kodi.tv ;
- un compte Apple Developer gratuit ou payant pour signer l’application.
Un compte gratuit permet généralement de tester une application signée pendant une durée limitée. Avec un compte Apple Developer payant, la durée de validité de la signature est plus longue. Apple peut modifier ces règles : contrôlez les conditions affichées dans Xcode au moment de l’opération.
Télécharger Kodi et Xcode depuis les bonnes sources
Commencez par installer Xcode depuis le Mac App Store. Ouvrez ensuite le logiciel une première fois afin qu’il termine l’installation de ses composants. L’opération peut demander le mot de passe administrateur du Mac.
Téléchargez Kodi uniquement depuis la page officielle des téléchargements de Kodi. Sélectionnez la section correspondant à tvOS, puis récupérez le paquet proposé pour votre appareil. Selon la version publiée, le fichier peut être fourni au format IPA ou dans un format nécessitant une étape de signature supplémentaire.
Évitez les fichiers trouvés sur des forums, des hébergeurs inconnus ou des pages qui proposent une version « préactivée ». Un fichier modifié peut contenir un composant indésirable et ne garantit pas la compatibilité avec votre version de tvOS.
Associer l’Apple TV à Xcode
Allumez l’Apple TV et vérifiez qu’elle utilise le même réseau Wi-Fi que le Mac. Sur l’Apple TV, ouvrez Réglages > Télécommandes et appareils > App et appareils à proximité, lorsque cette option est disponible sur votre version de tvOS.
Dans Xcode, ouvrez le menu Window > Devices and Simulators. Cliquez sur l’onglet consacré aux appareils, puis sélectionnez l’Apple TV dans la liste. Un code peut apparaître sur l’écran du téléviseur. Saisissez-le dans Xcode pour terminer l’association.
Pour une Apple TV HD, la connexion USB peut être utilisée lorsqu’elle dispose du port correspondant. Pour une Apple TV 4K, la connexion réseau est la méthode habituelle. Si l’appareil n’apparaît pas, redémarrez l’Apple TV et Xcode, puis désactivez temporairement un VPN ou un pare-feu qui bloque la détection locale.
Créer une signature de développement dans Xcode
Avant d’envoyer Kodi sur l’Apple TV, Xcode doit disposer d’une équipe de développement et d’un identifiant d’application. Dans Xcode > Settings > Accounts, ajoutez votre identifiant Apple, puis sélectionnez votre compte dans la liste.
La méthode varie légèrement selon le fichier fourni par Kodi. Avec une version IPA déjà prévue pour tvOS, utilisez un outil de signature compatible avec les applications tvOS, puis choisissez votre équipe Apple et un identifiant d’application unique. Un identifiant du type com.votrenom.kodi convient, à condition qu’il ne soit pas déjà utilisé dans votre compte.
Si Kodi est fourni au format DEB, la conversion en IPA demande un utilitaire de signature compatible avec tvOS. Utilisez la documentation associée à la version publiée par Kodi et vérifiez que l’outil accepte bien les applications tvOS. Cette étape ne consiste pas à télécharger Kodi ailleurs : le paquet de départ doit rester celui du site officiel.
Une erreur de signature ne signifie pas forcément que le fichier est défectueux. Elle vient souvent d’un identifiant déjà utilisé, d’une équipe non sélectionnée ou d’un profil de provisioning incompatible avec la version de tvOS.
Installer Kodi sur l’Apple TV
Une fois l’IPA signé, revenez dans Window > Devices and Simulators et sélectionnez l’Apple TV associée. Dans la zone des applications installées, ajoutez le fichier IPA signé. Selon la version de Xcode, vous pouvez le faire avec le bouton d’ajout ou par glisser-déposer.
Xcode copie alors l’application sur l’Apple TV et vérifie la signature. L’opération peut prendre quelques instants. Kodi apparaît ensuite sur l’écran d’accueil de tvOS. Débranchez l’Apple TV uniquement après la fin du transfert.
Au premier lancement, tvOS peut bloquer l’ouverture de l’application. Dans ce cas, rendez-vous dans Réglages > Général > Gestion des appareils et profils, ou dans la rubrique équivalente selon la version installée, puis faites confiance au profil associé à votre identifiant Apple. Le nom exact des menus peut changer entre deux versions de tvOS.
Configurer Kodi après son installation
Ouvrez Kodi depuis l’écran d’accueil. Commencez par choisir la langue et le réglage régional. Pour modifier l’apparence ou la disposition des menus, passez par Settings > Interface. Gardez les paramètres par défaut au premier démarrage : cela facilite le diagnostic si l’application se ferme ou affiche une erreur.
Pour ajouter des fichiers stockés sur un ordinateur ou un NAS, ouvrez la section correspondant au type de contenu, choisissez Files, puis Add videos ou l’option équivalente. Indiquez ensuite le chemin réseau SMB ou NFS utilisé dans votre installation. Le Mac, le NAS et l’Apple TV doivent se trouver sur le même réseau, sauf configuration réseau particulière.
Testez d’abord un seul dossier et un seul fichier. Cette méthode permet de distinguer un problème de Kodi d’un problème de partage réseau. Si la vidéo est saccadée, vérifiez la connexion Wi-Fi de l’Apple TV et essayez une liaison Ethernet lorsque le modèle et l’installation le permettent.
Résoudre les problèmes courants
L’Apple TV n’apparaît pas dans Xcode
Vérifiez que le Mac et l’Apple TV sont sur le même réseau. Fermez puis relancez Xcode. Sur une Apple TV 4K, redémarrez l’appareil depuis Réglages > Système > Redémarrer. Un réseau invité empêche souvent les appareils de communiquer entre eux.
Xcode refuse le fichier IPA
Le fichier est peut-être destiné à iOS et non à tvOS, ou sa signature n’est pas valide. Téléchargez le paquet tvOS depuis la page officielle de Kodi, puis recréez la signature avec votre équipe Apple. Ne renommez pas un fichier au hasard pour corriger cette erreur : l’extension ne change pas le contenu ni la plateforme ciblée.
Kodi disparaît après quelques jours
Une application installée avec une signature de développement cesse de fonctionner lorsque cette signature arrive à expiration. Recréez une signature avec Xcode, puis transférez de nouveau l’IPA. Avec un compte gratuit, cette opération peut devoir être répétée plus souvent qu’avec un compte Apple Developer payant.
Kodi se ferme dès son ouverture
Supprimez la version installée, redémarrez l’Apple TV et utilisez une build Kodi compatible avec votre version de tvOS. Une application construite pour une version différente peut s’installer mais ne pas démarrer correctement. Évitez aussi de restaurer immédiatement une ancienne configuration : testez d’abord Kodi avec ses réglages initiaux.
La télécommande Apple TV répond mal
La navigation dépend de la version tvOS et de la version Kodi installée. Essayez de redémarrer l’application, puis l’Apple TV. Une télécommande Bluetooth mal chargée ou une perte de connexion peut aussi donner l’impression que Kodi est bloqué.
Questions fréquentes
Kodi est-il disponible dans l’App Store de l’Apple TV ?
Non. Kodi n’est pas installé depuis l’App Store de tvOS dans cette procédure. Le transfert passe par un Mac, Xcode et une application signée.
Peut-on installer Kodi sur une Apple TV 3 ?
Non, cette méthode ne concerne pas l’Apple TV de troisième génération. Utilisez un modèle Apple TV HD ou Apple TV 4K compatible avec la version tvOS de Kodi.
Faut-il un Mac pour installer Kodi sur Apple TV ?
La méthode avec Xcode demande un Mac sous macOS. Un PC Windows ne peut pas exécuter Xcode, même si d’autres méthodes de sideload existent.
Un compte Apple Developer payant est-il obligatoire ?
Pas toujours. Un compte Apple gratuit peut suffire pour un test, mais la signature a une durée limitée. Le compte payant offre une durée de validité plus longue selon les règles Apple en vigueur.
Que faire si Kodi ne reste pas installé ?
Vérifiez la date d’expiration du profil de signature, puis signez et installez à nouveau l’IPA. Contrôlez aussi la compatibilité entre la version de Kodi et celle de tvOS.
Peut-on ajouter des sources réseau à Kodi sur Apple TV ?
Oui, ajoutez un emplacement SMB ou NFS depuis la section des fichiers de Kodi. Le partage doit être accessible depuis le même réseau et les identifiants doivent être corrects.
Où télécharger la version de Kodi à installer ?
Utilisez la page officielle des téléchargements de Kodi et choisissez le paquet tvOS correspondant à votre appareil. N’utilisez pas de site d’APK ou de dépôt non officiel.
