diff --git a/README.md b/README.md index 6ed8262..c459661 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ -## Semi-automatic installer of macOS on VirtualBox +## Push-button installer of macOS on VirtualBox This is a Bash script that creates a VirtualBox guest macOS virtual machine with unmodified macOS installation files downloaded directly from Apple servers. -The script is semi-automatic and requires a little user interaction. A default install only requires the user to sit patiently and, less than ten times, press enter when prompted. The script doesn't install any closed-source additions or extra bootloaders. Tested on Cygwin. Works on macOS and WSL, should work on most Linux distros. +The script requires very little user interaction. A default install only requires the user to sit patiently and, less than ten times, press enter when prompted. The script doesn't install any closed-source additions or extra bootloaders. Tested on Cygwin. Works on macOS and WSL, should work on most Linux distros. ### macOS Mojave (10.14) and High Sierra (10.13) currently supported #### macOS Catalina 10.15.2 and 10.15.3 fail to boot on VirtualBox @@ -14,14 +14,15 @@ Documentation can be viewed by executing the command `./macos-guest-virtualbox.s iCloud, iMessage, and other connected Apple services require a valid device name and serial number, board ID and serial number, and other genuine (or genuine-like) Apple parameters. These can be set in NVRAM by editing the script. See `documentation` for further information. ## Storage size -The script by default assigns a target virtual disk storage size of 80GB, which is populated to about 15GB on the host on initial installation. After the installation is complete, the storage size may be increased. See `documentation` for further information. +The script by default assigns a target virtual disk storage size of 80GB, which is populated to about 20GB on the host on initial installation. After the installation is complete, the storage size may be increased. See `documentation` for further information. ## Graphics controller Selecting VBoxSVGA instead of VBoxVGA for the graphics controller may considerably increase graphics performance. VBoxVGA is assigned by default for compatibility reasons. ## Performance and unsupported features -Developing and maintaining VirtualBox or macOS features is beyond the scope of this script. Some features may behave unexpectedly, such as USB device support, audio support, and other features. +Developing and maintaining VirtualBox or macOS features is beyond the scope of this script. Some features may behave unexpectedly, such as USB device support, audio support, FileVault boot password prompt support, and other features. +### Performance After successfully creating a working macOS virtual machine, consider importing it into QEMU/KVM so it can run with hardware passthrough at near-native performance. QEMU/KVM requires additional configuration that is beyond the scope of the script. ### Audio @@ -30,8 +31,6 @@ macOS may not support any built-in VirtualBox audio controllers. The bootloader ### FileVault The VirtualBox EFI implementation does not properly load the FileVault full disk encryption password prompt upon boot. The bootloader [OpenCore](https://github.com/acidanthera/OpenCorePkg/releases) may be able to load the password prompt. - - ## Dependencies * [VirtualBox](https://www.virtualbox.org/wiki/Downloads)≥6.0 with Extension Pack * `Bash`≥4.3 (GNU variant; run on Windows through [Cygwin](https://cygwin.com/install.html) or WSL)