Displaying conditionally
The 26 conditions: the machine, the screen, and the displayed system.
An if= condition makes a component appear only in certain cases.
<image name="fond" if="crt">…</image>They combine with ! (not), & (and), | (or) — or, if you prefer words, not, and, or: if="crt and not tate". See Combining several conditions.
⚠️ An identifier missing from this list is ignored by Recalbox and reported as unknown in themes.log.
Everywhere — the machine and the screen
| Condition | True when… |
|---|---|
hd fhd vga qvga | the screen has that resolution |
crt | the screen is a CRT tube |
overscan | the picture overscans (CRT without Jamma) |
tate tateleft tateright | the screen is vertical |
jamma bartop | the machine is an arcade cabinet |
ispc ispi isodroid isanbernic | the machine is that model |
nomenu | menus are disabled |
Only where a system is displayed
These eight query the current system. They only apply in the Systems view and the Game list — elsewhere there is no system, and the condition is always false.
| Condition | True when… |
|---|---|
console handheld computer arcade engine port fantasy | the system is of that type |
virtual | it is an automatic system (Favorites, Last played, All games…) |
favorite | it is the automatic Favorites system |
lastplayed | it is the automatic Last played system |
⚠️
favoritedoes not mean the highlighted game is a favorite: it refers to the system. There is no condition on a game or a folder — to react to a game’s content, use its variables (${game.isfavorite}) orifexists.