diff --git a/Readme.md b/Readme.md
index 02a808f..c3ca26a 100644
--- a/Readme.md
+++ b/Readme.md
@@ -1,8 +1,31 @@
-Py2/py3 script that can download macOS components direct from Apple
+# gibmacOS scripts
 
-Can also now build Internet Recovery USB installers from Windows using [dd](http://www.chrysocome.net/dd) and [7zip](https://www.7-zip.org/download.html).
+## Guide
+The gibmacOS is a Python2/3 script that can download macOS components direct from Apple and create installers from it.
 
-Thanks to:
+To run this script simple issue the following command in your terminal:
+```
+./gibMacOS.command
+```
+
+This will give you a prompt to select the macOS version you wish to download. After downloading the correct version we can create an installer with:
+```
+./BuildmacOSInstallApp.command
+```
+
+Add the download folder as outputed by the first step. An installer will be added to your folder.
+
+You can now create bootable media for your version. For reference check out the official Apple documentation:
+https://support.apple.com/en-us/HT201372
+
+
+
+## Updates
+- This script can now also build Internet Recovery USB installers from Windows using [dd](http://www.chrysocome.net/dd) and [7zip](https://www.7-zip.org/download.html).
+
+
+
+## A special thanks goes out to:
 
 * FoxletFox for [FetchMacOS](http://www.insanelymac.com/forum/topic/326366-fetchmacos-a-tool-to-download-macos-on-non-mac-platforms/) and outlining the URL setup
 * munki for his [macadmin-scripts](https://github.com/munki/macadmin-scripts)