diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7794922
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+JS implementation of Blackmagic Design's IP10 codec as documentated [here](https://downloads.blackmagicdesign.com/Developer/Converters/20240613-76d445/Blackmagic_IP10_Codec_v1.1.zip).
+
+# Usage
+see [test.js](./test.js) for an example of using the `Encoder` and `Decoder` classes