Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added the code for enabling 1080p full screen resolution. #82

Open
wants to merge 64 commits into
base: cloverless
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
4514e34
Update ToC in README.md
yzgyyang Mar 12, 2019
c3fcd39
Merge pull request #59 from yzgyyang/patch-2
AlexanderWillner Mar 12, 2019
238ba21
Minor FAQ updates
AlexanderWillner Mar 12, 2019
db419ba
Comment on missing 3D support. Closes #64
AlexanderWillner Apr 6, 2019
79db106
How to get in recovery mode #60
AlexanderWillner Apr 6, 2019
8afc82b
Merge pull request #66 from AlexanderWillner/cloverless
AlexanderWillner Apr 6, 2019
bb407d7
Merge pull request #70 from AlexanderWillner/cloverless
AlexanderWillner Jun 4, 2019
ffd94b2
Merge branch 'master' of https://github.com/AlexanderWillner/runMacOS…
AlexanderWillner Jun 4, 2019
c751b90
cadded atalina screenshot
AlexanderWillner Jun 5, 2019
2959c27
Link to issue #71
AlexanderWillner Oct 6, 2019
aaa81fb
README updated with 'Installation Not Starting' issue.
dumol Oct 11, 2019
0e04893
Merge pull request #83 from dumol/readme-qa-installation-not-starting
AlexanderWillner Oct 11, 2019
c85d34c
README updated with improved instructions for accessing recovery.
dumol Oct 14, 2019
442ad4d
Further improved instructions for accessing recovery mode.
dumol Dec 17, 2019
ea08adf
Respect destination folder when creating VM
roamingthings Jan 19, 2020
4b872c1
Added download button
AlexanderWillner Jan 23, 2020
c5688c9
Create FUNDING.yml
AlexanderWillner Feb 15, 2020
e4ab1b3
Merge branch 'master' of https://github.com/AlexanderWillner/runMacOS…
AlexanderWillner Apr 9, 2020
7b3a842
working on #99
AlexanderWillner Apr 9, 2020
786bd41
fixed #99
AlexanderWillner Apr 9, 2020
4fb3a90
Merge pull request #97 from roamingthings/fix_vm_basefolder
AlexanderWillner Apr 9, 2020
d1dc14b
Merge pull request #85 from dumol/readme-qa-better-recovery-instructions
AlexanderWillner Apr 9, 2020
534fc81
cleanup: removed reference to 'ProgressDialog.app'
AlexanderWillner Apr 9, 2020
ef619db
Merge branch 'master' of https://github.com/AlexanderWillner/runMacOS…
AlexanderWillner Apr 9, 2020
216878f
fixed #104 and added information on how to download macOS
AlexanderWillner Apr 20, 2020
79e0eef
removed lint
AlexanderWillner May 8, 2020
56493d6
added pointer to installinstallmacos.py
AlexanderWillner May 8, 2020
00103cc
replace tool to download macos (for macOS Big Sur support)
AlexanderWillner Jun 23, 2020
027298f
replace tool to download macos (for macOS Big Sur support)
AlexanderWillner Jun 23, 2020
78ed3cb
forcing eject, added some 10.16 related comments
AlexanderWillner Jun 23, 2020
0800d56
fixing macOS 10.16 Big Sur #110
AlexanderWillner Jun 24, 2020
a9f054d
Setting board-id and serial from host / updates for macOS 10.16 Big S…
AlexanderWillner Jun 24, 2020
9a5f15c
added picture of macOS 10.16 Big Sur
AlexanderWillner Jun 24, 2020
21d152d
changes as by #111
AlexanderWillner Jun 29, 2020
d5547ba
adding icloud support #110
AlexanderWillner Jul 14, 2020
c5ac7d2
adding system information dynamically #110
AlexanderWillner Jul 18, 2020
3e452f0
added 'make download', removed time estimations, re-enabled disk crea…
AlexanderWillner Jul 18, 2020
6322b5c
fixing #108
AlexanderWillner Jul 19, 2020
5b1cdc7
It's macOS 11 not 10.16
indexerrowaty Jul 24, 2020
5c98053
Merge pull request #113 from Indexerrowaty/patch-1
AlexanderWillner Jul 24, 2020
2776aad
Increase installer volume size to 16Gb
vitalys Aug 18, 2020
049e263
Merge pull request #116 from vitalys/Increase_installer_volume_size
AlexanderWillner Aug 18, 2020
5a0efc0
fix for #117
AlexanderWillner Nov 5, 2020
a86702b
Update installinstallmacos.py
AlexanderWillner Nov 6, 2020
ae21e19
re-added big sur catalog
AlexanderWillner Nov 6, 2020
ccf8ced
Fix #118: clarify instructions
Blaisorblade Nov 15, 2020
f344abe
README.md: fix after fix of #104
Blaisorblade Nov 15, 2020
7da807d
Merge pull request #119 from Blaisorblade/patch-1
AlexanderWillner Nov 15, 2020
6e2a29d
Merge pull request #120 from Blaisorblade/patch-2
AlexanderWillner Nov 15, 2020
6759795
Merge branch 'master' of https://github.com/AlexanderWillner/runMacOS…
AlexanderWillner Dec 8, 2020
68610a1
fixed #123: describe DST_DIR parameter
AlexanderWillner Dec 8, 2020
76fe92d
script also supports big sur
AlexanderWillner Jan 2, 2021
cb825f4
delete empty folders to improve robustness #74
AlexanderWillner Jan 2, 2021
9715ad1
fixed #127
AlexanderWillner Apr 22, 2021
cb3fa94
fixing #130 - Initial run hangs on 'Start RandomSeed'
AlexanderWillner Aug 1, 2021
7b0d1c5
removed markdown lints
Oct 28, 2021
71567c1
upgraded downloader
Oct 28, 2021
9f126ad
updated badge
Oct 28, 2021
fcd3485
upgraded downloader
Oct 28, 2021
1e4c3fc
new brew command
Oct 28, 2021
b812b5a
fixing #107: disabled nested paging
Dec 21, 2021
3713b0c
Set VBoxInternal/TM/TSCMode to avoid Monterey guest kernel panics
Apr 28, 2022
497d596
Merge pull request #137 from keithwhite/fix_monterey_panics
AlexanderWillner Apr 28, 2022
95004ea
fix #138
Oct 19, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# These are supported funding model platforms

