diff --git a/images/risetofall.png b/images/risetofall.png
new file mode 100644
index 0000000..b3d7d32
Binary files /dev/null and b/images/risetofall.png differ
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..c716b53
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,17 @@
+# risetofall
+simple inertial platformer
+
+![risetofall demo image](images/risetofall.png)
+
+controls:
+control | action
+---|---
+`w`|jump
+`a`|strafe left
+`d`|strafe right
+`space`|invert gravity
+
+download:
+[latest release](https://github.com/Speedy6451/risetofall/releases/latest)
+
+For platforms other than OS X, download source and run `cli.py`.