diff --git a/README.md b/README.md
new file mode 100644
index 0000000..70a874a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# gamo
+
+local gamepad tester
+
+## why ?
+
+its much easier and much faster to have this locally installed and boot it in a terminal than to search the web for a web tester that's decent
+
+there's nothing particularly fancy about this and it does what it says, allows the user to test their gamepad
+
+## controls
+
+use `v` to start a weak vibrations test and `V` (uppercase) for a strong vibration test if your gamepad supports them.