Un thème est l'habillage complet d'EmulationStation : fond d'écran, carrousel des systèmes, disposition des listes de jeux, polices, couleurs, sons et animations. En changer transforme entièrement l'aspect de votre Recalbox sans toucher à un seul réglage de jeu.
Le gestionnaire de thèmes, arrivé avec Recalbox 10, va chercher en ligne le catalogue officiel des thèmes et permet de les parcourir, installer, mettre à jour, activer et supprimer directement depuis la machine — plus besoin d'ordinateur ni de carte SD à démonter. Le changement de thème est immédiat : aucun redémarrage n'est nécessaire.
Le gestionnaire a besoin d'une connexion Internet pour récupérer le catalogue et télécharger les thèmes. Sans réseau, les thèmes déjà installés restent utilisables via
MENU PRINCIPAL→OPTIONS DE L'INTERFACE→THÈME.
¶ Ouvrir le gestionnaire
Appuyez sur START pour ouvrir le MENU PRINCIPAL, sélectionnez GESTIONNAIRE DE THÈMES puis validez (LANCER).
Recalbox affiche Chargement de la liste des thèmes... puis Chargement des informations des thèmes... avec une barre de progression, le temps de récupérer le catalogue et la fiche de chaque thème.
Si le catalogue ne peut pas être récupéré, le message
Une erreur est survenue pendant le chargement de la liste des thèmes! Veuillez recommencer plus tard.s'affiche et le gestionnaire se referme. Vérifiez votre connexion réseau et réessayez.
¶ L'écran du gestionnaire
Le gestionnaire présente un thème à la fois. Le titre affiche GESTIONNAIRE DE THÈMES (n/total) : la position du thème courant dans le catalogue.
Au centre, les captures d'écran du thème (liste des systèmes, listes de jeux, menus, clips de jeux) défilent verticalement.
De part et d'autre, des pictogrammes indiquent ce que le thème sait faire — allumés s'il est compatible, estompés sinon :
| Colonne | Pictogrammes | Signification |
|---|---|---|
| Gauche — affichage | HDMI, CRT, JAMMA, TATE |
Types d'écran prévus par le thème (TATE = écran pivoté à la verticale) |
| Droite — résolution | SD 240p, SD+ 480p, HD 720p, FULLHD 1080p |
Résolutions pour lesquelles le thème a été conçu |
Un logo Patreon apparaît en haut à droite sur les thèmes réservés aux patrons.
Sous les captures, le nom du thème est suivi de son état, [Installé] ou [Non installé], puis d'une fiche descriptive :
Auteur— l'auteur du thème ;Version— la version du thème, ouINCONNUpour un thème installé à la main ;Compatible avec—Recalbox v10.00 et versions supérieures, par exemple ;Taille du téléchargement— le poids de l'archive à télécharger ;Description— la présentation du thème, affichée dans votre langue quand l'auteur l'a traduite.
¶ Les commandes
| Commande | Action |
|---|---|
GAUCHE/DROITE (PARCOURIR LES THÈMES) |
Passer d'un thème à l'autre |
HAUT/BAS (PARCOURIR LES APERÇUS) |
Faire défiler les captures du thème affiché |
A (INSTALLER) |
Télécharger et installer le thème (s'il n'est pas installé) |
A (APPLIQUER) |
Activer un thème déjà installé |
A (METTRE À JOUR) |
Installer la nouvelle version d'un thème déjà installé |
X (EFFACER) |
Désinstaller le thème |
Y (OPTIONS) |
Ouvrir les options du thème — uniquement sur le thème actif |
B (FERMER) |
Quitter le gestionnaire |
Le libellé du bouton A change donc tout seul selon la situation : INSTALLER, APPLIQUER ou METTRE À JOUR. De même, EFFACER et OPTIONS n'apparaissent dans la barre d'aide que quand ils sont possibles.
Le bouton
START, non affiché dans la barre d'aide, recharge le catalogue : pratique après avoir copié un thème à la main, ou pour retenter le chargement après une coupure réseau.
¶ Le catalogue
Le catalogue rassemble trois familles de thèmes :
- Les thèmes livrés avec Recalbox —
recalbox-next(le thème par défaut),recalbox-next-v9etrecalbox-240p. Ils sont toujours présents, ne se téléchargent pas et ne peuvent pas être supprimés. - Les thèmes du dépôt officiel — publiés et validés par l'équipe Recalbox, téléchargés à la demande.
- Les thèmes patron — une sélection exclusive qui s'ajoute au catalogue pour les soutiens Patreon de Recalbox, une fois la clé renseignée dans
recalbox.conf(voir Jukebox pour la procédure d'activation).
Les thèmes que vous avez copiés vous-même dans /recalbox/share/themes apparaissent aussi dans la liste, sous le nom lu dans leur theme.xml, avec la mention Ce theme a été installé manuellement. Nous n'avons aucune information à son sujet. — voir Installer des thèmes.
Beaucoup de thèmes sont publiés en plusieurs variantes (une par type d'écran et par résolution). Vous n'avez rien à choisir : Recalbox détecte votre affichage et sélectionne automatiquement la variante et les captures d'écran qui correspondent le mieux à votre matériel.
¶ Changer de thème actif
Placez-vous sur un thème installé et appuyez sur A (APPLIQUER). Le nouveau thème se charge immédiatement, sans redémarrage : Chargement du nouveau thème <nom> s'affiche le temps du basculement.
Si le thème n'est pas prévu pour votre configuration, Recalbox demande confirmation avec le détail du problème — écran non supporté, résolution non supportée, mode TATE non géré, ou version de thème trop ancienne — suivi de Êtes-vous certain de vouloir activer ce thème ?. Vous pouvez passer outre, au risque d'un affichage cassé.
Le thème actif se change aussi depuis MENU PRINCIPAL → OPTIONS DE L'INTERFACE → THÈME → THÈME. Dans cette liste, chaque thème est précédé d'une coche s'il est compatible avec votre configuration, ou d'un panneau d'avertissement sinon, et suivi de son numéro de version.
¶ Où sont stockés les thèmes
EmulationStation cherche les thèmes dans trois dossiers :
| Emplacement | Contenu |
|---|---|
/recalbox/share_init/system/.emulationstation/themes/ |
Thèmes livrés avec Recalbox, en lecture seule |
/recalbox/share/themes/ |
Thèmes installés par le gestionnaire et thèmes copiés à la main |
/recalbox/share/system/.emulationstation/themes/ |
Emplacement historique, toujours lu |
Un dossier n'est reconnu comme thème que s'il contient un fichier theme.xml à sa racine.
Dans les thèmes installés par le gestionnaire, un fichier caché .installedFrom conserve l'URL d'origine : c'est ce qui permet à Recalbox de reconnaître le thème dans le catalogue et de détecter les mises à jour. Ne le supprimez pas.
Le thème actif est mémorisé dans recalbox.conf :
emulationstation.theme.folder=recalbox-next
¶ Aller plus loin
- Installer des thèmes — installation depuis le catalogue, mise à jour, suppression et installation manuelle.
- Options des thèmes — jeux de couleurs, agencements, régions et autres réglages proposés par les thèmes.
- Créer et modifier un thème — la documentation complète du format de thème d'EmulationStation.
- Vous avez créé un thème ? Présentez-le sur le Discord Recalbox : c'est par là qu'un thème rejoint le dépôt officiel.
¶ Questions fréquentes
Le gestionnaire affiche une erreur au chargement. Le catalogue est récupéré en ligne : vérifiez que la Recalbox a accès à Internet (MENU PRINCIPAL → OPTIONS RÉSEAU), puis rouvrez le gestionnaire ou appuyez sur START pour relancer le chargement.
Je ne vois pas les thèmes patron. Ils n'apparaissent qu'avec un statut patron actif : voyez Activer son statut patron.
EFFACER n'apparaît pas. Les thèmes livrés avec Recalbox ne sont pas supprimables — c'est normal, ils garantissent qu'il reste toujours un thème fonctionnel sur la machine.
OPTIONS n'apparaît pas. Le raccourci Y n'ouvre les options que du thème actuellement utilisé. Appliquez d'abord le thème (A), puis appuyez sur Y.
Faut-il redémarrer après un changement de thème ? Non. Le changement de thème comme le changement d'option de thème sont appliqués à chaud.