diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fa0cef3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# notice
+
+Basic text-based D-Bus notification handler that outputs JSON compatible
+with Waybar.
+
+## waybar integration
+
+In `.config/waybar/config.jsonc`:
+
+```jsonc
+"custom/notifications": {
+    "format": "{}",
+    "max-length": 64,
+    "hide-empty-text": true,
+    "return-type": "json",
+    "exec": "/path/to/notice",
+}
+```