From b5abbdc696003c91653942ad486b9badc9ac97ef Mon Sep 17 00:00:00 2001
From: Rasmus Karlsson <rasmus.karlsson@pajlada.com>
Date: Mon, 6 Jul 2026 16:47:30 +0200
Subject: [PATCH] docs(man): add load

---
 .github/wiki/mapping.json |   1 +
 man/waybar-load.5.scd     | 134 ++++++++++++++++++++++++++++++++++++++
 man/waybar.5.scd.in       |   1 +
 3 files changed, 136 insertions(+)
 create mode 100644 man/waybar-load.5.scd

diff --git a/.github/wiki/mapping.json b/.github/wiki/mapping.json
index 1bee1bc3..d17338ed 100644
--- a/.github/wiki/mapping.json
+++ b/.github/wiki/mapping.json
@@ -21,6 +21,7 @@
   "Module:-JACK": ["waybar-jack"],
   "Module:-Keyboard-State": ["waybar-keyboard-state"],
   "Module:-Language": ["waybar-sway-language", "waybar-hyprland-language", "waybar-niri-language", "waybar-mango-language"],
+  "Module:-Load": ["waybar-load"],
   "Module:-Mango": ["waybar-mango-window", "waybar-mango-workspaces", "waybar-mango-keymode", "waybar-mango-layout"],
   "Module:-Memory": ["waybar-memory"],
   "Module:-Menu": ["waybar-menu"],
diff --git a/man/waybar-load.5.scd b/man/waybar-load.5.scd
new file mode 100644
index 00000000..3a3ce5b9
--- /dev/null
+++ b/man/waybar-load.5.scd
@@ -0,0 +1,134 @@
+waybar-load(5)
+
+# NAME
+
+waybar - load module
+
+# DESCRIPTION
+
+The *load* module displays the current CPU load.
+
+# CONFIGURATION
+
+Addressed by *load*
+
+*interval*: ++
+	typeof: integer++
+	default: 10 ++
+	The interval in which the information gets polled.
+
+*format*: ++
+	typeof: string ++
+	default: {load1} ++
+	The format, how information should be displayed.
+
+*rotate*: ++
+	typeof: integer ++
+	Positive value to rotate the text label (in 90 degree increments).
+
+*states*: ++
+	typeof: object ++
+	A number of load states which get activated on certain thresholds, based on `load1`. See *waybar-states(5)*.
+
+*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.
+
+*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 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.
+
+*tooltip-format*: ++
+	typeof: string ++
+	default: Load 1: {load1}\\nLoad 5: {load5}\\nLoad 15: {load15} ++
+	The format of the tooltip shown on hover. Supports the same replacements as *format*.
+
+*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
+
+*{}*: Equivalent to `{load1}`
+
+*{load1}*: Current CPU load average over the last minute
+
+*{load5}*: Current CPU load average over the last 5 minutes
+
+*{load15}*: Current CPU load average over the last 15 minutes
+
+# EXAMPLES
+
+```
+"load": {
+    "interval": 10,
+    "format": "load: {load1}",
+    "max-length": 10
+}
+```
+
+```
+"load": {
+    "interval": 1,
+    "format": "load: {load1} {load5} {load15}"
+}
+```
+
+# STYLE
+
+- *#load*
diff --git a/man/waybar.5.scd.in b/man/waybar.5.scd.in
index 78dc433e..ff2af1bc 100644
--- a/man/waybar.5.scd.in
+++ b/man/waybar.5.scd.in
@@ -474,6 +474,7 @@ To hide the power group if it is empty, apply to #power and all its children:
 - *waybar-inhibitor(5)*
 - *waybar-jack(5)*
 - *waybar-keyboard-state(5)*
+- *waybar-load(5)*
 - *waybar-memory(5)*
 - *waybar-mpd(5)*
 - *waybar-mpris(5)*