diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4f4ef13
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# [radio-archive](https://archive.tilderadio.org)
+
+the [webhook](webhook/index.php) starts and stops recording the live stream based on the values sent by the webhook.
+
+this setup assumes that the webhook is sent by [azuracast](https://www.azuracast.com/) and on the dj connecting and disconnecting events.
+
+djs that haven't connected before will have a new directory created based on the dj name field in the webhook payload.
\ No newline at end of file