Skip to content

Commit

Permalink
Complete Fetching BaseSystem Conversion!
Browse files Browse the repository at this point in the history
  • Loading branch information
royalgraphx committed Jun 26, 2023
1 parent 83c1506 commit ce96314
Show file tree
Hide file tree
Showing 3 changed files with 60 additions and 3 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
15 changes: 14 additions & 1 deletion docs/docs/05-FetchingBaseSystem/00-Introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,17 @@ layout: default
title: Part 0 - Introduction
parent: Fetching BaseSystem
nav_order: 1
---
---

# 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>.
46 changes: 45 additions & 1 deletion docs/docs/05-FetchingBaseSystem/01-macrecovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>
# 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>

0 comments on commit ce96314

Please sign in to comment.