diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5213320
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# townstats
+
+This program dumps information about tilde.town in the [Tilde Data Protocol](http://protocol.club/~datagrok/beta-wiki/tdp.html).
+
+# author
+
+vilmibm, based on python work by [datagrok](https://datagrok.org)
+
+# license
+
+gplv3+
\ No newline at end of file