xbacklight(1)

xbacklight1

Adjust backlight brightness using randr extension

Usage

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

Overview

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.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 5 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8–12
  5. 13
  6. Arch

-version since Debian 13 (Trixie).

Authors

Keith Packard, Open Source Technology Center, Intel Corporation.

From xorg-xbacklight 1.2.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.