Scheme Files

A scheme is a plain text .ini file that sets your theme’s colours, transparency, sizes and positions. Each screen can have its own scheme, and every scheme only needs the settings you want to change.

Key ideas

ColoursSix-digit hex codes, such as C69200.
AlphaTransparency from 0, invisible, to 255, fully solid.
Missing settingsKeep whatever the previous layer set, or the frontend's built-in default.
One screenName a scheme after a screen's module, such as muxlaunch.ini, to change only that screen. Theme Structure lists the module names.

How schemes are layered

Several schemes can apply to one screen. They load in this order, and a later layer always wins:

Global/scheme/global.ini applies to every screen at every resolution.
Resolution default/{resolution}/scheme/default.ini applies to every screen at that resolution.
Screen/{resolution}/scheme/{module}.ini applies to one screen.
AlternativeThe active alternative's scheme files.
Device overrideMUOS/theme/override/{module}.ini on the device itself, handy for quick tests without editing the theme.

Layers 2 and 3 look in the resolution folder first, then fall back to the theme’s root scheme folder. If the theme has no folder for the device’s resolution, MustardOS scales a resolution the theme does support to fit the screen. Users can also choose a theme resolution themselves in Customisation.

Jump to a section

Setting reference

Each section below matches a [section] in a scheme file. Every row shows a setting with an example value, its default and what it does.

Section [background]

Setting Default Description
BACKGROUND=C69200 C69200 Background colour. Most used in [list] gradients.
BACKGROUND_ALPHA=255 255 Background colour transparency.
BACKGROUND_GRADIENT_COLOR=C69200 C69200 Second colour in the gradient.
BACKGROUND_GRADIENT_START=0 0 Start point of gradient change. [BACKGROUND] changes to [BACKGROUND_GRADIENT_COLOR] colour.
BACKGROUND_GRADIENT_STOP=200 200 End point of gradient change.
BACKGROUND_GRADIENT_DIRECTION=0 0 Direction of gradient.
0 = None
1 = Vertical
2 = Horizontal
BACKGROUND_GRADIENT_DITHER=0 0 Apply dithering effect to background gradient to help smooth out banding in the background gradient.
0 = Disabled
1 = Enabled
BACKGROUND_GRADIENT_BLUR=0 0 Apply blur to background gradient.
0 = Disabled
1 or greater = Level of blur.

Section [animation]

These settings are parsed and stored by the frontend. Nothing currently reads them to drive visible behaviour; list item animation timing is hard coded elsewhere. They are documented for completeness and currently have no visible effect.

Setting Default Description
ANIMATION_DELAY=100 100 Reserved. Minimum accepted value is 10.
ANIMATION_REPEAT=0 0 Reserved.
ANIMATION_FOREGROUND=0 0 Reserved.
ANIMATION_POSITION=4 4 Reserved.
ANIMATION_ALPHA=255 255 Reserved. Accepted range is 1-255.

Section [font]

Font sizes set here are the theme’s own preference, in pixels. A user can still override any of these from their own device in Customisation > Font Settings, which always takes priority over what the theme sets here. See the Custom Fonts page for how to actually supply the font files these sizes apply to.

Setting Default Description
FONT_LIST_SIZE=0 0 (auto) Point size for list item text. 0 leaves it at the frontend’s device-appropriate default.
FONT_HEADER_SIZE=0 0 (auto) Point size for header text. 0 leaves it at the frontend’s device-appropriate default.
FONT_FOOTER_SIZE=0 0 (auto) Point size for footer text. 0 leaves it at the frontend’s device-appropriate default.
FONT_PANEL_SIZE=0 0 (auto) Point size for grid mode panel text. 0 leaves it at the frontend’s device-appropriate default.
FONT_HEADER_PAD_TOP=0 0 Number of pixels from top of header area to header text.
FONT_HEADER_PAD_BOTTOM=0 0 Number of pixels from bottom of header area to header text.
FONT_HEADER_ICON_PAD_TOP=0 0 Number of pixels from top of header area to header icons.
FONT_HEADER_ICON_PAD_BOTTOM=0 0 Number of pixels from bottom of header area to header icons.
FONT_FOOTER_PAD_TOP=0 0 Number of pixels from top of footer area to footer text.
FONT_FOOTER_PAD_BOTTOM=0 0 Number of pixels from bottom of footer area to footer text.
FONT_FOOTER_ICON_PAD_TOP=0 0 Number of pixels from top of footer area to footer icons.
FONT_FOOTER_ICON_PAD_BOTTOM=0 0 Number of pixels from bottom of footer area to footer icons.
FONT_MESSAGE_PAD_TOP=0 0 Number of pixels from top of message area to message text.
FONT_MESSAGE_PAD_BOTTOM=0 0 Number of pixels from bottom of message area to message text.
FONT_MESSAGE_ICON_PAD_TOP=0 0 Number of pixels from top of message area to message icons.
FONT_MESSAGE_ICON_PAD_BOTTOM=0 0 Number of pixels from bottom of message area to message icons.
FONT_LIST_PAD_TOP=0 0 Number of pixels from top of a list item area to a list item text.
FONT_LIST_PAD_BOTTOM=0 0 Number of pixels from bottom of an item area to a list item text.
FONT_LIST_PAD_LEFT=32 32 Number of pixels from left of a list item area to a list item text.
FONT_LIST_PAD_RIGHT=6 6 Number of pixels from right of an item area to a list item text.
FONT_LIST_ICON_PAD_TOP=0 0 Number of pixels from top of a list item area to a list item glyph.
FONT_LIST_ICON_PAD_BOTTOM=0 0 Number of pixels from bottom of an item area to a list item glyph.

