waybar-cpu(5)

✨ waybar-cpu(5) ✨

okay bestie, so this is the manual page for the cpu module in waybar, and it's lowkey one of the cutest things you can put in your bar. it lives in the File Formats Manual section, and honestly? it's giving main character energy for a sysmon widget. let's get into it 💅

---

🌸 NAME 🌸

waybar-cpu — literally the cpu module, that's it, that's the name 🫶

---

🦋 DESCRIPTION 🦋

The cpu module displays the current CPU utilization.

periodt. that's the whole job. it watches your cores sweat and tells you about it 🧚

---

💖 CONFIGURATION 💖

every single knob you can turn, coming right up. no skips, no shortcuts, we're listing all of them:

• interval — typeof: integer or float, default: 10. The interval in which the information gets polled. Minimum value is 0.001 (1ms). Values smaller than 1ms will be set to 1ms. so like, don't try to be cute and go below 1ms, it'll just gently drag you back up 🙈
• format — typeof: string, default: {usage}%. The format, how information should be displayed. On {} data gets inserted. (that {} is the empty-but-not-really spot where the data slides in 💫)
• format-icons — typeof: array/object. Based on the current usage, the corresponding icon gets selected. The order is low to high. Or by the state if it is an object. so low usage → first icon, spicy usage → last icon, iconic ✨
• max-length — typeof: integer. The maximum length in character 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. (she's flexible like that 💅)
• justify — typeof: string. The alignment of the text within the module's label, allowing options 'left', 'right', or 'center' to define the positioning.
• rotate — typeof: integer. Positive value to rotate the text label (in 90 degree increments). tilt her head, queen 👑
• states — typeof: object. A number of CPU usage states which get activated on certain usage levels. See waybar-states(5).
• on-click — typeof: string. Command to execute when clicked 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. (set it to false if the little popup is not your vibe)
• expand — typeof: bool, default: false. Enables this module to consume all left over space dynamically. greedy girlie behavior, we respect it 🔥

---

🌈 FORMAT REPLACEMENTS 🌈

these are the lil spells you drop into format to make the module say things. copy them exactly, they're picky about spelling 🎀

• {load}: Current CPU load.
• {usage}: Current overall CPU usage.
• {usage{n}}: Current CPU core n usage. Cores are numbered from zero, so first core will be {usage0} and 4th will be {usage3}.
• {avg_frequency}: Current CPU average frequency (based on all cores) in GHz.
• {max_frequency}: Current CPU max frequency (based on the core with the highest frequency) in GHz.
• {min_frequency}: Current CPU min frequency (based on the core with the lowest frequency) in GHz.
• {icon}: Icon for overall CPU usage.
• {icon{n}}: Icon for CPU core n usage. Use like {icon0}.

---

💜 EXAMPLES 💜

Basic configuration:

"cpu": {
     "interval": 10,
     "format": "{}% ",
     "max-length": 10
}

CPU usage per core rendered as icons:

"cpu": {
     "interval": 1,
     "format": "{icon0}{icon1}{icon2}{icon3} {usage:>2}% ",
     "format-icons": ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"],
},

(yes, that trailing comma in the second one is in the original, so it stays fr fr 😌)

---

💅 STYLE 💅

• #cpu

that's your CSS hook, bestie. go make her pretty 🌸

---

okay and that's the whole page!! 🫶 this was waybar-cpu(5) from the File Formats Manual, and the page itself is dated 2026-02-08. slay, obsessed, go forth and monitor your cores responsibly 💖✨🎀🦋