From ce96314a333ee3877ac15a72f7a8f0aef15a8900 Mon Sep 17 00:00:00 2001
From: RoyalGraphX <39929362+royalgraphx@users.noreply.github.com>
Date: Mon, 26 Jun 2023 15:18:07 -0500
Subject: [PATCH] Complete Fetching BaseSystem Conversion!

---
 README.md                                     |  2 +-
 .../05-FetchingBaseSystem/00-Introduction.md  | 15 +++++-
 .../05-FetchingBaseSystem/01-macrecovery.md   | 46 ++++++++++++++++++-
 3 files changed, 60 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5160cb4..559fa1e 100644
--- a/README.md
+++ b/README.md
@@ -827,7 +827,7 @@ Used for exempting certain memory regions from OSes to use, mainly relevant for
 | Tool  | Status | Description | 
 | ----- | ----- | ----- |
 | [Python](https://www.python.org/downloads/) | Required | Needed as a dependency. |
-| [macrecovery]() | Required | Allows you to fetch RecoveryOS images. |
+| [macrecovery](https://github.com/royalgraphx/macrecovery) | Required | Allows you to fetch RecoveryOS images. |
 
 <br>
 <br>
diff --git a/docs/docs/05-FetchingBaseSystem/00-Introduction.md b/docs/docs/05-FetchingBaseSystem/00-Introduction.md
index e516c0a..6064f7c 100644
--- a/docs/docs/05-FetchingBaseSystem/00-Introduction.md
+++ b/docs/docs/05-FetchingBaseSystem/00-Introduction.md
@@ -3,4 +3,17 @@ layout: default
 title: Part 0 - Introduction
 parent: Fetching BaseSystem
 nav_order: 1
----
\ No newline at end of file
+---
+
+# Introduction / Overview
+
+We'll be using a tool included [OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) under Utilities called macrecovery. It's included in this repository. While I recommend getting the latest version of macOS available to you at the time, there is a chart on the next page which will allow you to select.
+
+Download the following tools needed for modifications.
+
+| Tool  | Status | Description | 
+| ----- | ----- | ----- |
+| [Python](https://www.python.org/downloads/) | Required | Needed as a dependency. |
+| [macrecovery](https://github.com/royalgraphx/macrecovery) | Required | Allows you to fetch RecoveryOS images. |
+
+## You can now continue to the next <a href="01-macrecovery.html">page</a>.
\ No newline at end of file
diff --git a/docs/docs/05-FetchingBaseSystem/01-macrecovery.md b/docs/docs/05-FetchingBaseSystem/01-macrecovery.md
index 5bfd1e2..b2ed7fe 100644
--- a/docs/docs/05-FetchingBaseSystem/01-macrecovery.md
+++ b/docs/docs/05-FetchingBaseSystem/01-macrecovery.md
@@ -5,4 +5,48 @@ parent: Fetching BaseSystem
 nav_order: 1
 ---
 
-<h1>You can now proceed to the <a href="../06-InstallingmacOS/">Installing macOS</a> section!</h1>
\ No newline at end of file
+# macrecovery
+
+Open a terminal and navigate to the directory containing the script files.
+
+For this example, we'll be getting the latest macOS Ventura:
+
+``python3 macrecovery.py -b Mac-4B682C642B45593E -m 00000000000000000 download``
+
+<p align="center">
+  <img src="../../assets/macrecovery.png">
+</p>
+
+Notice that it will then create a folder ``com.apple.recovery.boot``, which you will need to copy over to the root of the OpenCore .img mount point. Refer to the image above for an example. It does load slower this way, but will persist so you will always have it around, you can delete it after if you'd like. You can also use dmg2img to convert the BaseSystem.dmg to a BaseSystem.img you can then mount via Virt-Manager.
+
+## If you'd like to convert to an img
+
+If for whatever reason you'd like to mount this directly to the Virtual Machine, you'll have to convert the dmg to an img file. You can do this using ``dmg2img`` the following way
+
+``dmg2img -i BaseSystem.dmg BaseSystem.img``
+
+## List of downloadable BaseSystems
+
+```
+# High Sierra (10.13)
+python3 macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000J80300 download
+python3 macrecovery.py -b Mac-BE088AF8C5EB4FA2 -m 00000000000J80300 download
+
+# Mojave (10.14)
+python3 macrecovery.py -b Mac-7BA5B2DFE22DDD8C -m 00000000000KXPG00 download
+
+# Catalina (10.15)
+python3 macrecovery.py -b Mac-00BE6ED71E35EB86 -m 00000000000000000 download
+
+# Big Sur (11)
+python3 macrecovery.py -b Mac-42FD25EABCABB274 -m 00000000000000000 download
+
+# Monterey (12)
+python3 macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000000000 download
+
+# Latest version
+# ie. Ventura (13)
+python3 macrecovery.py -b Mac-4B682C642B45593E -m 00000000000000000 download
+```
+
+<h1>You can now proceed to the <a href="../06-InstallingmacOS/">Installing macOS</a> section!</h1>