Note: By default text and glyphs in the header, footer, and list items will be centred vertically. It is recommended to start with a value of 0. Depending on the font used you may need to adjust the FONT_LIST_PAD_TOP or FONT_LIST_PAD_BOTTOM settings. FONT_LIST_PAD_TOP to move the text down and FONT_LIST_PAD_BOTTOM to move the text up. Do not use both settings at the same time.

Section [status]

Setting Description
ALIGN=1 Alignment of header icons
0 = Left
1 = Right
2 = Centre
3 = Icons spaced evenly across header
4 = icons evenly distributed with equal space around them
5 = First icon aligned left last icon aligned right all other icons evenly distributed
PADDING_LEFT=0 Number of pixels of space to add to left side of the header icons.
PADDING_RIGHT=0 Number of pixels of space to add to right side of the header icons.

Section [battery]

Setting Description
BATTERY_NORMAL=FFFFFF Battery icon standard recolour.
BATTERY_ACTIVE=85F718 On-charge battery icon recolour.
BATTERY_LOW=D35C54 Low battery icon recolour.
BATTERY_NORMAL_ALPHA=255 Battery icon standard recolour transparency.
BATTERY_ACTIVE_ALPHA=255 On-charge battery icon recolour transparency.
BATTERY_LOW_ALPHA=255 Low battery icon recolour transparency.

Section [network]

Setting Description
NETWORK_NORMAL=282525 Disconnected network icon recolour.
NETWORK_ACTIVE=F7E318 Connected network icon recolour.
NETWORK_NORMAL_ALPHA=255 Disconnected network icon recolour transparency.
NETWORK_ACTIVE_ALPHA=255 Connected network icon recolour transparency.

Section [bluetooth]

Setting Description
BLUETOOTH_NORMAL=282525 Disconnected bluetooth icon recolour.
BLUETOOTH_ACTIVE=F7E318 Connected bluetooth icon recolour.
BLUETOOTH_NORMAL_ALPHA=255 Disconnected bluetooth icon recolour transparency.
BLUETOOTH_ACTIVE_ALPHA=255 Connected bluetooth icon recolour transparency.

Section [date]

Setting Description
DATETIME_TEXT=FFFFFF Time text colour.
DATETIME_ALPHA=255 Time text transparency.
DATETIME_ALIGN=1 Alignment of time text
0 = Auto
1 = Left
2 = Centre
3 = Right
PADDING_LEFT=0 Number of pixels of space to add to left side of the time text.
PADDING_RIGHT=0 Number of pixels of space to add to right side of the time text.
Setting Description
FOOTER_HEIGHT=42 Adjust the height of the footer by pixels.
FOOTER_BACKGROUND=100808 Footer area/background colour.
FOOTER_BACKGROUND_ALPHA=255 Footer area/background transparency.
FOOTER_TEXT=FFFFFF Footer text colour, not including any navigation buttons.
FOOTER_TEXT_ALPHA=255 Footer text transparency, not including any navigation buttons.

Section [header]

Setting Description
HEADER_HEIGHT=42 Adjust the height of the header by pixels.
HEADER_BACKGROUND=100808 Header area/background colour.
HEADER_BACKGROUND_ALPHA=255 Header area/background transparency.
HEADER_TEXT=FFFFFF Header text colour, not including time text.
HEADER_TEXT_ALPHA=255 Header text transparency, not including time text.
HEADER_TEXT_ALIGN=2 Alignment of header title text
0 = Auto
1 = Left
2 = Centre
3 = Right
PADDING_LEFT=0 Number of pixels of space to add to left side of the title text.
PADDING_RIGHT=0 Number of pixels of space to add to right side of the title text.

Section [help]

Setting Description
HELP_BACKGROUND=282525 Help/info background window colour.
HELP_BACKGROUND_ALPHA=255 Help/info background window transparency.
HELP_BORDER=100808 Help/info window border colour.
HELP_BORDER_ALPHA=255 Help/info window border transparency.
HELP_CONTENT=A5B2B5 Help/info window standard text colour.
HELP_TITLE=F7E318 Help/info window title text colour.
HELP_RADIUS=3 Border roundness. 0 is a right angle. 10+ is very round.

Section [dialogue]

Covers confirmation prompts and popup dialogues, such as the save-scope prompt shown when backing out of a settings screen with unsaved changes.

Setting Default Description
DIALOGUE_BACKGROUND=282525 282525 Dialogue window background colour.
DIALOGUE_BACKGROUND_ALPHA=255 255 Dialogue window background transparency.
DIALOGUE_BORDER=100808 100808 Dialogue window border colour.
DIALOGUE_BORDER_ALPHA=255 255 Dialogue window border transparency.
DIALOGUE_TITLE=F7E318 F7E318 Dialogue title text colour.
DIALOGUE_CONTENT=A5B2B5 A5B2B5 Dialogue body text colour.
DIALOGUE_OPTION=282525 282525 Colour of the individual selectable options within the dialogue.
DIALOGUE_DIM_ALPHA=128 128 How much the rest of the screen dims behind an open dialogue.
DIALOGUE_SELECTION=F7E318 F7E318 Colour of the currently highlighted option.
DIALOGUE_SELECTION_ALPHA=255 255 Transparency of the currently highlighted option’s colour.
DIALOGUE_RADIUS_MAIN=3 3 Dialogue window corner radius. 0 is a right angle, 10+ is very round.
DIALOGUE_RADIUS_SELECTED=0 0 Corner radius of the highlighted option.
DIALOGUE_SHADOW_COLOUR=000000 000000 Drop shadow colour cast by the dialogue window.
DIALOGUE_SHADOW_ALPHA=255 255 Drop shadow transparency. Accepted range is 1-255.
DIALOGUE_SHADOW_X_OFFSET=2 2 Horizontal offset of the drop shadow, in pixels.
DIALOGUE_SHADOW_Y_OFFSET=2 2 Vertical offset of the drop shadow, in pixels.
DIALOGUE_SHADOW_COLOUR_FOCUS=222222 222222 Drop shadow colour for the highlighted option.
DIALOGUE_SHADOW_ALPHA_FOCUS=96 96 Drop shadow transparency for the highlighted option. Accepted range is 1-255.
DIALOGUE_SHADOW_X_OFFSET_FOCUS=2 2 Horizontal drop shadow offset for the highlighted option, in pixels.
DIALOGUE_SHADOW_Y_OFFSET_FOCUS=2 2 Vertical drop shadow offset for the highlighted option, in pixels.

