From 648be56a195bd3fdb63b6de5ab5be90c628b4546 Mon Sep 17 00:00:00 2001
From: yawnt <yawnt@users.noreply.github.com>
Date: Mon, 23 Dec 2013 08:04:02 -0800
Subject: [PATCH] Created brightness (markdown)

---
 brightness.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 brightness.md

diff --git a/brightness.md b/brightness.md
new file mode 100644
index 0000000..590359a
--- /dev/null
+++ b/brightness.md
@@ -0,0 +1,40 @@
+[<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)
+
+Shows brightness level in a textbox.
+
+	volumewidget = lain.widgets.contrib.brightness()
+
+### input table
+
+Variable | Meaning | Type | Default
+--- | --- | --- | ---
+`timeout` | Refresh timeout seconds | int | 5
+`backlight` | Backlight Video | string | "acpi_video0" 
+`settings` | User settings | function | empty function
+
+`settings` can use the following variables:
+
+Variable | Meaning | Type | Values
+--- | --- | --- | ---
+`brightness_now` | Brightness level | int | 0-100
+
+### output table
+
+Variable | Meaning | Type
+--- | --- | --- 
+`widget` | The widget | `wibox.widget.textbox`
+`update` | Update `widget` | function
+
+You can control the widget with key bindings like these:
+
+    -- Volume control
+    awful.key({}, "XF86MonBrightnessUp",
+    function ()
+        awful.util.spawn("xbacklight -inc 1")
+        brightnesswidget.update()
+    end),
+    awful.key({}, "XF86MonBrightnessDown",
+    function ()
+        awful.util.spawn("xbacklight -dec 1")
+        brightnesswidget.update()
+    end),
-- 
2.39.5