Theme

Theme file

Launch retherm with the path to your custom theme.

retherm --theme ./your_theme.toml

All theme options have a default; you only need to include options you would like to override in your theme file.

The screen size is 320x320 pixels, with the origin in the top left.

Fonts

Font can be specified in the format "<name>:<size>" where name is one of the following:

  • Icon: FontAwesome 7.1.0
  • Regular: Roboto Regular
  • Bold: Roboto Bold

Main screen

Customize the look and feel of the main thermostat screen.

[main_screen]
fg_color = "#00ff00"

fg_colour

Colour of text on main screen, default "#ffffff"

bg_colour

Background colour, default "#000000"

bg_heat_colour

Background colour when heating is turned on, default "#F17E3B"

bg_cool_colour

Background colour when cooling is turned on, default "#3B72F1"

away_icon_center

Position of away icon, default [160, 230]

away_icon

Away icon styling, default { icon_font: "Icon:42", icon: "\u{e50b}", colour: "#696969" }

Main screen gauge

[main_screen.gauge]
fg_colour = "#00ff00"

fg_colour

Colour of text, default "#ffffff"

arc_dia

Diameter of guage arch, default 260

arc_width

Width of arc, default 20

arc_start_deg

Arc start angle; 0 degrees at 3'oclock, default 120

arc_sweed_deg

Sweep angle of arc, default 300

target_font

Target temp decimal digit font, default "Bold:100"

target_decimal_font

Target temp fraction digit font, default "Bold:40"

current_font

Current temp font, default "Regular:20"

arc_bg_colour

Background fill colour of arc, default "#696969"

arc_heat_colour

Arc background for heating, default "#E65D10"

arc_heat_dot_colour

Target heat temp dot colour, default "#C4500E"

arc_cool_colour

Arc background for cooling, default "#1050E6"

arc_cool_dot_colour

Target cool temp dot colour, default "#0E44C4""

arc_target_dot_dia

Diameter of target temp dot, default 30

arc_temp_dot_dia

Current temp dot diameter, default 12

arc_temp_dot_colour

Current temp dot colour, default "#C0C0C0"

arc_temp_text_dia

Diameter of arc current temp label position, default 220

Mode select screen

Customize the look and feel of the mode select screen.

[mode_select]
bg_color = "#000000"

bg_colour

Background colour, default "#000000"

icon_heat_colour

Heat mode icon colour, default "#E65D10"

icon_cool_colour

Cool mode icon colour, default "#1050E6"

icon_center

Position of mode icon, default [160, 25]

mode_icon

Mode icon styling, default { icon_font: "Icon:42", icon: "\u{f72e}", colour: "#696969" }

Mode select list style

colour

Colour of list item text, default "#d3d3d3"

label_font

List item font, default "Bold:36"

icon_font

Selected item icon font, default "Icon:20"

selected_icon

Selected item icon, default "\u{f00c}"

highlight_text_colour

Highlighted row text colour, default "#ffffff"

highlight_rect

Style of the highlight row, default { fill_colour: "#", corner_radius: 18 }

row_size

List item row size, default [140, 40]