diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..133399b
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,5 @@
+# Alternativebit Gemlog Generator
+
+I use this small script to automatically generate a gemlog index from a directory containing all the log entries.
+
+It uses the unix file creation date to retrieve the entry date. Meaning take care not to alter the file creation time as it'll alter the entries order.