Installer Kodi sur Apple TV demande un Mac, Xcode et une signature d’application, car Kodi n’est pas proposé directement dans l’App Store de tvOS. La méthode concerne l’Apple TV HD et les Apple TV 4K. Elle ne fonctionne pas sur les modèles Apple TV de première, deuxième ou troisième génération.
Vérifier le modèle de votre Apple TV
Ouvrez Réglages > Général > Informations, puis relevez le modèle de l’appareil. Kodi peut être installé sur les Apple TV équipées de tvOS, à partir de l’Apple TV HD, aussi appelée Apple TV de quatrième génération.
L’Apple TV 4K ne possède pas de port USB pour transférer l’application. Elle devra être associée au Mac sur le même réseau Wi-Fi ou Ethernet. L’Apple TV HD peut aussi être reliée au Mac avec son port USB-C pendant certaines étapes, selon la méthode retenue.
Préparer le Mac et l’Apple TV
Avant de commencer, réunissez les éléments suivants :
- un Mac compatible avec la version actuelle de Xcode ;
- Xcode installé depuis le Mac App Store ;
- un compte Apple ;
- une Apple TV HD ou une Apple TV 4K mise à jour ;
- le fichier Kodi téléchargé depuis le site officiel du projet.
Connectez le Mac et l’Apple TV au même réseau. Sur l’Apple TV, ouvrez Réglages > Télécommandes et appareils > Application Remote et appareils, puis laissez l’écran disponible pour l’association. Le nom exact des menus peut varier légèrement selon la version de tvOS.
Pas encore d'abonnement IPTV ?
Accès immédiat à 45K+ chaînes et 240K+ films en HD/4K.
Télécharger Kodi depuis la source officielle
Rendez-vous sur la page officielle des téléchargements de Kodi et choisissez la section dédiée à iOS. Téléchargez le paquet prévu pour les appareils Apple. Ne récupérez pas de fichier depuis un site d’APK, un forum ou une page de téléchargement non vérifiée.
La version fournie peut être un fichier .deb. Pour l’installer sur tvOS, il faut généralement le convertir en fichier .ipa avec un outil de signature compatible, comme iOS App Signer. Utilisez uniquement la version obtenue depuis la page officielle de son éditeur et vérifiez que l’outil accepte bien les applications tvOS avec votre version de Xcode.
Créer la signature avec Xcode
- Ouvrez Xcode et acceptez les conditions d’utilisation si elles s’affichent.
- Allez dans Xcode > Settings > Accounts, puis ajoutez votre compte Apple.
- Créez un projet de type tvOS App.
- Attribuez-lui un identifiant d’application unique, par exemple fr.votrenom.kodi.
- Sélectionnez votre compte dans la rubrique Signing & Capabilities.
- Choisissez votre Apple TV comme appareil de destination dans la barre supérieure de Xcode.
Un compte Apple gratuit peut servir à tester une application signée, mais la durée de validité de la signature est limitée. Avec un compte Apple Developer payant, la période de signature est généralement plus longue. Apple peut aussi afficher un avertissement si l’identifiant du projet est déjà utilisé : dans ce cas, modifiez-le.
Générer puis installer le fichier IPA
Ouvrez iOS App Signer, sélectionnez le fichier Kodi téléchargé, choisissez votre certificat de signature et le profil de provisioning créé par Xcode. Lancez la génération du fichier .ipa. Si aucun profil n’est proposé, revenez dans Xcode et vérifiez le compte Apple, l’identifiant du projet et la cible tvOS.
Dans Xcode, ouvrez ensuite Window > Devices and Simulators. Sélectionnez l’Apple TV dans la colonne de gauche, puis utilisez le bouton d’ajout pour installer le fichier IPA généré. Sur une Apple TV 4K, confirmez le code affiché à l’écran lorsque Xcode demande l’autorisation de connexion.
Une fois l’installation terminée, l’icône Kodi apparaît sur l’écran d’accueil. Lancez l’application depuis l’Apple TV et attendez son premier chargement. La première ouverture peut être plus longue après une installation signée manuellement.
Pas encore d'abonnement IPTV ?
Accès immédiat à vos chaînes, sans engagement long terme.
Configurer Kodi après l’installation
Commencez par régler la langue et l’apparence dans les paramètres. Pour ajouter des fichiers présents sur un ordinateur ou un NAS, ouvrez la section correspondante, choisissez Fichiers, puis Ajouter une source. Saisissez le chemin réseau utilisé chez vous, par exemple une adresse SMB, ainsi que les identifiants si le partage en demande.
Testez d’abord un seul dossier avec une vidéo connue. Cette vérification permet de distinguer un problème de réseau d’un problème de configuration de Kodi. Pour les extensions, utilisez les dépôts intégrés ou les sources officielles de leurs éditeurs. Les extensions qui donnent accès à des contenus protégés sans autorisation peuvent être illégales.
Résoudre les problèmes fréquents
Kodi n’apparaît pas sur l’Apple TV
Vérifiez que l’installation du fichier IPA s’est terminée sans message d’erreur. Redémarrez l’Apple TV, puis regardez dans Réglages > Général > Stockage si Kodi est bien présent. Si l’application a disparu après quelques jours, la signature a probablement expiré.
Xcode ne détecte pas l’Apple TV
Les deux appareils doivent être sur le même réseau. Désactivez temporairement un VPN, redémarrez Xcode et redémarrez l’Apple TV. Pour une Apple TV HD, essayez une connexion USB-C si votre modèle et votre Mac permettent cette association.
Le fichier IPA refuse de s’installer
Le paquet peut être incompatible avec la version de tvOS ou mal signé. Téléchargez une version Kodi prévue pour l’écosystème Apple, recréez le profil de provisioning et utilisez un identifiant d’application différent. Une mise à jour de Xcode peut aussi rendre nécessaire la nouvelle génération du fichier IPA.
Les vidéos saccadent ou ne se lancent pas
Testez la lecture depuis un fichier local, puis depuis le partage réseau. Si seul le réseau pose problème, contrôlez la connexion de l’Apple TV, le chemin SMB et les droits d’accès au dossier. Évitez de modifier plusieurs réglages vidéo à la fois : vous perdrez plus facilement la cause du problème.
Questions fréquentes
Peut-on installer Kodi depuis l’App Store de l’Apple TV ?
Non. Kodi n’est pas distribué directement dans l’App Store de tvOS. L’installation passe par une signature manuelle avec Xcode et un fichier compatible.
Quel modèle d’Apple TV accepte Kodi ?
L’Apple TV HD et les Apple TV 4K sont les modèles concernés. Les Apple TV de première à troisième génération ne permettent pas cette procédure tvOS.
Faut-il un Mac pour installer Kodi sur Apple TV ?
Pour la méthode avec Xcode, oui. Le Mac sert à signer le paquet et à le transférer sur l’Apple TV.
Un compte Apple gratuit suffit-il ?
Il peut suffire pour un test, mais l’application signée peut cesser de fonctionner lorsque la période de validité expire. Il faut alors générer et installer une nouvelle signature.
Kodi reste-t-il installé après une mise à jour de tvOS ?
Ce n’est pas garanti. Une mise à jour peut rendre l’application incompatible ou invalider sa signature. Conservez le fichier Kodi utilisé afin de pouvoir recommencer la procédure.
Peut-on utiliser Kodi avec un NAS ?
Oui, ajoutez le dossier partagé comme source réseau dans Kodi. Le NAS et l’Apple TV doivent être accessibles sur le même réseau, avec des droits de lecture valides.