Deux façons d'ajouter un thème à Recalbox : le catalogue intégré, qui fait tout depuis la machine, et l'installation manuelle, pour les thèmes distribués ailleurs.
START → MENU PRINCIPAL → GESTIONNAIRE DE THÈMES (LANCER).GAUCHE/DROITE et les aperçus avec HAUT/BAS.A (INSTALLER).Veuillez confirmer. Voulez-vous installer le thème <nom> ? → OUI.Téléchargement du thème <nom>, Téléchargé à X%) puis l'installe (Installation du thème <nom>, Installé à X%, Nettoyage...).Souhaitez-vous activer le thème <nom> nouvellement installé ? → OUI applique le thème immédiatement, NON le laisse simplement installé.L'installation se fait sans redémarrage et sans toucher au thème actuellement utilisé tant que vous n'avez pas répondu OUI à la dernière question.
L'archive est téléchargée dans un dossier temporaire de la partition de démarrage, puis décompressée dans
/recalbox/share/themes/<dossier-du-theme>. Un thème lourd demande donc de la place à la fois sur la partitionBOOTet sur votre partageSHARE.
Quand une version plus récente d'un thème installé est publiée dans le catalogue, le bouton A affiche METTRE À JOUR au lieu d'APPLIQUER.
Le déroulé est le même que pour une installation, avec le message Veuillez confirmer. Voulez-vous mettre à jour le thème <nom> ?. L'ancienne version n'est remplacée qu'une fois la nouvelle correctement décompressée : en cas d'échec en cours de route, votre thème actuel reste intact.
Les thèmes installés à la main n'ont pas de version connue : ils ne sont jamais proposés à la mise à jour. Pour les mettre à jour, recopiez le nouveau dossier par-dessus l'ancien.
Placez-vous sur un thème installé et appuyez sur X (EFFACER), puis confirmez : Veuillez confirmer. Voulez-vous vraiment supprimer le thème <nom> ?.
Le dossier du thème est supprimé de /recalbox/share/themes. Si vous supprimez le thème actif, Recalbox bascule automatiquement sur le thème par défaut livré avec le système.
Les thèmes livrés avec Recalbox (recalbox-next, recalbox-next-v9, recalbox-240p) ne sont pas supprimables : le bouton EFFACER n'apparaît pas sur eux.
| Message | Cause | Que faire |
|---|---|---|
Échec lors du téléchargement du fichier du thème. Veuillez vérifier votre connexion Internet. |
Le téléchargement a échoué | Vérifiez le réseau et réessayez |
Échec lors de l'installation des fichiers requis. Veuillez vérifier si vous avez assez d'espace disque de libre ! |
Écriture ou renommage impossible | Libérez de l'espace sur SHARE et sur la partition de démarrage |
Une erreur est survenue pendant le chargement de la liste des thèmes! Veuillez recommencer plus tard. |
Le catalogue n'a pas pu être récupéré | Vérifiez la connexion Internet, puis rouvrez le gestionnaire |
Les thèmes distribués hors du dépôt officiel (dépôt GitHub d'un auteur, page personnelle, partage sur le Discord…) s'installent en copiant leur dossier.
share/themes, accessible par le partage réseau \\RECALBOX\share\themes, par le gestionnaire web, ou directement sur la carte SD (SHARE/themes/) — voir Gestion des fichiers.GESTIONNAIRE DE THÈMES (ou appuyez sur START s'il est déjà ouvert). Aucun redémarrage n'est nécessaire.L'arborescence doit ressembler à ceci — un seul dossier par thème, avec le theme.xml à sa racine, et surtout pas les fichiers du thème en vrac dans themes :
📁 recalbox
┣ 📁 share
┃ ┣ 📁 themes
┃ ┃ ┣ 📁 mon-theme
┃ ┃ ┃ ┣ 🗒 theme.xml
┃ ┃ ┃ ┣ 📁 snes
┃ ┃ ┃ ┣ 📁 megadrive
Évitez les espaces, les accents et les caractères spéciaux dans le nom du dossier du thème : les réglages du thème sont enregistrés dans
recalbox.confsous une clé construite à partir de ce nom, et tout caractère horsa-z,A-Z,0-9,_,.et-y est remplacé par un tiret.
Un thème ainsi copié apparaît dans le gestionnaire avec son nom lu dans theme.xml, l'auteur INCONNU si le fichier n'en déclare pas, la version INCONNU, et la description Ce theme a été installé manuellement. Nous n'avons aucune information à son sujet.. Vous pouvez l'appliquer (A), l'effacer (X) et régler ses options (Y) comme n'importe quel autre thème.
C'est le point qui casse le plus souvent un thème récupéré ailleurs : un thème conçu pour une version antérieure de Recalbox affichera des systèmes manquants, des visuels décalés, ou refusera de se charger.
La compatibilité est déclarée par le thème lui-même, dans la balise <theme> de son theme.xml :
<theme name="Mon thème" version="1.0" recalbox="10.0" compatibility="hdmi,crt" resolutions="hd,fhd">
recalbox — la version minimale de Recalbox. En dessous de 9.2, Recalbox prévient que La version du thème est trop ancienne et le thème peut ne pas fonctionner correctement. En pratique, visez un thème conçu pour la 10.x : le format a beaucoup changé.compatibility — les types d'affichage gérés : hdmi, crt, jamma, tate.resolutions — les résolutions gérées : qvga (240p), vga (480p), hd (720p), fhd (1080p).Ces mêmes valeurs alimentent les pictogrammes affichés dans le gestionnaire et la coche de compatibilité dans la liste OPTIONS DE L'INTERFACE → THÈME → THÈME. Les thèmes du catalogue intégré sont testés pour la version installée ; ceux récupérés ailleurs ne le sont pas.
Le détail complet de ces attributs se trouve dans la page Arborescence de la documentation des thèmes.