The system view — the machines
The carousel, the logo, the information line.
The first screen: the list of your machines.
The reserved components
| Name | Type | Role |
|---|---|---|
systemcarousel | carousel | the carousel — one only, not renamable |
logo | image | the system's logo in the carousel |
systemInfo | text | the “510 games available, 13 favorites” line |
bgsound | sound | the theme's background music |
directory | sound | the theme's music folder |
bgsoundanddirectoryare the only names<sound>accepts, and only in this view.
Two traps
systemInfo has a gray background by default. To remove it:
<text name="systemInfo">
<backgroundColor>00000000</backgroundColor>
</text>
The carousel is unique. A second <carousel> is read without error but never drawn.
The default logo
When the theme does not provide a logo, Recalbox looks for its own in this order:
<system>-<language_COUNTRY>.svg → <system>-<language>.svg
→ <system>-<region>.svg → <system>.svg
That is what allows a “Genesis” logo in the United States and “Mega Drive” in Europe without writing anything.
The carousel in detail
| Property | Default | Detail |
|---|---|---|
type | horizontal | horizontal, vertical, vertical_wheel; any other value falls back to horizontal |
logoSize | computed | ratio of the screen, not of the carousel |
logoScale | 1.2 | enlargement of the chosen logo |
maxLogoCount | 3 | rounded to the integer — a decimal is useless |
color | transparent | the carousel's background |
The spacing of the logos is computed like this:
spacing = (length − logoSize × maxLogoCount) / maxLogoCount + logoSize
where length is size.y in vertical, size.x in horizontal.