Section [navigation]

Setting Description
ALIGNMENT=1 Regarding all navigation buttons in the footer. 0 = aligned to the left, 1 = central aligned, 2 = aligned to the right. Anything above is a secret.
SPACING=0 Amount of spacing, in pixels, between each navigation hint in the footer.
NAV_LR_GLYPH=F7E318 The device’s “L/R” shoulder button hint icon recolour.
NAV_LR_GLYPH_ALPHA=255 The device’s “L/R” hint icon transparency.
NAV_LR_GLYPH_RECOLOUR_ALPHA=255 The device’s “L/R” hint icon recolour transparency.
NAV_LR_TEXT=FFFFFF Text describing the function of “L/R” - recolour.
NAV_LR_TEXT_ALPHA=255 Text describing the function of “L/R” - transparency.
NAV_UD_GLYPH=F7E318 The device’s “Up/Down” hint icon recolour.
NAV_UD_GLYPH_ALPHA=255 The device’s “Up/Down” hint icon transparency.
NAV_UD_GLYPH_RECOLOUR_ALPHA=255 The device’s “Up/Down” hint icon recolour transparency.
NAV_UD_TEXT=FFFFFF Text describing the function of “Up/Down” - recolour.
NAV_UD_TEXT_ALPHA=255 Text describing the function of “Up/Down” - transparency.
NAV_A_GLYPH=000000 The device’s “A” button - icon recolour .
NAV_A_GLYPH_ALPHA=255 The device’s “A” button - icon transparency.
NAV_A_GLYPH_RECOLOUR_ALPHA=255 The device’s “A” button - icon recolour transparency.
NAV_A_TEXT=000000 Text describing the function of the “A” button - recolour .
NAV_A_TEXT_ALPHA=255 Text describing the function of the “A” button - transparency.
NAV_B_GLYPH=000000 The device’s “B” button - icon colour.
NAV_B_GLYPH_ALPHA=255 The device’s “B” button - icon transparency.
NAV_B_GLYPH_RECOLOUR_ALPHA=255 The device’s “B” button - icon recolour transparency.
NAV_B_TEXT=000000 Text describing the function of the “B” button - recolour .
NAV_B_TEXT_ALPHA=255 Text describing the function of the “B” button - transparency.
NAV_C_GLYPH=000000 The device’s “C” button - icon colour.
NAV_C_GLYPH_ALPHA=255 The device’s “C” button - icon transparency.
NAV_C_GLYPH_RECOLOUR_ALPHA=255 The device’s “C” button - icon recolour transparency.
NAV_C_TEXT=000000 Text describing the function of the “C” button - recolour .
NAV_C_TEXT_ALPHA=255 Text describing the function of the “C” button - transparency.
NAV_X_GLYPH=000000 The device’s “X” button - icon colour.
NAV_X_GLYPH_ALPHA=255 The device’s “X” button - icon transparency.
NAV_X_GLYPH_RECOLOUR_ALPHA=255 The device’s “X” button - icon recolour transparency.
NAV_X_TEXT=000000 Text describing the function of the “X” button - recolour .
NAV_X_TEXT_ALPHA=255 Text describing the function of the “X” button - transparency.
NAV_Y_GLYPH=000000 The device’s “Y” button - icon colour.
NAV_Y_GLYPH_ALPHA=255 The device’s “Y” button - icon transparency.
NAV_Y_GLYPH_RECOLOUR_ALPHA=255 The device’s “Y” button - icon recolour transparency.
NAV_Y_TEXT=000000 Text describing the function of the “Y” button - recolour .
NAV_Y_TEXT_ALPHA=255 Text describing the function of the “Y” button - transparency.
NAV_Z_GLYPH=000000 The device’s “Z” button - icon colour.
NAV_Z_GLYPH_ALPHA=255 The device’s “Z” button - icon transparency.
NAV_Z_GLYPH_RECOLOUR_ALPHA=255 The device’s “Z” button - icon recolour transparency.
NAV_Z_TEXT=000000 Text describing the function of the “Z” button - recolour .
NAV_Z_TEXT_ALPHA=255 Text describing the function of the “Z” button - transparency.
NAV_MENU_GLYPH=000000 The device’s “M/MENU” button - icon colour.
NAV_MENU_GLYPH_ALPHA=255 The device’s “M/MENU” button - icon transparency.
NAV_MENU_GLYPH_RECOLOUR_ALPHA=255 The device’s “M/MENU” button - icon recolour transparency.
NAV_MENU_TEXT=000000 Text describing the function of the “M” button - recolour .
NAV_MENU_TEXT_ALPHA=255 Text describing the function of the “M” button - transparency.

Section [grid]

Allows for displaying a grid of icons for the main menu or content explorer. Content Explorer will only be displayed for directories that only contain folders. You can disable grid view for a specific folder by adding an empty .nogrid text file to the root of the directory.

