Expand description

The system temperature

This block displays the system temperature, based on libsensors library.

This block has two modes: “collapsed”, which uses only color as an indicator, and “expanded”, which shows the content of a format string. The average, minimum, and maximum temperatures are computed using all sensors displayed by sensors, or optionally filtered by chip and inputs.

Requires libsensors and appropriate kernel modules for your hardware.

Run sensors command to list available chips and inputs.

Note that the colour of the block is always determined by the maximum temperature across all sensors, not the average. You may need to keep this in mind if you have a misbehaving sensor.

§Configuration

KeyValuesDefault
formatA string to customise the output of this block. See below for available placeholders" $icon $average avg, $max max "
format_altIf set, block will switch between format and format_alt on every clickNone
intervalUpdate interval in seconds5
scaleEither "celsius" or "fahrenheit""celsius"
goodMaximum temperature to set state to good20 °C (68 °F)
idleMaximum temperature to set state to idle45 °C (113 °F)
infoMaximum temperature to set state to info60 °C (140 °F)
warningMaximum temperature to set state to warning. Beyond this temperature, state is set to critical80 °C (176 °F)
chipNarrows the results to a given chip name. * may be used as a wildcard.None
inputsNarrows the results to individual inputs reported by each chip.None
ActionDescriptionDefault button
toggle_formatToggles between format and format_altLeft
PlaceholderValueTypeUnit
minMinimum temperature among all inputsNumberDegrees
averageAverage temperature among all inputsNumberDegrees
maxMaximum temperature among all inputsNumberDegrees

Note that when block is collapsed, no placeholders are provided.

§Example

[[block]]
block = "temperature"
format = " $icon $max max "
format_alt = " $icon $min min, $max max, $average avg "
interval = 10
chip = "*-isa-*"

§Icons Used

  • thermometer

Structs§

Enums§

Functions§