Cette page décrit Recalbox 11.0, disponible uniquement aux patrons via le canal
patron. Elle est à jour de la version 11.0-patron-3-alpha-1.
Recalbox TV est le média center de Recalbox : films, séries, chaînes en direct et vidéos à la demande, au même endroit, pilotés à la manette. Il remplace Kodi, qui n'est plus embarqué.
Il est présent sur les Raspberry Pi (Zero 2, 3, 4/400, 5/500), sur PC, sur les Anbernic RG353, les Odroid Go et la Retroid Pocket Nova. Seules les consoles portables à puce RK3326, dont l'Anbernic RG35, n'en disposent pas.

Recalbox TV est un système comme un autre : sélectionnez Recalbox TV dans la liste des systèmes, et il s'ouvre.
Il peut aussi s'ouvrir tout seul :
OUVRIR RECALBOX TV AU DÉMARRAGE ;Recalbox TV ne remplace pas EmulationStation : c'est la même application, et le bouton A vous ramène aux jeux (B valide et A revient, sauf si vous avez inversé ces deux boutons dans les options des manettes).
| Onglet | Ce qu'on y trouve |
|---|---|
ACCUEIL |
La reprise de lecture, les ajouts récents, les suggestions |
FILMS |
Votre bibliothèque de films |
SÉRIES |
Vos séries, saison par saison |
VOD |
Les catalogues à la demande : Pluto TV, Plex, Crunchyroll, YouTube et les sites de streaming liés |
EN DIRECT |
Les chaînes en direct, source par source : Pluto TV, Plex, vos listes IPTV, Twitch |
FICHIERS |
Vos vidéos telles quelles, sans bibliothèque |
L'onglet VOD n'apparaît que si un service à la demande est là — Pluto TV y suffit, et il est actif d'emblée.

Au-dessus des grilles FILMS et SÉRIES, une rangée de filtres, que Y rejoint : Tous et Non vus, Identifiés (que Tout ce qui est trouvé relâche), Genre : …, Année : … par décennie, et Tri : … — récents, titre, année ou note. Une puce Source : … s'y ajoute quand la grille compte plus d'une source : une bibliothèque qui n'en a qu'une ne la propose pas.



| Touche | Dans les pages |
|---|---|
GAUCHE / DROITE |
Changer d'onglet |
HAUT / BAS |
Entrer dans la page, puis s'y déplacer |
L / R |
Changer d'onglet depuis n'importe où dans la page |
Y |
Les filtres de l'onglet |
L2 / R2 |
Sauter à une lettre dans une grille |
START |
Le menu de Recalbox TV |
A |
Revenir : remonte aux onglets, puis au premier onglet |
Tant qu'aucune source n'est déclarée, l'accueil est vide et l'écrit : « Ajouter une source avec START > SOURCES : ses vidéos apparaissent ici. »
START.SOURCES.AJOUTER UNE SOURCE.
Recalbox TV cherche tout seul sur votre réseau les partages, les serveurs multimédia, les serveurs Jellyfin et les box opérateur : ce qu'il trouve apparaît sous TROUVÉ SUR LE RÉSEAU, prêt à ajouter, et CHERCHER À NOUVEAU relance la recherche. Le reste se déclare sous AJOUT MANUEL.

