diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cc938ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+SatNOGS Demo Display
+====================
+A hacky python script rendering the waterfall of the latest SatNOGS observation,
+to a nice info graphic.
+Currently limited to a fixed resolution of 1280x1024.
+
+Install
+-------
+```
+python3 -m venv virtenv
+source virtenv/bin/activate
+
+pip install -r requirements.txt
+```
+
+
+Usage
+-----
+1. Run update.py once a minute. e.g. using cron
+2. Run something to display the resulting waterfall.png. e.g. `feh -F -D 30 waterfall.png`
+3. Fun & Profit