diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e79f040
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+dmenu - dynamic menu
+====================
+dmenu is an efficient dynamic menu for X.
+
+Personal Adjustments
+--------------------
+This build has a history feature, can open a terminal window
+if command ends in "!" and is adjust to fit bar padding used in dwm.
+
+
+Requirements
+------------
+In order to build dmenu you need the Xlib header files.
+
+
+Installation
+------------
+Edit config.mk to match your local setup (dmenu is installed into
+the /usr/local namespace by default).
+
+Afterwards enter the following command to build and install dmenu
+(if necessary as root):
+
+    make clean install
+
+
+Running dmenu
+-------------
+See the man page for details.