diff --git a/README.md b/README.md
index 3bcf56e..6fe948c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-# um-tracer
+# um-tracer - Usermode Virtual Instruction Tracer Demo
 
-Usermode Virtual Instruction Tracer Demo
\ No newline at end of file
+um-trace is a demo project/repo which contains an example of how to create a runtime trace of a VMProtect'ed binary (VMProtect 2). The binaries in this repo are not packed for simplicity sake, however in later demo's I will be applying packing to the executable. 
+
+#### Contents
+
+* dependencies/ - this project is dependent on `vmtracer`. 
+* refbuilds/ - binaries protected with `ultra virtualization` and no packing. These bins are for you to mess with!
+* src/ - source code for the usermode tracer. 
+    * vmptest/ - source code for the the test bins
+    * um-tracer/ - source code for usermode tracer, includes a hook on `LCONSTBZX`.
\ No newline at end of file