---
name: "xbacklight"
section: "1"
platform: "linux"
package: "xorg-xbacklight"
version: "1.2.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xbacklight"
---

# xbacklight(1)

adjust backlight brightness using RandR extension

## NAME

xbacklight - adjust backlight brightness using RandR extension

## SYNOPSIS

**xbacklight** \[-help\]  \[-display *display*\] \[-get\] \[-set percent\] \[-inc percent\] \[-dec percent\] \[-time milliseconds\] \[-steps number\]

## DESCRIPTION

*Xbacklight* is used to adjust the backlight brightness where supported. It finds all outputs on the X server supporting backlight brightness control and changes them all in the same way.

- \-get

  Print out the current backlight brightness of each output with such a control. The brightness is represented as a percentage of the maximum brightness supported.

- \-set *percent*

  Sets each backlight brightness to the specified level.

- \-inc *percent*

  Increases brightness by the specified amount.

- \-dec *percent*

  Decreases brightness by the specified amount.

- \-help

  Print out a summary of the usage and exit.

- \-version

  Print out the program version and exit.

- \-time *milliseconds*

  Length of time to spend fading the backlight between old and new value. Default is 200.

- \-steps *number*

  Number of steps to take while fading. Default is 20.

## SEE ALSO

[Xrandr(3)](/Xrandr/3.md)

## AUTHORS

Keith Packard, Open Source Technology Center, Intel Corporation.