| Source | Ce que c'est |
|---|---|
PARTAGE RÉSEAU (SMB, NFS) |
Un partage Windows ou un export NFS : le serveur et son compte, puis le partage et le dossier |
SERVEUR JELLYFIN |
Un serveur Jellyfin, par son adresse |
LISTE IPTV |
Une liste de chaînes M3U, par son adresse ou par un fichier du share |
VIDÉOS LOCALES |
Le dossier videos de votre share, et les disques branchés sur la Recalbox |
COMPTE PLEX |
Un compte Plex, à lier |
COMPTE CRUNCHYROLL |
Un compte Crunchyroll Premium, à lier |
COMPTE TWITCH |
Un compte Twitch, à lier |
COMPTE YOUTUBE |
Un compte YouTube, à lier : ses abonnements, ses vidéos aimées et ses playlists rejoignent l'onglet VOD. Recalbox ne fait que lire le compte |
NETFLIX (BÊTA) · PRIME VIDEO (BÊTA) |
Un site de streaming, joué sur son propre site avec votre compte |
Le menu se raccourcit à mesure qu'on s'en sert : une entrée disparaît une fois sa source ajoutée — VIDÉOS LOCALES, les quatre comptes à lier, chaque site de streaming. On la retrouve sous SOURCES, où la source se règle et se retire.
Les serveurs multimédia n'ont pas d'entrée à eux : les serveurs DLNA/UPnP du réseau (NAS, box opérateur…) se déclarent sous TROUVÉ SUR LE RÉSEAU, comme les partages, les serveurs Jellyfin et les chaînes d'une Freebox, qui arrive en liste de chaînes avec son guide.
Pluto TV est déjà là, sans rien configurer : ses chaînes gratuites et ses films garnissent les onglets EN DIRECT et VOD dès la première ouverture. On le coupe depuis son menu de source, avec SOURCE ACTIVÉE.
Un serveur Jellyfin s'ajoute par son nom ou son adresse IP (le port
8096est pris quand vous n'en donnez pas). La connexion se fait parCONNEXION RAPIDE— un code à approuver depuis un téléphone ou un ordinateur déjà connecté au serveur — ou par un utilisateur et son mot de passe, qui n'est jamais conservé sur la Recalbox.
La TV en direct d'une Freebox est reconnue avec son guide des programmes. Les chaînes Twitch que vous suivez s'affichent en direct, avec leurs rediffusions : sur Raspberry Pi 5/500 d'emblée, et sur Raspberry Pi 4/400 où le moteur web est encore à l'essai — il s'y ouvre au cas par cas. Aucune autre machine ne l'embarque. Des sites de streaming (Netflix et Prime Video, en bêta) s'ouvrent de la même façon, compte par compte, de même qu'un compte YouTube : ils n'apparaissent pas tant que l'équipe ne les a pas ouverts.
Plex, Crunchyroll, Twitch et YouTube se lient sans jamais taper de mot de passe sur la Recalbox : l'écran affiche un QR code et un code à saisir sur un téléphone ou un ordinateur, puis le compte est lié. Le code expire au bout de quelques minutes ; NOUVEAU CODE en demande un autre.
Un compte lié devient une source, et se dissocie depuis START → SOURCES → le compte → DISSOCIER.

