diff --git a/README.md b/README.md
index e69de29..7fb38e9 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,14 @@
+# Random computer graphics algorithms visualized with the Diagrams library
+
+## Building
+
+cabal build (you need cabal)
+
+## Running
+
+```cabal run Gtk -- file.obj```
+or
+```cabal run Gif -- -w 600 -h 600 -o out.gif```
+
+### Build Status
+[![Build Status](https://travis-ci.org/hasufell/CG2.png)](https://travis-ci.org/hasufell/CG2)