diff --git a/README.md b/README.md
new file mode 100644
index 0000000..28f4d05
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# poem, rotting
+
+This is a small program that slowly rots a given text file. It replaces random
+characters with other unicode characters, and sometimes deletes characters and 
+sends them off into the internet over UDP ECHO packets.
+
+This program is used in a poetry project that lives here: [tilde.town/~ike/rot.html](https://tilde.town/~ike/rot.html)