Setting Description
ALIGNMENT=0 Overall alignment of the grid within the screen.
ALIGNMENT_X_OFFSET=0 Horizontal offset applied on top of ALIGNMENT, in pixels.
ALIGNMENT_Y_OFFSET=0 Vertical offset applied on top of ALIGNMENT, in pixels.
CURRENT_ITEM_LABEL_ALIGNMENT=9 Label alignment:
1=Top Left
2=Top Middle
3=Top Right
4=Bottom Left
5=Bottom Middle
6=Bottom Right
7=Left Middle
8=Right Middle
9=Centre
CURRENT_ITEM_LABEL_WIDTH=600 Width of label. A value of 0 will size to content.
CURRENT_ITEM_LABEL_HEIGHT=0 Height of label. A value of 0 will size to content.
CURRENT_ITEM_LABEL_OFFSET_X=0 Horizontal offset based on CURRENT_ITEM_LABEL_ALIGNMENT.
CURRENT_ITEM_LABEL_OFFSET_Y=260 Vertical offset based on CURRENT_ITEM_LABEL_ALIGNMENT.
CURRENT_ITEM_LABEL_RADIUS=10 Add radius to label corners. 0 is a right angle. 10+ is very round.
CURRENT_ITEM_LABEL_BORDER_WIDTH=5 Border width in pixels.
CURRENT_ITEM_LABEL_BORDER=FFFFFF Label border colour.
CURRENT_ITEM_LABEL_BORDER_ALPHA=0 Label border transparency.
CURRENT_ITEM_LABEL_BACKGROUND=F7E318 Label background colour.
CURRENT_ITEM_LABEL_BACKGROUND_ALPHA=0 Label background transparency.
CURRENT_ITEM_LABEL_BACKGROUND_GRADIENT_COLOR=F7E318 Second colour in the label’s background gradient.
CURRENT_ITEM_LABEL_BACKGROUND_GRADIENT_START=255 Start point of the label’s gradient change.
CURRENT_ITEM_LABEL_BACKGROUND_GRADIENT_STOP=255 End point of the label’s gradient change.
CURRENT_ITEM_LABEL_BACKGROUND_GRADIENT_DIRECTION=0 Direction of the label’s gradient.
0 = None
1 = Vertical
2 = Horizontal
CURRENT_ITEM_LABEL_TEXT=100808 Label text colour.
CURRENT_ITEM_LABEL_TEXT_ALPHA=0 Label text transparency.
CURRENT_ITEM_LABEL_TEXT_ALIGNMENT=2 Text horizontal alignment:
1=Left
2=Centre
3=Right
CURRENT_ITEM_LABEL_TEXT_LINE_SPACING=0 Amount of spacing between lines of text. Negative values can be used.
CURRENT_ITEM_LABEL_LABEL_LONG_MODE=0 Long text mode for the label.
0 = Wrap long lines
1 = Show ellipsis when unselected, scroll when selected
CURRENT_ITEM_LABEL_TEXT_PADDING_BOTTOM=10 Amount of padding between bottom edge of label and text.
CURRENT_ITEM_LABEL_TEXT_PADDING_LEFT=10 Amount of padding between left edge of label and text.
CURRENT_ITEM_LABEL_TEXT_PADDING_RIGHT=10 Amount of padding between right edge of label and text.
CURRENT_ITEM_LABEL_TEXT_PADDING_TOP=10 Amount of padding between top edge of label and text.
CURRENT_ITEM_LABEL_SHADOW=000000 Label drop shadow colour.
CURRENT_ITEM_LABEL_SHADOW_WIDTH=0 Label drop shadow blur width in pixels.
CURRENT_ITEM_LABEL_SHADOW_X_OFFSET=10 Label drop shadow horizontal offset in pixels.
CURRENT_ITEM_LABEL_SHADOW_Y_OFFSET=10 Label drop shadow vertical offset in pixels.
NAVIGATION_TYPE=2 2: Left/right/up/down navigation. Left/Right navigation at beginning or end of row moves to previous or next row.
4: Same as 2 except that left/right wraps around on the active row.
BACKGROUND=000000 Grid main background colour.
BACKGROUND_ALPHA=0 Grid main background transparency.
LOCATION_X=0 Horizontal position of grid in pixels
LOCATION_Y=0 Vertical position of grid in pixels
COLUMN_COUNT=0 Number of columns
COLUMN_PADDING=0 Space, in pixels, between each column.
ROW_COUNT=0 Number of rows displayed on screen at one time
ROW_HEIGHT=0 Height in pixels of each row
ROW_PADDING=0 Space, in pixels, between each row.
COLUMN_WIDTH=0 Width in pixels of each column
CELL_COLUMN_ALIGN=1 Alignment of grid cell to column.
0 = Left
1 = Centre
2 = Right
CELL_ROW_ALIGN=1 Alignment of grid cell to row.
0 = Top
1 = Centre
2 = Bottom
CELL_WIDTH=200 Width of cell in pixels. Cell will be centred horizontally and vertically.
CELL_HEIGHT=200 Height of cell in pixels. Cell will be centred horizontally and vertically.
CELL_RADIUS=10 Add radius to cell corners. 0 is a right angle. 10+ is very round.
CELL_BORDER_WIDTH=5 Cell border width in pixels.
CELL_IMAGE_PADDING_TOP=5 Amount of padding between top edge of cell and cell image. Note: If text alpha is set to 0 image will be centred in the cell by default.
CELL_TEXT_PADDING_BOTTOM=5 Amount of padding between bottom edge of cell and text label.
CELL_TEXT_PADDING_SIDE=5 Amount of padding between edge of cell and text label.
CELL_TEXT_LINE_SPACING=0 Adjust spacing between lines for text labels that wrap text. Negative values can be used to bring lines closer together.
CELL_SHADOW=000000 Grid cell shadow colour
CELL_SHADOW_WIDTH=0 Width in pixels of the shadow
CELL_SHADOW_X_OFFSET=10 Horizontal offset in pixels of the shadow
CELL_SHADOW_Y_OFFSET=10 Vertical offset in pixels of the shadow
CELL_DEFAULT_BACKGROUND=000000 Unselected cell background colour.
CELL_DEFAULT_BACKGROUND_ALPHA=255 Unselected cell background transparency.
CELL_DEFAULT_BACKGROUND_GRADIENT_COLOR=000000 Second colour in the gradient.
CELL_DEFAULT_BACKGROUND_GRADIENT_START=0 Start point of gradient change. [CELL_DEFAULT_BACKGROUND] changes to [CELL_DEFAULT_BACKGROUND_GRADIENT_COLOR] colour.
CELL_DEFAULT_BACKGROUND_GRADIENT_STOP=255 End point of gradient change.
CELL_DEFAULT_BACKGROUND_GRADIENT_DIRECTION=0 Direction of gradient.
0 = None
1 = Vertical
2 = Horizontal
CELL_DEFAULT_BORDER=000000 Unselected cell border colour.
CELL_DEFAULT_BORDER_ALPHA=255 Unselected cell border transparency.
CELL_DEFAULT_IMAGE_ALPHA=255 Unselected cell image transparency.
CELL_DEFAULT_IMAGE_RECOLOUR=000000 Unselected cell image recolour.
CELL_DEFAULT_IMAGE_RECOLOUR_ALPHA=0 Unselected cell image recolour transparency.
CELL_DEFAULT_TEXT=000000 Unselected cell text colour.
CELL_DEFAULT_TEXT_ALPHA=255 Unselected cell text transparency.
CELL_FOCUS_BACKGROUND=000000 Selected cell background colour.
CELL_FOCUS_BACKGROUND_ALPHA=255 Selected cell background transparency.
CELL_FOCUS_BACKGROUND_GRADIENT_COLOR=000000 Second colour in the gradient.
CELL_FOCUS_BACKGROUND_GRADIENT_START=0 Start point of gradient change. [CELL_FOCUS_BACKGROUND] changes to [CELL_FOCUS_BACKGROUND_GRADIENT_COLOR] colour.
CELL_FOCUS_BACKGROUND_GRADIENT_STOP=255 End point of gradient change.
CELL_FOCUS_BACKGROUND_GRADIENT_DIRECTION=0 Direction of gradient.
0 = None
1 = Vertical
2 = Horizontal
CELL_FOCUS_BORDER=000000 Selected cell border colour.
CELL_FOCUS_BORDER_ALPHA=255 Selected cell border transparency.
CELL_FOCUS_IMAGE_ALPHA=255 Selected cell image transparency.
CELL_FOCUS_IMAGE_RECOLOUR=000000 Selected cell image recolour.
CELL_FOCUS_IMAGE_RECOLOUR_ALPHA=0 Selected cell image recolour transparency.
CELL_FOCUS_TEXT=000000 Selected cell text colour.
CELL_FOCUS_TEXT_ALPHA=255 Selected cell text transparency.