github: AlexanderWillner
custom: paypal.me/alexwillner
20 changes: 12 additions & 8 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,20 @@ about: Create a report to help us improve

---

**To Reproduce**
# To Reproduce

Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
1. Click on '....'
1. Scroll down to '....'
1. See error

# Expected behavior

**Expected behavior**
A clear and concise description of what you expected to happen.

**Additional context**
- log file (see ```~/Library/Logs/runMojaveVirtualbox.log``` that is accessible via ```Console.app```).
- screen shot
# Additional context

- log file (see ```~/Library/Logs/runMojaveVirtualbox.log``` / ```Console.app```).
- screen shot
4 changes: 4 additions & 0 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ SHELL=bash
help:
@echo "Some available commands:"
@echo " * all : run everything needed (check, installer, vm, patch, run, stop, eject)"
@echo " * download : download a macOS installer"
@echo " * check : check environment"
@echo " * installer: create macOS installer image"
@echo " * patch : add APFS drivers to VM EFI to boot"
Expand All @@ -25,6 +26,9 @@ help:
all:
@bash $(SCRIPT) all

download:
@bash $(SCRIPT) download

check:
@bash $(SCRIPT) check

Expand Down
96 changes: 58 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,38 +1,43 @@
# Run macOS 10.15 Catalina (and other versions) in VirtualBox on macOS
# Run macOS 11 Big Sur (and other versions) in VirtualBox on macOS

