|
|
@@ -1,62 +1,59 @@
|
|
1
|
|
-<!DOCTYPE html>
|
|
|
1
|
+<!doctype html>
|
|
2
|
2
|
<html>
|
|
3
|
|
-
|
|
4
|
3
|
<head>
|
|
5
|
|
- <meta charset='utf-8' />
|
|
6
|
|
- <meta http-equiv="X-UA-Compatible" content="chrome=1" />
|
|
7
|
|
- <meta name="description" content="Light : GNU/Linux application to control backlights" />
|
|
8
|
|
-
|
|
9
|
|
- <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
|
|
10
|
|
-
|
|
11
|
|
- <title>Light</title>
|
|
|
4
|
+ <meta charset="utf-8">
|
|
|
5
|
+ <meta http-equiv="X-UA-Compatible" content="chrome=1">
|
|
|
6
|
+ <title>Light by haikarainen</title>
|
|
|
7
|
+
|
|
|
8
|
+ <link rel="stylesheet" href="stylesheets/styles.css">
|
|
|
9
|
+ <link rel="stylesheet" href="stylesheets/github-light.css">
|
|
|
10
|
+ <meta name="viewport" content="width=device-width">
|
|
|
11
|
+ <!--[if lt IE 9]>
|
|
|
12
|
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
|
|
|
13
|
+ <![endif]-->
|
|
12
|
14
|
</head>
|
|
13
|
|
-
|
|
14
|
15
|
<body>
|
|
|
16
|
+ <div class="wrapper">
|
|
|
17
|
+ <header>
|
|
|
18
|
+ <h1>Light</h1>
|
|
|
19
|
+ <p>GNU/Linux application to control backlights</p>
|
|
15
|
20
|
|
|
16
|
|
- <!-- HEADER -->
|
|
17
|
|
- <div id="header_wrap" class="outer">
|
|
18
|
|
- <header class="inner">
|
|
19
|
|
- <a id="forkme_banner" href="https://github.com/haikarainen/light">View on GitHub</a>
|
|
|
21
|
+ <p class="view"><a href="https://github.com/haikarainen/light">View the Project on GitHub <small>haikarainen/light</small></a></p>
|
|
20
|
22
|
|
|
21
|
|
- <h1 id="project_title">Light</h1>
|
|
22
|
|
- <h2 id="project_tagline">GNU/Linux application to control backlights</h2>
|
|
23
|
23
|
|
|
24
|
|
- <section id="downloads">
|
|
25
|
|
- <a class="zip_download_link" href="https://github.com/haikarainen/light/zipball/master">Download this project as a .zip file</a>
|
|
26
|
|
- <a class="tar_download_link" href="https://github.com/haikarainen/light/tarball/master">Download this project as a tar.gz file</a>
|
|
27
|
|
- </section>
|
|
28
|
|
- </header>
|
|
29
|
|
- </div>
|
|
30
|
|
-
|
|
31
|
|
- <!-- MAIN CONTENT -->
|
|
32
|
|
- <div id="main_content_wrap" class="outer">
|
|
33
|
|
- <section id="main_content" class="inner">
|
|
|
24
|
+ <ul>
|
|
|
25
|
+ <li><a href="https://github.com/haikarainen/light/zipball/master">Download <strong>ZIP File</strong></a></li>
|
|
|
26
|
+ <li><a href="https://github.com/haikarainen/light/tarball/master">Download <strong>TAR Ball</strong></a></li>
|
|
|
27
|
+ <li><a href="https://github.com/haikarainen/light">View On <strong>GitHub</strong></a></li>
|
|
|
28
|
+ </ul>
|
|
|
29
|
+ </header>
|
|
|
30
|
+ <section>
|
|
34
|
31
|
<h1>
|
|
35
|
|
-<a name="light" class="anchor" href="#light"><span class="octicon octicon-link"></span></a>Light</h1>
|
|
|
32
|
+<a id="light" class="anchor" href="#light" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Light</h1>
|
|
36
|
33
|
|
|
37
|
34
|
<p>Copyright (C) 2012 - 2014, Fredrik Haikarainen
|
|
38
|
35
|
This is free software, see the source for copying conditions. There is NO
|
|
39
|
36
|
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE</p>
|
|
40
|
37
|
|
|
41
|
38
|
<h2>
|
|
42
|
|
-<a name="description" class="anchor" href="#description"><span class="octicon octicon-link"></span></a>Description</h2>
|
|
|
39
|
+<a id="description" class="anchor" href="#description" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Description</h2>
|
|
43
|
40
|
|
|
44
|
|
-<p>"Light" is a program to control backlight controllers under GNU/Linux,
|
|
45
|
|
-it is the successor of lightscript, which was a bash script with the same
|
|
46
|
|
-purpose, and tries to maintain the same functionality.</p>
|
|
|
41
|
+<p>Light is a program to control backlight controllers under GNU/Linux, it is the successor of lightscript, which was a bash script with the same purpose, and tries to maintain the same functionality.</p>
|
|
47
|
42
|
|
|
48
|
43
|
<h2>
|
|
49
|
|
-<a name="features" class="anchor" href="#features"><span class="octicon octicon-link"></span></a>Features</h2>
|
|
|
44
|
+<a id="features" class="anchor" href="#features" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Features</h2>
|
|
50
|
45
|
|
|
51
|
46
|
<ul>
|
|
52
|
|
-<li>Works excellent where other software has been proven to be unusable or problematic, thanks to how it operates internally and to the fact that it does not rely on xorg.</li>
|
|
53
|
|
-<li>Can automatically figure out the best controller to use, making full use of underlying hardware drivers.</li>
|
|
|
47
|
+<li>Works excellent where other software have been proven unusable or problematic, thanks to how it operates internally and the fact that it does not rely on X.</li>
|
|
|
48
|
+<li>Can automatically figure out the best controller to use, making full use of underlying hardware.</li>
|
|
54
|
49
|
<li>Possibility to set a minimum brightness value, as some controllers set the screen to be pitch black at a vaĺue of 0 (or higher).</li>
|
|
55
|
|
-</ul><h2>
|
|
56
|
|
-<a name="installation" class="anchor" href="#installation"><span class="octicon octicon-link"></span></a>Installation</h2>
|
|
|
50
|
+</ul>
|
|
|
51
|
+
|
|
|
52
|
+<h2>
|
|
|
53
|
+<a id="installation" class="anchor" href="#installation" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Installation</h2>
|
|
57
|
54
|
|
|
58
|
55
|
<h3>
|
|
59
|
|
-<a name="arch-linux" class="anchor" href="#arch-linux"><span class="octicon octicon-link"></span></a>Arch Linux</h3>
|
|
|
56
|
+<a id="arch-linux" class="anchor" href="#arch-linux" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Arch Linux</h3>
|
|
60
|
57
|
|
|
61
|
58
|
<p>If you run Arch Linux, there exists 2 packages;</p>
|
|
62
|
59
|
|
|
|
@@ -65,29 +62,23 @@ purpose, and tries to maintain the same functionality.</p>
|
|
65
|
62
|
<a href="https://aur.archlinux.org/packages/light-git">light-git</a> - For the absolutely latest version</li>
|
|
66
|
63
|
<li>
|
|
67
|
64
|
<a href="https://aur.archlinux.org/packages/light">light</a> - For the latest tagged release</li>
|
|
68
|
|
-</ul><p>I recommend you go with light-git as you might miss important features and bugfixes if you do not.</p>
|
|
69
|
|
-
|
|
70
|
|
-<h3>
|
|
71
|
|
-<a name="debianubuntu-or-other-debian-based" class="anchor" href="#debianubuntu-or-other-debian-based"><span class="octicon octicon-link"></span></a>Debian/Ubuntu (Or other Debian-based)</h3>
|
|
72
|
|
-
|
|
73
|
|
-<p>There are 2 different versions of .deb packages available:</p>
|
|
74
|
|
-
|
|
75
|
|
-<ul>
|
|
76
|
|
-<li>
|
|
77
|
|
-<a href="http://haikarainen.1.ai/light/light_20140713-1_i386.deb">light_20140713-1_i386.deb</a> - Dated releases, for the absolutely latest version</li>
|
|
78
|
|
-<li>
|
|
79
|
|
-<a href="http://haikarainen.1.ai/light/light_0.9-1_i386.deb">light_0.9-1_i386.deb</a> - Tagged releases, for the latest versioned release</li>
|
|
80
|
|
-</ul><p>I recommend you go with the dated releases, as you might miss important features and bugfixes if you do not.</p>
|
|
|
65
|
+</ul>
|
|
81
|
66
|
|
|
82
|
|
-<p>For an archive, see: <a href="http://haikarainen.1.ai/light">http://haikarainen.1.ai/light/</a></p>
|
|
|
67
|
+<p>I recommend you go with light-git as you might miss important features and bugfixes if you do not.</p>
|
|
83
|
68
|
|
|
84
|
69
|
<h3>
|
|
85
|
|
-<a name="manual" class="anchor" href="#manual"><span class="octicon octicon-link"></span></a>Manual</h3>
|
|
|
70
|
+<a id="manual" class="anchor" href="#manual" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Manual</h3>
|
|
86
|
71
|
|
|
87
|
72
|
<p><code>make && make install</code></p>
|
|
88
|
73
|
|
|
|
74
|
+<p><strong>Optional:</strong> If you want to use udev rules instead of suid to manage sysfs permissions, you may skip the <code>make install</code> step and instead add something like the following to <code>/etc/udev/rules.d/90-backlight.rules</code> after copying your binaries:</p>
|
|
|
75
|
+
|
|
|
76
|
+<pre><code>ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"
|
|
|
77
|
+ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"
|
|
|
78
|
+</code></pre>
|
|
|
79
|
+
|
|
89
|
80
|
<h2>
|
|
90
|
|
-<a name="usage" class="anchor" href="#usage"><span class="octicon octicon-link"></span></a>Usage</h2>
|
|
|
81
|
+<a id="usage" class="anchor" href="#usage" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Usage</h2>
|
|
91
|
82
|
|
|
92
|
83
|
<p>This application usually has 4 different criteria on flags to use, which are operation modes, value mode, target and controller mode. Flags from these different modes can never be used in conjunction, but all of them do not always have to be specified (although it is recommended to do so for verbosity).</p>
|
|
93
|
84
|
|
|
|
@@ -98,8 +89,10 @@ purpose, and tries to maintain the same functionality.</p>
|
|
98
|
89
|
<li>1: Errors</li>
|
|
99
|
90
|
<li>2: Errors, warnings</li>
|
|
100
|
91
|
<li>3: Errors, warnings, notices</li>
|
|
101
|
|
-</ul><h3>
|
|
102
|
|
-<a name="operation-modes" class="anchor" href="#operation-modes"><span class="octicon octicon-link"></span></a>Operation modes</h3>
|
|
|
92
|
+</ul>
|
|
|
93
|
+
|
|
|
94
|
+<h3>
|
|
|
95
|
+<a id="operation-modes" class="anchor" href="#operation-modes" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Operation modes</h3>
|
|
103
|
96
|
|
|
104
|
97
|
<p>The operation modes describe <strong>what</strong> you want to do.</p>
|
|
105
|
98
|
|
|
|
@@ -111,20 +104,24 @@ purpose, and tries to maintain the same functionality.</p>
|
|
111
|
104
|
<li>-O: Save the current brightness for later use (usually used on shutdown)</li>
|
|
112
|
105
|
<li>-I: Restore the previously saved brightness (usually used on boot)</li>
|
|
113
|
106
|
<li>-L: List the available controllers</li>
|
|
114
|
|
-</ul><p>When used by themselves operate on the brightness of a controller that is selected automatically. S, A and U needs another argument -- except for the main 4 criteria -- which is the value to set/add/subtract. This can be specified either in percent or in raw values, but remember to specify the value mode (read below) if you want to write raw values.</p>
|
|
|
107
|
+</ul>
|
|
|
108
|
+
|
|
|
109
|
+<p>When used by themselves operate on the brightness of a controller that is selected automatically. S, A and U needs another argument -- except for the main 4 criteria -- which is the value to set/add/subtract. This can be specified either in percent or in raw values, but remember to specify the value mode (read below) if you want to write raw values.</p>
|
|
115
|
110
|
|
|
116
|
111
|
<h3>
|
|
117
|
|
-<a name="value-modes" class="anchor" href="#value-modes"><span class="octicon octicon-link"></span></a>Value modes</h3>
|
|
|
112
|
+<a id="value-modes" class="anchor" href="#value-modes" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Value modes</h3>
|
|
118
|
113
|
|
|
119
|
114
|
<p>The value mode specify in what unit you want to read or write values in. The default one (if not specified) is in percent, the other one is raw mode and should always be used when you need very precise values (or only have a controller with a very small amount of brightness levels).</p>
|
|
120
|
115
|
|
|
121
|
116
|
<ul>
|
|
122
|
117
|
<li>-p: Percent</li>
|
|
123
|
118
|
<li>-r: Raw mode</li>
|
|
124
|
|
-</ul><p>Remember, this is the unit that will be used when you set, get, add or subtract brightness values.</p>
|
|
|
119
|
+</ul>
|
|
|
120
|
+
|
|
|
121
|
+<p>Remember, this is the unit that will be used when you set, get, add or subtract brightness values.</p>
|
|
125
|
122
|
|
|
126
|
123
|
<h3>
|
|
127
|
|
-<a name="target" class="anchor" href="#target"><span class="octicon octicon-link"></span></a>Target</h3>
|
|
|
124
|
+<a id="target" class="anchor" href="#target" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Target</h3>
|
|
128
|
125
|
|
|
129
|
126
|
<p>As you can not only handle the <strong>brightness</strong> of controllers, you may also specify a target to read/write from/to:</p>
|
|
130
|
127
|
|
|
|
@@ -132,15 +129,17 @@ purpose, and tries to maintain the same functionality.</p>
|
|
132
|
129
|
<li>-b: Current brightness of selected controller</li>
|
|
133
|
130
|
<li>-m: Maximum brightness of selected controller</li>
|
|
134
|
131
|
<li>-c: Minimum brightness (cap) of selected controller</li>
|
|
135
|
|
-</ul><p>The minimum brightness is a feature implemented as some controllers make the screen go pitch black at 0%, if you have a controller like that, it is recommended to set this value (in either percent or in raw mode). These values will be saved in raw mode though, so if you specify it in percent it might not be too accurate depending on your controller.</p>
|
|
|
132
|
+</ul>
|
|
|
133
|
+
|
|
|
134
|
+<p>The minimum brightness is a feature implemented as some controllers make the screen go pitch black at 0%, if you have a controller like that, it is recommended to set this value (in either percent or in raw mode). These values will be saved in raw mode though, so if you specify it in percent it might not be too accurate depending on your controller.</p>
|
|
136
|
135
|
|
|
137
|
136
|
<h3>
|
|
138
|
|
-<a name="controller-modes" class="anchor" href="#controller-modes"><span class="octicon octicon-link"></span></a>Controller modes</h3>
|
|
|
137
|
+<a id="controller-modes" class="anchor" href="#controller-modes" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Controller modes</h3>
|
|
139
|
138
|
|
|
140
|
139
|
<p>Finally, you can either use the built-in controller selection to get the controller with the maximum precision, or you can specify one manually with the -s flag. The -a flag will force automatic mode and is default. Use -L to get a list of controllers to use with the -s flag (to specify which controller to use).</p>
|
|
141
|
140
|
|
|
142
|
141
|
<h3>
|
|
143
|
|
-<a name="examples" class="anchor" href="#examples"><span class="octicon octicon-link"></span></a>Examples</h3>
|
|
|
142
|
+<a id="examples" class="anchor" href="#examples" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Examples</h3>
|
|
144
|
143
|
|
|
145
|
144
|
<p>Get the current brightness in percent</p>
|
|
146
|
145
|
|
|
|
@@ -154,17 +153,12 @@ purpose, and tries to maintain the same functionality.</p>
|
|
154
|
153
|
|
|
155
|
154
|
<p><code>light -Scrs "acpi_video0" 2</code></p>
|
|
156
|
155
|
</section>
|
|
157
|
|
- </div>
|
|
158
|
|
-
|
|
159
|
|
- <!-- FOOTER -->
|
|
160
|
|
- <div id="footer_wrap" class="outer">
|
|
161
|
|
- <footer class="inner">
|
|
162
|
|
- <p class="copyright">Light maintained by <a href="https://github.com/haikarainen">haikarainen</a></p>
|
|
163
|
|
- <p>Published with <a href="http://pages.github.com">GitHub Pages</a></p>
|
|
|
156
|
+ <footer>
|
|
|
157
|
+ <p>This project is maintained by <a href="https://github.com/haikarainen">haikarainen</a></p>
|
|
|
158
|
+ <p><small>Hosted on GitHub Pages — Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
|
|
164
|
159
|
</footer>
|
|
165
|
160
|
</div>
|
|
166
|
|
-
|
|
|
161
|
+ <script src="javascripts/scale.fix.js"></script>
|
|
167
|
162
|
|
|
168
|
|
-
|
|
169
|
163
|
</body>
|
|
170
|
164
|
</html>
|
Fredrik Haikarainen
8 jaren geleden