yambar-modules-cpu(5) File Formats Manual yambar-modules-cpu(5)

# [NAME](#NAME)

cpu - This module provides the CPU usage

# [DESCRIPTION](#DESCRIPTION)

This module reports CPU usage, in percent. The *content* particle is a template that is instantiated once for each core, and once for the total CPU usage.

# [TAGS](#TAGS)

**Name** **Type** **Description** id int Core ID. 0..n represents individual cores, and -1 represents the total usage cpu range Current usage of CPU core {id}, in percent

# [CONFIGURATION](#CONFIGURATION)

**Name** **Type** **Req** **Description** poll-interval int no Refresh interval of the CPU usage stats in milliseconds (default=500). Cannot be less then 250ms.

# [EXAMPLES](#EXAMPLES)

## [Display total CPU usage as a number](#Display_total_CPU_usage_as_a_number)

```
bar:


  left:


    - cpu:


        poll-interval: 2500


        content:


          map:


            conditions:


              id < 0:


                - string: {text: , font: Font Awesome 6 Free:style=solid}


                - string: {text: "{cpu}%"}
```

## [Display a vertical bar for each core](#Display_a_vertical_bar_for_each_core)

```
bar:


  left:


    - cpu:


        poll-interval: 2500


        content:


          map:


            conditions:


              id >= 0:


                - ramp:


                    tag: cpu


                    items:


                      - string: {text: ▁}


                      - string: {text: ▂}


                      - string: {text: ▃}


                      - string: {text: ▄}


                      - string: {text: ▅}


                      - string: {text: ▆}


                      - string: {text: ▇}


                      - string: {text: █}
```

# [SEE ALSO](#SEE_ALSO)

[**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5), [**yambar-particles**(5)](/man/enterprise-packages/yambar/yambar-particles.5), [**yambar-tags**(5)](/man/enterprise-packages/yambar/yambar-tags.5), [**yambar-decorations**(5)](/man/enterprise-packages/yambar/yambar-decorations.5)

2026-09-18

---

Document: yambar-modules-cpu(5) from yambar 1.11.0-r3 (Chainguard OS)
Source: https://codeberg.org/dnkl/yambar