## Overview

Simple script to automatically download, install and run macOS 10.15 Catalina (and other versions) in VirtualBox on macOS. Since VirtualBox does not support booting from APFS volumes, this script is copying the APFS EFI drivers automatically.
Simple script to automatically download, install and run macOS 11 Big Sur (and other versions) in VirtualBox on macOS. Since VirtualBox does not support booting from APFS volumes, this script is copying the APFS EFI drivers automatically.

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/722e2f9736844387b611945fb430d195)](https://app.codacy.com/app/AlexanderWillner/runMacOSinVirtualBox?utm_source=github.com&utm_medium=referral&utm_content=AlexanderWillner/runMacOSinVirtualBox&utm_campaign=Badge_Grade_Dashboard)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/c0cd95d620854cfcb8784ff066b1b1c1)](https://www.codacy.com/gh/AlexanderWillner/runMacOSinVirtualBox/dashboard?utm_source=github.com&utm_medium=referral&utm_content=AlexanderWillner/runMacOSinVirtualBox&utm_campaign=Badge_Grade) [![download](https://img.shields.io/github/downloads/AlexanderWillner/runMacOSinVirtualBox/total)](https://github.com/AlexanderWillner/runMacOSinVirtualBox/releases)

## ToC
![macosBigSurBeta1](./img/macosBigSurBeta1.png)

* [Quick Guide](#quick-guide)
* [Step by Step Guide](#step-by-step-guide)
* [Shell Hacker](#shell-hacker)
* [FAQ](#faq)
## ToC

- [Run macOS 11 Big Sur (and other versions) in VirtualBox on macOS](#run-macos-11-big-sur-and-other-versions-in-virtualbox-on-macos)
- [Overview](#overview)
- [ToC](#toc)
- [Required Software](#required-software)
- [Step by Step Video](#step-by-step-video)
- [Step by Step](#step-by-step)
- [Customizing your build](#customizing-your-build)
- [FAQ](#faq)

## Required Software
## Required Software

The following software is needed.

* macOS Installer
* VirtualBox
* VirtualBox Extension Pack (note: released under the Personal Use and Evaluation License)
- macOS Installer
- VirtualBox
- VirtualBox Extension Pack (note: released under the Personal Use and Evaluation License)

## Step by Step Video
Two minute summary video:

Two minute summary video (Catalina):

[![Short Summary Video](https://img.youtube.com/vi/WmETOgRuMx4/0.jpg)](https://youtu.be/WmETOgRuMx4)

## Step by Step

Execute ```make all``` to setup and run everything. After the installer reboots, press enter in the terminal to finish the installation.

```
```bash
$ make all
Running checks (around 1 second)....
Creating image '/Users/awi/VirtualBox VMs/macOS-VM.dmg' (around 20 seconds, version 14.2.2, will need sudo)....
Expand All @@ -53,18 +58,18 @@ Additionally the following parameters can be customized with environment variabl

| variable name | description | default value |
|---------------|-----------------------------------------------------|------------------------------|
| VM_NAME | name of the virtual machine | macOS-VM |
| VM_DIR | directory, where the virtual machine will be stored | HOME/VirtualBox VMs/$VM_NAME |
| VM_SIZE | the size of the hard disk | 32768 |
| DST_DIR | root directory, where the VM will be stored | $HOME/VirtualBox VMs/ |
| VM_NAME | name of the virtual machine | macOS-VM |
| VM_DIR | sub directory, where the VM will be stored | $DST_DIR/$VM_NAME |
| VM_SIZE | the size of the hard disk | 131072 |
| VM_RES | monitor resolution | 1680x1050 |
| VM_RAM | ram size in megabytes | 4096 |
| VM_VRAM | video ram size in megabytes | 128 |
| VM_CPU | number of cpu cores to allocate | 2 |


Execute ```make``` to get some help:

```
```bash
$ make
Some available commands:
* all : run everything needed (check, installer, vm, patch, run, stop, eject)
Expand All @@ -87,21 +92,36 @@ Some available commands:

## FAQ

* Error Message
* Q: I get the error code 2, 3, 4, or 6.
* A: You need to have some software components installed on your machine (VirtualBox, VirtualBox Extension Pack, awk). If you've installed http://brew.sh, the script will partly install these automatically. Otherwise, you need to install them manually.
* Reboot
* Q: I see the message ```MACH Reboot```. What should I do?
* A: The VM failed to restart. Restart manually.
* Installation Loop
* Q: After starting the installation the VM restarts and I see the installer again.
* A: You've to press enter in the terminal after the installer restarts.
* Kernel Panic
* Q: I see the message ```Error loading kernel cache (0x9)```. What should I do?
* A: This error is shown from time to time. Restart the VM.
* Black Screen
* Q: When I then boot I don't see anything, just a black screen. What should I do?
* A: Change the VM version in the settings from ```Mac OS X (64-bit)``` to ```macOS 10.13 High Sierra (64-bit)```
* Other Issue
* Q: Something is not working. What should I do?
* A: [Create a ticket](https://github.com/AlexanderWillner/runMacOSinVirtualBox/issues/new?template=bug_report.md)
- Download macOS
- Q: Where can I download macOS?
- A: Execute the script `installinstallmacos.py` - this produces a `dmg` file which you can open. Within this image you can find the `app` that should be copied to `/Applications`.
- Graphic Issues
- Q: Applications such as Apple Maps do not work as expected.
- A: There is currently no 3D acceleration, therefore some applications do not work.
- Recovery
- Q: How do I start the recovery mode?
- A: Start the VM as usual and be ready to press ```CMD+C``` when you see ```Trying to find a bootable device...``` to interrupt the regular boot process. At the following EFI shell prompt try to find the relevant volume holding ```boot.efi``` in a single randomly-named sub-directory of the root directory. So try to change the current volume by entering ```fs4:``` (or ```fs5:```, ```fs6:```, etc.), then enter ```cd TAB``` (where ```TAB``` is used to auto-complete the randomly-named sub-dir), then look for ```boot.efi``` in that dir. If existing, start Recovery by entering ```boot.efi```.
- Installation Loop
- Q: After starting the installation the VM restarts and I see the installer again.
- A: You've to press enter in the terminal after the installer restarts.
- Installation Not Starting
- Q: I've pressed ```Continue``` to start the installation and nothing happens for minutes.
- A: Your macOS installer might be incomplete or corrupted, please download it again from Apple.
- Error Message
- Q: I get the error code 2, 3, 4, or 6.
- A: You need to have some software components installed on your machine (VirtualBox, VirtualBox Extension Pack, awk). If you've installed [Homebrew](https://brew.sh), the script will partly install these automatically. Otherwise, you need to install them manually.
- Reboot
- Q: I see the message ```MACH Reboot```. What should I do?
- A: The VM failed to restart. Restart manually. However, this should not happen anymore with the latest version.
- Kernel Panic
- Q: I see the message ```Error loading kernel cache (0x9)```. What should I do?
- A: This error is shown from time to time. Restart the VM. However, this should not happen anymore with the latest version.
- Black Screen
- Q: When I then boot I don't see anything, just a black screen. What should I do?
- A: Change the VM version in the settings from ```Mac OS X (64-bit)``` to ```macOS 10.13 High Sierra (64-bit)```
- Slow
- Q: Why is the VM so slow?
- A: Maybe [#71](https://github.com/AlexanderWillner/runMacOSinVirtualBox/issues/71) provides some insights.
- Other Issue
- Q: Something is not working. What should I do?
- A: [Create a ticket](https://github.com/AlexanderWillner/runMacOSinVirtualBox/issues/new?template=bug_report.md)
Binary file added img/macosBigSurBeta1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/macosCatalinaBeta1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading