diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fa648ec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+This is the endoh entry from the 2012 International Obfuscated C Code Contest.
+
+tl;dr: it does ASCII fluid simulations.
+
+To run it:
+
+- git clone https://github.com/gardaud/endoh.git
+- cd endoh
+- make
+- ./endoh1 < pour-out.txt
+
+You can also `make endoh1_color` and run this binary instead to get colored output.
+
+Have fun :)
+
+Original code by Yusuke Endoh <mame@tsg.ne.jp>
+
+Original page here: http://www.ioccc.org/2012/endoh1/hint.html
+