Jellyfin est le serveur multimédia libre et open-source vers lequel beaucoup d'entre nous se sont tournés après avoir quitté les jardins clos — pas de version premium, pas de compte obligatoire, juste votre bibliothèque sur votre propre matériel. Sur Apple TV, le problème a toujours été le même : taper un mot de passe de serveur avec la Siri Remote est un supplice. Ce guide vous montre comment appairer Jellyfin avec OneTV Connect grâce à Quick Connect (zéro mot de passe), puis regarder votre bibliothèque juste à côté de vos chaînes IPTV en direct.
Jellyfin + IPTV dans une seule app
La plupart des apps IPTV s'arrêtent aux chaînes en direct et à une maigre liste de VOD, et la plupart des clients Jellyfin ignorent totalement l'IPTV. OneTV Connect fait les deux, dans un même écran d'accueil. Vos films et séries Jellyfin apparaissent dans les mêmes rangées que vos chaînes, partagent les mêmes fiches détaillées cinématiques et se lisent avec le même lecteur multi-moteur. Pour les fichiers 4K HEVC, KSPlayer assure la lecture directe même sur l'Apple TV 4K : vous n'attendez pas un transcodage côté serveur quand votre matériel peut décoder localement. Si vous hésitiez entre le Jellyfin IPTV et deux apps séparées, c'est tout l'intérêt de l'app unique — un seul EPG, un seul lecteur, une seule liste de favoris.
Avant de commencer
Il vous faut trois choses :
- OneTV Connect installé sur votre Apple TV (c'est un téléchargement gratuit sur l'App Store). L'intégration Jellyfin se débloque avec Pro.
- Un serveur Jellyfin en fonctionnement — sur votre LAN ou accessible via internet. Jellyfin étant libre et open-source, il n'y a rien à acheter.
- Un second appareil connecté à Jellyfin (un téléphone ou un ordinateur portable avec l'interface web Jellyfin ouverte) si vous voulez utiliser Quick Connect. C'est là que vous validerez l'appairage.
Quick Connect doit être activé sur votre serveur — il l'est par défaut. S'il est désactivé, vous pouvez l'activer dans Tableau de bord → Général de l'admin Jellyfin, ou simplement utiliser la solution de repli identifiant/mot de passe décrite plus bas.
Appairage avec Quick Connect sur Apple TV
C'est l'étape que tout le monde redoute sur un téléviseur, et c'est celle que OneTV Connect rend indolore. Suivez ces étapes :
- Ouvrez l'intégration Jellyfin. Dans OneTV Connect, allez dans Réglages → Intégrations → Jellyfin et touchez Ajouter un serveur.
- Laissez OneTV trouver votre serveur. Sur le même réseau, l'app diffuse un broadcast UDP POSIX sur le port 7359 à travers chaque sous-réseau local et liste votre serveur Jellyfin en environ cinq secondes — aucune URL à saisir. Pas sur le LAN ? Entrez l'URL du serveur vous-même, par exemple
https://jellyfin.example.com. Quick Connect fonctionne aussi en WAN. - Demandez un code Quick Connect. Choisissez Quick Connect. OneTV demande à votre serveur un code unique de 6 caractères et l'affiche à l'écran de l'Apple TV.
- Validez depuis l'interface web Jellyfin. Sur n'importe quel appareil déjà connecté à Jellyfin, ouvrez l'écran Quick Connect (généralement dans le menu de votre utilisateur) et tapez les 6 caractères. À l'instant où vous confirmez, OneTV est authentifié. Aucun mot de passe n'est tapé à la télécommande, et aucun ne quitte votre ordinateur.
Voilà le déroulé complet du Jellyfin Quick Connect Apple TV — il prend généralement moins de deux minutes. Vous préférez la méthode classique ? L'identifiant et le mot de passe restent disponibles en repli si Quick Connect est désactivé sur votre serveur.
Parcourir votre bibliothèque
Une fois l'appairage fait, vos bibliothèques Jellyfin remplissent les rangées d'accueil aux côtés de votre catalogue IPTV : Récemment ajoutés, Reprendre la lecture et la Recherche fusionnent les deux sources. Toucher un titre Jellyfin ouvre la même fiche détaillée que la VOD IPTV, et lorsque les métadonnées sont pauvres, TMDB complète les visuels et les descriptions. Pendant la lecture, OneTV lit les marqueurs d'intro et d'outro de Jellyfin (du plugin IntroSkipper) et affiche un bouton natif Passer l'intro exactement au bon moment — ici, ce n'est pas une fonction réservée à Plex. L'état de lecture et la progression restent synchronisés : un film commencé sur votre téléphone réapparaît dans Reprendre la lecture sur le téléviseur.
Multi-serveur & favoris
Vous n'êtes pas limité à un seul serveur. Ajoutez autant de serveurs Jellyfin que vous voulez — votre box maison, celle d'un ami, un VPS distant — et ils apparaissent dans un sélecteur de source unique, leurs bibliothèques agrégées en un seul Récemment ajoutés, un seul Reprendre la lecture, une seule Recherche. Chaque serveur suit ses propres positions de lecture et ses favoris, rien ne déborde d'un compte à l'autre. Les favoris sont bidirectionnels : mettez un film en favori dans l'interface web Jellyfin et il apparaît dans OneTV ; faites-le dans OneTV et il réapparaît dans Jellyfin. Si vous utilisez Trakt, les épisodes Jellyfin sont scrobblés dans votre historique Trakt unifié via l'ID TMDB, exactement comme le font Plex et Emby.
Conseils de dépannage
Quelques points pour lisser les aspérités :
- Le serveur n'apparaît pas dans la liste ? Certains routeurs domestiques agressifs bloquent le broadcast UDP. Saisissez l'URL du serveur manuellement — Quick Connect fonctionne dès que OneTV peut l'atteindre.
- Option Quick Connect grisée ? Elle est désactivée sur le serveur. Activez-la dans Tableau de bord → Général de l'admin Jellyfin, ou repliez-vous sur identifiant/mot de passe.
- Ça met en mémoire tampon en 4K ? Gardez le serveur sur votre LAN quand c'est possible. L'accélération matérielle est purement côté serveur, mais pour le 4K HEVC, KSPlayer lit en direct sur l'Apple TV 4K sans solliciter le transcodeur.
Les quatre pannes qu'il faut comprendre
Au-delà des correctifs rapides ci-dessus, presque tous les problèmes Jellyfin persistants sur Apple TV sont l'un de ces quatre cas, et chacun a un signe qui l'identifie en quelques secondes.
Le serveur est invisible mais joignable
Le signe : la détection ne trouve rien, mais saisir l'adresse marche du premier coup.
La détection repose sur une diffusion locale, c'est-à-dire exactement ce que les réseaux invités, l'« isolation des clients » et la segmentation en VLAN sont faits pour bloquer. Rien n'est cassé : le téléviseur et le serveur ne peuvent simplement pas se héler, même s'ils peuvent se parler. Utilisez l'adresse manuelle et passez à la suite ; la détection est un confort, pas une obligation. Pour la retrouver, la correction se fait sur la box : mettre l'Apple TV et le serveur sur le même sous-réseau.
Tout transcode
Le signe : le processeur du serveur s'emballe à chaque lecture, et l'image est plus molle que ne le mérite le fichier.
Transcoder, c'est réencoder un fichier parce que le client a annoncé qu'il ne savait pas le lire. Une lecture native évite cela pour les formats qui comptent, 4K HEVC compris. Quand ça arrive quand même, les causes habituelles sont un format de sous-titres qui doit être incrusté ou une piste audio que la chaîne de sortie ne sait pas transmettre. Désactivez la piste de sous-titres le temps d'une lecture : si le transcodage disparaît, vous l'avez trouvé.
La lecture marche, pas la reprise
Le signe : les épisodes se lisent bien, mais « Reprendre » ne se met jamais à jour, ou se met à jour sur un appareil et pas sur l'autre.
L'état de lecture est propre à un serveur et à un utilisateur. Si vous vous êtes appairé avec un utilisateur Jellyfin différent de celui que vous utilisez dans l'interface web, les deux fonctionnent correctement et tiennent simplement deux historiques séparés. Vérifiez à quel utilisateur appartient l'appairage avant de conclure à un bug de synchronisation.
L'accès distant n'est pas vraiment distant
Le signe : tout marche à la maison, rien ne marche ailleurs.
Une adresse locale n'a aucun sens hors de la maison. Testez l'URL exacte que vous avez configurée dans le navigateur d'un téléphone en données mobiles, Wi-Fi coupé : si elle ne répond pas là, aucun client ne l'atteindra, et le problème est la redirection de port, le reverse proxy ou le DNS, pas l'application.
Ce que vous obtenez une fois connecté
Bon à savoir avant de juger l'installation, car plusieurs de ces points ne sautent pas aux yeux tant qu'on ne les cherche pas :
- Une bibliothèque, plusieurs serveurs. Ajoutez autant de serveurs Jellyfin que vous voulez — le vôtre, celui d'un ami, une machine distante. Leurs bibliothèques se fondent dans les mêmes rangées Ajoutés récemment et Reprendre et dans la même recherche, avec un état de lecture suivi par serveur.
- Vos fichiers à côté de vos chaînes. Tout l'intérêt de l'intégration est de ne pas changer d'app : la bibliothèque et les chaînes en direct vivent dans la même interface, sous le même guide et le même lecteur.
- Les marqueurs d'intro et d'outro sont respectés. Si votre serveur les génère, le bouton de saut apparaît au bon moment au lieu d'être un luxe réservé à Plex.
- Favoris et état de lecture vont dans les deux sens. Mettez une étoile ici, elle apparaît dans l'interface web Jellyfin, et réciproquement.
- Trakt voit tout. Un épisode Jellyfin est scrobblé comme les autres : votre historique reste au même endroit quel que soit le serveur utilisé — comment fonctionne le scrobbling Trakt ici.
Jellyfin, Plex ou Emby — le choix compte-t-il ?
Les trois sont pris en charge avec la même profondeur : choisissez sur leurs mérites propres, pas sur les préférences de l'app. Jellyfin est libre et open source, rien ne téléphone dehors, et Quick Connect en fait le moins pénible à connecter sur un téléviseur. Plex offre les métadonnées les plus soignées et l'écosystème le plus large, au prix d'un compte et d'un aller-retour par le cloud. Emby est le seul des trois avec une vraie Live TV intégrée, ce qui compte si votre serveur gère déjà des chaînes en plus des fichiers.
Et vous pouvez faire tourner les trois en même temps : les bibliothèques se fondent au lieu de se disputer l'interface.
Voilà — votre bibliothèque Jellyfin vit désormais à côté de vos chaînes, au même endroit. Pour le détail complet des fonctionnalités, voyez la page intégration Jellyfin, et si quelque chose coince, la page d'assistance propose la checklist complète.