Making a Recalbox theme

45 pages · 8 sections
FRENESDE Show everything Create my theme

All the components

What exists, and what each one can do.

A component is declared by its type — the tag name. A type not in this list is ignored by Recalbox and reported in the log.

Displaying something

TypeWhat it does
texta text, on one or several lines
scrolltexta text that scrolls when too long
markdowna formatted text (bold, headings, lists)
imagean image
videoa video
boxa color block, or a gradient
datetimea date
ratinga rating, as stars
sounda sound (nothing displayed)

Lists and navigation

TypeWhat it does
textlistthe game list
carouselthe system carousel
helpsystemthe help bar at the bottom of the screen

These nine are not placed: they adjust the look of the menus Recalbox builds itself.

menuBackground · menuIcons · menuText · menuTextSmall · menuSection · menuSwitch · menuSlider · menuButton · menuSize

Virtual keyboard styling

keyboard is not placed either: it gives its colors and its font to the keyboard Recalbox opens for a search or an input. It is set up in Global components.

Mind the case

Names are case sensitive. menuswitch does not work, it must be menuSwitch. A single property is the exception, written all lowercase: keepratio.