Add some brief documentation or how to

[matronator]

It would be good to have some instructions on how to install and use it. Might reduce the number of issues submitted.

[Masamune3210]

the script pretty much walks you through everything and will tell you how to fix detected issues so I don't see this as required

[matronator]

Which script though. There's like 4 of them, plus the Scripts folder

[Wondrous27]

Download the folder and unzip it. Then, using your terminal go the unzipped folder. In the terminal type ./gibMacOS.command and follow the instructions.

[gquiring]

the script pretty much walks you through everything and will tell you how to fix detected issues so I don't see this as required

I don't see how the script walks you through creating bootable media. So I selected option 1 for Monterey 10.1. It downloaded a bunch of files, so now how do I create an ISO for VMware?

M. Change Max-OS Version (Currently 10.15)
C. Change Catalog (Currently publicrelease)
I. Only Print URLs (Currently False)
S. Set Current Catalog to SoftwareUpdate Catalog
L. Clear SoftwareUpdate Catalog
R. Toggle Recovery-Only (Currently Off)
U. Show Catalog URL
Q. Quit

[MarkGotLasagna]

I also fail to understand what am I supposed to do with these files.

How do I bundle them into an ISO file?

[corpnewt]

Worth noting that gibMacOS's MakeInstall script is mostly defunct as of the advent of Acidanthera's macrecovery.py that's bundled with OpenCore. Apple changed how they distribute the OS with Big Sur - so the typical software update catalog no longer contains a recovery environment.

If you're using macOS - you can download the full OS installer via gibMacOS and just run InstallAssistant.pkg to copy the Install macOS [version].app to your /Applications folder.

As for changes regarding Windows - I did update MakeInstall some time ago to accept the BaseSystem.dmg from macrecovery.py if you experience issues loading the dmg directly via OpenCore. It will extract the file system from the .dmg using 7z, then dd it to the USB.

Regarding VMWare and other VMs, you're on your own with that - as it's not something I personally use or have plans to support.

-CorpNewt

[MarkGotLasagna]

Thank you for your quick reply.

I'm on arch linux, I now understand that this repository probably was not meant for my objective, or maybe it is?
I'm looking to install an iso, or convert dmg to vmdk, for a MacOS virtual machine hosted on VBox.

[corpnewt]

I'm no authority on VM setups regarding macOS - so I can't really give you any step-by-step approach for that. AFAIK OpenCore (or some similar boot manager) is needed though? If that's the case - you can just use the approach leveraged by those installing bare metal, and use macrecovery.py to download the BaseSystem.dmg|chunklist for whichever target OS, and place that in a com.apple.recovery.boot folder at the root of the primary FAT32 partition of the startup disk - which, I don't see why that couldn't be an iso in your case. OpenCore can dmg boot - which helps simplify things as well.

Again - take all of that info with a hefty grain of salt as it's not something in my wheelhouse - but without researching the topic first, that's what comes to mind.

-CorpNewt