diff --git a/README.md b/README.md
new file mode 100644
index 0000000..91c2e10
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# Midi Multi Player
+> low-latency midi input from remote sources
+
+be it viewers in the same rooms on their phone or strangers on the internet, with `mmp` it's possible to let others drive your midi while playing!
+
+## setup
+ * serve the webpage somewhere: users will connect here and play with sliders
+ * run the server remotely: it will bridge many websocket connections from users to one tcp stream to you
+ * run the port locally: point it to the server and it will convert remote actions in midi events