aboutsummaryrefslogtreecommitdiffstats
path: root/adjbacklight.1
blob: 3596e5d8fef4269aa63fdd178788a954e56b67bf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
.TH ADJBACKLIGHT 1 ADJBACKLIGHT
.SH NAME
adjbacklight - Convenient method for adjusting the backlight on your portable computer
.SH SYNOPSIS
.B adjbacklight
[-g | -s
.RB [ + | - ]\fIlevel\fP[ % | %% ]]
[-a |
.IR device \ ...]
.SH DESCRIPTION
.B adjbacklight
can be used to fetch or set the backlight non-interactively.
If these feature is not used, it starts a interactive user
interface in the terminal.
.P
.B adjbacklight
installs with the set-uid bit set, to enable any user to
change the backlight on the computer.
.P
.B adjbacklight
was originally designed for small netbooks that are not running
.BR X .
However, it is still suitable for desktop computers and can
be used inside
.BR X .
In fact it seems to work for all machines with backlight, which
is not true for
.BR xbacklight (1).
.V adjbacklight
uses
.IR /sys/class/backlight .
.B adjbacklight
as been retrofitted to be convenient for use inside
.B X
on desktop computers, with commands that lets it be used
non-interactively with hotkeys set up in
.BR xbindkeys (1).
.SH OPTIONS
.TP
.BR \-a
Run for all devices, including ACPI devices.
.TP
.BR \-g
Get average brightness on devices.
.TP
.BR -s \ \fIlevel\fP
Set brightness on devices by actual value.
.TP
.BR -s\ + \fIlevel\fP
Increase brightness on devices by actual value.
.TP
.BR -s\ - \fIlevel\fP
Decrease brightness on devices by actual value.
.TP
.BR -s \ \fIlevel\fP%
Set brightness on devices by percentage-points.
.TP
.BR -s\ + \fIlevel\fP%
Increase brightness on devices by percentage-points.
.TP
.BR -s\ - \fIlevel\fP%
Decrease brightness on devices by percentage-points.
.TP
.BR -s \ \fIlevel\fP%%
Set brightness on devices by percentage.
.TP
.BR -s\ + \fIlevel\fP%%
Increase brightness on devices by percentage.
.TP
.BR -s\ - \fIlevel\fP%%
Decrease brightness on devices by percentage.
.SH KEYBOARD
.TP
.BR left ,\  down
Darken the screen.
.TP
.BR right ,\  up
Brighten the screen.
.TP
.BR q ,\  enter ,\  C-d
Continue to next controller, or if at last, quit.
.SH "SEE ALSO"
.BR xbindkeys (1),
.BR xbacklight (1)
.SH AUTHORS
Mattias Andrée
.RI < maandree@kth.se >