Un thème Recalbox est un ensemble de fichiers XML et de ressources graphiques qui décrivent l'apparence complète d'EmulationStation : liste des systèmes, listes de jeux, menus, barre d'aide et écran de veille. Cette section documente le moteur de thèmes tel qu'il est implémenté dans Recalbox 10.1.
Cette documentation décrit le format de thème de Recalbox 10.0 et supérieur. Un thème qui déclare
recalbox="9.1"ou moins est signalé comme potentiellement incompatible au moment de l'activer.
Si vous découvrez la thématisation, suivez ces pages dans l'ordre :
theme.xml, attributs de la balise <theme>.${...}.Un thème est composé de vues (<view>), chaque vue contient des objets (<image>, <text>, <carousel>…), et chaque objet porte des propriétés (pos, size, color…).
<theme name="Mon thème" version="1.0" recalbox="10.0" compatibility="hdmi" resolutions="hd,fhd">
<view name="system">
<image name="deco" extra="true" path="./art/fond.png" pos="0 0" size="1 1" zIndex="5" />
</view>
</theme>
Les cinq vues existantes en 10.1 sont system, detailed, basic, menu et gameclip. Toute autre valeur est ignorée, avec une erreur consignée dans themes.log.
Un objet dont le name correspond à un élément déjà géré par l'interface (par exemple <image name="logo">) personnalise cet élément. Un objet dont le name vous est propre doit porter extra="true" : il est alors ajouté à la vue, et dessiné dans l'ordre de déclaration.
${...} remplacent les anciennes variables $system, $fullname, $crt… qui restent lues mais sont dépréciées.<box>, <scrolltext>, <markdown>, <menuSection>, <menuSize>, <keyboard>.textOnly="true"), avec ses propres couleurs et son sélecteur.ifexists et ifnotexists.grid et video n'existent plus.EmulationStation cherche les thèmes dans trois dossiers, dans cet ordre :
| Emplacement | Usage |
|---|---|
/recalbox/share_init/system/.emulationstation/themes/ |
Thèmes livrés avec Recalbox, en lecture seule |
/recalbox/share/themes/ |
Vos thèmes — c'est ici que vous travaillez, et c'est aussi ici que le gestionnaire de thèmes installe ses téléchargements |
/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.
Le thème actif se choisit depuis MENU PRINCIPAL > OPTIONS DE L'INTERFACE > THÈME > THÈME. Le même menu propose la RÉGION, le style de transition, et les options propres au thème sélectionné. Pour télécharger des thèmes supplémentaires, utilisez MENU PRINCIPAL > GESTIONNAIRE DE THÈMES — voir Gestionnaire de thèmes et Options des thèmes côté utilisateur.
Une question sur la création de thèmes ? Rejoignez le Discord Recalbox.