From 7928852aa377bd6c5a553e93e7bfa4403291b50b Mon Sep 17 00:00:00 2001
From: Evgeny Zinoviev <me@ch1p.com>
Date: Sat, 29 Jun 2019 03:49:52 +0300
Subject: write readme

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/README.md b/README.md
index 5b6c7d5..66681ff 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,41 @@
 # write-intel-brightness
+
+This is a script to control screen brightness on Lenovo ThinkPad X220 and similar after you changed PWM frequency by writing a custom value to 0xC8254 register. I use it with acpid.
+
+The script reads current PWM frequency from the register, calculates correct new brightness level for `/sys/class/backlight/intel_backlight/brighness` and writes it.
+
+### Usage
+
+To increase brightness:
+```
+write-intel-brightness +
+```
+
+To decrease:
+```
+write-intel-brightness -
+```
+
+### acpid example
+
+From `/etc/acpi/default.sh` on my Gentoo box:
+
+```
+case "$group" in
+    video)
+        case "$action" in
+            brightnessup)
+                /usr/local/bin/write-intel-brightness +
+                ;;
+
+            brightnessdown)
+                /usr/local/bin/write-intel-brightness -
+                ;;
+        esac
+        ;;
+esac
+```
+
+### License
+
+MIT
-- 
cgit v1.2.3