Le menu d'une source change selon ce qu'elle est :
| Réglage | Pour quelles sources |
|---|---|
BIBLIOTHÈQUES |
Les bibliothèques du serveur que Recalbox TV lit |
CONTENU |
Classer tout ce que la source contient en Films, en Séries, ou laisser le nom décider |
AJOUTER SES FILMS ET SÉRIES À LA BIBLIOTHÈQUE |
Un disque ou un partage : ses vidéos rejoignent la bibliothèque, ou restent dans l'onglet FICHIERS |
QUALITÉ |
Plex et Crunchyroll : la qualité demandée au service |
MODIFIER |
Un partage ou un serveur : son adresse et son compte ; une liste IPTV : sa playlist et son guide |
SE CONNECTER |
Un site de streaming : l'adresse e-mail du compte, tapée dans la page de connexion du site |
AIDE : BIEN NOMMER LES VIDÉOS |
Un disque ou un partage : comment Recalbox TV distingue les films des épisodes |
SUPPRIMER CETTE SOURCE |
Ses vidéos quittent la bibliothèque ; les positions de lecture sont gardées |
Crunchyroll et une partie des films gratuits de Plex sont protégés : ils ne se lisent qu'avec Widevine, le module de Google, qui ne fait pas partie du système.
START → SOURCES → la source concernée.INSTALLER WIDEVINE (LECTURE DRM).Le module est téléchargé depuis les serveurs de Google — une vingtaine de méga-octets —, vérifié, puis rangé dans le dossier système caché du share. TESTER WIDEVINE lit ensuite le film de test de Google : s'il s'affiche, la Recalbox sait lire les vidéos protégées.
Google ne propose pas Widevine pour toutes les cartes. Quand il n'y en a pas pour la vôtre, Recalbox TV le dit, et les vidéos protégées restent illisibles — les autres sources, elles, ne changent pas.
Déposez vos fichiers dans le dossier videos de votre share, par le partage réseau share ou sur une clé USB, puis ajoutez la source VIDÉOS LOCALES.
C'est le nom du fichier qui permet de retrouver l'affiche, le résumé et les acteurs. Recalbox TV rappelle ces règles dans START → AIDE : BIEN NOMMER LES VIDÉOS.
Films
Titre (Année) : Gangs of New York (2002).mkvGangs of New York.mkv — mais l'année aide à trouver le bon film.The.Matrix.1999.mkv, Gangs-of-New-York-2002.mkvThe Matrix (1999) CD1.mkv, The Matrix (1999) CD2.mkvSéries
MacGyver/Saison 01/MacGyver S01E02.mkvMacGyver.S01E02.mkv, MacGyver-S01E02.mkvMacGyver 1x02.mkvDoctor Who (2005)/Saison 01/Doctor Who S01E01.mkv — l'année les distingue.MacGyver S00E01.mkvDossiers
films ou movies, ou dans leurs sous-dossiers, est prise pour un film.series ou tv shows, ou dans leurs sous-dossiers, est prise pour un épisode.CONTENU de la source classe tout le reste en Films ou en Séries.Les fiches viennent de TMDB et de TheTVDB.
.mkv .mp4 .m4v .avi .mov .webm .ts .m2ts .mts .mpg .mpeg .wmv .flv .ogv .3gp .vob
| Touche | Effet |
|---|---|
GAUCHE / DROITE |
Reculer ou avancer de 10 secondes |
L / R |
Reculer ou avancer de 5 minutes |
L2 / R2 |
Chapitre précédent ou suivant |
HAUT / BAS |
Volume |
X |
Les options de la vidéo |
Y |
Les informations de la vidéo |
X ouvre un panneau à trois onglets :
IMAGE — le cadrage (Image entière, Zoomée, Étirée), la résolution et la vitesse de lecture ;AUDIO — la piste audio et son décalage, par pas de 0,05 seconde ;SOUS-TITRES — la piste, son décalage par pas de 0,1 seconde, et sa taille, de la moitié au double.Ces choix valent pour la vidéo en cours ; les réglages du menu valent pour toutes.
Une vidéo arrêtée est proposée à la reprise au-delà de trois minutes de lecture, et tant qu'il reste plus de 8 % à voir. Au-delà de 90 %, elle est comptée comme vue et repartira du début.
Les vidéos en cours s'affichent sous CONTINUER À REGARDER, sur l'accueil ; RETIRER les en sort.
À la fin d'un épisode, le suivant s'enchaîne, et après le dernier d'une saison, le premier de la suivante — sauf si vous demandez autre chose avec À LA FIN D'UN ÉPISODE.
Avec un lecteur de cartes, une carte peut lancer une vidéo, comme elle lance un jeu.
START → ASSOCIER UNE CARTE.L'association est écrite sur la carte : elle fonctionne sur n'importe quelle Recalbox, pas seulement la vôtre. DISSOCIER LA CARTE l'efface. Une carte déjà liée à un jeu ou à une autre vidéo n'est remplacée qu'après confirmation.
La carte VHS fait exception : elle ouvre Recalbox TV sans rien lancer.
Une carte dont la vidéo est devenue introuvable — fichier effacé, disque débranché, serveur éteint — le dit à l'écran au lieu de lancer autre chose.
START → RÉGLAGES.

