diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..1c6a35b
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,21 @@
+# picoti
+
+![Outside](./picote-outside.jpg)
+![Inside](./picote-inside.jpg)
+
+Use a rpi pico and push buttons to send key strokes to a computer.
+
+This is the companion project to the [Stopi](https://forge.chapril.org/ABelliqueux//stopi) stop-motion software.  
+
+## Software setup
+
+ 1. Upload 'code.py' and the 'lib' folder to the rpi pico
+ 2. Done
+
+## Hadware setup
+
+ * 5 push buttons
+ * 1 ON/OFF switch with indicator light or a separate LED
+ * 1 330Ω resistor
+
+![The crude diagram](./picote-s.jpg)
\ No newline at end of file