Making a Recalbox theme

49 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 smaller side of the screen; from 1 up, it is a size meant for a 240-line screen, which Recalbox multiplies according to the definition — never screen 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

Recalbox makes those weights itself: it thickens the outline by one pixel for bold, and it slants the letters for italic. A font shipped as a single “Regular” file therefore becomes bold and slanted without any other file.

⚠️ A real “Bold” file drawn by a typographer still looks better: if your font has one, point to it with its own fontPath.

⚠️ fontStyle only exists on text and scrolltext. The other components ignore it.

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