¶ Introduction
To make themes more dynamic, there are some variables you can use. These variables can be used anywhere in the tags.
Apart from the $system, $language and $country variables, all other variables have been present since Recalbox 9.2.
¶ Variables list
Contextual variables
Custom variables
The variables below are deprecated in Recalbox 10. We invite you to modify your themes with the latest variables.
The subpages listed above contain all the variables that can be used in Recalbox 10 minimum.
¶ Variable $system 
The $system variable is used to make the system name dynamic.
Example:
<include>
./$system/custom.xml
</include>
¶ Variable $language
The $language variable allows you to use the code of the language chosen by the user.
Example:
<include>
./data/$language/texts.xml
</include>
¶ Variable $country
The $country variable allows you to use the country chosen by the user.
Example:
<include>
./data/$country/logo.svg
</include>
¶ Variable $fullname
The $fullname variable uses the full name of the current system.
Example:
<text name=“systemCurrent” text=“$fullname”></text>
¶ Variable $type
The $type variable allows you to use the type of system from this list:
- arcade: arcade system
- computer: microcomputer
- console: home console
- engine: game engine
- fantasy: fantasy console
- handheld: portable console
- port: ports
- virtual: virtual system except arcade
- virtual-arcade: virtual arcade system by manufacturer
Example:
<text name=“systemGameName” text=“$type”></text>
¶ Variable $pad
The $pad variable indicates whether a pad or joystick is required to take advantage of this system from this list:
- mandatory: mandatory
- recommended: strongly recommended
- optional: you can do without it
- no: not required
Example:
<image>
<path path=“./data/assets/pad-$pad.svg”></path>
</image>
¶ Variable $keyboard
The $keyboard variable indicates the level of need for a keyboard to take advantage of this system among this list:
- mandatory: mandatory
- recommended: strongly recommended
- optional: you can do without it
- no: not required
<image>
<path path=“./data/assets/keyboard-$keyboard.svg”></path>
</image>
¶ Variable $mouse
The $mouse variable indicates the level of need for a mouse to take advantage of this system from this list:
- mandatory: mandatory
- recommended: strongly recommended
- optional: you can do without it
- no: not required
<image>
<path path=“./data/assets/mouse-$mouse.svg”></path>
</image>
¶ Variable $releaseyear
The $releaseyear variable indicates the year the system was released.
Example:
<text name=“date” extra=“true”>
<text>System release date: $releaseyear</text>
</text>
¶ Variable $netplay
The $netplay variable indicates by yes or no whether the system is Netplay-compatible or not.
Example:
<text name=“netplay” extra=“true”>
<text>Netplay available for system: $netplay</text>
</text>
¶ Variable $lightgun
The $lightgun variable indicates by yes or no whether the system has lightgun-playable games.
<text name=“lightgun” extra=“true”>
<text>Lightgun game: $lightgun</text>
</text>
¶ Variable $crt
The $crt variable indicates by yes or no whether a CRT adapter is active or not.
<text name=“crt” extra=“true”>
<text>CRT active: $crt</text>
</text>
¶ Variable $jamma
The $jamma variable indicates by yes or no whether a Jamma adapter is active or not.
<text name=“jamma” extra=“true”>
<text>Jamma active: $jamma</text>
</text>
¶ Variable $tate
The $tate variable indicates by yes or no whether the screen is flipped to 90° or -90°.
<text name=“tate” extra=“true”>
<text>Active tate: $tate</text>
</text>
¶ Variable $overscan
The $overscan variable indicates by yes or no whether a CRT adapter without a Jamma adapter is active or not.
<text name=“overscan” extra=“true”>
<text>Overscan active: $overscan</text>
</text>
¶ Variable $resolution
The $resolution variable is used to hold information for a certain screen resolution.
List of values:
qvga: less than or equal to 288 pixels in height.vga: less than or equal to 576 pixels in height.hd: less than or equal to 920 pixels in height.fhd: greater than 920 pixels in height.
<text name=“resolution” extra=“true”>
<text>Resolution: $resolution</text>
</text>