diff --git a/README.md b/README.md
index 1efdf62..c408c55 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,29 @@
-# Boulderman
+Boulderman
+============
 
+A game that is a clone of Kye by Colin Garbutt.
+It's not an exact relica or anything like that,
+I wanted to recreate the game mechanics in my own way.
+
+
+Usage
+-----
+
+    ./boulderman [level.file]
+
+Call with no arguments to get the intro level.
+
+
+Controls
+---------
+
+Move with `i`,`j`,`k`,`l`.
+
+Skip a turn with the spacebar.
+
+Quit level with `q`.
+
+Credits
+--------
+
+`intro.kye` is from Kye by Colin Phipps under the GPL licence.