diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2c169c0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# xdg-sanity
+
+This script is built to replace your default web browser in your desktop/XDG
+settings. It intercepts http/s URIs sent to the default browser by XDG settings
+and sends it to the appropriate application. For example, it will send
+image/jpeg MIME type files to your image viewer.
+
+Add your default web browser to `/etc/xdg-sanity.conf` so the script can forward
+links to it.
\ No newline at end of file