Section [list]

For all list item backgrounds, gradients can be applied. L-R = 0-255.

Setting Description
LIST_DEFAULT_RADIUS=0 Background window border radius. 0 = square, 5+ = round. This applies setting applies to LIST_DEFAULT_BACKGROUND & LIST_FOCUS_BACKGROUND
LIST_DEFAULT_BACKGROUND=ececec Unselected list item main background colour.
LIST_DEFAULT_BACKGROUND_ALPHA=0 Unselected list item main background transparency.
LIST_DEFAULT_GRADIENT_START=0 Start point of the change towards the second background colour.
LIST_DEFAULT_GRADIENT_STOP=0 End point of gradient change.
LIST_DEFAULT_GRADIENT_DIRECTION=0 Direction of gradient.
0 = None
1 = Vertical
2 = Horizontal
LIST_DEFAULT_BORDER_WIDTH=5 Unselected list item border width in pixels.
LIST_DEFAULT_BORDER_SIDE=4 Unselected list item border sides.
0 = None
1 = Bottom
2 = Top
4 = Left
8 = Right
Note: To do multiple sides add the values. For example to do top, bottom, left, and right you would add the 4 values together to get 15.
LIST_DEFAULT_INDICATOR=ececec Unselected list item indicator/border colour.
LIST_DEFAULT_INDICATOR_ALPHA=0 Unselected list item indicator/border transparency.
LIST_DEFAULT_TEXT=53422e Unselected list item text colour.
LIST_DEFAULT_TEXT_ALPHA=255 Unselected list item text transparency.
LIST_DEFAULT_GLYPH_PAD_LEFT=19 Adjusts the padding in pixels from the left side of the list item to the centre of the glyph.

