diff --git a/README.md b/README.md
new file mode 100644
index 0000000..26f8a7f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# collab
+how 2 use
+1. add images in the images/original directory
+2. set up your logo files in the su25x25.png or whatever it is figure it out yourself
+3. run the run_gen.sh
+4. host it and tada
+
+uses
+1. https://github.com/Deprecator16/OpenSeadragonSmartScrollZoom/
+2. https://github.com/openseadragon/openseadragon
+3. https://github.com/annotorious/annotorious-openseadragon
+4. https://github.com/VoidVolker/MagickSlicer