Trying out your theme

Copying it onto the machine, and reading the log when something goes wrong.

A theme can only be judged switched on, on a screen. The studio's preview is faithful, but nothing replaces the machine.

1. Export the theme from the studio;
2. copy the folder into /recalbox/share/themes/;
3. on the machine: Menu → Interface properties → Theme, and pick yours.

📄 The log: themes.log

This is the first place to look when something does not show up.

/recalbox/share/system/logs/themes.log

It records, with file and line to back it up:

• an unknown property — often a case mistake (keepRatio instead of keepratio);
• a component whose type does not exist;
• an Extra type unknown: … — you placed as an extra a type that does not accept it;
• a variable without name or without value;
• a badly written pair (pos, size).

An invisible component with nothing in the log almost always means extra="true" is missing: see The most important rule.