Custom Fonts

Themes can use their own TrueType (.ttf) fonts. Put them in the font folder in the theme root, or in a resolution folder for a version made for one screen size.

Where fonts go

font/default.ttfThe main font for lists and the interface.
font/{module}.ttfThe main font for one screen.
font/header/default.ttfThe header font.
font/footer/default.ttfThe footer font.
font/panel/default.ttfThe font for grid panels.
font/{area}/{module}.ttfA header, footer or panel font for one screen.

For example, font/header/muxlaunch.ttf is used for the Main Menu header, and 640x480/font/header/muxlaunch.ttf does the same at 640x480 only.

Fonts for a language

Put language-specific fonts in font/{language}, keeping the rest of the path the same:

font/{language}/default.ttf
font/{language}/header/default.ttf
font/{language}/footer/default.ttf
font/{language}/panel/default.ttf

Screens in grid mode can also use the grid path the frontend recognises. Keep a general fallback font when a theme covers several languages or layouts.

How a font is chosen

MustardOS looks in the resolution folder first, then the theme root. In each place it tries these in order:

LanguageA font for the active language.
AreaA font for the header, footer or panel being drawn.
ScreenA font named after the current screen.
Defaultdefault.ttf.

If nothing matches, the bundled interface font is used.

Font sizes and padding are set in the [font] section of the scheme reference. A user’s own Font Settings always take priority over the theme.