LIST_DEFAULT_GLYPH_PAD_RIGHT=6 Adjusts the padding in pixels from the right side of the list item to the centre of the glyph.
LIST_DEFAULT_GLYPH_ALPHA=255 List item glyph transparency
LIST_DEFAULT_GLYPH_RECOLOUR=53422e Unselected list item glyph recolour.
LIST_DEFAULT_GLYPH_RECOLOUR_ALPHA=255 Transparency of this colour.
LIST_DEFAULT_LABEL_LONG_MODE=1 Long mode behaviour for label text.
0 = Wrap long lines
1 = Show an ellipsis when unselected and scroll text when selected.
LIST_DEFAULT_SHADOW_COLOUR=000000 Unselected list item drop shadow colour.
LIST_DEFAULT_SHADOW_ALPHA=255 Unselected list item drop shadow transparency. Accepted range is 1-255.
LIST_DEFAULT_SHADOW_X_OFFSET=2 Unselected list item drop shadow horizontal offset in pixels.
LIST_DEFAULT_SHADOW_Y_OFFSET=2 Unselected list item drop shadow vertical offset in pixels.
LIST_DISABLED_TEXT=a78b65 Unavailable list item text colour.
LIST_DISABLED_TEXT_ALPHA=255 Unavailable list item text transparency.
LIST_FOCUS_BACKGROUND=000000 Selected list item main background colour.
LIST_FOCUS_BACKGROUND_ALPHA=0 Selected list item main background transparency.
LIST_FOCUS_GRADIENT_START=0 Start point of the change towards the second background colour.
LIST_FOCUS_GRADIENT_STOP=0 End point of gradient change.
LIST_FOCUS_GRADIENT_DIRECTION=0 Direction of gradient.
0 = None
1 = Vertical
2 = Horizontal
LIST_FOCUS_BORDER_WIDTH=5 Selected list item border width in pixels.
LIST_FOCUS_BORDER_SIDE=4 Selected list item border sides.
0 = None
1 = Bottom
2 = Top
4 = Left
8 = Right
Note: To do multiple sides add the values. For example to do top, bottom, left, and right you would add the 4 values together to get 15.
LIST_FOCUS_INDICATOR=5d0014 Selected list item indicator/border colour.
LIST_FOCUS_INDICATOR_ALPHA=255 Selected list item indicator/border transparency.
LIST_FOCUS_TEXT=5d0014 Selected list item text colour.
LIST_FOCUS_TEXT_ALPHA=255 Selected list item text transparency.
LIST_FOCUS_GLYPH_ALPHA=255 Selected List item glyph transparency.
LIST_FOCUS_GLYPH_RECOLOUR=5d0014 Selected list item glyph recolour.
LIST_FOCUS_GLYPH_RECOLOUR_ALPHA=255 Transparency of this colour.
LIST_FOCUS_SHADOW_COLOUR=222222 Selected list item drop shadow colour.
LIST_FOCUS_SHADOW_ALPHA=96 Selected list item drop shadow transparency. Accepted range is 1-255.
LIST_FOCUS_SHADOW_X_OFFSET=2 Selected list item drop shadow horizontal offset in pixels.
LIST_FOCUS_SHADOW_Y_OFFSET=2 Selected list item drop shadow vertical offset in pixels.

Section [image_list]

Alters properties of list images.

Setting Description
IMAGE_LIST_ALPHA=255 Image transparency
IMAGE_LIST_RADIUS=3 Image window radius. 0 = no change. 10+ = heavily rounded window.
IMAGE_LIST_RECOLOUR=ad0000 Image recolour.
IMAGE_LIST_RECOLOUR_ALPHA=0 Transparency of this colour.
IMAGE_LIST_PAD_TOP=0 Number of pixels of space to add to top side of the image.
IMAGE_LIST_PAD_BOTTOM=0 Number of pixels of space to add to bottom side of the image.
IMAGE_LIST_PAD_LEFT=0 Number of pixels of space to add to left side of the image.
IMAGE_LIST_PAD_RIGHT=0 Number of pixels of space to add to right side of the image.
IMAGE_PREVIEW_ALPHA=255 Preview image transparency
IMAGE_PREVIEW_RADIUS=3 Image window radius. 0 = no change. 10+ = heavily rounded window.
IMAGE_PREVIEW_RECOLOUR=ad0000 Image recolour.
IMAGE_PREVIEW_RECOLOUR_ALPHA=0 Transparency of this colour.

Section [charging]

When placed on charge without booting, the charging screen will appear.

Setting Description
CHARGER_BACKGROUND=100808 Charging banner background colour.
CHARGER_BACKGROUND_ALPHA=0 Charging banner background transparency.
CHARGER_TEXT=000000 Charging banner text colour.
CHARGER_TEXT_ALPHA=255 Charging banner text transparency.
CHARGER_Y_POS=100 Position of the banner from the centre. -100 is up, 100 is down.

Section [verbose]

Covers the verbose boot log overlay shown when Verbose Messages is enabled in Advanced settings.

Setting Description
VERBOSE_BOOT_BACKGROUND=000000 Background colour of verbose boot messages.
VERBOSE_BOOT_BACKGROUND_ALPHA=255 Background colour transparency.
VERBOSE_BOOT_TEXT=FFFFFF Text colour of verbose boot messages.
VERBOSE_BOOT_TEXT_ALPHA=255 Text colour transparency.
VERBOSE_BOOT_Y_POS=165 Vertical position of verbose boot messages in pixels.

Section [keyboard]

