diff --git a/404.html b/404.html index 8f77d54181..d8cf83cb10 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - +

404

How did we get here?
Take me home.
- + diff --git a/ACCEL.html b/ACCEL.html index 7de758d6be..96cc792ee3 100644 --- a/ACCEL.html +++ b/ACCEL.html @@ -11,7 +11,7 @@ - + @@ -45,6 +45,6 @@ ⟶

- + diff --git a/BOOT.html b/BOOT.html index 42ae45e664..1917c37e3c 100644 --- a/BOOT.html +++ b/BOOT.html @@ -11,7 +11,7 @@ - + @@ -35,6 +35,6 @@ ⟶

- + diff --git a/BUILD.html b/BUILD.html index e530ca30d8..355615fc3b 100644 --- a/BUILD.html +++ b/BUILD.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/DEBUG.html b/DEBUG.html index b548ac71d5..14f943929c 100644 --- a/DEBUG.html +++ b/DEBUG.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/DONATE.html b/DONATE.html index f6ab3fe6ee..30b884d75c 100644 --- a/DONATE.html +++ b/DONATE.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/HOW.html b/HOW.html index cab6505a2b..f32e3c59ec 100644 --- a/HOW.html +++ b/HOW.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/ICNS.html b/ICNS.html index 016aa96a93..e6482b23ab 100644 --- a/ICNS.html +++ b/ICNS.html @@ -11,7 +11,7 @@ - + @@ -32,6 +32,6 @@ ⟶

- + diff --git a/INSTALLER.html b/INSTALLER.html index 5a65500b6e..7cf83a1b04 100644 --- a/INSTALLER.html +++ b/INSTALLER.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/ISSUES-HOLD.html b/ISSUES-HOLD.html index a6618caa17..d5682ed6d7 100644 --- a/ISSUES-HOLD.html +++ b/ISSUES-HOLD.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/LICENSE.html b/LICENSE.html index 98293861aa..eb00e76106 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -11,7 +11,7 @@ - + @@ -31,6 +31,6 @@ ⟶

- + diff --git a/MODELS.html b/MODELS.html index 71909c176d..5abda3948d 100644 --- a/MODELS.html +++ b/MODELS.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/MONTEREY-DROP.html b/MONTEREY-DROP.html index 6d630f03a1..c6b201e6a9 100644 --- a/MONTEREY-DROP.html +++ b/MONTEREY-DROP.html @@ -11,7 +11,7 @@ - + @@ -33,6 +33,6 @@ ⟶

- + diff --git a/PATCHEXPLAIN.html b/PATCHEXPLAIN.html index 8111763840..b6ff22f7ed 100644 --- a/PATCHEXPLAIN.html +++ b/PATCHEXPLAIN.html @@ -11,7 +11,7 @@ - + @@ -115,6 +115,6 @@

- + diff --git a/POST-INSTALL.html b/POST-INSTALL.html index 04823a203e..4f2063e035 100644 --- a/POST-INSTALL.html +++ b/POST-INSTALL.html @@ -11,7 +11,7 @@ - + @@ -38,6 +38,6 @@ ⟶

- + diff --git a/SONOMA-DROP.html b/SONOMA-DROP.html index 985d240caf..a708520991 100644 --- a/SONOMA-DROP.html +++ b/SONOMA-DROP.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/START.html b/START.html index 6810ea561b..608948c63f 100644 --- a/START.html +++ b/START.html @@ -11,7 +11,7 @@ - + @@ -24,6 +24,6 @@ ⟶

- + diff --git a/TERMS.html b/TERMS.html index c8a0c1ea33..ac64f919ec 100644 --- a/TERMS.html +++ b/TERMS.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/TESTED.html b/TESTED.html index ac4b9580dd..47b3cb3d21 100644 --- a/TESTED.html +++ b/TESTED.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/TROUBLESHOOTING.html b/TROUBLESHOOTING.html index 89230f03f7..2dc1551f28 100644 --- a/TROUBLESHOOTING.html +++ b/TROUBLESHOOTING.html @@ -11,7 +11,7 @@ - + @@ -20,12 +20,11 @@ (opens new window)

# Troubleshooting

Here are some common errors that users may experience while using this patcher:

# OpenCore Legacy Patcher not launching

If the application won't launch (e.g. icon will bounce in the Dock), try launching OCLP via Terminal by typing the following command, make sure you've moved the app to /Applications before this.

/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher
-

# Stuck on This version of Mac OS X is not supported on this platform or (🚫) Prohibited Symbol

This means macOS has detected an SMBIOS it does not support. To resolve this, ensure you're booting OpenCore before the macOS installer in the boot picker. Reminder that the option will be called EFI Boot.

Once you've booted OpenCore at least once, your hardware should now auto-boot it until either an NVRAM reset occurs, or you remove the drive with OpenCore installed.

However, if the 🚫 Symbol only appears after the boot process has already started (the bootscreen appears/verbose boot starts), it could mean that your USB drive has failed to pass macOS' integrity checks. To resolve this, create a new installer using a different USB drive (preferably of a different model.)

# Cannot boot macOS without the USB

By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs.

After installing macOS, OpenCore Legacy Patcher should automatically prompt you to install OpenCore onto the internal drive. However, if it doesn't show the prompt, you'll need to either manually transfer (opens new window) OpenCore to the internal drive's EFI or Build and Install again and select your internal drive.

Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.

# Infinite Recovery OS Booting

With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve this, simply uninstall OpenCore and reset NVRAM (opens new window).

# Stuck on boot after root patching

Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up) -Go into terminal and type the following:

mount -uw /Volumes/Macintosh\ HD
-bless --mount /Volumes/Macintosh\ HD --bootefi -last-sealed-snapshot
-

If your disk name is something else than "Macintosh HD", make sure to change the path accordingly.

Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.

# Reboot when entering Hibernation (Sleep Wake Failure)

Known issue on some models (opens new window), a temporary fix is to disable Hibernation by executing the following command in the terminal:

sudo pmset -a hibernatemode 0
+

# Stuck on This version of Mac OS X is not supported on this platform or (🚫) Prohibited Symbol

This means macOS has detected an SMBIOS it does not support. To resolve this, ensure you're booting OpenCore before the macOS installer in the boot picker. Reminder that the option will be called EFI Boot.

Once you've booted OpenCore at least once, your hardware should now auto-boot it until either an NVRAM reset occurs, or you remove the drive with OpenCore installed.

However, if the 🚫 Symbol only appears after the boot process has already started (the bootscreen appears/verbose boot starts), it could mean that your USB drive has failed to pass macOS' integrity checks. To resolve this, create a new installer using a different USB drive (preferably of a different model.)

# Cannot boot macOS without the USB

By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs.

After installing macOS, OpenCore Legacy Patcher should automatically prompt you to install OpenCore onto the internal drive. However, if it doesn't show the prompt, you'll need to either manually transfer (opens new window) OpenCore to the internal drive's EFI or Build and Install again and select your internal drive.

Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.

# Infinite Recovery OS Booting

With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve this, simply uninstall OpenCore and reset NVRAM (opens new window).

# Stuck on boot after root patching

Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up)

Go into terminal and first mount the disk by typing

mount -uw "/Volumes/Macintosh HD"
+

Then revert the snapshot (if your disk name is something else than "Macintosh HD", make sure to change the path accordingly)

bless --mount "/Volumes/Macintosh HD" --bootefi -last-sealed-snapshot
+

Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.

# Reboot when entering Hibernation (Sleep Wake Failure)

Known issue on some models (opens new window), a temporary fix is to disable Hibernation by executing the following command in the terminal:

sudo pmset -a hibernatemode 0
 

# How to Boot Recovery through OpenCore Legacy Patcher

By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the Spacebar key while inside OpenCore's Picker to list all boot options.

# Stuck on "Your Mac needs a firmware update"

Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."

This error occurs when macOS determines that the current firmware does not have full APFS support. To resolve this, when installing OpenCore, head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show support for full APFS capabilities.

# No Brightness Control

With OCLP v0.0.22, we've added support for brightness control on many models. However, some users may have noticed that their brightness keys do not work.

As a work-around, we recommend users try out the below app:

# Cannot connect Wi-Fi on Monterey with legacy cards

With OCLP v0.2.5, we've added support for legacy Wi-Fi on Monterey. However, some users may have noticed that they can't connect to wireless networks.

To work-around this, we recommend that users manually connect using the "Other" option in the Wi-Fi menu bar or manually adding the network in the "Network" preference pane.

# No Graphics Acceleration

In macOS, GPU drivers are often dropped from the OS with each major release of it. With macOS Big Sur, currently, all non-Metal GPUs require additional patches to gain acceleration. In addition, macOS Monterey removed Graphics Drivers for both Intel Ivy Bridge and NVIDIA Kepler graphics processors.

If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after the first boot from installation of macOS. If you need to do this manually, you can do so within the patcher app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.

# Black Screen on MacBookPro11,3 in macOS Monterey

Due to Apple dropping NVIDIA Kepler support in macOS Monterey, MacBookPro11,3's GMUX has difficulties switching back to the iGPU to display macOS correctly. (opens new window) To work-around this issue, boot the MacBookPro11,3 in Safe Mode and once macOS is installed, run OCLP's Post Install Root Patches to enable GPU Acceleration for the NVIDIA dGPU.

# No DisplayPort Output on Mac Pros with NVIDIA Kepler

If you're having trouble with DisplayPort output on Mac Pros, try enabling Minimal Spoofing in Settings -> SMBIOS Settings and rebuild/install OpenCore. This will trick macOS drivers into thinking you have a newer MacPro7,1 and resolve the issue.

# Volume Hash Mismatch Error in macOS Monterey

A semi-common popup some users face is the "Volume Hash Mismatch" error:

What this error signifies is that the OS detects that the boot volume's hash does not match what the OS is expecting, this error is generally cosmetic and can be ignored. However if your system starts to crash spontaneously shortly after, you'll want to reinstall macOS fresh without importing any data at first.

Additionally, it can help to disable FeatureUnlock in Settings -> Misc Settings as this tool can be strenuous on systems with weaker memory stability.

# Cannot Disable SIP in recoveryOS

With OCLP, the patcher will always overwrite the current SIP value on boot to ensure that users don't brick an installation after an NVRAM reset. However, for users wanting to disable SIP entirely, this can be done easily.

Head into the GUI, go to Patcher Settings, and toggle the bits you need disabled from SIP:

SIP Enabled SIP Lowered (Root Patching) SIP Disabled

# Intermediate issues with USB 1.1 and Bluetooth on MacPro3,1 - MacPro5,1

For those experiencing issues with USB 1.1 devices (such as mice, keyboards and bluetooth chipsets), macOS Big Sur and newer have weakened OS-side reliability for the UHCI controller in older Mac Pros.

Because of this, we recommend placing a USB 2.0/3.0 hub between your devices and the port on the Mac Pro. UHCI and EHCI cannot both be used at once, so using a USB hub will always force the EHCI controller on.

# Stuck on "Less than a minute remaining..."

A common area for systems to get "stuck", namely for units that are missing the AES CPU instruction/older mobile hardware. During this stage, a lot of heavy cryptography is performed, which can make systems appear to be stuck. In reality they are working quite hard to finish up the installation.

Because this step can take a few hours or more depending on drive speeds, be patient at this stage and do not manually power off or reboot your machine as this will break the installation and require you to reinstall. If you think your system has stalled, press the Caps Lock key. If the light turns on, your system is busy and not actually frozen.

# No acceleration after a Metal GPU swap on Mac Pro

If you finished installing Monterey with the original card installed (to see bootpicker for example) and swapped your GPU to a Metal supported one, you may notice that you're missing acceleration. To fix this, open OCLP and revert root patches to get your Metal-supported GPU work again.

Alternatively, you can remove "AutoPkg-Assets.pkg" from /Library/Packages on the USB drive before proceeding with the installation. To see the folder, enable hidden files with Command + Shift + .

The reason for this is that the autopatcher will assume that you will be using the original graphics card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate after swapping.

# Keyboard, Mouse and Trackpad not working in installer or after update

For Macs using legacy USB 1.1 controllers, OpenCore Legacy Patcher can only restore support once it has performed root volume patches. Thus to install macOS, you need to hook up a USB hub between your Mac and Keyboard/Mouse.

More information can be found here:

Applicable models include:

Family Year Model Notes
MacBook Mid 2010 and older MacBook5,1 - MacBook7,1
MacBook Air Late 2010 and older MacBookAir2,1 - MacBookAir3,x
MacBook Pro Mid 2010 and older MacBookPro4,1 - MacBookPro7,x Excludes Mid 2010 15" and 17" (MacBookPro6,x)
iMac Late 2009 and older iMac7,1 - iMac10,x Excludes Core i5/7 27" late 2009 iMac (iMac11,1)
Mac mini Mid 2011 and older Macmini3,1 - Macmini5,x
Mac Pro Mid 2010 and older MacPro3,1 - MacPro5,1

