diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bcac909
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# apub2gmi.py
+
+This is a script which takes an archive exported from a Mastodon account, looks for media attachments and uses them to build an archive for a Gemini server.
+
+I use it to update the [Glossatory archives](gemini://gemini.mikelynch.org/glossatory/) and there's still a few things hard-coded in it which I haven't moved out to a config file, specifically the regular expressions which match attachment URLs and pull bits of text out for the index links.
\ No newline at end of file