Setting Description
OSK_BACKGROUND=5d0014 On-screen keyboard background window colour.
OSK_BACKGROUND_ALPHA=255 On-screen keyboard background window transparency.
OSK_BORDER=ffe5b9 On-screen keyboard background window border colour.
OSK_BORDER_ALPHA=255 On-screen keyboard background window border transparency.
OSK_RADIUS=10 Background window border radius. 0 = square, 5+ = round.
OSK_TEXT=ffe5b9 Unselected and inputted text colour.
OSK_TEXT_ALPHA=255 Unselected and inputted text transparency.
OSK_TEXT_FOCUS=ffe5b9 Selected text colour.
OSK_TEXT_FOCUS_ALPHA=255 Selected text transparency.
OSK_ITEM_BACKGROUND=000000 Unselected text background / button colour.
OSK_ITEM_BACKGROUND_ALPHA=50 Unselected text background / button transparency.
OSK_ITEM_BACKGROUND_FOCUS=000000 Selected text background / button colour.
OSK_ITEM_BACKGROUND_FOCUS_ALPHA=150 Selected text background / button transparency.
OSK_ITEM_BORDER=c0c0c0 Unselected text button border colour.
OSK_ITEM_BORDER_ALPHA=0 Unselected text button border transparency.
OSK_ITEM_BORDER_FOCUS=ffe5b9 Selected text button border colour.
OSK_ITEM_BORDER_FOCUS_ALPHA=255 Selected text button border transparency.
OSK_ITEM_RADIUS=5 All button border radius. 0 = square, 5+ = round.
OSK_ITEM_SHADOW_COLOUR=000000 Unselected key drop shadow colour.
OSK_ITEM_SHADOW_ALPHA=255 Unselected key drop shadow transparency. Accepted range is 1-255.
OSK_ITEM_SHADOW_X_OFFSET=2 Unselected key drop shadow horizontal offset in pixels.
OSK_ITEM_SHADOW_Y_OFFSET=2 Unselected key drop shadow vertical offset in pixels.
OSK_ITEM_SHADOW_COLOUR_FOCUS=222222 Selected key drop shadow colour.
OSK_ITEM_SHADOW_ALPHA_FOCUS=96 Selected key drop shadow transparency. Accepted range is 1-255.
OSK_ITEM_SHADOW_X_OFFSET_FOCUS=2 Selected key drop shadow horizontal offset in pixels.
OSK_ITEM_SHADOW_Y_OFFSET_FOCUS=2 Selected key drop shadow vertical offset in pixels.

Section [notification]

Setting Description
MSG_BACKGROUND=5d0014 Pop-up message background colour.
MSG_BACKGROUND_ALPHA=255 Pop-up message background transparency.
MSG_BORDER=ffe5b9 Pop-up message window border colour.
MSG_BORDER_ALPHA=255 Pop-up message window border transparency.
MSG_RADIUS=10 Pop-up message window border roundness. 0 = square, 5+ = round.
MSG_TEXT=ffe5b9 Pop-up message text colour.
MSG_TEXT_ALPHA=255 Pop-up message text transparency.
MSG_LEVEL_SUCCESS=4D9E4D Success message accent colour.
MSG_LEVEL_WARNING=D9A33A Warning message accent colour.
MSG_LEVEL_ERROR=C24B4B Error message accent colour.

Section [bar]

This is the horizontal bar showing volume/brightness.

Setting Description
BAR_WIDTH=615 Background of the bar window - width.
BAR_HEIGHT=5d0014 Background of the bar window - height.
BAR_BACKGROUND=5d0014 Background of the bar window - colour.
BAR_BACKGROUND_ALPHA=255 Background of the bar window - transparency.
BAR_BORDER=ffe5b9 Bar window border colour.
BAR_BORDER_ALPHA=255 Bar window border transparency.
BAR_RADIUS=10 Bar window border roundness. 0 = square, 5+ = round.
BAR_PROGRESS_WIDTH=550 Inactive section of the progress bar - width.
BAR_PROGRESS_HEIGHT=16 Inactive section of the progress bar - height.
BAR_PROGRESS_BACKGROUND=000000 Inactive section of the progress bar - colour.
BAR_PROGRESS_BACKGROUND_ALPHA=255 Inactive section of the progress bar - transparency.
BAR_PROGRESS_ACTIVE_BACKGROUND=ffe5b9 Active section of the progress bar - colour.
BAR_PROGRESS_ACTIVE_BACKGROUND_ALPHA=255 Active section of the progress bar - transparency.
BAR_PROGRESS_RADIUS=3 Progress bar roundness. 0 = square, 5+ = round.
BAR_ICON=ffe5b9 Bar icon/glyph colour. Volume/brightness symbol.
BAR_ICON_ALPHA=255 Bar icon transparency. Volume/brightness symbol.
BAR_Y_POS=384 Vertical position of the bar from the top.

Section [roll]

This relates to the passcode/lock screen when enabled in settings.

Setting Description
ROLL_TEXT=53422e Unselected passcode text colour.
ROLL_TEXT_ALPHA=255 Unselected passcode text transparency.
ROLL_BACKGROUND=fbfbfb Unselected passcode background / button colour.
ROLL_BACKGROUND_ALPHA=255 Unselected passcode background / button transparency.
ROLL_RADIUS=10 Unselected passcode button border radius.
ROLL_SELECT_TEXT=000000 Selected passcode text colour.
ROLL_SELECT_TEXT_ALPHA=255 Selected passcode text transparency.
ROLL_SELECT_BACKGROUND=000000 Selected passcode background / button colour.
ROLL_SELECT_BACKGROUND_ALPHA=50 Selected passcode background / button transparency.
ROLL_SELECT_RADIUS=10 Selected passcode button border radius.
ROLL_BORDER_COLOUR=53422e Window border colour.
ROLL_BORDER_ALPHA=255 Window border transparency.
ROLL_BORDER_RADIUS=10 Window border roundness. 0 = square, 5+ = round.

Section [counter]

Setting Description
COUNTER_ALIGNMENT=2 0 = aligned to the left, 1 = central aligned, 2 = aligned to the right.
COUNTER_PADDING_AROUND=10 Number of pixels around the text of the counter.
COUNTER_PADDING_SIDE=5 Number of pixels to move the counter from the side of the screen. Only used with left and right alignments
COUNTER_PADDING_TOP=50 Number of pixels from screen top to place the counter.
COUNTER_BORDER_COLOUR=c69200 Border colour.
COUNTER_BORDER_ALPHA=255 Border transparency.
COUNTER_BORDER_WIDTH=2 Border width in pixels.
COUNTER_RADIUS=3 Border roundness. 0 is a right angle. 10+ is very round.
COUNTER_BACKGROUND=100808 Counter area/background colour.
COUNTER_BACKGROUND_ALPHA=255 Counter area/background transparency.
COUNTER_TEXT=ffffff Counter text colour.
COUNTER_TEXT_ALPHA=255 Counter text transparency.
COUNTER_TEXT_FADE_TIME=50 Used to gradually fade out the counter when screen activity is idle. A value of 0 will disable the setting.
COUNTER_TEXT_SEPARATOR= of Separator in between the current item index and the number of items in the list. Default value “ of “ which would display as “1 of 50”.

