waybar-temperature(5)

okay bestie, sit down, hydrate, and let me tell you about waybar-temperature(5) — it's a whole module from the File Formats Manual and it's genuinely so useful. let's get into it 💅

---

🎀 NAME 🎀

waybar — the temperature module. that's it, that's the girl. 🌡️✨

---

🌈 DESCRIPTION 🌈

the temperature module displays the current temperature from a thermal zone. she reads your machine's temp and puts it on your bar. lowkey essential, no cap. 🔥

---

💖 CONFIGURATION 💖

you reach this module by the name temperature. here's every knob she has:

• thermal-zone — typeof: integer. the thermal zone, as in /sys/class/thermal/. that's the directory she pulls from. 🌡️
• hwmon-path — typeof: string. the temperature path you wanna use, e.g. /sys/class/hwmon/hwmon2/temp1_input, instead of one of the ones sitting in /sys/class/thermal/.
  • this can also be an array of strings. in that case, waybar checks each item in the array and uses the first valid one. obsessed, honestly — it's perfect if you wanna share the same configuration file between different machines that have different hardware configurations. 🖥️💞
• hwmon-path-abs — typeof: string. the path of the hwmon-directory of the device, e.g. /sys/devices/pci0000:00/0000:00:18.3/hwmon. (note that the subdirectory hwmon/hwmon#, where # is a number, is not part of the path!) this one has to be used together with input-filename, they're a package deal bestie 🫶
  • this can also be an array of strings, and for that, it just works like hwmon-path.
• input-filename — typeof: string. the temperature filename of your hwmon-path-abs, e.g. temp1_input.
• warning-threshold — typeof: integer. the threshold before it is considered warning (Celsius).
• critical-threshold — typeof: integer. the threshold before it is considered critical (Celsius).
• interval — typeof: integer or float, default: 10. the interval in which the information gets polled.
• format-warning — typeof: string. the format to use when temperature is considered warning.
• format-critical — typeof: string. the format to use when temperature is considered critical.
• format — typeof: string, default: {temperatureC}°C. the format (Celsius/Fahrenheit/Kelvin) in which the temperature should be displayed.
• format-icons — typeof: array. based on the current temperature (Celsius) and critical-threshold if available, the corresponding icon gets selected. the order is low to high. ⬆️
• tooltip-format — typeof: string, default: {temperatureC}°C. the format for the tooltip.
• rotate — typeof: integer. positive value to rotate the text label (in 90 degree increments). spin her around 🌀
• max-length — typeof: integer. the maximum length in characters the module should display.
• min-length — typeof: integer. the minimum length in characters the module should accept.
• align — typeof: float. the alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. if the module is rotated, it will follow the flow of the text.
• justify — typeof: string. the alignment of the text within the module's label, allowing options 'left', 'right', or 'center' to define the positioning.
• on-click — typeof: string. command to execute when you click on the module.
• on-click-middle — typeof: string. command to execute when middle-clicked on the module using mousewheel.
• on-click-right — typeof: string. command to execute when you right-click on the module.
• on-update — typeof: string. command to execute when the module is updated.
• on-scroll-up — typeof: string. command to execute when scrolling up on the module.
• on-scroll-down — typeof: string. command to execute when scrolling down on the module.
• smooth-scrolling-threshold — typeof: double. threshold to be used when scrolling.
• tooltip — typeof: bool, default: true. option to disable tooltip on hover.
• menu — typeof: string. action that popups the menu.
• menu-file — typeof: string. location of the menu descriptor file. there need to be an element of type GtkMenu with id menu.
• menu-actions — typeof: array. the actions corresponding to the buttons of the menu.
• expand — typeof: bool, default: false. enables this module to consume all left over space dynamically.

---

🔥 FORMAT REPLACEMENTS 🔥

these are the lil tokens you drop into your formats, bestie:

• {temperatureC}: temperature in Celsius.
• {temperatureF}: temperature in Fahrenheit.
• {temperatureK}: temperature in Kelvin.

---

✨ EXAMPLES ✨

here's the vibe, copy-paste ready, character for character:

    "temperature": {
        // "thermal-zone": 2,
        // "hwmon-path": ["/sys/class/hwmon/hwmon2/temp1_input", "/sys/class/thermal/thermal_zone0/temp"],
        // "critical-threshold": 80,
        // "format-critical": "{temperatureC}°C ",
        "format": "{temperatureC}°C "
   }

---

👑 STYLE 👑

these are the CSS selectors she answers to, periodt:

• #temperature
• #temperature.warning
• #temperature.critical

---

and that's the whole page, my love 🦋 go forth and keep an eye on your temps, she can't hurt you if you're watching her. this one came from the File Formats Manual, dated 2026-02-08 — waybar-temperature(5), mwah, iconic, no notes 💜✨