Making a Recalbox theme

45 pages · 8 sections
FRENESDE Show everything Create my theme

Virtual keyboard styling

The colors and the font of the keyboard that opens to search a game or type a text.

Like the menus, it is not placed: the keyboard decides its own geometry, the theme only picks its colors and its font.

It opens over the screen you are on, whichever it is — so it is set once, in Global components.

PropertyWhat it paints
keyColoreach key's background at rest
keySelectedColorthe key you are on
keyTextColorthe letter written on the key
keyDisabledColorthe letter of a character the input refuses
keyModifierColorShift / Ctrl / Alt pressed for a single key
keyModifierLockedColorShift / Ctrl / Alt locked
keyTitleColorthe title above the keyboard
keyEditTextColorthe text being typed
fontPaththe font — the size stays decided by the keyboard

Three keyboards, and the user chooses

The theme does not decide which one shows: it is a console setting. And they do not all read your colors.

So set first the four that all of them read: your styling will hold whatever the keyboard.

What it writes

<view name="system, basic, detailed, menu, gameclip">
    <keyboard name="keyboard">
        <keyColor>1B1D22</keyColor>
        <keySelectedColor>4FE3C1</keySelectedColor>
        <keyTextColor>FFFFFF</keyTextColor>
        <keyTitleColor>FFFFFF</keyTitleColor>
        <keyEditTextColor>FFFFFF</keyEditTextColor>
    </keyboard>
</view>

The name must be exactly keyboard, and it accepts neither pos nor size.

Available from Recalbox 10.1. On an older machine, the block is ignored and the keyboard keeps its factory colors.