diff --git a/Readme.txt b/Readme.txt
new file mode 100644
index 0000000..910b246
--- /dev/null
+++ b/Readme.txt
@@ -0,0 +1,84 @@
+===================
+Linux
+===================
+HOST APPLICATION:
+install libusb:
+sudo apt-get install libusb-1.0-0-dev
+
+make:
+gcc -I include usbtest.c -o usbtest -lusb-1.0
+
+run:
+./usbtest
+
+FIRMWARE:
+install avr-gcc and avr-libc:
+sudo apt-get install gcc-avr
+sudo apt-get install avr-libc
+
+BOOTLOADER:
+https://github.com/ajd4096/bootloadHID
+
+
+===================
+Windows
+===================
+HOST APPLICATION:
+Install minGW:
+	download: http://www.mingw.org/wiki/Getting_Started
+	launch: Installation manager default settings
+	select: mingw32-base 
+		(primary need is gcc)
+	select: msys-base 
+		(primary need is make, basic unix commands are nice to have)
+	optional: msys-openssh 
+		(helpful if using gitlab to pull updates)
+	minGW utilities can be easily added or removed at any time with minGW installation manager.
+	Add C:\MinGW\bin & C:\MinGW\msys\1.0\bin to your PC's enviroment PATH variable
+		-control panel search: "edit system environment variables
+		-System properties window, Advanced tab, click Environment Variables...
+		-System Variables pane: Select and edit "PATH"
+		-Add new entries below assuming you used default location for minGW
+			C:\MinGW\bin
+			C:\MinGW\msys\1.0\bin
+	
+Now host app can be built from windows command prompt command make when in host directory
+
+FIRMWARE:
+Download and Install WinAVR
+http://www.webring.org/l/rd?ring=avr;id=59;url=http%3A%2F%2Fwinavr%2Esourceforge%2Enet%2Findex%2Ehtml  
+	optional: install programmer's notepad has handy feature to make clean, all, program in tools menu
+		this is nifty if you are scared of the command prompt for some strange reason...
+	installation process should modify PATH environment variables for you.
+	incase they don't add them just like MinGW above
+		C:\WinAVR-20100110\bin
+		C:\WinAVR-20100110\utils\bin
+
+Now firmware can be built from windows command prompt with command "make" when in firmware directory
+
+There is a bootloader installed on all "kazzo" INL retro programmer-dumper's which allows new firmware
+builds to be easily flashed on to the device without a avr programmer.
+Place BL/RUN switch in BL, then hit reset button in INL retro-prog
+from firmware folder run command "make program" this will flash target build onto device using bootloadHID.exe
+Take BL/RUN switch back to RUN and device will reset into INL retro-prog you just built.
+
+BOOTLOADER:
+If you wish to build bootloader for kazzo (shouldn't be necessary for most ppl) follow the following
+Requires you to have an avr programmer to reflash atmega164a mcu
+Helpful to download more recent version of avrdude than included with WinAVR.
+Download latest version with mingw32.zip from following link:
+http://download.savannah.gnu.org/releases/avrdude/
+unzip and copy paste both avrdude.exe and avrdude.conf to C:\WinAVR-20100110\bin directory
+Assuming the recent build still doesn't support atmega164a..
+You'll also have to add a definition for atmega164a in the avrdude.conf file
+Copy paste the atmega324P section and rename it atmega164A
+Then change the following lines to match:
+    id               = "m164a";
+    desc             = "ATmega164A";
+    signature        = 0x1e 0x94 0x0f;
+
+Now the bootloader can be built and flashed from the bootloadHID/firmware directory with make
+If trying to flash mcu from make file you'll have to modify AVRDUDE line to match your avr programmer
+Once completed you can make the bootloader and flash it with command "make flash"
+
+