Files
dotfiles/dot_config/waybar/waybar.wiki/Module:-Backlight.md
s0wlz (Matthias Puchstein) 8018b53353 feat: finalize migration to chezmoi and modernize configuration logic
- Modularize Hyprland config into hyprland.d/
- Implement infinitely scalable monitor/workspace logic using templates and loop-based data structures
- Consolidate host-specific configs (hyprlock, hyprpaper, waybar) into single templates
- Resolve waybar symlink conflict and fix template execution errors
- Integrate chezmoi data variables for scale, resolution, and peripherals
2025-12-27 22:52:43 +01:00

52 lines
3.4 KiB
Markdown

The `backlight` module displays the current backlight level.
### Config
Addressed by `backlight`
| option | typeof | default | description |
| ---------------------------- | ------- | ------------ | ----------- |
| `interval` | integer | 2 | The polling interval (in seconds) for the backlight level. |
| `format` | string | `{percent}%` | The format, how information should be displayed. On `{}` data gets inserted. |
| `format-icons` | array | | Based on the current screen brightness, the corresponding icon gets selected.<br>The order is *low* to *high*.<br> |
| `max-length` | integer | | The maximum length in characters the module should display. |
| `rotate` | integer | | Positive value to rotate the text label. |
| `states` | array | | A number of backlight states which get activated on certain brightness levels.<br>See [States](https://github.com/Alexays/Waybar/wiki/States) |
| `on-click` | string | | Command to execute when clicking on the module. |
| `on-click-middle` | string | | Command to execute when you middle click on the module using the mousewheel. |
| `on-click-right` | string | | Command to execute when you right click on the module. |
| `on-scroll-up` | string | | Command to execute when scrolling up on the module. This replaces the default behaviour of brightness control. |
| `on-scroll-down` | string | | Command to execute when scrolling down on the module. This replaces the default behaviour of brightness control. |
| `smooth-scrolling-threshold` | double | | Threshold to be used when scrolling. |
| `reverse-scrolling` | bool | false | Option to reverse the scroll direction for devices other than a mouse (touchpad, trackpad, etc) |
| `reverse-mouse-scrolling` | bool | false | Option to reverse the scroll direction for mice |
| `scroll-step` | float | 1.0 | The speed in which to change the brightness when scrolling. |
| `tooltip` | bool | `true` | Option to disable tooltip on hover. |
| `tooltip-format` | string | | Text to be displayed in the tooltip |
#### Format replacements:
| string | replacement |
| ------------ | ----------- |
| `{percent}` | Screen brightness as a percentage |
| `{icon}` | Icon, as defined in `format-icons`. |
#### Example:
```jsonc
"backlight": {
"device": "intel_backlight",
"format": "{percent}% {icon}",
"format-icons": ["", ""]
}
```
### Style
- `#backlight`
### See also
* [External screen brightness](https://gist.github.com/nicodebo/297c1e134256ea24abf02a485ce41420) (using [ddcutil](https://github.com/rockowitz/ddcutil))
* [Another external screen brightness](https://gist.github.com/Ar7eniyan/42567870ad2ce47143ffeb41754b4484) (using ddcutil too)
* [Screen brightness without external scripts](https://gist.github.com/MyrikLD/4467d4dae3f0911cd5094b8440cbf418) (still ddcutil) Note: Can close Monitor **O**n**S**creen**D**isplay each set interval (e.g.: AOC 27G2G8)
* [Screen brightness with simple bash script](https://gist.github.com/negoro26/c59167fb4c08da46c4e08e1fdcd7aeb1) (with ddcutil too)