diff --git a/README b/README
new file mode 100644
index 0000000..fb6b3b2
--- /dev/null
+++ b/README
@@ -0,0 +1,19 @@
+### install
+
+switch to your awesome config folder, typically at:
+
+```
+cd ~/.config/awesome
+```
+
+clone this repository:
+
+```
+https://github.com/basaran/awesomewm-backham
+```
+
+and call it from your `rc.lua`
+
+```
+require('awesomewm-backham')
+```