diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ca5b04e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+## Nimwin
+
+### What is this?
+A very simple X11 window manager written in Nim, and inspired by TinyWM.
+
+
+### How to build it?
+Install nim and nimble and run `nimble build`. You must have XLib development headers on your system (and obviously an X server).
+
+### How to run it?
+* Install [Xephyr](https://en.wikipedia.org/wiki/Xephyr)
+* Make sure you have a running X server
+
+Then run these commands to launch Xephyr. You could also directly execute nimwin from your `~/.xinitrc`, but that would be difficult to use.
+```
+Xephyr -ac -screen 1280x1024 -br -reset -terminate 2> /dev/null :1 &
+env DISPLAY=:1 ./nimwin
+```
+
+### How to launch a window?
+If you want to run xterm, for example, just run `xterm -display :1`
+
+### How to move windows
+
+alt + right click allows you to resize, alt + left click allows you to move.