LUX(1) Manual Page

  • Home
  • Back

  • LUX(1) General Commands Manual LUX(1)

    luxquery and modify display brightness

    lux [-gGm] [-dDiIsS val]

    The lux utility allows you to get display brightness information as well as set it. When invoked without any arguments, lux will print the current brightness level as a percentage (“45.000000” means that the current brightness level is 45%).

    All flags besides the -m flag have both lowercase and uppercase variants. The lowercase variants operate in terms of brightness units in the range of [0, MAX] where MAX is a system dependent maximum obtainable with the -m flag. The uppercase variants operate in terms of percentages without a percent symbol (‘%’) as a suffix.

    The options are as follows:

    val, --decrease=val
    Decrease the current display brightness by val brightness units.
    val, --decrease-percent=val
    Decrease the current display brightness by val percent.
    , --get
    Print the current display brightness in brightness units.
    , --get-percent
    Print the current display brightness as a percentage.
    val, --increase=val
    Increase the current display brightness by val brightness units.
    val, --increase-percent=val
    Increase the current display brightness by val percent.
    , --max
    Print the maximum display brightness in brightness units.
    val, --set=val
    Set the current display brightness to val brightness units.
    val, --set-percent=val
    Set the current display brightness to val percent.

    The lux utility exits 0 on success, and >0 if an error occurs.

    Get the current display brightness as a percentage:

    $ lux

    Increase the current display brightness by 15% and then print out the new brightness level as a percentage:

    $ lux -I 15 -G

    lux(3)

    Thomas Voss <[email protected]>

    August 7, 2022 Linux