diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b296f99
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# MASSINSPIRO
+
+MASS collection of INSPIRObot images
+
+## How to
+
+* Think of how many images we want. In this example we will use 2 as our value
+* Think of if you want it in christmas mode or not. There is a seperate script for xmas mode. In this example we'll be using normal mode.
+
+For this example we would run:
+
+```zsh
+./massinspiro.zsh 2
+```
+
+It's that easy!
\ No newline at end of file