- + diff --git a/UNINSTALL.html b/UNINSTALL.html index c78f162740..7d8f77b10d 100644 --- a/UNINSTALL.html +++ b/UNINSTALL.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/UNIVERSALCONTROL.html b/UNIVERSALCONTROL.html index 8a9a889db2..19056890c8 100644 --- a/UNIVERSALCONTROL.html +++ b/UNIVERSALCONTROL.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/UPDATE.html b/UPDATE.html index 8f5ad636bf..dbf210667a 100644 --- a/UPDATE.html +++ b/UPDATE.html @@ -11,7 +11,7 @@ - + @@ -32,6 +32,6 @@ ⟶

- + diff --git a/VENTURA-DROP.html b/VENTURA-DROP.html index c4d81c0285..7b5ae49238 100644 --- a/VENTURA-DROP.html +++ b/VENTURA-DROP.html @@ -11,7 +11,7 @@ - + @@ -33,6 +33,6 @@ ⟶

- + diff --git a/WINDOWS.html b/WINDOWS.html index dc59c70a1a..98d3fc244a 100644 --- a/WINDOWS.html +++ b/WINDOWS.html @@ -11,7 +11,7 @@ - + @@ -33,6 +33,6 @@ ⟶

- + diff --git a/assets/js/10.685a8aaf.js b/assets/js/10.3be01ffa.js similarity index 82% rename from assets/js/10.685a8aaf.js rename to assets/js/10.3be01ffa.js index a6f9d1d948..12083df7a2 100644 --- a/assets/js/10.685a8aaf.js +++ b/assets/js/10.3be01ffa.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[10],{318:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Main-Menu.40fc1dad.png"},381:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Build-Start.61964260.png"},382:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Build-Finished.8fc0d8ea.png"},383:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-EFI-Select-Disk.d9a3392f.png"},384:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-EFI-Select-Partition.131e5d28.png"},453:function(t,e,a){"use strict";a.r(e);var n=a(25),i=Object(n.a)({},(function(){var t=this,e=t.$createElement,n=t._self._c||e;return n("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[n("h1",{attrs:{id:"building-and-installing-opencore"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#building-and-installing-opencore"}},[t._v("#")]),t._v(" Building and installing OpenCore")]),t._v(" "),n("p",[t._v("Now that we have a macOS installer, let's now build our OpenCore configuration!")]),t._v(" "),n("p",[t._v("If you haven't downloaded OpenCore Patcher yet, do so now:")]),t._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[t._v("OpenCore Legacy Patcher Releases"),n("OutboundLink")],1)])]),t._v(" "),n("p",[t._v("Next, run the "),n("code",[t._v("OpenCore-Patcher.app")]),t._v(":")]),t._v(" "),n("p",[n("img",{attrs:{src:a(318),alt:""}})]),t._v(" "),n("div",{staticClass:"custom-block warning"},[n("p",{staticClass:"custom-block-title"},[t._v("WARNING")]),t._v(" "),n("p",[t._v("OpenCore configurations are hardware specific.\nIf you're building OpenCore for a different model than you're currently running, it is absolutely necessary to select the proper model from Settings.")])]),t._v(" "),n("p",[t._v("Here we'll select Build and Install OpenCore and start building:")]),t._v(" "),n("table",[n("thead",[n("tr",[n("th",{staticStyle:{"text-align":"left"}},[t._v("Start Building")]),t._v(" "),n("th",{staticStyle:{"text-align":"left"}},[t._v("Finished Building")])])]),t._v(" "),n("tbody",[n("tr",[n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(381),alt:""}})]),t._v(" "),n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(382),alt:"OCLP GUI Build Finished"}})])])])]),t._v(" "),n("p",[t._v("Once it finishes building, you'll want to select the Install OpenCore button:")]),t._v(" "),n("ul",[n("li",[t._v("If you created a macOS USB manually and don't see it listed, make sure it's either formatted as GUID/GPT or has a FAT32 partition for OpenCore to reside on.")])]),t._v(" "),n("table",[n("thead",[n("tr",[n("th",{staticStyle:{"text-align":"left"}},[t._v("Select Drive")]),t._v(" "),n("th",{staticStyle:{"text-align":"left"}},[t._v("Select Partition")])])]),t._v(" "),n("tbody",[n("tr",[n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(383),alt:""}})]),t._v(" "),n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(384),alt:""}})])])])]),t._v(" "),n("h1",{attrs:{id:"once-finished-head-to-booting-opencore-and-macos"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#once-finished-head-to-booting-opencore-and-macos"}},[t._v("#")]),t._v(" Once finished, head to "),n("RouterLink",{attrs:{to:"/BOOT.html"}},[t._v("Booting OpenCore and macOS")])],1)])}),[],!1,null,null,null);e.default=i.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[10],{318:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Main-Menu.40fc1dad.png"},391:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Build-Start.61964260.png"},392:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-Build-Finished.8fc0d8ea.png"},393:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-EFI-Select-Disk.d9a3392f.png"},394:function(t,e,a){t.exports=a.p+"assets/img/OCLP-GUI-EFI-Select-Partition.131e5d28.png"},457:function(t,e,a){"use strict";a.r(e);var n=a(25),i=Object(n.a)({},(function(){var t=this,e=t.$createElement,n=t._self._c||e;return n("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[n("h1",{attrs:{id:"building-and-installing-opencore"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#building-and-installing-opencore"}},[t._v("#")]),t._v(" Building and installing OpenCore")]),t._v(" "),n("p",[t._v("Now that we have a macOS installer, let's now build our OpenCore configuration!")]),t._v(" "),n("p",[t._v("If you haven't downloaded OpenCore Patcher yet, do so now:")]),t._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[t._v("OpenCore Legacy Patcher Releases"),n("OutboundLink")],1)])]),t._v(" "),n("p",[t._v("Next, run the "),n("code",[t._v("OpenCore-Patcher.app")]),t._v(":")]),t._v(" "),n("p",[n("img",{attrs:{src:a(318),alt:""}})]),t._v(" "),n("div",{staticClass:"custom-block warning"},[n("p",{staticClass:"custom-block-title"},[t._v("WARNING")]),t._v(" "),n("p",[t._v("OpenCore configurations are hardware specific.\nIf you're building OpenCore for a different model than you're currently running, it is absolutely necessary to select the proper model from Settings.")])]),t._v(" "),n("p",[t._v("Here we'll select Build and Install OpenCore and start building:")]),t._v(" "),n("table",[n("thead",[n("tr",[n("th",{staticStyle:{"text-align":"left"}},[t._v("Start Building")]),t._v(" "),n("th",{staticStyle:{"text-align":"left"}},[t._v("Finished Building")])])]),t._v(" "),n("tbody",[n("tr",[n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(391),alt:""}})]),t._v(" "),n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(392),alt:"OCLP GUI Build Finished"}})])])])]),t._v(" "),n("p",[t._v("Once it finishes building, you'll want to select the Install OpenCore button:")]),t._v(" "),n("ul",[n("li",[t._v("If you created a macOS USB manually and don't see it listed, make sure it's either formatted as GUID/GPT or has a FAT32 partition for OpenCore to reside on.")])]),t._v(" "),n("table",[n("thead",[n("tr",[n("th",{staticStyle:{"text-align":"left"}},[t._v("Select Drive")]),t._v(" "),n("th",{staticStyle:{"text-align":"left"}},[t._v("Select Partition")])])]),t._v(" "),n("tbody",[n("tr",[n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(393),alt:""}})]),t._v(" "),n("td",{staticStyle:{"text-align":"left"}},[n("img",{attrs:{src:a(394),alt:""}})])])])]),t._v(" "),n("h1",{attrs:{id:"once-finished-head-to-booting-opencore-and-macos"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#once-finished-head-to-booting-opencore-and-macos"}},[t._v("#")]),t._v(" Once finished, head to "),n("RouterLink",{attrs:{to:"/BOOT.html"}},[t._v("Booting OpenCore and macOS")])],1)])}),[],!1,null,null,null);e.default=i.exports}}]); \ No newline at end of file diff --git a/assets/js/12.94eb9dfd.js b/assets/js/12.fc14094b.js similarity index 93% rename from assets/js/12.94eb9dfd.js rename to assets/js/12.fc14094b.js index c70db4f110..fd6efb3c35 100644 --- a/assets/js/12.94eb9dfd.js +++ b/assets/js/12.fc14094b.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{321:function(e,t,o){e.exports=o.p+"assets/img/mountefi.f1bedccd.png"},385:function(e,t,o){e.exports=o.p+"assets/img/ocdebugimage.f846d5a0.png"},386:function(e,t,o){e.exports=o.p+"assets/img/logs-efi.c416d33f.png"},454:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"how-to-debug-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-debug-with-opencore"}},[e._v("#")]),e._v(" How to debug with OpenCore")]),e._v(" "),r("p",[e._v("For those who've hit an odd bug and are unsure if it's user error or within the patcher, we recommend asking on the "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),r("OutboundLink")],1),e._v(" for help.")]),e._v(" "),r("h2",{attrs:{id:"debugging-yourself"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#debugging-yourself"}},[e._v("#")]),e._v(" Debugging yourself")]),e._v(" "),r("p",[e._v("The easiest way to debug yourself is via Patcher Settings. Here there are many different settings, however, the 3 main options that will help are:")]),e._v(" "),r("ul",[r("li",[e._v('"Enable Verbose Mode"')]),e._v(" "),r("li",[e._v('"Enable OpenCore DEBUG"')]),e._v(" "),r("li",[e._v('"Enable Kext DEBUG"')])]),e._v(" "),r("p",[r("img",{attrs:{src:o(385),alt:""}})]),e._v(" "),r("p",[e._v("When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.")]),e._v(" "),r("h2",{attrs:{id:"obtaining-opencore-logs-from-disk"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-opencore-logs-from-disk"}},[e._v("#")]),e._v(" Obtaining OpenCore logs from disk")]),e._v(" "),r("p",[e._v('With "Enable OpenCore DEBUG" set, on every boot there will be a .txt file generated on the EFI Partition. To grab these logs, '),r("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("download and run MountEFI"),r("OutboundLink")],1),e._v(":")]),e._v(" "),r("p",[r("img",{attrs:{src:o(321),alt:""}})]),e._v(" "),r("p",[e._v("Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(386),alt:""}})]),e._v(" "),r("h2",{attrs:{id:"obtaining-kernel-logs-from-macos"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-kernel-logs-from-macos"}},[e._v("#")]),e._v(" Obtaining Kernel logs from macOS")]),e._v(" "),r("p",[e._v('With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:')]),e._v(" "),r("div",{staticClass:"language-sh extra-class"},[r("pre",{pre:!0,attrs:{class:"language-sh"}},[r("code",[r("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token function"}},[e._v("dmesg")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" ~/Desktop/DMESG.txt\n")])])]),r("p",[e._v("From there, you'll have a log on your desktop.")]),e._v(" "),r("h2",{attrs:{id:"filing-an-issue-with-us"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#filing-an-issue-with-us"}},[e._v("#")]),e._v(" Filing an issue with us")]),e._v(" "),r("div",{staticClass:"custom-block warning"},[r("p",{staticClass:"custom-block-title"},[e._v("WARNING")]),e._v(" "),r("p",[e._v("Currently issues have been disabled due to "),r("RouterLink",{attrs:{to:"/ISSUES-HOLD.html"}},[e._v("current events")]),e._v(". You can continue to receive support in the "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),r("OutboundLink")],1),e._v(", where there are active members of the community available.")],1)]),e._v(" "),r("p",[e._v("Now that you have proper logs, you can now "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1),e._v(". This is a reminder to include the following info:")]),e._v(" "),r("ul",[r("li",[e._v("Model that you're patching for (ie. MacBookPro10,1)")]),e._v(" "),r("li",[e._v("Target OS (ie. macOS 11.2.3)")]),e._v(" "),r("li",[e._v("Host OS (ie. macOS 10.15.7)")]),e._v(" "),r("li",[e._v("Upload of your OpenCore Build Folder")]),e._v(" "),r("li",[e._v("Upload of your OpenCore log (if applicable)")]),e._v(" "),r("li",[e._v("Upload of your Kernel log (if applicable)")])]),e._v(" "),r("p",[e._v("Additionally, please search to see if the issue has been reported before. This avoids having duplicate issues.")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{321:function(e,t,o){e.exports=o.p+"assets/img/mountefi.f1bedccd.png"},375:function(e,t,o){e.exports=o.p+"assets/img/ocdebugimage.f846d5a0.png"},376:function(e,t,o){e.exports=o.p+"assets/img/logs-efi.c416d33f.png"},452:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"how-to-debug-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-debug-with-opencore"}},[e._v("#")]),e._v(" How to debug with OpenCore")]),e._v(" "),r("p",[e._v("For those who've hit an odd bug and are unsure if it's user error or within the patcher, we recommend asking on the "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),r("OutboundLink")],1),e._v(" for help.")]),e._v(" "),r("h2",{attrs:{id:"debugging-yourself"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#debugging-yourself"}},[e._v("#")]),e._v(" Debugging yourself")]),e._v(" "),r("p",[e._v("The easiest way to debug yourself is via Patcher Settings. Here there are many different settings, however, the 3 main options that will help are:")]),e._v(" "),r("ul",[r("li",[e._v('"Enable Verbose Mode"')]),e._v(" "),r("li",[e._v('"Enable OpenCore DEBUG"')]),e._v(" "),r("li",[e._v('"Enable Kext DEBUG"')])]),e._v(" "),r("p",[r("img",{attrs:{src:o(375),alt:""}})]),e._v(" "),r("p",[e._v("When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.")]),e._v(" "),r("h2",{attrs:{id:"obtaining-opencore-logs-from-disk"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-opencore-logs-from-disk"}},[e._v("#")]),e._v(" Obtaining OpenCore logs from disk")]),e._v(" "),r("p",[e._v('With "Enable OpenCore DEBUG" set, on every boot there will be a .txt file generated on the EFI Partition. To grab these logs, '),r("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("download and run MountEFI"),r("OutboundLink")],1),e._v(":")]),e._v(" "),r("p",[r("img",{attrs:{src:o(321),alt:""}})]),e._v(" "),r("p",[e._v("Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(376),alt:""}})]),e._v(" "),r("h2",{attrs:{id:"obtaining-kernel-logs-from-macos"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-kernel-logs-from-macos"}},[e._v("#")]),e._v(" Obtaining Kernel logs from macOS")]),e._v(" "),r("p",[e._v('With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:')]),e._v(" "),r("div",{staticClass:"language-sh extra-class"},[r("pre",{pre:!0,attrs:{class:"language-sh"}},[r("code",[r("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token function"}},[e._v("dmesg")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" ~/Desktop/DMESG.txt\n")])])]),r("p",[e._v("From there, you'll have a log on your desktop.")]),e._v(" "),r("h2",{attrs:{id:"filing-an-issue-with-us"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#filing-an-issue-with-us"}},[e._v("#")]),e._v(" Filing an issue with us")]),e._v(" "),r("div",{staticClass:"custom-block warning"},[r("p",{staticClass:"custom-block-title"},[e._v("WARNING")]),e._v(" "),r("p",[e._v("Currently issues have been disabled due to "),r("RouterLink",{attrs:{to:"/ISSUES-HOLD.html"}},[e._v("current events")]),e._v(". You can continue to receive support in the "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),r("OutboundLink")],1),e._v(", where there are active members of the community available.")],1)]),e._v(" "),r("p",[e._v("Now that you have proper logs, you can now "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1),e._v(". This is a reminder to include the following info:")]),e._v(" "),r("ul",[r("li",[e._v("Model that you're patching for (ie. MacBookPro10,1)")]),e._v(" "),r("li",[e._v("Target OS (ie. macOS 11.2.3)")]),e._v(" "),r("li",[e._v("Host OS (ie. macOS 10.15.7)")]),e._v(" "),r("li",[e._v("Upload of your OpenCore Build Folder")]),e._v(" "),r("li",[e._v("Upload of your OpenCore log (if applicable)")]),e._v(" "),r("li",[e._v("Upload of your Kernel log (if applicable)")])]),e._v(" "),r("p",[e._v("Additionally, please search to see if the issue has been reported before. This avoids having duplicate issues.")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/20.812e4953.js b/assets/js/20.626bdffe.js similarity index 87% rename from assets/js/20.812e4953.js rename to assets/js/20.626bdffe.js index 0aa5821add..307baaec1d 100644 --- a/assets/js/20.812e4953.js +++ b/assets/js/20.626bdffe.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[20],{387:function(e,t,o){e.exports=o.p+"assets/img/oc-explained.d196cefa.png"},456:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"boot-process-with-opencore-legacy-patcher"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore-legacy-patcher"}},[e._v("#")]),e._v(" Boot Process with OpenCore Legacy Patcher")]),e._v(" "),r("p",[e._v('OpenCore Legacy Patcher itself is actually quite a "dumb" program. It essentially edits a config.plist file and moves files around, actually having little logic regarding the boot process. The real magic of OCLP is '),r("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),r("OutboundLink")],1),e._v(", our back-end, and what makes this patcher so powerful.")]),e._v(" "),r("h2",{attrs:{id:"boot-process-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore"}},[e._v("#")]),e._v(" Boot Process with OpenCore")]),e._v(" "),r("p",[e._v("To understand a bit more of how OpenCore is able to revive older Macs in such a native-like way, we need to go over "),r("em",[e._v("how")]),e._v(" OpenCore works with your Mac:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(387),alt:""}})])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[20],{377:function(e,t,o){e.exports=o.p+"assets/img/oc-explained.d196cefa.png"},454:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"boot-process-with-opencore-legacy-patcher"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore-legacy-patcher"}},[e._v("#")]),e._v(" Boot Process with OpenCore Legacy Patcher")]),e._v(" "),r("p",[e._v('OpenCore Legacy Patcher itself is actually quite a "dumb" program. It essentially edits a config.plist file and moves files around, actually having little logic regarding the boot process. The real magic of OCLP is '),r("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),r("OutboundLink")],1),e._v(", our back-end, and what makes this patcher so powerful.")]),e._v(" "),r("h2",{attrs:{id:"boot-process-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore"}},[e._v("#")]),e._v(" Boot Process with OpenCore")]),e._v(" "),r("p",[e._v("To understand a bit more of how OpenCore is able to revive older Macs in such a native-like way, we need to go over "),r("em",[e._v("how")]),e._v(" OpenCore works with your Mac:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(377),alt:""}})])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/24.cfda37b6.js b/assets/js/24.a4bb2286.js similarity index 97% rename from assets/js/24.cfda37b6.js rename to assets/js/24.a4bb2286.js index 49eca37b98..bd10c8e808 100644 --- a/assets/js/24.cfda37b6.js +++ b/assets/js/24.a4bb2286.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{455:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.a)({},(function(){var e=this,t=e.$createElement,a=e._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"supporting-the-patcher"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[e._v("#")]),e._v(" Supporting the patcher")]),e._v(" "),a("p",[e._v("OpenCore Legacy Patcher is a hobby project for us developers, and while we love helping out the community, it's very difficult for us to troubleshoot issues remotely. The best way for us to get to work on the patcher, fix issues and add enhancements is having the hardware in-hand. As a hobby project, neither of the main developers can afford to buy every legacy Mac to test on.")]),e._v(" "),a("p",[e._v("The best way to support us in all honesty is to donate any old hardware you no longer need, as this allows us to have machines to test locally and push fixes much faster. While we appreciate cash donations, this makes it much more difficult for us to handle as an organization.")]),e._v(" "),a("p",[e._v("Main sections of help we'd appreciate:")]),e._v(" "),a("ul",[a("li",[e._v("Donating any Mac you own\n"),a("ul",[a("li",[e._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])])]),e._v(" "),a("p",[e._v("Additionally, hardware info dumps are greatly beneficial for us to determine what patches a machine might need:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://github.com/khronokernel/IORegistryClone/blob/master/ioreg-210.zip?raw=true",target:"_blank",rel:"noopener noreferrer"}},[e._v("IORegistryExplorer"),a("OutboundLink")],1),e._v(" "),a("ul",[a("li",[a("code",[e._v("File -> SaveAs")]),e._v(" and open an issue on Github")]),e._v(" "),a("li",[e._v("Note: We want IOReg dumps of hardware not running on OpenCore, instead running a clean, officially supported OS by the machine")])])])]),e._v(" "),a("p",[e._v("If you have any legacy hardware you're willing to donate or want to buy us hardware, please reach out on our Discord server.")])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{453:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.a)({},(function(){var e=this,t=e.$createElement,a=e._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"supporting-the-patcher"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[e._v("#")]),e._v(" Supporting the patcher")]),e._v(" "),a("p",[e._v("OpenCore Legacy Patcher is a hobby project for us developers, and while we love helping out the community, it's very difficult for us to troubleshoot issues remotely. The best way for us to get to work on the patcher, fix issues and add enhancements is having the hardware in-hand. As a hobby project, neither of the main developers can afford to buy every legacy Mac to test on.")]),e._v(" "),a("p",[e._v("The best way to support us in all honesty is to donate any old hardware you no longer need, as this allows us to have machines to test locally and push fixes much faster. While we appreciate cash donations, this makes it much more difficult for us to handle as an organization.")]),e._v(" "),a("p",[e._v("Main sections of help we'd appreciate:")]),e._v(" "),a("ul",[a("li",[e._v("Donating any Mac you own\n"),a("ul",[a("li",[e._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])])]),e._v(" "),a("p",[e._v("Additionally, hardware info dumps are greatly beneficial for us to determine what patches a machine might need:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://github.com/khronokernel/IORegistryClone/blob/master/ioreg-210.zip?raw=true",target:"_blank",rel:"noopener noreferrer"}},[e._v("IORegistryExplorer"),a("OutboundLink")],1),e._v(" "),a("ul",[a("li",[a("code",[e._v("File -> SaveAs")]),e._v(" and open an issue on Github")]),e._v(" "),a("li",[e._v("Note: We want IOReg dumps of hardware not running on OpenCore, instead running a clean, officially supported OS by the machine")])])])]),e._v(" "),a("p",[e._v("If you have any legacy hardware you're willing to donate or want to buy us hardware, please reach out on our Discord server.")])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/5.90346ee5.js b/assets/js/5.2d014cc8.js similarity index 89% rename from assets/js/5.90346ee5.js rename to assets/js/5.2d014cc8.js index 21139edc3e..c2cb57220d 100644 --- a/assets/js/5.90346ee5.js +++ b/assets/js/5.2d014cc8.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[5],{321:function(e,o,t){e.exports=t.p+"assets/img/mountefi.f1bedccd.png"},388:function(e,o,t){e.exports=t.p+"assets/img/icnspack-folder.6cad9bdf.png"},389:function(e,o,t){e.exports=t.p+"assets/img/icnspack-done.9f84140f.png"},390:function(e,o,t){e.exports=t.p+"assets/img/graphics-download.7cc2642f.png"},391:function(e,o,t){e.exports=t.p+"assets/img/graphics-open.a92a70e2.png"},392:function(e,o,t){e.exports=t.p+"assets/img/icon-SL.e5bfa343.png"},393:function(e,o,t){e.exports=t.p+"assets/img/background-moved.bbb8b0fd.png"},394:function(e,o,t){e.exports=t.p+"assets/img/mac-icns-drive.4aaed978.png"},457:function(e,o,t){"use strict";t.r(o);var n=t(25),a=Object(n.a)({},(function(){var e=this,o=e.$createElement,n=e._self._c||o;return n("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[n("h1",{attrs:{id:"creating-custom-icons-for-opencore-and-mac-boot-picker"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#creating-custom-icons-for-opencore-and-mac-boot-picker"}},[e._v("#")]),e._v(" Creating custom icons for OpenCore and Mac Boot Picker")]),e._v(" "),n("p",[e._v("For users who want to customize their setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("Custom Mac Boot Picker icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#installing-updated-icons"}},[e._v("Installing updated icons")])])]),e._v(" "),n("h1",{attrs:{id:"custom-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-opencore-icons"}},[e._v("#")]),e._v(" Custom OpenCore icons")]),e._v(" "),n("p",[e._v("To generate custom OpenCore icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("Images in PNG format")]),e._v(" "),n("li",[e._v("Each image, with the following res:\n"),n("ul",[n("li",[e._v("Cursor — Mouse cursor (mandatory, up to 144x144).")]),e._v(" "),n("li",[e._v("Selected — Selected item (mandatory, 144x144).")]),e._v(" "),n("li",[e._v("Selector — Selecting item (mandatory, up to 144x40).")]),e._v(" "),n("li",[e._v("Left — Scrolling left (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("Right — Scrolling right (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("HardDrive — Generic OS (mandatory, 128x128).")]),e._v(" "),n("li",[e._v("Background — Centred background image. (Recommended max size 1920x1080)")]),e._v(" "),n("li",[e._v("Apple — Apple OS (128x128).")]),e._v(" "),n("li",[e._v("AppleRecv — Apple Recovery OS (128x128).")]),e._v(" "),n("li",[e._v("AppleTM — Apple Time Machine (128x128).")]),e._v(" "),n("li",[e._v("Windows — Windows (128x128).")]),e._v(" "),n("li",[e._v("Other — Custom entry (see "),n("a",{attrs:{href:"https://dortania.github.io/docs/latest/Configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Entries"),n("OutboundLink")],1),e._v(", 128x128).")]),e._v(" "),n("li",[e._v("ResetNVRAM — Reset NVRAM system action or tool (128x128).")]),e._v(" "),n("li",[e._v("Shell — Entry with UEFI Shell name for e.g. OpenShell (128x128).")]),e._v(" "),n("li",[e._v("Tool — Any other tool (128x128).")])])])]),e._v(" "),n("p",[e._v("Note, for each image we recommend having one of double the size. This ensures that icons are scaled correctly since .icns support dedicated images depending on HiDPI or not.")]),e._v(" "),n("p",[e._v("Once you have a custom image you want to use(for example, as a background), download the "),n("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("latest release of OpenCorePkg"),n("OutboundLink")],1),e._v(" and enter the "),n("code",[e._v("Utilities/icnspack/")]),e._v(" folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(388),alt:""}})]),e._v(" "),n("p",[e._v("Now "),n("code",[e._v("cd")]),e._v(" to this folder in terminal and run the following:")]),e._v(" "),n("div",{staticClass:"language-sh extra-class"},[n("pre",{pre:!0,attrs:{class:"language-sh"}},[n("code",[e._v("./icnspack Background.icns "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x1_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x2_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v("\n")])])]),n("p",[e._v("Once done, you'll see your custom icon generated in "),n("code",[e._v("icnspack")]),e._v("'s folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(389),alt:""}})]),e._v(" "),n("h1",{attrs:{id:"custom-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Custom Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Custom boot picker icons are much more complicated on Legacy Macs. On late 2013+ Macs, the "),n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")]),e._v(" method will work just fine. However, on many 2012 and older Macs, the icons generated will be incompatible with the firmware.")]),e._v(" "),n("p",[e._v("To generate legacy icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("A machine running macOS 10.4 through 10.11")]),e._v(" "),n("li",[e._v("Icon Composer.app (Requires Apple Developer Account for official download)\n"),n("ul",[n("li",[e._v("Users without a developer account can find mirrors here:\n"),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.6.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.6"),n("OutboundLink")],1)]),e._v(" "),n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.11.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.11"),n("OutboundLink")],1)])])])])]),e._v(" "),n("li",[e._v("PNG Image you wish to convert")])]),e._v(" "),n("p",[e._v("Head to "),n("a",{attrs:{href:"https://developer.apple.com/download/more/",target:"_blank",rel:"noopener noreferrer"}},[e._v("developer.apple's More Downloads page"),n("OutboundLink")],1),e._v(" and search for "),n("code",[e._v("Graphics Tools")]),e._v(" that is supported by your OS(note for 10.6 and older, the app is hidden inside "),n("code",[e._v("Developer Tools")]),e._v("):")]),e._v(" "),n("p",[n("img",{attrs:{src:t(390),alt:""}})]),e._v(" "),n("p",[e._v("Once downloaded, open the disk image and you'll find Icon Composer.app:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(391),alt:"Graphics Open"}})]),e._v(" "),n("p",[e._v("Now run the app and simply drag the images to each section as so:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(392),alt:""}})]),e._v(" "),n("p",[e._v("Now save and export the new icns file.")]),e._v(" "),n("h1",{attrs:{id:"installing-updated-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#installing-updated-icons"}},[e._v("#")]),e._v(" Installing updated icons")]),e._v(" "),n("p",[e._v('To install, please ensure that Vault was disabled when you built OpenCore. If you\'re unsure, simply rebuild OpenCore with the Patcher setting "Vault" set to false.')]),e._v(" "),n("ul",[n("li",[n("span",{staticStyle:{color:"red"}},[e._v(" Warning")]),e._v(": Editing your OpenCore EFI incorrectly can result in a bricked install. Please ensure you have a natively supported version of macOS installed to boot into in case of issues.")])]),e._v(" "),n("p",[e._v("Now that you've verified that you can edit OpenCore safely, you'll need to mount the drive that OpenCore is stored on. To do this, download "),n("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("MountEFI"),n("OutboundLink")],1),e._v(" and run it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(321),alt:""}})]),e._v(" "),n("p",[e._v("Select the drive you installed OpenCore to and mount it.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#updating-opencore-icons"}},[e._v("Updating OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("Updating Mac Boot Picker icons")])])]),e._v(" "),n("h3",{attrs:{id:"updating-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-icons"}},[e._v("#")]),e._v(" Updating OpenCore icons")]),e._v(" "),n("p",[e._v("Head to "),n("code",[e._v("EFI/OC/Resources/Image/")]),e._v(" on your drive and you'll see all the custom icons. For Background.icns, we need to ensure the file matches the theme OpenCore has set so we add the prefix "),n("code",[e._v("Modern")]),e._v(" to it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(393),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you should see your updated icon(s)!")]),e._v(" "),n("h3",{attrs:{id:"updating-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Updating Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Updating the Mac Boot Picker icons is actually quite simple. On the root of your drive, simply drop the icon into the root of the drive with the name "),n("code",[e._v(".VolumeIcon.icns")])]),e._v(" "),n("p",[n("img",{attrs:{src:t(394),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you'll see the new icon!")])])}),[],!1,null,null,null);o.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[5],{321:function(e,o,t){e.exports=t.p+"assets/img/mountefi.f1bedccd.png"},378:function(e,o,t){e.exports=t.p+"assets/img/icnspack-folder.6cad9bdf.png"},379:function(e,o,t){e.exports=t.p+"assets/img/icnspack-done.9f84140f.png"},380:function(e,o,t){e.exports=t.p+"assets/img/graphics-download.7cc2642f.png"},381:function(e,o,t){e.exports=t.p+"assets/img/graphics-open.a92a70e2.png"},382:function(e,o,t){e.exports=t.p+"assets/img/icon-SL.e5bfa343.png"},383:function(e,o,t){e.exports=t.p+"assets/img/background-moved.bbb8b0fd.png"},384:function(e,o,t){e.exports=t.p+"assets/img/mac-icns-drive.4aaed978.png"},455:function(e,o,t){"use strict";t.r(o);var n=t(25),a=Object(n.a)({},(function(){var e=this,o=e.$createElement,n=e._self._c||o;return n("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[n("h1",{attrs:{id:"creating-custom-icons-for-opencore-and-mac-boot-picker"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#creating-custom-icons-for-opencore-and-mac-boot-picker"}},[e._v("#")]),e._v(" Creating custom icons for OpenCore and Mac Boot Picker")]),e._v(" "),n("p",[e._v("For users who want to customize their setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("Custom Mac Boot Picker icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#installing-updated-icons"}},[e._v("Installing updated icons")])])]),e._v(" "),n("h1",{attrs:{id:"custom-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-opencore-icons"}},[e._v("#")]),e._v(" Custom OpenCore icons")]),e._v(" "),n("p",[e._v("To generate custom OpenCore icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("Images in PNG format")]),e._v(" "),n("li",[e._v("Each image, with the following res:\n"),n("ul",[n("li",[e._v("Cursor — Mouse cursor (mandatory, up to 144x144).")]),e._v(" "),n("li",[e._v("Selected — Selected item (mandatory, 144x144).")]),e._v(" "),n("li",[e._v("Selector — Selecting item (mandatory, up to 144x40).")]),e._v(" "),n("li",[e._v("Left — Scrolling left (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("Right — Scrolling right (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("HardDrive — Generic OS (mandatory, 128x128).")]),e._v(" "),n("li",[e._v("Background — Centred background image. (Recommended max size 1920x1080)")]),e._v(" "),n("li",[e._v("Apple — Apple OS (128x128).")]),e._v(" "),n("li",[e._v("AppleRecv — Apple Recovery OS (128x128).")]),e._v(" "),n("li",[e._v("AppleTM — Apple Time Machine (128x128).")]),e._v(" "),n("li",[e._v("Windows — Windows (128x128).")]),e._v(" "),n("li",[e._v("Other — Custom entry (see "),n("a",{attrs:{href:"https://dortania.github.io/docs/latest/Configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Entries"),n("OutboundLink")],1),e._v(", 128x128).")]),e._v(" "),n("li",[e._v("ResetNVRAM — Reset NVRAM system action or tool (128x128).")]),e._v(" "),n("li",[e._v("Shell — Entry with UEFI Shell name for e.g. OpenShell (128x128).")]),e._v(" "),n("li",[e._v("Tool — Any other tool (128x128).")])])])]),e._v(" "),n("p",[e._v("Note, for each image we recommend having one of double the size. This ensures that icons are scaled correctly since .icns support dedicated images depending on HiDPI or not.")]),e._v(" "),n("p",[e._v("Once you have a custom image you want to use(for example, as a background), download the "),n("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("latest release of OpenCorePkg"),n("OutboundLink")],1),e._v(" and enter the "),n("code",[e._v("Utilities/icnspack/")]),e._v(" folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(378),alt:""}})]),e._v(" "),n("p",[e._v("Now "),n("code",[e._v("cd")]),e._v(" to this folder in terminal and run the following:")]),e._v(" "),n("div",{staticClass:"language-sh extra-class"},[n("pre",{pre:!0,attrs:{class:"language-sh"}},[n("code",[e._v("./icnspack Background.icns "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x1_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x2_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v("\n")])])]),n("p",[e._v("Once done, you'll see your custom icon generated in "),n("code",[e._v("icnspack")]),e._v("'s folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(379),alt:""}})]),e._v(" "),n("h1",{attrs:{id:"custom-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Custom Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Custom boot picker icons are much more complicated on Legacy Macs. On late 2013+ Macs, the "),n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")]),e._v(" method will work just fine. However, on many 2012 and older Macs, the icons generated will be incompatible with the firmware.")]),e._v(" "),n("p",[e._v("To generate legacy icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("A machine running macOS 10.4 through 10.11")]),e._v(" "),n("li",[e._v("Icon Composer.app (Requires Apple Developer Account for official download)\n"),n("ul",[n("li",[e._v("Users without a developer account can find mirrors here:\n"),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.6.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.6"),n("OutboundLink")],1)]),e._v(" "),n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.11.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.11"),n("OutboundLink")],1)])])])])]),e._v(" "),n("li",[e._v("PNG Image you wish to convert")])]),e._v(" "),n("p",[e._v("Head to "),n("a",{attrs:{href:"https://developer.apple.com/download/more/",target:"_blank",rel:"noopener noreferrer"}},[e._v("developer.apple's More Downloads page"),n("OutboundLink")],1),e._v(" and search for "),n("code",[e._v("Graphics Tools")]),e._v(" that is supported by your OS(note for 10.6 and older, the app is hidden inside "),n("code",[e._v("Developer Tools")]),e._v("):")]),e._v(" "),n("p",[n("img",{attrs:{src:t(380),alt:""}})]),e._v(" "),n("p",[e._v("Once downloaded, open the disk image and you'll find Icon Composer.app:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(381),alt:"Graphics Open"}})]),e._v(" "),n("p",[e._v("Now run the app and simply drag the images to each section as so:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(382),alt:""}})]),e._v(" "),n("p",[e._v("Now save and export the new icns file.")]),e._v(" "),n("h1",{attrs:{id:"installing-updated-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#installing-updated-icons"}},[e._v("#")]),e._v(" Installing updated icons")]),e._v(" "),n("p",[e._v('To install, please ensure that Vault was disabled when you built OpenCore. If you\'re unsure, simply rebuild OpenCore with the Patcher setting "Vault" set to false.')]),e._v(" "),n("ul",[n("li",[n("span",{staticStyle:{color:"red"}},[e._v(" Warning")]),e._v(": Editing your OpenCore EFI incorrectly can result in a bricked install. Please ensure you have a natively supported version of macOS installed to boot into in case of issues.")])]),e._v(" "),n("p",[e._v("Now that you've verified that you can edit OpenCore safely, you'll need to mount the drive that OpenCore is stored on. To do this, download "),n("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("MountEFI"),n("OutboundLink")],1),e._v(" and run it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(321),alt:""}})]),e._v(" "),n("p",[e._v("Select the drive you installed OpenCore to and mount it.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#updating-opencore-icons"}},[e._v("Updating OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("Updating Mac Boot Picker icons")])])]),e._v(" "),n("h3",{attrs:{id:"updating-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-icons"}},[e._v("#")]),e._v(" Updating OpenCore icons")]),e._v(" "),n("p",[e._v("Head to "),n("code",[e._v("EFI/OC/Resources/Image/")]),e._v(" on your drive and you'll see all the custom icons. For Background.icns, we need to ensure the file matches the theme OpenCore has set so we add the prefix "),n("code",[e._v("Modern")]),e._v(" to it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(383),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you should see your updated icon(s)!")]),e._v(" "),n("h3",{attrs:{id:"updating-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Updating Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Updating the Mac Boot Picker icons is actually quite simple. On the root of your drive, simply drop the icon into the root of the drive with the name "),n("code",[e._v(".VolumeIcon.icns")])]),e._v(" "),n("p",[n("img",{attrs:{src:t(384),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you'll see the new icon!")])])}),[],!1,null,null,null);o.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/7.c439032f.js b/assets/js/7.abbbf277.js similarity index 87% rename from assets/js/7.c439032f.js rename to assets/js/7.abbbf277.js index bb0acec023..dc288b896e 100644 --- a/assets/js/7.c439032f.js +++ b/assets/js/7.abbbf277.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[7],{375:function(e,t,o){e.exports=o.p+"assets/img/efi-boot.8307f610.png"},376:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-1.ba0e58a4.png"},377:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-2.5e873f39.png"},378:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-3.79f71d03.png"},379:function(e,t,o){e.exports=o.p+"assets/img/oc-boot.3c2bdab5.png"},380:function(e,t,o){e.exports=o.p+"assets/img/oclp-stuck-firstreboot.12edd7b4.png"},452:function(e,t,o){"use strict";o.r(t);var s=o(25),n=Object(s.a)({},(function(){var e=this,t=e.$createElement,s=e._self._c||t;return s("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[s("h1",{attrs:{id:"booting-opencore-and-macos"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#booting-opencore-and-macos"}},[e._v("#")]),e._v(" Booting OpenCore and macOS")]),e._v(" "),s("p",[e._v("Now we finally get to boot OpenCore!")]),e._v(" "),s("p",[e._v("Reboot the machine while holding "),s("code",[e._v("Option")]),e._v(" to select the EFI Boot entry with the OpenCore icon (holding the "),s("code",[e._v("Control")]),e._v(" key will make this the default boot entry):")]),e._v(" "),s("ul",[s("li",[e._v("This will be the Mac Boot Picker")])]),e._v(" "),s("p",[s("img",{attrs:{src:o(375),alt:""}})]),e._v(" "),s("details",{staticClass:"custom-block details"},[s("summary",[e._v("Note for Mac Pros/Xserves/iMacs with unflashed GPUs")]),e._v(" "),s("p",[e._v("(Adapted from the "),s("a",{attrs:{href:"https://forums.macrumors.com/threads/opencore-on-the-mac-pro.2207814/",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore on the Mac Pro guide"),s("OutboundLink")],1),e._v(")")]),e._v(" "),s("p",[e._v("For Mac Pro, Xserve and, iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process.")]),e._v(" "),s("p",[e._v("Firstly, open the Terminal and run the following command:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[s("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" nvram "),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('"recovery-boot-mode=unused"')]),e._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v("&&")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("reboot")]),e._v(" recovery\n")])])]),s("p",[e._v("This will make your machine reboot into the Recovery Environment. Alternatively, holding "),s("code",[e._v("Command")]),e._v(" + "),s("code",[e._v("R")]),e._v(" when your machine is starting up will also let you enter the Recovery.")]),e._v(" "),s("p",[e._v("Secondly, open the Recovery Environment's Terminal (Menu bar > Utilities > Terminal).")]),e._v(" "),s("p",[e._v("Now you'll want to get a list of drive identifiers. To do so, run the following command:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("diskutil list\n")])])]),s("p",[e._v("The command should produce a list of drives installed in your system:\n"),s("img",{attrs:{src:o(376),alt:""}})]),e._v(" "),s("p",[e._v("Keep track of the drive with the OCLP install. You will need the drive identifer for later.")]),e._v(" "),s("p",[e._v("Now you'll want to mount the EFI partition (where OCLP is installed, though it may differ if you've installed OCLP to a FAT-32 volume).")]),e._v(" "),s("p",[e._v("Run the following command (Replace X with the drive number):")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("diskutil "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("mount")]),e._v(" diskXs1\n")])])]),s("p",[s("img",{attrs:{src:o(377),alt:""}}),e._v("\nIf everything is correct, the EFI partion should be mounted.")]),e._v(" "),s("p",[e._v("Now you'll want to use the "),s("code",[e._v("bless")]),e._v(" command to set the default boot device:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("bless --mount /Volumes/EFI --setBoot --file /Volumes/EFI/System/Library/CoreServices/boot.efi\n")])])]),s("p",[e._v("Once the command is run, it should produce no output.\n"),s("img",{attrs:{src:o(378),alt:""}})]),e._v(" "),s("p",[e._v("If the command produces an output, ensure that you've typed it in correctly.")]),e._v(" "),s("p",[e._v("Now you can reboot your machine. OCLP is now the default boot option!")])]),e._v(" "),s("p",[e._v('Now that you\'ve loaded OpenCore, "select Install macOS":')]),e._v(" "),s("ul",[s("li",[e._v("This will be the OpenCore Picker")])]),e._v(" "),s("p",[s("img",{attrs:{src:o(379),alt:""}})]),e._v(" "),s("p",[e._v("You will soon reach the installer screen! If you enabled verbose mode when building OCLP, a lot of text will run across the screen. From there, it's just like any normal macOS install. For an example of how the boot process looks, see the following video:")]),e._v(" "),s("ul",[s("li",[s("a",{attrs:{href:"https://www.youtube.com/watch?v=AN3zsbQV_n4",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Legacy Patcher Boot Process"),s("OutboundLink")],1)])]),e._v(" "),s("p",[e._v("If your Mac is looping back into the beginning of the setup after the first reboot, turn it off, start it again and hold "),s("code",[e._v("Option")]),e._v('. This time, select the option with a grey hard disk icon, it can say "macOS Installer" or the name you gave the disk during the installer process. Keep repeating this step after every reboot if necessary.')]),e._v(" "),s("p",[s("img",{attrs:{src:o(380),alt:""}})]),e._v(" "),s("div",{staticClass:"custom-block warning"},[s("p",{staticClass:"custom-block-title"},[e._v("WARNING")]),e._v(" "),s("p",[s("strong",[e._v("MacBookPro11,3 Note")]),e._v(": When booting macOS Monterey, you'll need to boot into safe mode if acceleration patches are not installed yet. "),s("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522",target:"_blank",rel:"noopener noreferrer"}},[e._v("Otherwise, you'll hit a black screen due to missing NVIDIA drivers."),s("OutboundLink")],1),e._v(" Safe Mode can be entered by holding "),s("code",[e._v("Shift + Enter")]),e._v(" when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),s("h1",{attrs:{id:"once-installed-and-booting-head-to-post-installation"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#once-installed-and-booting-head-to-post-installation"}},[e._v("#")]),e._v(" Once installed and booting, head to "),s("RouterLink",{attrs:{to:"/POST-INSTALL.html"}},[e._v("Post-Installation")])],1)])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[7],{385:function(e,t,o){e.exports=o.p+"assets/img/efi-boot.8307f610.png"},386:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-1.ba0e58a4.png"},387:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-2.5e873f39.png"},388:function(e,t,o){e.exports=o.p+"assets/img/Unflashed-Boot-3.79f71d03.png"},389:function(e,t,o){e.exports=o.p+"assets/img/oc-boot.3c2bdab5.png"},390:function(e,t,o){e.exports=o.p+"assets/img/oclp-stuck-firstreboot.12edd7b4.png"},456:function(e,t,o){"use strict";o.r(t);var s=o(25),n=Object(s.a)({},(function(){var e=this,t=e.$createElement,s=e._self._c||t;return s("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[s("h1",{attrs:{id:"booting-opencore-and-macos"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#booting-opencore-and-macos"}},[e._v("#")]),e._v(" Booting OpenCore and macOS")]),e._v(" "),s("p",[e._v("Now we finally get to boot OpenCore!")]),e._v(" "),s("p",[e._v("Reboot the machine while holding "),s("code",[e._v("Option")]),e._v(" to select the EFI Boot entry with the OpenCore icon (holding the "),s("code",[e._v("Control")]),e._v(" key will make this the default boot entry):")]),e._v(" "),s("ul",[s("li",[e._v("This will be the Mac Boot Picker")])]),e._v(" "),s("p",[s("img",{attrs:{src:o(385),alt:""}})]),e._v(" "),s("details",{staticClass:"custom-block details"},[s("summary",[e._v("Note for Mac Pros/Xserves/iMacs with unflashed GPUs")]),e._v(" "),s("p",[e._v("(Adapted from the "),s("a",{attrs:{href:"https://forums.macrumors.com/threads/opencore-on-the-mac-pro.2207814/",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore on the Mac Pro guide"),s("OutboundLink")],1),e._v(")")]),e._v(" "),s("p",[e._v("For Mac Pro, Xserve and, iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process.")]),e._v(" "),s("p",[e._v("Firstly, open the Terminal and run the following command:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[s("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" nvram "),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('"recovery-boot-mode=unused"')]),e._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v("&&")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("reboot")]),e._v(" recovery\n")])])]),s("p",[e._v("This will make your machine reboot into the Recovery Environment. Alternatively, holding "),s("code",[e._v("Command")]),e._v(" + "),s("code",[e._v("R")]),e._v(" when your machine is starting up will also let you enter the Recovery.")]),e._v(" "),s("p",[e._v("Secondly, open the Recovery Environment's Terminal (Menu bar > Utilities > Terminal).")]),e._v(" "),s("p",[e._v("Now you'll want to get a list of drive identifiers. To do so, run the following command:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("diskutil list\n")])])]),s("p",[e._v("The command should produce a list of drives installed in your system:\n"),s("img",{attrs:{src:o(386),alt:""}})]),e._v(" "),s("p",[e._v("Keep track of the drive with the OCLP install. You will need the drive identifer for later.")]),e._v(" "),s("p",[e._v("Now you'll want to mount the EFI partition (where OCLP is installed, though it may differ if you've installed OCLP to a FAT-32 volume).")]),e._v(" "),s("p",[e._v("Run the following command (Replace X with the drive number):")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("diskutil "),s("span",{pre:!0,attrs:{class:"token function"}},[e._v("mount")]),e._v(" diskXs1\n")])])]),s("p",[s("img",{attrs:{src:o(387),alt:""}}),e._v("\nIf everything is correct, the EFI partion should be mounted.")]),e._v(" "),s("p",[e._v("Now you'll want to use the "),s("code",[e._v("bless")]),e._v(" command to set the default boot device:")]),e._v(" "),s("div",{staticClass:"language-sh extra-class"},[s("pre",{pre:!0,attrs:{class:"language-sh"}},[s("code",[e._v("bless --mount /Volumes/EFI --setBoot --file /Volumes/EFI/System/Library/CoreServices/boot.efi\n")])])]),s("p",[e._v("Once the command is run, it should produce no output.\n"),s("img",{attrs:{src:o(388),alt:""}})]),e._v(" "),s("p",[e._v("If the command produces an output, ensure that you've typed it in correctly.")]),e._v(" "),s("p",[e._v("Now you can reboot your machine. OCLP is now the default boot option!")])]),e._v(" "),s("p",[e._v('Now that you\'ve loaded OpenCore, "select Install macOS":')]),e._v(" "),s("ul",[s("li",[e._v("This will be the OpenCore Picker")])]),e._v(" "),s("p",[s("img",{attrs:{src:o(389),alt:""}})]),e._v(" "),s("p",[e._v("You will soon reach the installer screen! If you enabled verbose mode when building OCLP, a lot of text will run across the screen. From there, it's just like any normal macOS install. For an example of how the boot process looks, see the following video:")]),e._v(" "),s("ul",[s("li",[s("a",{attrs:{href:"https://www.youtube.com/watch?v=AN3zsbQV_n4",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Legacy Patcher Boot Process"),s("OutboundLink")],1)])]),e._v(" "),s("p",[e._v("If your Mac is looping back into the beginning of the setup after the first reboot, turn it off, start it again and hold "),s("code",[e._v("Option")]),e._v('. This time, select the option with a grey hard disk icon, it can say "macOS Installer" or the name you gave the disk during the installer process. Keep repeating this step after every reboot if necessary.')]),e._v(" "),s("p",[s("img",{attrs:{src:o(390),alt:""}})]),e._v(" "),s("div",{staticClass:"custom-block warning"},[s("p",{staticClass:"custom-block-title"},[e._v("WARNING")]),e._v(" "),s("p",[s("strong",[e._v("MacBookPro11,3 Note")]),e._v(": When booting macOS Monterey, you'll need to boot into safe mode if acceleration patches are not installed yet. "),s("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522",target:"_blank",rel:"noopener noreferrer"}},[e._v("Otherwise, you'll hit a black screen due to missing NVIDIA drivers."),s("OutboundLink")],1),e._v(" Safe Mode can be entered by holding "),s("code",[e._v("Shift + Enter")]),e._v(" when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),s("h1",{attrs:{id:"once-installed-and-booting-head-to-post-installation"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#once-installed-and-booting-head-to-post-installation"}},[e._v("#")]),e._v(" Once installed and booting, head to "),s("RouterLink",{attrs:{to:"/POST-INSTALL.html"}},[e._v("Post-Installation")])],1)])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/8.b3209fb5.js b/assets/js/8.b3209fb5.js deleted file mode 100644 index 8d762db73d..0000000000 --- a/assets/js/8.b3209fb5.js +++ /dev/null @@ -1 +0,0 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[8],{319:function(e,t,a){e.exports=a.p+"assets/img/usb11-chart.5b4b5b26.png"},322:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Enabled.f95aadf0.png"},323:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Root-Patch.b983af09.png"},324:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Disabled.960a27d1.png"},414:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-SMBIOS-Minimal.c35b43de.png"},415:function(e,t,a){e.exports=a.p+"assets/img/Hash-Mismatch.add9f660.png"},470:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.a)({},(function(){var e=this,t=e.$createElement,o=e._self._c||t;return o("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[o("h1",{attrs:{id:"troubleshooting"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),o("p",[e._v("Here are some common errors that users may experience while using this patcher:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("OpenCore Legacy Patcher not launching")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-(%F0%9F%9A%AB)-prohibited-symbol"}},[e._v("Stuck on "),o("code",[e._v("This version of Mac OS X is not supported on this platform")]),e._v(" or (🚫) Prohibited Symbol")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("Cannot boot macOS without the USB")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#infinite-recovery-os-reboot"}},[e._v("Infinite Recovery OS Booting")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-boot-after-root-patching"}},[e._v("Stuck on boot after root patching")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("Reboot when entering Hibernation ("),o("code",[e._v("Sleep Wake Failure")]),e._v(")")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#how-to-boot-recovery-through-opencore-legacy-patcher"}},[e._v("How to Boot Recovery through OpenCore Legacy Patcher")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v('Stuck on "Your Mac needs a firmware update"')])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-brightness-control"}},[e._v("No Brightness Control")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-connect-Wi-Fi-on-Monterey-with-legacy-cards"}},[e._v("Cannot connect Wi-Fi on Monterey with legacy cards")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-graphics-acceleration"}},[e._v("No Graphics Acceleration")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#black-screen-on-macbookpro113-in-macos-monterey"}},[e._v("Black Screen on MacBookPro11,3 in macOS Monterey")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-displayport-output-on-mac-pros-with-NVIDIA-kepler"}},[e._v("No DisplayPort Output on Mac Pros with NVIDIA Kepler")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("Volume Hash Mismatch Error in macOS Monterey")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("Cannot Disable SIP in recoveryOS")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v('Stuck on "Less than a minute remaining..."')])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[e._v("No acceleration after a Metal GPU swap on Mac Pro")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[e._v("Keyboard, Mouse and Trackpad not working in installer or after update")])])]),e._v(" "),o("h2",{attrs:{id:"opencore-legacy-patcher-not-launching"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher not launching")]),e._v(" "),o("p",[e._v("If the application won't launch (e.g. icon will bounce in the Dock), try launching OCLP via Terminal by typing the following command, make sure you've moved the app to "),o("code",[e._v("/Applications")]),e._v(" before this.")]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[e._v("/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher\n")])])]),o("h2",{attrs:{id:"stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-🚫-prohibited-symbol"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-🚫-prohibited-symbol"}},[e._v("#")]),e._v(" Stuck on "),o("code",[e._v("This version of Mac OS X is not supported on this platform")]),e._v(" or (🚫) Prohibited Symbol")]),e._v(" "),o("p",[e._v("This means macOS has detected an SMBIOS it does not support. To resolve this, ensure you're booting OpenCore "),o("strong",[e._v("before")]),e._v(" the macOS installer in the boot picker. Reminder that the option will be called "),o("code",[e._v("EFI Boot")]),e._v(".")]),e._v(" "),o("p",[e._v("Once you've booted OpenCore at least once, your hardware should now auto-boot it until either an NVRAM reset occurs, or you remove the drive with OpenCore installed.")]),e._v(" "),o("p",[e._v("However, if the 🚫 Symbol only appears after the boot process has already started (the bootscreen appears/verbose boot starts), it could mean that your USB drive has failed to pass macOS' integrity checks. To resolve this, create a new installer using a different USB drive (preferably of a different model.)")]),e._v(" "),o("h2",{attrs:{id:"cannot-boot-macos-without-the-usb"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("#")]),e._v(" Cannot boot macOS without the USB")]),e._v(" "),o("p",[e._v("By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs.")]),e._v(" "),o("p",[e._v("After installing macOS, OpenCore Legacy Patcher should automatically prompt you to install OpenCore onto the internal drive. However, if it doesn't show the prompt, you'll need to either "),o("a",{attrs:{href:"https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("manually transfer"),o("OutboundLink")],1),e._v(" OpenCore to the internal drive's EFI or Build and Install again and select your internal drive.")]),e._v(" "),o("p",[e._v("Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.")]),e._v(" "),o("h2",{attrs:{id:"infinite-recovery-os-booting"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#infinite-recovery-os-booting"}},[e._v("#")]),e._v(" Infinite Recovery OS Booting")]),e._v(" "),o("p",[e._v("With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve this, simply uninstall OpenCore and "),o("a",{attrs:{href:"https://support.apple.com/en-mide/HT201255",target:"_blank",rel:"noopener noreferrer"}},[e._v("reset NVRAM"),o("OutboundLink")],1),e._v(".")]),e._v(" "),o("ul",[o("li",[e._v("Note: Machines with modified root volumes will also result in an infinite recovery loop until integrity is restored.")])]),e._v(" "),o("h2",{attrs:{id:"stuck-on-boot-after-root-patching"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-boot-after-root-patching"}},[e._v("#")]),e._v(" Stuck on boot after root patching")]),e._v(" "),o("p",[e._v("Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up)\nGo into terminal and type the following:")]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[o("span",{pre:!0,attrs:{class:"token function"}},[e._v("mount")]),e._v(" -uw /Volumes/Macintosh"),o("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("\\")]),e._v(" HD\nbless --mount /Volumes/Macintosh"),o("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("\\")]),e._v(" HD --bootefi -last-sealed-snapshot\n")])])]),o("p",[e._v('If your disk name is something else than "Macintosh HD", make sure to change the path accordingly.')]),e._v(" "),o("p",[e._v("Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.")]),e._v(" "),o("h2",{attrs:{id:"reboot-when-entering-hibernation-sleep-wake-failure"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("#")]),e._v(" Reboot when entering Hibernation ("),o("code",[e._v("Sleep Wake Failure")]),e._v(")")]),e._v(" "),o("p",[o("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/issues/72",target:"_blank",rel:"noopener noreferrer"}},[e._v("Known issue on some models"),o("OutboundLink")],1),e._v(", a temporary fix is to disable Hibernation by executing the following command in the terminal:")]),e._v(" "),o("div",{staticClass:"language- extra-class"},[o("pre",{pre:!0,attrs:{class:"language-text"}},[o("code",[e._v("sudo pmset -a hibernatemode 0\n")])])]),o("h2",{attrs:{id:"how-to-boot-recovery-through-opencore-legacy-patcher"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#how-to-boot-recovery-through-opencore-legacy-patcher"}},[e._v("#")]),e._v(" How to Boot Recovery through OpenCore Legacy Patcher")]),e._v(" "),o("p",[e._v("By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the "),o("code",[e._v("Spacebar")]),e._v(" key while inside OpenCore's Picker to list all boot options.")]),e._v(" "),o("h2",{attrs:{id:"stuck-on-your-mac-needs-a-firmware-update"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v("#")]),e._v(' Stuck on "Your Mac needs a firmware update"')]),e._v(" "),o("p",[e._v('Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."')]),e._v(" "),o("p",[e._v('This error occurs when macOS determines that the current firmware does not have full APFS support. To resolve this, when installing OpenCore, head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show support for full APFS capabilities.')]),e._v(" "),o("h2",{attrs:{id:"no-brightness-control"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-brightness-control"}},[e._v("#")]),e._v(" No Brightness Control")]),e._v(" "),o("p",[e._v("With OCLP v0.0.22, we've added support for brightness control on many models. However, some users may have noticed that their brightness keys do not work.")]),e._v(" "),o("p",[e._v("As a work-around, we recommend users try out the below app:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"https://actproductions.net/free-apps/brightness-slider/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Brightness Slider"),o("OutboundLink")],1)])]),e._v(" "),o("h2",{attrs:{id:"cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[e._v("#")]),e._v(" Cannot connect Wi-Fi on Monterey with legacy cards")]),e._v(" "),o("p",[e._v("With OCLP v0.2.5, we've added support for legacy Wi-Fi on Monterey. However, some users may have noticed that they can't connect to wireless networks.")]),e._v(" "),o("p",[e._v('To work-around this, we recommend that users manually connect using the "Other" option in the Wi-Fi menu bar or manually adding the network in the "Network" preference pane.')]),e._v(" "),o("h2",{attrs:{id:"no-graphics-acceleration"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-graphics-acceleration"}},[e._v("#")]),e._v(" No Graphics Acceleration")]),e._v(" "),o("p",[e._v("In macOS, GPU drivers are often dropped from the OS with each major release of it. With macOS Big Sur, currently, all non-Metal GPUs require additional patches to gain acceleration. In addition, macOS Monterey removed Graphics Drivers for both Intel Ivy Bridge and NVIDIA Kepler graphics processors.")]),e._v(" "),o("p",[e._v("If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after the first boot from installation of macOS. If you need to do this manually, you can do so within the patcher app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.")]),e._v(" "),o("h2",{attrs:{id:"black-screen-on-macbookpro11-3-in-macos-monterey"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#black-screen-on-macbookpro11-3-in-macos-monterey"}},[e._v("#")]),e._v(" Black Screen on MacBookPro11,3 in macOS Monterey")]),e._v(" "),o("p",[e._v("Due to Apple dropping NVIDIA Kepler support in macOS Monterey, "),o("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522",target:"_blank",rel:"noopener noreferrer"}},[e._v("MacBookPro11,3's GMUX has difficulties switching back to the iGPU to display macOS correctly."),o("OutboundLink")],1),e._v(" To work-around this issue, boot the MacBookPro11,3 in Safe Mode and once macOS is installed, run OCLP's Post Install Root Patches to enable GPU Acceleration for the NVIDIA dGPU.")]),e._v(" "),o("ul",[o("li",[e._v("Safe Mode can be started by holding "),o("code",[e._v("Shift")]),e._v(" + "),o("code",[e._v("Enter")]),e._v(" when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),o("h2",{attrs:{id:"no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[e._v("#")]),e._v(" No DisplayPort Output on Mac Pros with NVIDIA Kepler")]),e._v(" "),o("p",[e._v("If you're having trouble with DisplayPort output on Mac Pros, try enabling Minimal Spoofing in Settings -> SMBIOS Settings and rebuild/install OpenCore. This will trick macOS drivers into thinking you have a newer MacPro7,1 and resolve the issue.")]),e._v(" "),o("p",[o("img",{attrs:{src:a(414),alt:""}})]),e._v(" "),o("h2",{attrs:{id:"volume-hash-mismatch-error-in-macos-monterey"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("#")]),e._v(" Volume Hash Mismatch Error in macOS Monterey")]),e._v(" "),o("p",[e._v('A semi-common popup some users face is the "Volume Hash Mismatch" error:')]),e._v(" "),o("p",{attrs:{align:"center"}},[o("img",{attrs:{src:a(415)}})]),e._v(" "),o("p",[e._v("What this error signifies is that the OS detects that the boot volume's hash does not match what the OS is expecting, this error is generally cosmetic and can be ignored. However if your system starts to crash spontaneously shortly after, you'll want to reinstall macOS fresh without importing any data at first.")]),e._v(" "),o("ul",[o("li",[e._v("Note that this bug affects native Macs as well and is not due to issues with unsupported Macs: "),o("a",{attrs:{href:"https://osxdaily.com/2021/11/10/volume-hash-mismatch-error-in-macos-monterey/",target:"_blank",rel:"noopener noreferrer"}},[e._v("OSX Daily: “Volume Hash Mismatch” Error in MacOS Monterey"),o("OutboundLink")],1)])]),e._v(" "),o("p",[e._v("Additionally, it can help to disable FeatureUnlock in Settings -> Misc Settings as this tool can be strenuous on systems with weaker memory stability.")]),e._v(" "),o("h2",{attrs:{id:"cannot-disable-sip-in-recoveryos"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("#")]),e._v(" Cannot Disable SIP in recoveryOS")]),e._v(" "),o("p",[e._v("With OCLP, the patcher will always overwrite the current SIP value on boot to ensure that users don't brick an installation after an NVRAM reset. However, for users wanting to disable SIP entirely, this can be done easily.")]),e._v(" "),o("p",[e._v("Head into the GUI, go to Patcher Settings, and toggle the bits you need disabled from SIP:")]),e._v(" "),o("table",[o("thead",[o("tr",[o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Enabled")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Lowered (Root Patching)")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Disabled")])])]),e._v(" "),o("tbody",[o("tr",[o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(322),alt:""}})]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(323),alt:""}})]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(324),alt:""}})])])])]),e._v(" "),o("h2",{attrs:{id:"intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[e._v("#")]),e._v(" Intermediate issues with USB 1.1 and Bluetooth on MacPro3,1 - MacPro5,1")]),e._v(" "),o("p",[e._v("For those experiencing issues with USB 1.1 devices (such as mice, keyboards and bluetooth chipsets), macOS Big Sur and newer have weakened OS-side reliability for the UHCI controller in older Mac Pros.")]),e._v(" "),o("ul",[o("li",[e._v("UHCI is a USB 1.1 controller that is hooked together with the USB 2.0 ports in your system. Whenever a USB 1.1 device is detected, the UHCI controller is given ownership of the device at a hardware/firmware level.\n"),o("ul",[o("li",[e._v("EHCI is the USB 2.0 controller in older Mac Pros")])])])]),e._v(" "),o("p",[e._v("Because of this, we recommend placing a USB 2.0/3.0 hub between your devices and the port on the Mac Pro. UHCI and EHCI cannot both be used at once, so using a USB hub will always force the EHCI controller on.")]),e._v(" "),o("ul",[o("li",[e._v("Alternatively, you can try cold-starting the hardware and see if macOS recognizes the UHCI controller properly.")])]),e._v(" "),o("h2",{attrs:{id:"stuck-on-less-than-a-minute-remaining"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v("#")]),e._v(' Stuck on "Less than a minute remaining..."')]),e._v(" "),o("p",[e._v('A common area for systems to get "stuck", namely for units that are missing the '),o("code",[e._v("AES")]),e._v(" CPU instruction/older mobile hardware. During this stage, a lot of heavy cryptography is performed, which can make systems appear to be stuck. In reality they are working quite hard to finish up the installation.")]),e._v(" "),o("p",[e._v("Because this step can take a few hours or more depending on drive speeds, be patient at this stage and do not manually power off or reboot your machine as this will break the installation and require you to reinstall. If you think your system has stalled, press the Caps Lock key. If the light turns on, your system is busy and not actually frozen.")]),e._v(" "),o("h2",{attrs:{id:"no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[e._v("#")]),e._v(" No acceleration after a Metal GPU swap on Mac Pro")]),e._v(" "),o("p",[e._v("If you finished installing Monterey with the original card installed (to see bootpicker for example) and swapped your GPU to a Metal supported one, you may notice that you're missing acceleration. To fix this, open OCLP and revert root patches to get your Metal-supported GPU work again.")]),e._v(" "),o("p",[e._v('Alternatively, you can remove "AutoPkg-Assets.pkg" from /Library/Packages on the USB drive before proceeding with the installation. To see the folder, enable hidden files with '),o("code",[e._v("Command")]),e._v(" + "),o("code",[e._v("Shift")]),e._v(" + "),o("code",[e._v(".")])]),e._v(" "),o("p",[e._v("The reason for this is that the autopatcher will assume that you will be using the original graphics card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate after swapping.")]),e._v(" "),o("h2",{attrs:{id:"keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[e._v("#")]),e._v(" Keyboard, Mouse and Trackpad not working in installer or after update")]),e._v(" "),o("p",[e._v("For Macs using legacy USB 1.1 controllers, OpenCore Legacy Patcher can only restore support once it has performed root volume patches. Thus to install macOS, you need to hook up a USB hub between your Mac and Keyboard/Mouse.")]),e._v(" "),o("ul",[o("li",[e._v("For MacBook users, you'll need to find an external keyboard/mouse in addition to the USB hub")])]),e._v(" "),o("p",[e._v("More information can be found here:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021",target:"_blank",rel:"noopener noreferrer"}},[e._v("Legacy UHCI/OHCI support in Ventura #1021"),o("OutboundLink")],1)])]),e._v(" "),o("p",[e._v("Applicable models include:")]),e._v(" "),o("table",[o("thead",[o("tr",[o("th",{staticStyle:{"text-align":"left"}},[e._v("Family")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Year")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Model")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Notes")])])]),e._v(" "),o("tbody",[o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook5,1 - MacBook7,1")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook Air")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Late 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBookAir2,1 - MacBookAir3,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook Pro")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBookPro4,1 - MacBookPro7,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v('Excludes Mid 2010 15" and 17" (MacBookPro6,x)')])]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("iMac")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Late 2009 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("iMac7,1 - iMac10,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v('Excludes Core i5/7 27" late 2009 iMac (iMac11,1)')])]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("Mac mini")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2011 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Macmini3,1 - Macmini5,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("Mac Pro")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacPro3,1 - MacPro5,1")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})])])]),e._v(" "),o("p",[o("img",{attrs:{src:a(319),alt:""}})])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/8.c46c76cf.js b/assets/js/8.c46c76cf.js new file mode 100644 index 0000000000..77403b2081 --- /dev/null +++ b/assets/js/8.c46c76cf.js @@ -0,0 +1 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[8],{319:function(e,t,a){e.exports=a.p+"assets/img/usb11-chart.5b4b5b26.png"},322:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Enabled.f95aadf0.png"},323:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Root-Patch.b983af09.png"},324:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-Settings-SIP-Disabled.960a27d1.png"},414:function(e,t,a){e.exports=a.p+"assets/img/OCLP-GUI-SMBIOS-Minimal.c35b43de.png"},415:function(e,t,a){e.exports=a.p+"assets/img/Hash-Mismatch.add9f660.png"},470:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.a)({},(function(){var e=this,t=e.$createElement,o=e._self._c||t;return o("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[o("h1",{attrs:{id:"troubleshooting"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),o("p",[e._v("Here are some common errors that users may experience while using this patcher:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("OpenCore Legacy Patcher not launching")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-(%F0%9F%9A%AB)-prohibited-symbol"}},[e._v("Stuck on "),o("code",[e._v("This version of Mac OS X is not supported on this platform")]),e._v(" or (🚫) Prohibited Symbol")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("Cannot boot macOS without the USB")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#infinite-recovery-os-reboot"}},[e._v("Infinite Recovery OS Booting")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-boot-after-root-patching"}},[e._v("Stuck on boot after root patching")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("Reboot when entering Hibernation ("),o("code",[e._v("Sleep Wake Failure")]),e._v(")")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#how-to-boot-recovery-through-opencore-legacy-patcher"}},[e._v("How to Boot Recovery through OpenCore Legacy Patcher")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v('Stuck on "Your Mac needs a firmware update"')])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-brightness-control"}},[e._v("No Brightness Control")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-connect-Wi-Fi-on-Monterey-with-legacy-cards"}},[e._v("Cannot connect Wi-Fi on Monterey with legacy cards")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-graphics-acceleration"}},[e._v("No Graphics Acceleration")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#black-screen-on-macbookpro113-in-macos-monterey"}},[e._v("Black Screen on MacBookPro11,3 in macOS Monterey")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-displayport-output-on-mac-pros-with-NVIDIA-kepler"}},[e._v("No DisplayPort Output on Mac Pros with NVIDIA Kepler")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("Volume Hash Mismatch Error in macOS Monterey")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("Cannot Disable SIP in recoveryOS")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v('Stuck on "Less than a minute remaining..."')])]),e._v(" "),o("li",[o("a",{attrs:{href:"#no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[e._v("No acceleration after a Metal GPU swap on Mac Pro")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[e._v("Keyboard, Mouse and Trackpad not working in installer or after update")])])]),e._v(" "),o("h2",{attrs:{id:"opencore-legacy-patcher-not-launching"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher not launching")]),e._v(" "),o("p",[e._v("If the application won't launch (e.g. icon will bounce in the Dock), try launching OCLP via Terminal by typing the following command, make sure you've moved the app to "),o("code",[e._v("/Applications")]),e._v(" before this.")]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[e._v("/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher\n")])])]),o("h2",{attrs:{id:"stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-🚫-prohibited-symbol"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-🚫-prohibited-symbol"}},[e._v("#")]),e._v(" Stuck on "),o("code",[e._v("This version of Mac OS X is not supported on this platform")]),e._v(" or (🚫) Prohibited Symbol")]),e._v(" "),o("p",[e._v("This means macOS has detected an SMBIOS it does not support. To resolve this, ensure you're booting OpenCore "),o("strong",[e._v("before")]),e._v(" the macOS installer in the boot picker. Reminder that the option will be called "),o("code",[e._v("EFI Boot")]),e._v(".")]),e._v(" "),o("p",[e._v("Once you've booted OpenCore at least once, your hardware should now auto-boot it until either an NVRAM reset occurs, or you remove the drive with OpenCore installed.")]),e._v(" "),o("p",[e._v("However, if the 🚫 Symbol only appears after the boot process has already started (the bootscreen appears/verbose boot starts), it could mean that your USB drive has failed to pass macOS' integrity checks. To resolve this, create a new installer using a different USB drive (preferably of a different model.)")]),e._v(" "),o("h2",{attrs:{id:"cannot-boot-macos-without-the-usb"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("#")]),e._v(" Cannot boot macOS without the USB")]),e._v(" "),o("p",[e._v("By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs.")]),e._v(" "),o("p",[e._v("After installing macOS, OpenCore Legacy Patcher should automatically prompt you to install OpenCore onto the internal drive. However, if it doesn't show the prompt, you'll need to either "),o("a",{attrs:{href:"https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("manually transfer"),o("OutboundLink")],1),e._v(" OpenCore to the internal drive's EFI or Build and Install again and select your internal drive.")]),e._v(" "),o("p",[e._v("Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.")]),e._v(" "),o("h2",{attrs:{id:"infinite-recovery-os-booting"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#infinite-recovery-os-booting"}},[e._v("#")]),e._v(" Infinite Recovery OS Booting")]),e._v(" "),o("p",[e._v("With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve this, simply uninstall OpenCore and "),o("a",{attrs:{href:"https://support.apple.com/en-mide/HT201255",target:"_blank",rel:"noopener noreferrer"}},[e._v("reset NVRAM"),o("OutboundLink")],1),e._v(".")]),e._v(" "),o("ul",[o("li",[e._v("Note: Machines with modified root volumes will also result in an infinite recovery loop until integrity is restored.")])]),e._v(" "),o("h2",{attrs:{id:"stuck-on-boot-after-root-patching"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-boot-after-root-patching"}},[e._v("#")]),e._v(" Stuck on boot after root patching")]),e._v(" "),o("p",[e._v("Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up)")]),e._v(" "),o("p",[e._v("Go into terminal and first mount the disk by typing")]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[o("span",{pre:!0,attrs:{class:"token function"}},[e._v("mount")]),e._v(" -uw "),o("span",{pre:!0,attrs:{class:"token string"}},[e._v('"/Volumes/Macintosh HD"')]),e._v("\n")])])]),o("p",[e._v('Then revert the snapshot (if your disk name is something else than "Macintosh HD", make sure to change the path accordingly)')]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[e._v("bless --mount "),o("span",{pre:!0,attrs:{class:"token string"}},[e._v('"/Volumes/Macintosh HD"')]),e._v(" --bootefi -last-sealed-snapshot\n")])])]),o("p",[e._v("Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.")]),e._v(" "),o("h2",{attrs:{id:"reboot-when-entering-hibernation-sleep-wake-failure"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("#")]),e._v(" Reboot when entering Hibernation ("),o("code",[e._v("Sleep Wake Failure")]),e._v(")")]),e._v(" "),o("p",[o("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/issues/72",target:"_blank",rel:"noopener noreferrer"}},[e._v("Known issue on some models"),o("OutboundLink")],1),e._v(", a temporary fix is to disable Hibernation by executing the following command in the terminal:")]),e._v(" "),o("div",{staticClass:"language- extra-class"},[o("pre",{pre:!0,attrs:{class:"language-text"}},[o("code",[e._v("sudo pmset -a hibernatemode 0\n")])])]),o("h2",{attrs:{id:"how-to-boot-recovery-through-opencore-legacy-patcher"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#how-to-boot-recovery-through-opencore-legacy-patcher"}},[e._v("#")]),e._v(" How to Boot Recovery through OpenCore Legacy Patcher")]),e._v(" "),o("p",[e._v("By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the "),o("code",[e._v("Spacebar")]),e._v(" key while inside OpenCore's Picker to list all boot options.")]),e._v(" "),o("h2",{attrs:{id:"stuck-on-your-mac-needs-a-firmware-update"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v("#")]),e._v(' Stuck on "Your Mac needs a firmware update"')]),e._v(" "),o("p",[e._v('Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."')]),e._v(" "),o("p",[e._v('This error occurs when macOS determines that the current firmware does not have full APFS support. To resolve this, when installing OpenCore, head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show support for full APFS capabilities.')]),e._v(" "),o("h2",{attrs:{id:"no-brightness-control"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-brightness-control"}},[e._v("#")]),e._v(" No Brightness Control")]),e._v(" "),o("p",[e._v("With OCLP v0.0.22, we've added support for brightness control on many models. However, some users may have noticed that their brightness keys do not work.")]),e._v(" "),o("p",[e._v("As a work-around, we recommend users try out the below app:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"https://actproductions.net/free-apps/brightness-slider/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Brightness Slider"),o("OutboundLink")],1)])]),e._v(" "),o("h2",{attrs:{id:"cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[e._v("#")]),e._v(" Cannot connect Wi-Fi on Monterey with legacy cards")]),e._v(" "),o("p",[e._v("With OCLP v0.2.5, we've added support for legacy Wi-Fi on Monterey. However, some users may have noticed that they can't connect to wireless networks.")]),e._v(" "),o("p",[e._v('To work-around this, we recommend that users manually connect using the "Other" option in the Wi-Fi menu bar or manually adding the network in the "Network" preference pane.')]),e._v(" "),o("h2",{attrs:{id:"no-graphics-acceleration"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-graphics-acceleration"}},[e._v("#")]),e._v(" No Graphics Acceleration")]),e._v(" "),o("p",[e._v("In macOS, GPU drivers are often dropped from the OS with each major release of it. With macOS Big Sur, currently, all non-Metal GPUs require additional patches to gain acceleration. In addition, macOS Monterey removed Graphics Drivers for both Intel Ivy Bridge and NVIDIA Kepler graphics processors.")]),e._v(" "),o("p",[e._v("If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after the first boot from installation of macOS. If you need to do this manually, you can do so within the patcher app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.")]),e._v(" "),o("h2",{attrs:{id:"black-screen-on-macbookpro11-3-in-macos-monterey"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#black-screen-on-macbookpro11-3-in-macos-monterey"}},[e._v("#")]),e._v(" Black Screen on MacBookPro11,3 in macOS Monterey")]),e._v(" "),o("p",[e._v("Due to Apple dropping NVIDIA Kepler support in macOS Monterey, "),o("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522",target:"_blank",rel:"noopener noreferrer"}},[e._v("MacBookPro11,3's GMUX has difficulties switching back to the iGPU to display macOS correctly."),o("OutboundLink")],1),e._v(" To work-around this issue, boot the MacBookPro11,3 in Safe Mode and once macOS is installed, run OCLP's Post Install Root Patches to enable GPU Acceleration for the NVIDIA dGPU.")]),e._v(" "),o("ul",[o("li",[e._v("Safe Mode can be started by holding "),o("code",[e._v("Shift")]),e._v(" + "),o("code",[e._v("Enter")]),e._v(" when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),o("h2",{attrs:{id:"no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[e._v("#")]),e._v(" No DisplayPort Output on Mac Pros with NVIDIA Kepler")]),e._v(" "),o("p",[e._v("If you're having trouble with DisplayPort output on Mac Pros, try enabling Minimal Spoofing in Settings -> SMBIOS Settings and rebuild/install OpenCore. This will trick macOS drivers into thinking you have a newer MacPro7,1 and resolve the issue.")]),e._v(" "),o("p",[o("img",{attrs:{src:a(414),alt:""}})]),e._v(" "),o("h2",{attrs:{id:"volume-hash-mismatch-error-in-macos-monterey"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("#")]),e._v(" Volume Hash Mismatch Error in macOS Monterey")]),e._v(" "),o("p",[e._v('A semi-common popup some users face is the "Volume Hash Mismatch" error:')]),e._v(" "),o("p",{attrs:{align:"center"}},[o("img",{attrs:{src:a(415)}})]),e._v(" "),o("p",[e._v("What this error signifies is that the OS detects that the boot volume's hash does not match what the OS is expecting, this error is generally cosmetic and can be ignored. However if your system starts to crash spontaneously shortly after, you'll want to reinstall macOS fresh without importing any data at first.")]),e._v(" "),o("ul",[o("li",[e._v("Note that this bug affects native Macs as well and is not due to issues with unsupported Macs: "),o("a",{attrs:{href:"https://osxdaily.com/2021/11/10/volume-hash-mismatch-error-in-macos-monterey/",target:"_blank",rel:"noopener noreferrer"}},[e._v("OSX Daily: “Volume Hash Mismatch” Error in MacOS Monterey"),o("OutboundLink")],1)])]),e._v(" "),o("p",[e._v("Additionally, it can help to disable FeatureUnlock in Settings -> Misc Settings as this tool can be strenuous on systems with weaker memory stability.")]),e._v(" "),o("h2",{attrs:{id:"cannot-disable-sip-in-recoveryos"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("#")]),e._v(" Cannot Disable SIP in recoveryOS")]),e._v(" "),o("p",[e._v("With OCLP, the patcher will always overwrite the current SIP value on boot to ensure that users don't brick an installation after an NVRAM reset. However, for users wanting to disable SIP entirely, this can be done easily.")]),e._v(" "),o("p",[e._v("Head into the GUI, go to Patcher Settings, and toggle the bits you need disabled from SIP:")]),e._v(" "),o("table",[o("thead",[o("tr",[o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Enabled")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Lowered (Root Patching)")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Disabled")])])]),e._v(" "),o("tbody",[o("tr",[o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(322),alt:""}})]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(323),alt:""}})]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[o("img",{attrs:{src:a(324),alt:""}})])])])]),e._v(" "),o("h2",{attrs:{id:"intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[e._v("#")]),e._v(" Intermediate issues with USB 1.1 and Bluetooth on MacPro3,1 - MacPro5,1")]),e._v(" "),o("p",[e._v("For those experiencing issues with USB 1.1 devices (such as mice, keyboards and bluetooth chipsets), macOS Big Sur and newer have weakened OS-side reliability for the UHCI controller in older Mac Pros.")]),e._v(" "),o("ul",[o("li",[e._v("UHCI is a USB 1.1 controller that is hooked together with the USB 2.0 ports in your system. Whenever a USB 1.1 device is detected, the UHCI controller is given ownership of the device at a hardware/firmware level.\n"),o("ul",[o("li",[e._v("EHCI is the USB 2.0 controller in older Mac Pros")])])])]),e._v(" "),o("p",[e._v("Because of this, we recommend placing a USB 2.0/3.0 hub between your devices and the port on the Mac Pro. UHCI and EHCI cannot both be used at once, so using a USB hub will always force the EHCI controller on.")]),e._v(" "),o("ul",[o("li",[e._v("Alternatively, you can try cold-starting the hardware and see if macOS recognizes the UHCI controller properly.")])]),e._v(" "),o("h2",{attrs:{id:"stuck-on-less-than-a-minute-remaining"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v("#")]),e._v(' Stuck on "Less than a minute remaining..."')]),e._v(" "),o("p",[e._v('A common area for systems to get "stuck", namely for units that are missing the '),o("code",[e._v("AES")]),e._v(" CPU instruction/older mobile hardware. During this stage, a lot of heavy cryptography is performed, which can make systems appear to be stuck. In reality they are working quite hard to finish up the installation.")]),e._v(" "),o("p",[e._v("Because this step can take a few hours or more depending on drive speeds, be patient at this stage and do not manually power off or reboot your machine as this will break the installation and require you to reinstall. If you think your system has stalled, press the Caps Lock key. If the light turns on, your system is busy and not actually frozen.")]),e._v(" "),o("h2",{attrs:{id:"no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[e._v("#")]),e._v(" No acceleration after a Metal GPU swap on Mac Pro")]),e._v(" "),o("p",[e._v("If you finished installing Monterey with the original card installed (to see bootpicker for example) and swapped your GPU to a Metal supported one, you may notice that you're missing acceleration. To fix this, open OCLP and revert root patches to get your Metal-supported GPU work again.")]),e._v(" "),o("p",[e._v('Alternatively, you can remove "AutoPkg-Assets.pkg" from /Library/Packages on the USB drive before proceeding with the installation. To see the folder, enable hidden files with '),o("code",[e._v("Command")]),e._v(" + "),o("code",[e._v("Shift")]),e._v(" + "),o("code",[e._v(".")])]),e._v(" "),o("p",[e._v("The reason for this is that the autopatcher will assume that you will be using the original graphics card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate after swapping.")]),e._v(" "),o("h2",{attrs:{id:"keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update"}},[e._v("#")]),e._v(" Keyboard, Mouse and Trackpad not working in installer or after update")]),e._v(" "),o("p",[e._v("For Macs using legacy USB 1.1 controllers, OpenCore Legacy Patcher can only restore support once it has performed root volume patches. Thus to install macOS, you need to hook up a USB hub between your Mac and Keyboard/Mouse.")]),e._v(" "),o("ul",[o("li",[e._v("For MacBook users, you'll need to find an external keyboard/mouse in addition to the USB hub")])]),e._v(" "),o("p",[e._v("More information can be found here:")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021",target:"_blank",rel:"noopener noreferrer"}},[e._v("Legacy UHCI/OHCI support in Ventura #1021"),o("OutboundLink")],1)])]),e._v(" "),o("p",[e._v("Applicable models include:")]),e._v(" "),o("table",[o("thead",[o("tr",[o("th",{staticStyle:{"text-align":"left"}},[e._v("Family")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Year")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Model")]),e._v(" "),o("th",{staticStyle:{"text-align":"left"}},[e._v("Notes")])])]),e._v(" "),o("tbody",[o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook5,1 - MacBook7,1")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook Air")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Late 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBookAir2,1 - MacBookAir3,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBook Pro")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacBookPro4,1 - MacBookPro7,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v('Excludes Mid 2010 15" and 17" (MacBookPro6,x)')])]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("iMac")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Late 2009 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("iMac7,1 - iMac10,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v('Excludes Core i5/7 27" late 2009 iMac (iMac11,1)')])]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("Mac mini")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2011 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Macmini3,1 - Macmini5,x")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})]),e._v(" "),o("tr",[o("td",{staticStyle:{"text-align":"left"}},[e._v("Mac Pro")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("Mid 2010 and older")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}},[e._v("MacPro3,1 - MacPro5,1")]),e._v(" "),o("td",{staticStyle:{"text-align":"left"}})])])]),e._v(" "),o("p",[o("img",{attrs:{src:a(319),alt:""}})])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/app.9a5bcbfa.js b/assets/js/app.fb2b13f2.js similarity index 98% rename from assets/js/app.9a5bcbfa.js rename to assets/js/app.fb2b13f2.js index fa8a7195c4..596857f1df 100644 --- a/assets/js/app.9a5bcbfa.js +++ b/assets/js/app.fb2b13f2.js @@ -1,9 +1,9 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[0],[]]);!function(t){function e(e){for(var r,a,c=e[0],s=e[1],u=e[2],f=0,p=[];f0?o(r(t),9007199254740991):0}},function(t,e){var n=Array.isArray;t.exports=n},function(t,e,n){var r=n(33),o=n(19);t.exports=function(t){return r(o(t))}},function(t,e,n){var r=n(142),o="object"==typeof self&&self&&self.Object===Object&&self,i=r||o||Function("return this")();t.exports=i},function(t,e,n){var r=n(6),o=n(1),i=n(7),a=Object.defineProperty,c={},s=function(t){throw t};t.exports=function(t,e){if(i(c,t))return c[t];e||(e={});var n=[][t],u=!!i(e,"ACCESSORS")&&e.ACCESSORS,l=i(e,0)?e[0]:s,f=i(e,1)?e[1]:void 0;return c[t]=!!n&&!o((function(){if(u&&!r)return!0;var t={length:-1};u?a(t,1,{enumerable:!0,get:s}):t[1]=1,n.call(t,l,f)}))}},function(t,e,n){var r=n(114),o=n(2),i=function(t){return"function"==typeof t?t:void 0};t.exports=function(t,e){return arguments.length<2?i(r[t])||i(o[t]):r[t]&&r[t][e]||o[t]&&o[t][e]}},function(t,e){t.exports=function(t){if(null==t)throw TypeError("Can't call method on "+t);return t}},function(t,e){t.exports=!1},function(t,e,n){var r=n(6),o=n(80),i=n(35),a=n(15),c=n(34),s=n(7),u=n(109),l=Object.getOwnPropertyDescriptor;e.f=r?l:function(t,e){if(t=a(t),e=c(e,!0),u)try{return l(t,e)}catch(t){}if(s(t,e))return i(!o.f.call(t,e),t[e])}},function(t,e){var n={}.toString;t.exports=function(t){return n.call(t).slice(8,-1)}},function(t,e){t.exports=function(t){if("function"!=typeof t)throw TypeError(String(t)+" is not a function");return t}},function(t,e,n){var r=n(231),o=n(234);t.exports=function(t,e){var n=o(t,e);return r(n)?n:void 0}},function(t,e,n){"use strict";function r(t,e,n,r,o,i,a,c){var s,u="function"==typeof t?t.options:t;if(e&&(u.render=e,u.staticRenderFns=n,u._compiled=!0),r&&(u.functional=!0),i&&(u._scopeId="data-v-"+i),a?(s=function(t){(t=t||this.$vnode&&this.$vnode.ssrContext||this.parent&&this.parent.$vnode&&this.parent.$vnode.ssrContext)||"undefined"==typeof __VUE_SSR_CONTEXT__||(t=__VUE_SSR_CONTEXT__),o&&o.call(this,t),t&&t._registeredComponents&&t._registeredComponents.add(a)},u._ssrRegister=s):o&&(s=c?function(){o.call(this,(u.functional?this.parent:this).$root.$options.shadowRoot)}:o),s)if(u.functional){u._injectStyles=s;var l=u.render;u.render=function(t,e){return s.call(e),l(t,e)}}else{var f=u.beforeCreate;u.beforeCreate=f?[].concat(f,s):[s]}return{exports:t,options:u}}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";var r=n(0),o=n(31).filter,i=n(54),a=n(17),c=i("filter"),s=a("filter");r({target:"Array",proto:!0,forced:!c||!s},{filter:function(t){return o(this,t,arguments.length>1?arguments[1]:void 0)}})},function(t,e){t.exports=function(t){return null!=t&&"object"==typeof t}},function(t,e,n){var r,o=n(5),i=n(189),a=n(78),c=n(36),s=n(113),u=n(75),l=n(49),f=l("IE_PROTO"),p=function(){},d=function(t){return" +