---
name: "yambar-modules-backlight"
section: "5"
platform: "linux"
package: "yambar"
version: "1.11.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yambar-modules-backlight"
---

# yambar-modules-backlight(5)

This module reads monitor backlight status

## NAME

backlight - This module reads monitor backlight status

## DESCRIPTION

This module reads monitor backlight status from */sys/class/backlight*, and uses **udev** to monitor for changes.

## TAGS

| | | |
| --- | --- | --- |
| **Name** | **Type** | **Description** |
| brightness | range | The current brightness level, in absolute value |
| percent | range | The current brightness level, in percent |

## CONFIGURATION

| | | | |
| --- | --- | --- | --- |
| **Name** | **Type** | **Req** | **Description** |
| name | string | yes | The backlight device's name (one of the names in **/sys/class/backlight**) |

## EXAMPLES

```
bar:
  left:
    - backlight:
        name: intel_backlight
        content:
          string: {text: "backlight: {percent}%"}
```

## SEE ALSO

[**yambar-modules**(5)](/yambar-modules/5.md), [**yambar-particles**(5)](/yambar-particles/5.md), [**yambar-tags**(5)](/yambar-tags/5.md), [**yambar-decorations**(5)](/yambar-decorations/5.md)