waybar-backlight(5)

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

💖 waybar-backlight(5) — the manual page, but make it cute 💖

okay bestie, welcome to waybar-backlight(5), a File Formats Manual page, and honestly? this one is a lil snack. it's the backlight module. it shows you your current backlight level. that's it. that's the whole gig. ✨

🌸 NAME 🌸

waybar - backlight module

like... the backlight module for waybar. the name is the name, we don't overthink it 💅

🦋 DESCRIPTION 🦋

The backlight module displays the current backlight level.

that's it. she's simple. she's iconic. she tells you how bright your screen is and she does it with main character energy. no cap. 👑

✨ CONFIGURATION ✨

okay here's where the real fun starts, bestie. all the knobs and dials. every single one. let's go 🎀

  • interval — typeof: integer. default: 2. this is how often (in whatever interval units, the poll interval) the info gets polled. every 2 of them, she checks in on you. lowkey clingy but in a sweet way 🫶
  • format — typeof: string. default: {percent}%. the format, aka how the information should be displayed. wherever you put {}, the data gets inserted. periodt.
  • max-length — typeof: integer. the maximum length in characters the module should display. she will NOT go over. boundaries, we love to see it 💅
  • min-length — typeof: integer. the minimum length in characters the module should accept. she also has a minimum. consistency queen ✨
  • align — typeof: float. the alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. oh and if the module is rotated, it will follow the flow of the text. flexible fr fr 🌈
  • justify — typeof: string. the alignment of the text within the module's label, letting options 'left', 'right', or 'center' define the positioning. pick your vibe 🌸
  • rotate — typeof: integer. a positive value to rotate the text label (in 90 degree increments). spin her around, she ate 🔥
  • states — typeof: object. a number of backlight states which get activated on certain brightness levels. see waybar-states(5). the drama! the aesthetics! 💜
  • on-click — typeof: string. command to execute when the module is clicked. tap tap, something happens 🎀
  • on-click-middle — typeof: string. command to execute when middle-clicked on the module using mouse scroll wheel. yes, the scroll wheel counts as a click. she contains multitudes 😭
  • on-click-right — typeof: string. command to execute when the module is right-clicked. right click bestie, we see you 🙈
  • on-update — typeof: string. command to execute when the module is updated. every refresh is a lil event ✨
  • on-scroll-up — typeof: string. command to execute when performing a scroll up on the module. heads up though: this replaces the default behaviour of brightness control. so if you set this, the built-in brightness-up scroll is gone, replaced by whatever you tell her to do. choose wisely 👀
  • on-scroll-down — typeof: string. command to execute when performing a scroll down on the module. same deal: this replaces the default behaviour of brightness control. your scroll-down brightness control? poof. replaced. it's giving "you asked for this" 💀
  • smooth-scrolling-threshold — typeof: double. threshold to be used when scrolling. smooth like butter, tune it to taste 🧚
  • reverse-scrolling — typeof: bool. option to reverse the scroll direction. because sometimes up is down and down is up and that's valid 🌈
  • scroll-step — typeof: float. default: 1.0. the speed at which to change the brightness when scrolling. how much per scroll tick. go slow, go feral, your call 🔥
  • min-brightness — typeof: double. default: 0.0. the minimum brightness of the backlight. she will not go below this, ever, absolutely not 🛑
  • menu — typeof: string. action that popups the menu. pop off, menu 🎀
  • menu-file — typeof: string. location of the menu descriptor file. there need to be an element of type GtkMenu with id menu. yes that's a whole requirement, don't skip it 👑
  • menu-actions — typeof: array. the actions corresponding to the buttons of the menu. one per button, you know the drill 💅
  • expand — typeof: bool. default: false. enables this module to consume all left over space dynamically. she's greedy (affectionate) and honestly? good for her 🌸

🌟 EXAMPLE: 🌟

here's the look, bestie. copy it, love it, live it:

     "backlight": {
          "device": "intel_backlight",
          "format": "{percent}% {icon}",
          "format-icons": ["", ""]
     }

(those format-icons are lil glyphs in the original, so if they render weird for you it's a font thing, not a you thing 🫶)

💅 STYLE 💅

  • #backlight

that's your CSS hook. go style her. make her gorgeous. ✨

and that's the whole page, bestie!! no notes. 🦋💖

this was waybar-backlight(5), from the File Formats Manual, dated 2026-02-08. mwah. go forth and control your brightness. periodt. ✨👑

📦 where this page comes from