diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ab7e2ab
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Android notification listener.
+Forwards all notifications to a ntfy URL
+## Configuration
+### Secrets
+##### `secret/token.txt`
+The authorization token for ntfy
+##### `secret/url.txt`
+The ntfy topic url to push notifications to.