diff --git a/README.md b/README.md
new file mode 100644
index 0000000..587a51e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# video compressor and player for the ch32v003 with an SSD1306 32x128 OLED display
+Put a webm file in `video/` and run `./convert <framerate>` to convert the video to a sequence of 32x40 images.
+
+Run `cd encoder && cargo run` to convert to bytes, this will be exported to `data.h`.
+
+Tweak framerate or MAX_ERROR in `main.rs` until the total size fits the 16k flash alongside the decoder.
+
+By default it's tuned for bad apple.
+