| Réglage | Par défaut | Effet |
|---|---|---|
RÉSOLUTION VIDÉO |
Auto |
La résolution de lecture. En Auto, sur un écran cathodique, chaque vidéo passe dans le mode de ses propres lignes |
FILMS 24P EN 48 HZ |
désactivé | Un film 24p est joué dans le mode cinéma que l'écran offre — 24, 48 ou 72 Hz —, à sa vraie cadence. Le libellé indique le mode disponible |
CADRE VIDÉO CRT |
— | Calibrer, mode par mode, la zone que votre écran cathodique montre vraiment |
SON |
Stéréo |
Stéréo mélange tout sur deux canaux ; Surround est pour un ampli |
CADRAGE |
Image entière |
Image entière, Zoomée ou Étirée |
À LA FIN D'UN ÉPISODE |
Lancer le suivant |
Lancer le suivant, Demander ou Arrêter |
TÉLÉCOMMANDE DE LA TV (HDMI-CEC) |
activé | Piloter Recalbox avec la télécommande du téléviseur |
ACCEPTER LES AVERTISSEMENTS DE CONTENU |
— | Un direct Twitch signalé à certains publics démarre sans demander |
NETTOYER LE CACHE |
— | Vide les affiches et les fiches, puis relit toutes les sources. Les positions de lecture sont gardées |
SCANNER À NOUVEAU TOUTES LES SOURCES |
— | Refait l'inventaire. Ce qu'une source n'a plus est masqué jusqu'à son retour |
DONNÉES DES FILMS ET SÉRIES |
— | D'où viennent les affiches et les résumés : TMDB et TheTVDB |
¶ 📺 Et sur un écran cathodique ?
Un CRT ne met pas l'image à l'échelle : il affiche des trames, et c'est là que Recalbox TV donne le meilleur. En
Auto, chaque vidéo prend le mode qui lui ressemble — d'abord par sa cadence (un mode à 50 Hz pour du 25 images par seconde, à 60 Hz pour du 30), puis par ses lignes : une capture 240p passe en 240p, un DVD PAL retrouve son 576i, et une vidéo plus fine que tout ce que l'écran sait faire prend son mode le plus haut.Les films, eux, tournent à 24 images par seconde, que ni le 50 ni le 60 Hz ne divisent : une image sur deux reste affichée plus longtemps que sa voisine, et les panoramiques saccadent. C'est ce que
FILMS 24Psupprime, en tenant chaque image exactement le même temps — deux trames en 48 Hz sur un CRT 15 kHz avec un Recalbox RGB Dual, trois balayages en 72 Hz sur un écran de PC, une image en 24 Hz sur un téléviseur HDMI qui l'accepte. Recalbox TV prend le 72 Hz s'il existe, sinon le 48, sinon le 24 — mais jamais au prix de la définition : un film 4K ne descend pas dans un mode 24 Hz qu'un téléviseur ne sort qu'en 1080p.Autre chose qui ne se règle pas : les cartes RGB de Recalbox sortent 18 bits de couleur, six par canal, là où une vidéo en compte vingt-quatre. Recalbox TV s'en aperçoit tout seul et trame l'image à la profondeur exacte de la carte — sans quoi les ciels, les fondus au noir et les dégradés sortiraient en bandes. Un écran branché en HDMI, lui, reçoit l'image telle quelle.
Enfin,
CADRE VIDÉO CRTretient, mode par mode, les quatre coins que votre écran montre vraiment : de quoi récupérer les sous-titres qui débordaient.
FILMS 24PetCADRE VIDÉO CRTn'apparaissent que si votre écran offre ce qu'ils règlent. Un écran incapable de tenir la cadence d'un film fait défiler l'image : laissez alorsFILMS 24Pdésactivé.
START → RECHERCHER cherche par n'importe quel mot du titre, de l'histoire, du casting ou des genres. Depuis les onglets FILMS ou SÉRIES, la recherche ne porte que sur eux ; depuis VOD, sur le service affiché.
Si votre téléviseur gère le HDMI-CEC, sa télécommande pilote Recalbox par le câble HDMI — flèches, OK, retour —, sans rien brancher d'autre. Le réglage est actif par défaut. Les Odroid Go 2 ne le proposent pas : leur noyau n'a pas ce qu'il faut.
Dans le menu principal, PARAMÈTRES AVANCÉS → RECALBOX TV :
ACTIVER RECALBOX TV : désactivé, il quitte la liste des systèmes et ne s'ouvre plus au démarrage ;OUVRIR RECALBOX TV AU DÉMARRAGE : la Recalbox démarre sur le média center.La même case se retrouve sous PARAMÈTRES DE DÉMARRAGE, nommée RECALBOX TV AU DÉMARRAGE.
| Quoi | Où |
|---|---|
| La bibliothèque | /recalbox/share/system/tv/library.db |
| Les positions de lecture | /recalbox/share/system/tv/playback.json |
| Les affiches et les fiches | /recalbox/share/system/tv/art |
| Widevine | /recalbox/share/system/.tv/widevine |
Ces fichiers se refont tout seuls : NETTOYER LE CACHE suffit à repartir de zéro sans perdre les positions de lecture.
Kodi n'est plus embarqué dans Recalbox 11.0. Les pages qui lui sont consacrées restent en ligne pour les versions 10.x :