README.md

Mon, 18 Jul 2016 14:58:32 +0200

author
David Demelier <markand@malikania.fr>
date
Mon, 18 Jul 2016 14:58:32 +0200
changeset 0
73a371432d36
child 6
77ea2359f3e4
permissions
-rw-r--r--

misc: initial import

0
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 backlight
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 =========
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
3
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 This tool adjust your laptop brightness using ACPI.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
5
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 It has been designed for broken ACPI (e.g. HP) where fn-keys do not work,
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 instead, you can map these keys to call this tool.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
8
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 Supported systems
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 =================
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
11
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 - Linux, requires video ACPI module,
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 - FreeBSD, requires the acpi_video(4) loaded.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
14
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 Installation
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 ============
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
17
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 It is recommended to install this tool using the setuid to allow non-root users
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 to change the laptop backlight.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
20
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 make
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 sudo make install
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
23
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 For FreeBSD, add the following to your **/boot/loader.conf**:
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
25
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 acpi_video_load=YES
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
27
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 Alternatively, you can compile this module into the kernel.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
29
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 Usage
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 =====
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
32
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 The backlight tool supports two commands, `up` and `down` which increment and
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 decrement backlight respectively.
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
35
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 Example:
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
37
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 backlight up
73a371432d36 misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 backlight down

mercurial