diff --git a/README.md b/README.md
new file mode 100644
index 0000000..91811be
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# Feather-Seq
+
+A CircuitPython based (DIN) MIDI note-sequencer for the `unexpected maker feather s2`.
+I use it connected to my MachineDrum.
+
+## Build Instructions
+
+### Hardware
+You just need a feather board and wire a DIN-MIDI cable to the pins:
+
+* TX
+* 3.3v
+* GND
+
+as described in `https://www.midi.org/specifications-old/item/midi-din-electrical-specification`
+
+Rocket science.
+
+### Software
+
+maybe restore your uf2 bootloader
+load the circuitpyhton uf2 into the UF2 drive
+If everythin is working, immediately after copy, with no action required, the drive disappears, and a new drive called `CICUITPY` shows up.
+
+After that just install the complete driver package onto you board
+
+Then, finally check out this repo, and copy the file `code.py` into your `CIRCUITPY` drive.
+
+After reset, the thing should be sending out MIDI notes in a euclidean fashion.
\ No newline at end of file