diff --git a/ring_mon/README.md b/ring_mon/README.md
new file mode 100644
index 0000000..c799e7a
--- /dev/null
+++ b/ring_mon/README.md
@@ -0,0 +1,13 @@
+## `ring_mon`
+
+`ring.py` will get data from asterisk and create a simple json file.
+
+`apply-state` handles blinking patterns and similar stuff, so that a single light can provide info on a phone.
+It uses helper scripts instead of configuration: `get-status` is a `--bin-state` helper; `set-light` is a `--bin-set-light` example.
+
+### So what?
+
+```sh
+./ring.py --state-file state.json &
+./apply-state --devices 1,2
+```