Section [glyph]

Overrides the pixel render size of glyphs in each area of the screen, as a theme-level default. A user can still override any of these per area from their own device in Customisation > Theme Options, which always takes priority over what the theme sets here.

Setting Default Description
LIST=0 0 (auto) Glyph size, in pixels, for list view items. 0 sizes to the item.
FOOTER=0 0 (auto) Glyph size, in pixels, for footer button hints.
HEADER=0 0 (auto) Glyph size, in pixels, for header status icons.
GRID=0 0 (auto) Glyph size, in pixels, for grid mode cells.

Section [terminal]

Covers the built-in terminal application’s appearance.

Setting Default Description
FONT_SIZE=16 16 Point size of the terminal’s font.
FOREGROUND=FFFFFF FFFFFF Font colour of terminal window
BACKGROUND=000000 000000 Background colour of terminal window

Section [sdl]

Low level rendering pipeline settings. Most themes never need this section, which is documented for completeness and for advanced or experimental use.

Setting Default Description
TEXTURE_BLEND_MODE=1 1 SDL texture blend mode used when compositing the frame.
DRAW_BLEND_MODE=0 0 SDL draw blend mode used for primitive drawing operations.
RENDER_OFFSET_X=0.0 0.0 Sub-pixel horizontal render offset, as a floating point value.
RENDER_OFFSET_Y=0.0 0.0 Sub-pixel vertical render offset, as a floating point value.
SOLID_R=0 0 Red channel (0-255) used when the renderer needs a solid fill colour outside of themed elements.
SOLID_G=0 0 Green channel (0-255), see SOLID_R.
SOLID_B=0 0 Blue channel (0-255), see SOLID_R.

Section [misc]

Setting Description
RANDOM_BACKGROUND=0 If set to 1 randomly select background image based on PNG sequence. Uses the naming convention {programname}.{Index}.png for example to have the background for muxlaunch randomly selected you would name the images: muxlaunch.0.png, muxlaunch.1.png, muxlaunch.2.png…
ANIMATED_BACKGROUND=0 If set to 1, treat the background image as an animated source rather than a single static frame. Requires a compatible sequence in place of a plain background image.
CONTENT_SIZE_TO_CONTENT=0 Resizes list items to fit text of item. If enabled CONTENT_WIDTH will be used as a max width.
CONTENT_ALIGNMENT=0 Alignment of list items. 0 = Left, 1 = Centre, 2 = Right. CONTENT_PADDING_LEFT adjusts the position; negative values shift left and positive values shift right.
CONTENT_ITEM_COUNT=13 Number of list items displayed in content panel. This setting along with CONTENT_HEIGHT to determine the height of each item. For example if CONTENT_HEIGHT = 300 and CONTENT_ITEM_COUNT = 10 then each item will be 30px tall. The first 28px will be used to display the item followed by a 2px gap.
CONTENT_ITEM_HEIGHT=0 Sets a static height for each list item. If used number of items will be calculated based CONTENT_HEIGHT size. Note: Should only be used if not using CONTENT_ITEM_COUNT
CONTENT_PADDING_LEFT=0 Number of pixels from screen left to list items. Commonly on 0.
CONTENT_PADDING_TOP=0 Number of pixels from screen top to list items.
Note: By default the list is positioned based on header height + 2px. With a default header height of 42px the list will start 44px from the top in order for it to be past the header. If you want the content list to take up the full screen you can use a value of -44 here. If your header height is larger you would need to adjust accordingly.
CONTENT_HEIGHT=392 Adjust the height of the content panel by pixels. (Minimum value = 100 Maximum value = Device Screen Height)
CONTENT_WIDTH=640 Adjust the width of list item content by horizontal pixels. If left unset, and the frontend’s own “Use Full Content Width” option is enabled, this instead defaults to the full device screen width.
NAVIGATION_TYPE=0 0: For vertical (up/down) navigation.
1: For horizontal (left/right).
2: For launch menu with two rows of 4 icons. (left/right/up/down)
3: For launch menu with two rows of icons. Top row has 3 icons and bottom row has 5 icons. (left/right/up/down)
4: Same as 2 except that left/right wraps around on the active row.
5: Same as 3 except that left/right wraps around on the active row.
STATIC_ALIGNMENT=0 Controls layering and position of static images with other elements. See below for details.
IMAGE_OVERLAY=0 Do you want to use an overlay .png image? 0 is no. 1 is yes.
ANTIALIASING=1 Apply antialiasing to fonts.
0 = Disabled
1 = Enabled
LABEL_WIDTH=57 Maximum width, as a percentage, allowed for the left-hand option label in a settings list before it truncates or scrolls.
PEEK_OPACITY=48 Opacity used for neighbouring content peeking into the current view.

Static Alignment Values

  • Describes the layering and position of static images with other elements.
  • Place static images in image/static and name them consistently with wall images.
  • You can use default.png as a static fallback image.
  • You can use static images for individual list items and programs.
Value Description
0 Bottom Right (Just above the footer)
1 Middle Right
2 Top Right (Just below the header)
3 Fullscreen - behind header and footer
4 Fullscreen - above header and footer