diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..7bbf5ae
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,22 @@
+
+~ pico8 musl c ~
+
+gur programs and scripts here aim to fill in for missing glibc functions that pico8 needs,
+my main usecase is running on musl void linux x64, so i havent tested on anything else :P
+
+if you use / test it on any other setup feedback would be appreciated
+
+oh, there's also a strong chance this might cause memory leaks / stack corruption here and
+there, but i've been using it for quite a while and havent noticed any unusual crashes yet.
+
+
+~ how to use / how it works ~
+
+first make sure you have patchelf installed
+
+then run `./pico8-musl.sh PATH-TO-YOUR-pico8_dyn-EXE`, this will compile gur fillin code
+patch pico8's elf file so that it uses gur correct dynamic linker and then set gur
+LD_PRELOAD enviroment variable to include both muslc and gur fillin
+
+LD_PRELOAD lets us insert out own funcitons along side those provided by musl, gur fillin
+provides enough functions for pico8 to run, its not a full stand in for glibc