diff options
| author |  Mykyta Holubakha <hilobakho@gmail.com> | 2017-01-17 01:45:17 +0200 |
|---|---|---|
| committer | Mykyta Holubakha <hilobakho@gmail.com> | 2017-01-17 01:45:17 +0200 |
| commit | de56ea2af5b628d96c1d576529ffb8e40f47b9df (patch) | |
| tree | 1296d1089b47a2873bdbf14a05b21ee60211acc6 /README.md | |
| parent | b287e2315f14446bfac5cb03510a566e78af21f1 (diff) | |
Updated readme
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..a161e6d --- /dev/null +++ b/README.md @@ -0,0 +1,49 @@ +# brightnessctl + +This program allows you read and control device brightness. Devices, by default, include are searched for in backlight and leds classes. If omitted, the first found device is selected. + +It can also preserve current brightness before applying the operation (allowing for usecases like disabling backlight on lid close). + +## Installation + +The program is available in: +* [Fedora/EPEL](https://apps.fedoraproject.org/packages/brightnessctl) + +## Permissions + +Modifying brightness requires write permissions for device files. This can be accomplished (without using sudo/su/etc.) by either of the following means: +1) installing brightnessctl as a suid binary (done by default) +2) adding a similar udev rule (assuming your user is in `video` group for backlight and `input` group for leds): +``` +ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness" +ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness" +ACTION=="add", SUBSYSTEM=="leds", RUN+="/bin/chgrp input /sys/class/leds/%k/brightness" +ACTION=="add", SUBSYSTEM=="leds", RUN+="/bin/chmod g+w /sys/class/leds/%k/brightness" +``` + +## Usage +``` +Usage: brightnessctl [options] [operation] [value] + +Options: + -l, --list list devices with available brightness controls. + -q, --quiet suppress output. + -p, --pretend do not perform write operations. + -m, --machine-readable produce machine-readable output. + -s, --save save previous state in a temporary file. + -r, --restore restore previous saved state. + -h, --help print this help. + -d, --device=DEVICE specify device name. + -c, --class=CLASS specify device class. + +Operations: + g, get get current brightness of the device. + m, max get maximum brightness of the device. + s, set VALUE set brightness of the device. + +Valid values: + specific value Example: 500 + percentage value Example: 50% + specific delta Example: 50- or +10 + percentage delta Example: 50%- or +10% + ``` |