Making a Recalbox theme

45 pages · 8 sections
FRENESDE Show everything Create my theme

The fonts

The machine's, and yours.

A font comes from two places, and that changes what must be shipped.

The machine's

<fontPath>:/ubuntu_condensed.ttf</fontPath>

The :/ designates EmulationStation's resources. Nothing to copy into your theme: the file is present on every Recalbox.

Yours

<fontPath>${root}/data/fonts/Exo2.otf</fontPath>

The file must be in your theme, and will ship with it. TTF and OTF work.

The size

fontSize changes unit depending on its value: below 1, it is a proportion of the screen height; from 1 up, it is pixels. Everything is explained in Ratio, percentage or pixels. Prefer the ratio: 0.045 gives the same proportion everywhere.

Pixel fonts

f8bitfortressplus is only sharp at sizes that are multiples of 7 in pixels. Between those values, it smears. That is true of every font drawn pixel by pixel: if you add one, check at which sizes it is clean.

fontStyle

normal · bold · italic · bolditalic

⚠️ Only works if the font contains those weights. A font shipped as a single “Regular” file will not become bold: you must provide the “Bold” file and point to it with its own fontPath.

Shipped with Recalbox

Nothing to copy into your theme.

FontWhat to write
Ubuntu Condensed:/ubuntu_condensed.ttf
DejaVu Sans Condensed:/dejavusanscondensed.ttf
Ubuntu Mono:/UbuntuMonoR.ttf
8-bit Fortress Plus — pixel font, crisp at multiples of 7:/f8bitfortressplus.ttf