diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..cf40ed0
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+# Piwik Map Generator
+
+Python script that generates all svg maps used in the new Piwik map widget 
+
+Uses [Kartograph.py](https://github.com/kartograph/kartograph.py) to generate the SVGs from [Natural Earth](http://www.naturalearthdata.com/downloads/) shapefiles.
+
+1. Install Kartograph.py
+2. Download shapefiles via download.sh
+3. Run make-maps.py