diff --git a/README.md b/README.md
new file mode 100644
index 0000000..857335e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+#lumbung feed aggregator
+
+This does the following:
+* Grab feeds listed in `feeds_list.txt`
+* Parse feed for blogpost entries
+* * Download images linked in blogposts
+* Turn blogpost entries into HUGO posts