waybar-memory(5)

📦
version 0.15.0 · 13 versions
, in ubuntu resolute, ubuntu stonking

✨ waybar-memory(5) ✨

okay bestie, this is the memory module for waybar, and it lives in the File Formats Manual section of the docs. yes it's a man page. no it's not boring. let's go 🫶

💖 NAME 💖

waybar — the memory module, babe. that's it, that's the name.

🌸 DESCRIPTION 🌸

The memory module displays the current memory utilization. literally just vibes — how much of your RAM is currently in use. slay. 👑

✨ CONFIGURATION ✨

You address this module by memory. put that in your config, bestie, or nothing happens.

  • interval — typeof: integer, default: 30. The interval in which the information gets polled. so like… how often it checks in on your memory. every 30 seconds by default. patient queen. ⏰
  • format — typeof: string, default: {percentage}%. The format, how information should be displayed. this is where you decide what the label actually says. 🎀
  • format-icons — typeof: array/object. Based on the current percentage, the corresponding icon gets selected. The order is low to high. Or by the state if it is an object. so array = low-to-high icon ladder, object = keyed by state. both valid, both iconic. 🌈
  • rotate — typeof: integer. Positive value to rotate the text label (in 90 degree increments). yes you can turn it sideways. main character angle. 📐
  • states — typeof: object. A number of memory utilization states which get activated on certain percentage thresholds. See waybar-states(5) for the deets. 🚦
  • max-length — typeof: integer. The maximum length in character the module should display. it will not go past this, no matter how loud the number is. ✂️
  • 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. keeps the scroll chill and not all over the place. 🌊
  • tooltip — typeof: bool, default: true. Option to disable tooltip on hover. yes it defaults to on. yes you can turn the little hover popup off. 💬
  • 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. don't skip that part, it's required fr fr. 📄
  • 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. greedy little module. love that for it. 🫶

🦋 FORMAT REPLACEMENTS 🦋

these are the little {thing} tokens you drop into your format. the good stuff:

  • {percentage} — Percentage of memory in use. 💜
  • {swapPercentage} — Percentage of swap in use. 🔁
  • {total} — Amount of total memory available in GiB. 📦
  • {swapTotal} — Amount of total swap available in GiB. 📦
  • {used} — Amount of used memory in GiB. 🔥
  • {swapUsed} — Amount of used swap in GiB. 🔥
  • {avail} — Amount of available memory in GiB. ✅
  • {swapAvail} — Amount of available swap in GiB. ✅
  • {swapState} — Signals if swap is activated or not. 🚨

⭐ EXAMPLES ⭐

the classic setup, no cap:

"memory": {
     "interval": 30,
     "format": "{}% ",
     "max-length": 10
}

🎀 FORMATTED MEMORY VALUES 🎀

want decimals? want it to look like a lil stat readout? say less:

"memory": {
     "interval": 30,
     "format": "{used:0.1f}G/{total:0.1f}G "
}

💅 STYLE 💅

  • #memory

one selector. that's all you need to style it. go off. 👑

reminder bestie: every token, every option, every default up there is exactly as written. no renames, no merges, no invented flags. i would never do that to you. 💖

that's the whole page, and it's from waybar-memory(5), dated 2026-02-08. go check your RAM, queen. 💜✨🦋

📦 where this page comes from