diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c3e4055
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+# i3status-custom-pim
+Generates JSON output for use with _custom_ block of [i3status-rust](https://github.com/greshake/i3status-rust)
+