From f01703a9bff3cfd02cee55237182030cf7f93511 Mon Sep 17 00:00:00 2001 From: khronokernel <48863253+khronokernel@users.noreply.github.com> Date: Sat, 16 Jul 2022 21:06:06 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=2011bd7?= =?UTF-8?q?a4083cd02c8141b7920fd25f155af1b8658=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 6 +++--- ACCEL.html | 6 +++--- BOOT.html | 6 +++--- BUILD.html | 6 +++--- DEBUG.html | 6 +++--- DONATE.html | 8 ++++---- HOW.html | 6 +++--- ICNS.html | 6 +++--- INSTALLER.html | 6 +++--- ISSUES-HOLD.html | 8 ++++---- LICENSE.html | 10 +++++----- MODELS.html | 6 +++--- MONTEREY-DROP.html | 6 +++--- PATCHEXPLAIN.html | 6 +++--- POST-INSTALL.html | 6 +++--- START.html | 6 +++--- TERMS.html | 6 +++--- TESTED.html | 6 +++--- TROUBLESHOOTING.html | 8 ++++---- UNINSTALL.html | 6 +++--- UNIVERSALCONTROL.html | 8 ++++---- UPDATE.html | 6 +++--- WINDOWS.html | 6 +++--- assets/js/{10.e1b69fa5.js => 10.134d384a.js} | 2 +- assets/js/{24.ebdb85b0.js => 24.8e484bf6.js} | 2 +- assets/js/{29.bb464292.js => 29.40021d7a.js} | 2 +- assets/js/9.0c9a4159.js | 1 + assets/js/9.23f068a0.js | 1 - assets/js/{app.80ddb062.js => app.1e4fc89e.js} | 8 ++++---- index.html | 6 +++--- 30 files changed, 86 insertions(+), 86 deletions(-) rename assets/js/{10.e1b69fa5.js => 10.134d384a.js} (99%) rename assets/js/{24.ebdb85b0.js => 24.8e484bf6.js} (94%) rename assets/js/{29.bb464292.js => 29.40021d7a.js} (58%) create mode 100644 assets/js/9.0c9a4159.js delete mode 100644 assets/js/9.23f068a0.js rename assets/js/{app.80ddb062.js => app.1e4fc89e.js} (90%) diff --git a/404.html b/404.html index c0326ba37..8ab9a7c30 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - + -

404

Looks like we've got some broken links.
+ - + diff --git a/ACCEL.html b/ACCEL.html index ffdb3a574..2db742753 100644 --- a/ACCEL.html +++ b/ACCEL.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Working Around Legacy Acceleration Issues

The below page is for users experiencing issues with their overall usage of macOS Big Sur / macOS Monterey and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur / Monterey:

  • Intel 3rd and 4th Gen - GMA series

For those unfamiliar with what is considered a non-Metal GPU, see below chart:

macOS GPU Chart

Metal is Apple's in-house graphics API that acts as a replacement for OpenGL/OpenCL, introduced in 2015. With the release of macOS Mojave, every system without a Metal-capable GPU was dropped.

Graphics Vendor Architecture Series Supports Metal
ATI TeraScale 1 HD2000 - HD4000 No
TeraScale 2 HD5000 - HD6000
AMD GCN (and newer) HD7000+ Yes
NVIDIA Tesla 8000GT - GT300 No
Fermi GT400 - GT500
Kepler GT600 - GT700 Yes
Intel GMA GMA900 - GMA3000 No
Iron Lake HD series
Sandy Bridge HD3000
Ivy Bridge (and newer) HD4000 Yes

# Broken Background Blurs

By default with the non-Metal acceleration patches, many background blur menus may act distorted when moving a cursor over it. With 0.4.1 and newer, users can enable a new Beta Blur feature to try and resolve the issue:

Do note that enabling beta blurs can be more demanding on slower hardware

# Downloading older non-Metal Apps

Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand.

Note: This archive assumes that you own these copies of these apps through the Mac App Store, Dortania does not condone piracy

# Unable to run Zoom

Currently Zoom relies partially on Metal and so needs a small binary patch. Dosdude1 has provided a nice script for this:

# Unable to grant special permissions to apps (ie. Camera Access to Zoom)

With version 0.2.5, this issue should be full resolved

0.2.4 and older Work-Around

Due to the usage of amfi_get_out_of_my_way=1, macOS will fail to prompt users for special permissions upon application start as well as omit the entires in System Preferences. To work around this, we recommend users install tccplus (opens new window) to manage permissions.

Example usage with Discord and microphone permissions:

# Open Terminal and run the following commands
+     (opens new window)    
 
# Working Around Legacy Acceleration Issues
  
The below page is for users experiencing issues with their overall usage of macOS Big Sur / macOS Monterey and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur / Monterey:
 
  • Intel 3rd and 4th Gen - GMA series
 
For those unfamiliar with what is considered a non-Metal GPU, see below chart:
 
macOS GPU Chart 
Metal is Apple's in-house graphics API that acts as a replacement for OpenGL/OpenCL, introduced in 2015. With the release of macOS Mojave, every system without a Metal-capable GPU was dropped.
 
Graphics Vendor Architecture Series Supports Metal
 
ATI TeraScale 1 HD2000 - HD4000 No
 
TeraScale 2 HD5000 - HD6000
 
AMD GCN (and newer) HD7000+ Yes
 
NVIDIA Tesla 8000GT - GT300 No
 
Fermi GT400 - GT500
 
Kepler GT600 - GT700 Yes
 
Intel GMA GMA900 - GMA3000 No
 
Iron Lake HD series
 
Sandy Bridge HD3000
 
Ivy Bridge (and newer) HD4000 Yes
 
# Broken Background Blurs
 
By default with the non-Metal acceleration patches, many background blur menus may act distorted when moving a cursor over it. With 0.4.1 and newer, users can enable a new Beta Blur feature to try and resolve the issue:
 
 
Do note that enabling beta blurs can be more demanding on slower hardware
 
# Downloading older non-Metal Apps
 
Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand.
  
Note: This archive assumes that you own these copies of these apps through the Mac App Store, Dortania does not condone piracy
 
# Unable to run Zoom
 
Currently Zoom relies partially on Metal and so needs a small binary patch. Dosdude1 has provided a nice script for this:
  
# Unable to grant special permissions to apps (ie. Camera Access to Zoom)
 
With version 0.2.5, this issue should be full resolved
 
0.2.4 and older Work-Around 
Due to the usage of amfi_get_out_of_my_way=1, macOS will fail to prompt users for special permissions upon application start as well as omit the entires in System Preferences. To work around this, we recommend users install tccplus (opens new window) to manage permissions.
 
Example usage with Discord and microphone permissions:
 
# Open Terminal and run the following commands
 cd ~/Downloads/
 chmod +x tccplus
 ./tccplus add Microphone com.hnc.Discord
@@ -46,6 +46,6 @@ nvram FA4CE28D-B62F-4C99-9CC3-6815686E30F9:gpu-power-prefs

-    
+    
   
 
diff --git a/BOOT.html b/BOOT.html
index 117b9d380..68ed340c5 100644
--- a/BOOT.html
+++ b/BOOT.html
@@ -11,7 +11,7 @@
     
     
     
-    
+    
     
   
   
@@ -19,7 +19,7 @@
     GitHub
      (opens new window)

# Booting OpenCore and macOS

Now we finally get to boot OpenCore!

Reboot machine while holding Option to select the EFI Boot entry with the OpenCore icon (holding the Control key will make this the default boot entry):

  • This will be the Mac Boot Picker

Note for Mac Pros/Xserves/iMacs with unflashed GPUs

(Adapted from the OpenCore on the Mac Pro guide (opens new window))

For Mac Pro, Xserve and, iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process.

Firstly, open the Terminal and run the following command:

sudo nvram "recovery-boot-mode=unused" && sudo reboot recovery
+     (opens new window)    
 
# Booting OpenCore and macOS
 
Now we finally get to boot OpenCore!
 
Reboot machine while holding Option to select the EFI Boot entry with the OpenCore icon (holding the Control key will make this the default boot entry):
 
  • This will be the Mac Boot Picker
 
 
Note for Mac Pros/Xserves/iMacs with unflashed GPUs 
(Adapted from the OpenCore on the Mac Pro guide (opens new window))
 
For Mac Pro, Xserve and, iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process.
 
Firstly, open the Terminal and run the following command:
 
sudo nvram "recovery-boot-mode=unused" && sudo reboot recovery
 
This will make your machine reboot into the Recovery Environment. Alternatively, holding Command + R when your machine is starting up will also let you enter the Recovery.
 
Secondly, open the Recovery Environment's Terminal (Menu bar > Utilities > Terminal).
 
Now you'll want to get a list of drive identifiers. To do so, run the following command:
 
diskutil list
 
The command should produce a list of drives installed in your system:
 
 
Keep track of the drive with the OCLP install. You will need the drive identifer for later.
 
Now you'll want to mount the EFI partition (where OCLP is installed, though may differ if you've installed OCLP to a FAT-32 volume).
 
Run the following command (Replace X with the drive number):
 
diskutil mount diskXs1
@@ -35,6 +35,6 @@ If everything is correct, the EFI partion should be mounted.
 
Now you'll w
       
       ⟶
- + diff --git a/BUILD.html b/BUILD.html index 4b22ff7fd..5dc66fe14 100644 --- a/BUILD.html +++ b/BUILD.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Building and installing OpenCore

Now that we have a macOS installer, lets now build our OpenCore configuration!

If you haven't downloaded OpenCore Patcher yet, do so now:

Next, run the OpenCore-Patcher.app:

Here we'll select Build and Install OpenCore and start building:

Start Building Finished Building
OCLP GUI Build Finished

Once it finishes building, you'll want to select the Install OpenCore button:

  • 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 sit on
Select Drive Select Partition

# Once finished, head to Booting OpenCore and macOS

+ (opens new window)

# Building and installing OpenCore

Now that we have a macOS installer, lets now build our OpenCore configuration!

If you haven't downloaded OpenCore Patcher yet, do so now:

Next, run the OpenCore-Patcher.app:

Here we'll select Build and Install OpenCore and start building:

Start Building Finished Building
OCLP GUI Build Finished

Once it finishes building, you'll want to select the Install OpenCore button:

  • 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 sit on
Select Drive Select Partition

# Once finished, head to Booting OpenCore and macOS

⟵ ⟶

- + diff --git a/DEBUG.html b/DEBUG.html index c8be1863b..22f35e9cd 100644 --- a/DEBUG.html +++ b/DEBUG.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# How to debug with OpenCore

For those who've hit an odd bug and unsure if it's user error or patcher, we recommend asking on the OpenCore Patcher Paradise Discord Server (opens new window) for help.

# Debugging yourself

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:

  • "Enable Verbose Mode"
  • "Enable OpenCore DEBUG"
  • "Enable Kext DEBUG"

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.

# Obtaining OpenCore logs from disk

With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, download and run MountEFI (opens new window):

Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:

# Obtaining Kernel logs from macOS

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:

sudo dmesg > ~/Desktop/DMESG.txt
+     (opens new window)    
 
# How to debug with OpenCore
 
For those who've hit an odd bug and unsure if it's user error or patcher, we recommend asking on the OpenCore Patcher Paradise Discord Server (opens new window) for help.
 
# Debugging yourself
 
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:
 
  • "Enable Verbose Mode"
    •  
  • "Enable OpenCore DEBUG"
    •  
  • "Enable Kext DEBUG"
 
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.
 
# Obtaining OpenCore logs from disk
 
With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, download and run MountEFI (opens new window):
 
 
Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:
 
 
# Obtaining Kernel logs from macOS
 
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:
 
sudo dmesg > ~/Desktop/DMESG.txt
 
From there, you'll have a log on your desktop.
 
# Filing an issue with us
 
WARNING
 
Currently issues have been disabled due to current events. You can continue to receive support in the OpenCore Patcher Paradise Discord Server (opens new window), where there are active members of the community available.
 
Now that you have proper logs, you can now file issues with us (opens new window). Reminder we want the following info:
 
  • Model patching for (ie. MacBookPro10,1)
    •  
  • Target OS (ie. macOS 11.2.3)
    •  
  • Host OS (ie. macOS 10.15.7)
    •  
  • Upload of your OpenCore Build Folder
    •  
  • Upload of your OpenCore log (if applicable)
    •  
  • Upload of your Kernel log (if applicable)
 
Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.
  

       ⟵
       
       ⟶
- + diff --git a/DONATE.html b/DONATE.html index b421fa9de..742fa0870 100644 --- a/DONATE.html +++ b/DONATE.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Supporting the patcher

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.

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.

Main sections of help we'd appreciate:

- + diff --git a/HOW.html b/HOW.html index cb54c32c7..5af4afb28 100644 --- a/HOW.html +++ b/HOW.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Boot Process with OpenCore Legacy Patcher

OpenCore Legacy Patcher itself is actually quite a "dumb" program, and essentially edits a config.plist file and moves files around, it actually has little logic regarding the boot process. The real magic of OCLP is OpenCorePkg (opens new window), our back-end and what makes this patcher so powerful.

# Boot Process with OpenCore

To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over how OpenCore works with your Mac:

+ (opens new window)

# Boot Process with OpenCore Legacy Patcher

OpenCore Legacy Patcher itself is actually quite a "dumb" program, and essentially edits a config.plist file and moves files around, it actually has little logic regarding the boot process. The real magic of OCLP is OpenCorePkg (opens new window), our back-end and what makes this patcher so powerful.

# Boot Process with OpenCore

To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over how OpenCore works with your Mac:

⟵ ⟶

- + diff --git a/ICNS.html b/ICNS.html index 08d334e14..d8479d2f3 100644 --- a/ICNS.html +++ b/ICNS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Creating custom icons for OpenCore and Mac Boot Picker

For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.

# Custom OpenCore icons

To generate custom OpenCore icons, you'll need the following:

- + diff --git a/INSTALLER.html b/INSTALLER.html index cf3d8c5ee..6d6cdcf3a 100644 --- a/INSTALLER.html +++ b/INSTALLER.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Download and build macOS Installers

This doc is centered around downloading and writing the macOS installer to a USB. If you're already familiar with how to do this, you can skip.

  • Note: 16GB+ USB will be required for the installer

# Creating the installer

With OpenCore Legacy Patcher, our new GUI includes a download menu for macOS installers. So to start off, you'll want to grab our app:

For this guide, we'll be using the standard OpenCore-Patcher (GUI).

Once downloaded, open the app and you should be greeted with this menu:

OCLP GUI Main Menu

First we'll want to select the "Create macOS Installer" button. This will present you with 2 options:

For this example, we'll assume you'll need an installer. Selecting this option will download Apple's Installer Catalogs and build a list for you to choose:

Downloading Listed Installers
OCLP GUI Installer Download Catalog OCLP GUI Installer Download Listed Products

Since the patcher officially supports Big Sur and newer for patching, only those entires will be shown. For ourselves, we'll select 12.1 as that's the latest public release at the time of writing. This will download and install the macOS installer to your applications folder.

WARNING

With the release of the M2 MacBooks, Apple made an Apple Silicon only installer labeled "macOS 12.4 (21F2092 - 11.7GB)". Trying to boot this on Intel will not work.

Instead, download "macOS 12.4 (21F79 - 12.1GB)" or newer.

Downloading the Installer Requesting to install Finished Installing
OCLP GUI Installer Download Progress OCLP GUI Installer Needs Installing OCLP GUI Installer Download Finished

Once finished, you can proceed to write the installer onto a USB drive.

  • Note: The entire USB drive will be formatted
Select Downloaded Installer Select disk to format

Now the patcher will start the installer flashing!

Flashing Success Prompt Finished Flashing

# Once finished, head to Building and installing OpenCore

+ (opens new window)

# Download and build macOS Installers

This doc is centered around downloading and writing the macOS installer to a USB. If you're already familiar with how to do this, you can skip.

  • Note: 16GB+ USB will be required for the installer

# Creating the installer

With OpenCore Legacy Patcher, our new GUI includes a download menu for macOS installers. So to start off, you'll want to grab our app:

For this guide, we'll be using the standard OpenCore-Patcher (GUI).

Once downloaded, open the app and you should be greeted with this menu:

OCLP GUI Main Menu

First we'll want to select the "Create macOS Installer" button. This will present you with 2 options:

For this example, we'll assume you'll need an installer. Selecting this option will download Apple's Installer Catalogs and build a list for you to choose:

Downloading Listed Installers
OCLP GUI Installer Download Catalog OCLP GUI Installer Download Listed Products

Since the patcher officially supports Big Sur and newer for patching, only those entires will be shown. For ourselves, we'll select 12.1 as that's the latest public release at the time of writing. This will download and install the macOS installer to your applications folder.

WARNING

With the release of the M2 MacBooks, Apple made an Apple Silicon only installer labeled "macOS 12.4 (21F2092 - 11.7GB)". Trying to boot this on Intel will not work.

Instead, download "macOS 12.4 (21F79 - 12.1GB)" or newer.

Downloading the Installer Requesting to install Finished Installing
OCLP GUI Installer Download Progress OCLP GUI Installer Needs Installing OCLP GUI Installer Download Finished

Once finished, you can proceed to write the installer onto a USB drive.

  • Note: The entire USB drive will be formatted
Select Downloaded Installer Select disk to format

Now the patcher will start the installer flashing!

Flashing Success Prompt Finished Flashing

# Once finished, head to Building and installing OpenCore

⟵ ⟶

- + diff --git a/ISSUES-HOLD.html b/ISSUES-HOLD.html index 9fd292509..831412c77 100644 --- a/ISSUES-HOLD.html +++ b/ISSUES-HOLD.html @@ -11,7 +11,7 @@ - + @@ -19,15 +19,15 @@ GitHub (opens new window)

# The current hold on new issues and pull requests

As written with the release of OpenCore Legacy Patcher 0.4.3, and macOS 12.3:

With today's macOS 12.3 release, I decided it would be best to release this build of OpenCore Legacy Patcher to ensure some important issues are resolved with today's release (namely Open/Save dialog problem introduced by Apple in the 12.3 Betas)

As the situation develops back home with my family in Ukraine, I am unlikely to continue the development of OpenCore Legacy Patcher in the near future. At most, there may be potential PatcherSupportPkg updates from ASentientBot and the rest of the amazing non-Metal development team however otherwise development may potentially be taken over by others later on. Issues will continue to remain closed for the time being.

With regards to the future of this project, this release should be treated as its last major release for the next couple of months. When WWDC2022 is presented, I hope my country will be in a calmer situation where we can tinker with Macs again peacefully.

This is not a final goodbye for me with this project, just a round-about way to say I'll be returning someday. I want to give the biggest thank you's to the community and to the many amazing developers within it. OpenCore Legacy Patcher is not just my project, it's the cumulation of many people that are all responsible for where we are today.

-- Mykola

If you encounter new issues with the patcher that do not have solutions easily available, our helpful community in the OpenCore Patcher Paradise Discord Server (opens new window) can provide support in the meantime. You should still provide as much information as you can by gathering debug logs when you ask for help.

+ (opens new window)

# The current hold on new issues and pull requests

As written with the release of OpenCore Legacy Patcher 0.4.3, and macOS 12.3:

With today's macOS 12.3 release, I decided it would be best to release this build of OpenCore Legacy Patcher to ensure some important issues are resolved with today's release (namely Open/Save dialog problem introduced by Apple in the 12.3 Betas)

As the situation develops back home with my family in Ukraine, I am unlikely to continue the development of OpenCore Legacy Patcher in the near future. At most, there may be potential PatcherSupportPkg updates from ASentientBot and the rest of the amazing non-Metal development team however otherwise development may potentially be taken over by others later on. Issues will continue to remain closed for the time being.

With regards to the future of this project, this release should be treated as its last major release for the next couple of months. When WWDC2022 is presented, I hope my country will be in a calmer situation where we can tinker with Macs again peacefully.

This is not a final goodbye for me with this project, just a round-about way to say I'll be returning someday. I want to give the biggest thank you's to the community and to the many amazing developers within it. OpenCore Legacy Patcher is not just my project, it's the cumulation of many people that are all responsible for where we are today.

-- Mykola

If you encounter new issues with the patcher that do not have solutions easily available, our helpful community in the OpenCore Patcher Paradise Discord Server (opens new window) can provide support in the meantime. You should still provide as much information as you can by gathering debug logs when you ask for help.

⟵ Tested Models on OpenCore Legacy Patcher ⟶

- + diff --git a/LICENSE.html b/LICENSE.html index 3fb2cb118..eab64496d 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -3,7 +3,7 @@ - OpenCore Legacy Patcher Licence | OpenCore Legacy Patcher + OpenCore Legacy Patcher License | OpenCore Legacy Patcher @@ -11,7 +11,7 @@ - + @@ -19,10 +19,10 @@ GitHub (opens new window)

# OpenCore Legacy Patcher Licence

This patcher is made of multiple external applications from different people and organizations. See each program for their licensing:

Remaining files within OpenCore Legacy Patcher are copyrighted 2020-2022 Mykola Grymalyuk & Dhinak G. For integration into other projects, please request written permission.

⟵ ⟶

- + diff --git a/MODELS.html b/MODELS.html index b21ba2df4..63b35acb4 100644 --- a/MODELS.html +++ b/MODELS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Supported Models

Any hardware supporting SSE4.1 CPU and 64-Bit firmware work on this patcher. To check your hardware model, run the below command on the applicable machine in terminal:

system_profiler SPHardwareDataType | grep 'Model Identifier'
+     (opens new window)    
 
# Supported Models
 
Any hardware supporting SSE4.1 CPU and 64-Bit firmware work on this patcher. To check your hardware model, run the below command on the applicable machine in terminal:
 
system_profiler SPHardwareDataType | grep 'Model Identifier'
 
The below table will list all supported and unsupported functions of the patcher currently:
  
Regarding OS support, see below:
 
Support Entry Supported OSes Description Comment
 
HostOS macOS 10.9 - macOS 12 Refers to OSes where running OpenCore-Patcher.app are supported Supports 10.7+ if Python 3.9 or higher (opens new window) is manually installed, simply run the OpenCore-Patcher.command located in the repo
 
TargetOS macOS 11 - macOS 12 Refers to OSes that can be patched to run with OpenCore May support 10.4 and newer (in a potentially broken state). No support provided.
 
# MacBook
 
SMBIOS Year Supported Comment
 
MacBook1,1 Mid-2006  NO  32-Bit CPU limitation
 
MacBook2,1 Late 2006 32-Bit Firmware limitation
 
MacBook3,1 Late 2007
 
MacBook4,1 Early 2008  YES  - No GPU Acceleration in Mavericks and newer
- No Keyboard and Trackpad
- No USB
 
MacBook5,1 Late 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
MacBook5,2 Early 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
- Trackpad is recognized as mouse
 
MacBook6,1 Late 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
MacBook7,1 Mid-2010
 
MacBook8,1 Mid-2015  Everything is supported
 
# MacBook Air
 
SMBIOS Year Supported Comment
 
MacBookAir1,1 Early 2008  NO  Requires SSE4.1 CPU
 
MacBookAir2,1 Late 2008  YES  GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
MacBookAir3,1 Late 2010
 
MacBookAir3,2
 
MacBookAir4,1 Mid-2011
 
MacBookAir4,2
 
MacBookAir5,1 Mid-2012  Everything is supported
 
MacBookAir5,2
 
MacBookAir6,1 Mid-2013, Early 2014
 
MacBookAir6,2
 
# MacBook Pro
 
SMBIOS Year Supported Comment
 
MacBookPro1,1 Early 2006  NO  32-Bit CPU limitation
 
MacBookPro1,2
 
MacBookPro2,1 Late 2006 32-Bit Firmware limitation
 
MacBookPro2,2 Late 2006
 
MacBookPro3,1 Mid-2007 Requires SSE4.1 CPU
 
MacBookPro4,1 Early 2008  YES  GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
MacBookPro5,1 Late 2008
 
MacBookPro5,2 Early 2009
 
MacBookPro5,3 Mid-2009
 
MacBookPro5,4
 
MacBookPro5,5
 
MacBookPro6,1 Mid-2010
 
MacBookPro6,2
 
MacBookPro7,1
 
MacBookPro8,1 Early 2011
 
MacBookPro8,2
 
MacBookPro8,3
 
MacBookPro9,1 Mid-2012  Everything is supported
 
MacBookPro9,2
 
MacBookPro10,1 Mid-2012, Early 2013
 
MacBookPro10,2 Late 2012, Early 2013
 
MacBookPro11,1 Late 2013, Mid-2014
 
MacBookPro11,2
 
MacBookPro11,3
 
# Mac mini
 
SMBIOS Year Supported Comment
 
Macmini1,1 Early 2006  NO  32-Bit CPU limitation
 
Macmini2,1 Mid-2007 32-Bit Firmware limitation
 
Macmini3,1 Early 2009  YES  GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
Macmini4,1 Mid-2010
 
Macmini5,1 Mid-2011
 
Macmini5,2
 
Macmini5,3
 
Macmini6,1 Late 2012  Everything is supported
 
Macmini6,2
 
# iMac
 
SMBIOS Year Supported Comment
 
iMac4,1 Early 2006  NO  32-Bit CPU limitation
 
iMac4,2 Mid-2006
 
iMac5,1 Late 2006 32-Bit Firmware limitation
 
iMac5,2
 
iMac6,1
 
iMac7,1 Mid-2007  YES  - Requires an SSE4.1 CPU Upgrade (opens new window)
- GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
- Stock Bluetooth 2.0 card non-functional
 
iMac8,1 Early 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window)))
 
iMac9,1 Early 2009
 
iMac10,1 Late 2009 - GPU is socketed, recommend upgrading to Metal GPU (opens new window) 
- GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
 
iMac11,1
 
iMac11,2 Mid-2010
 
iMac11,3
 
iMac12,1 Mid-2011
 
iMac12,2
 
iMac13,1 Late 2012  Everything is supported
 
iMac13,2
 
iMac13,3
 
iMac14,1 Late 2013
 
iMac14,2
 
iMac14,3
 
iMac14,4 Mid-2014
 
iMac15,1 Late 2014, Mid-2015
  
# Mac Pro
 
SMBIOS Year Supported Comment
 
MacPro1,1 Mid-2006  NO  32-Bit Firmware limitation
 
MacPro2,1 Mid-2007
 
MacPro3,1 Early 2008  YES  - Potential boot issues with built-in USB 1.1 ports (recommend using a USB 2.0 hub or dedicated USB PCIe controller)
- Potential boot issues with stock Bluetooth card, recommend removing to avoid kernel panics
 
MacPro4,1 Early 2009  Everything is supported as long as GPU is Metal capable 
 
MacPro5,1 Mid-2010, Mid-2012
 
# Xserve
 
SMBIOS Year Supported Comment
 
Xserve1,1 Mid-2006  NO  32-Bit Firmware limitation
 
Xserve2,1 Early 2008  YES   Everything is supported as long as GPU is Metal capable 
 
Xserve3,1 Early 2009
 
# Once you've verified your hardware is supported, head to Download and build macOS Installers
  

       ⟵
       
       ⟶
- + diff --git a/MONTEREY-DROP.html b/MONTEREY-DROP.html index 9514ec9fe..e4aba8bf3 100644 --- a/MONTEREY-DROP.html +++ b/MONTEREY-DROP.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

With OpenCore Legacy Patcher v0.1.7 and newer, we've implemented beta macOS Monterey support for users. Please note that Apple has dropped a lot of hardware with this release as well as broken many of our previous patch sets. This page will be used to inform users regarding current issues and will be updated as new patch sets are developed and added to our patcher.

# Newly dropped hardware

With Monterey, Apple continues their their somewhat ruthless march of dropping Intel hardware. This release saw the removal, and thus addition into OpenCore Legacy Patcher, of the following models:

  • iMac14,4
  • iMac15,1
  • MacBook8,1
  • MacBookAir6,1
  • MacBookAir6,2
  • MacBookPro11,1
  • MacBookPro11,2
  • MacBookPro11,3
Model names
  • iMac (21.5-inch, Mid 2014)
  • iMac (Retina 5K, 27-inch, Late 2014)
  • MacBook (Retina, 12-inch, Early 2015)
  • MacBook Air (11-inch, Mid 2013)
  • MacBook Air (13-inch, Mid 2013)
  • MacBook Air (11-inch, Early 2014)
  • MacBook Air (13-inch, Early 2014)
  • MacBook Pro (Retina, 13-inch, Late 2013)
  • MacBook Pro (Retina, 15-inch, Late 2013)
  • MacBook Pro (Retina, 13-inch, Mid 2014)
  • MacBook Pro (Retina, 15-inch, Mid 2014)

All of these models now have support in OpenCore Legacy Patcher.

# Current Monterey Issues

# MacBookPro11,3 booting issue without Kepler acceleration

Due to the display being routed through the NVIDIA Kepler card and macOS being rendered on the Intel iGPU, users have been experiencing issues booting without post-install patches applied (see here for more info (opens new window).) Currently the only workaround is to install the patches in safe mode, by holding down Shift+Enter when you select macOS in the OCLP boot picker.

# Previously Broken Hardware

iMac15,1 5K Display Output Issue (Resolved in 0.3.2 and newer)
- + diff --git a/PATCHEXPLAIN.html b/PATCHEXPLAIN.html index f17f37d8d..eeb7363bd 100644 --- a/PATCHEXPLAIN.html +++ b/PATCHEXPLAIN.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Explaining the patches in OpenCore Legacy Patcher

In our patcher, there are numerous patches used to ensure a stable system. Here we're going to go over what patches are used and why we recommend or even require them.

# OpenCore Settings

Below is a run down of the main logic OpenCore Legacy Patcher uses to gain native support in macOS. Note OpenCore's configuration is documented within OpenCorePkg (opens new window) as well as an online version provided by us:

Configuration Explanation

# ACPI -> Add

- + diff --git a/POST-INSTALL.html b/POST-INSTALL.html index 9d55935e5..8ab9642b5 100644 --- a/POST-INSTALL.html +++ b/POST-INSTALL.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Post-Installation

# Booting without USB drive

Once you've installed macOS through OpenCore, you can boot up and go through the regular install process. To boot without the USB drive plugged in is quite simple:

  • Download OpenCore Legacy Patcher
  • Change Patcher settings as you'd like
  • Build OpenCore again
  • Install OpenCore to internal drive
  • Reboot holding Option, and select the internal EFI

And voila! No more USB drive required

# Booting seamlessly without Verbose or OpenCore Picker

To do this, run the OpenCore Patcher and head to Patcher Settings:

GUI Settings TUI Settings

Here you can change different patcher settings, however the main interest is:

  • Show Boot Picker (GUI)
  • Set ShowPicker Mode (TUI)

Once you've toggled them both off, build your OpenCore EFI once again and install to your desired drive. Now to show the OpenCore selector, you can simply hold down the "ESC" key while clicking on EFI boot, then you can release the "ESC" key when you see the cursor arrow at the top left.

# Enabling SIP

For many users, SIP will be enabled by default on build. For Intel HD 4000 users, you may have noticed that SIP is partially disabled. This is to ensure full compatibility with macOS Monterey and allow seamless booting between it and older OSes. However for users who do not plan to boot Monterey, you can re-enable under Patcher Settings.

Note: Machines with non-Metal GPUs cannot enable SIP in Big Sur either due to patched root volume

SIP Enabled SIP Lowered (Root Patching) SIP Disabled

WARNING

If you're unsure whether you should enable SIP, leave as-is. Systems where you have already ran the Post Install Root Patching cannot enable SIP without potentially breaking the current install.

# Applying Post Install Volume Patches

Post Install Volume Patches, sometimes also called root patches, are patches that have to be installed on disk for some older Macs to gain back functionality.

OCLP v0.4.4 and higher include an autopatcher, which will automatically root patch your system but only if the USB install media was created within OCLP.

Users with OCLP v0.4.4 or higher will also be prompted to install these patches after macOS updates or whenever patches are not detected on the system. We recommend rebuilding OpenCore with the latest version of OCLP to take advantage of these new features.

In OCLP v0.4.5 a new indicator was added to help users to see if, when and on what version the system was root patched. Note that the "Available patches" section above this does not track the status and will always show the patches that are available, whether they're installed or not.

Automatic install prompt in 0.4.4+ Last patched status in 0.4.5+

# Running Post Install patches manually

If you're using OCLP v0.4.3 or earlier, or need to run the patcher manually, you can do so with the app. There is no harm in trying to run the Patcher, as without compatible hardware nothing will be done. You can see below on whether your hardware needs root volume patching.

Listing Patches Patching Finished

WARNING

With OpenCore Legacy Patcher versions prior to v0.4.4, Root Patching requires a network connection by default to grab associated resources. If your system is having difficulties with wifi or ethernet, you can grab the newest release :

Unsupported GPUs in macOS Big Sur
- + diff --git a/START.html b/START.html index 246c81bb8..5a39cbe36 100644 --- a/START.html +++ b/START.html @@ -11,7 +11,7 @@ - + @@ -19,11 +19,11 @@ GitHub (opens new window)

# What is OpenCore?

This is a sophisticated boot loader used to inject and patch data in memory, instead of on disk. This means we're able to get near-native experience on many unsupported Macs.

# How do I get started?

  1. The first step of ensuring whether your model is supported is checking here:
  1. Download and build macOS Installer
  2. Run the OpenCore-Patcher.app
  3. Reboot and boot OpenCore

+ (opens new window)

# What is OpenCore?

This is a sophisticated boot loader used to inject and patch data in memory, instead of on disk. This means we're able to get near-native experience on many unsupported Macs.

# How do I get started?

  1. The first step of ensuring whether your model is supported is checking here:
  1. Download and build macOS Installer
  2. Run the OpenCore-Patcher.app
  3. Reboot and boot OpenCore

Supported Models ⟶

- + diff --git a/TERMS.html b/TERMS.html index ef628832c..51e1d2b08 100644 --- a/TERMS.html +++ b/TERMS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# OpenCore Patcher Terminology

With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including SSE4.1, 32-Bit Firmware, etc. This page is to help users understand what all these confusing words mean.

# Terminology

Term Description
macOS Apple's own UNIX based OS used for Mac machines and "What makes a Mac a Mac".
Windows Microsoft's proprietary OS that is used and supported on a wide range of devices
Linux Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.
Bootloader Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.
Boot Manager Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.
Term Description
OpenCore The new hotness on the scene, made with security in mind by the Acidanthera team (opens new window), has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc
ACPI Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup
NVRAM Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc
Term Description
XNU Also known as X is Not Unix, XNU is referred to as macOS's "kernel" and the heart of what makes macOS tick
Kexts Also known as Kernel Extensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.
KernelCollection Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience
- PrelinkedKernel: Default caching system since 10.7
- ImmutableKernel: Secure Boot based caching system since 10.13
- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur
IOKit Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates
WindowServer Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in
OTA Short for Over The Air, refers to native OS updates via System Preferences like a supported Mac
DELTA Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmodified otherwise ~12GB updates will occur.
Term Description
EFI It can denote two things:
- Mac's firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal"
- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.
HFS+ Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks
APFS This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.
32 and 64-Bit CPU The bit number of a CPU determines how much data a CPU can address.
- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.
32-Bit Firmware The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware
- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.
SSE Instructions Also known as SIMD Single-Precision Floating-Point Instructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation:
- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger
- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard
- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra

+ (opens new window)

# OpenCore Patcher Terminology

With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including SSE4.1, 32-Bit Firmware, etc. This page is to help users understand what all these confusing words mean.

# Terminology

Term Description
macOS Apple's own UNIX based OS used for Mac machines and "What makes a Mac a Mac".
Windows Microsoft's proprietary OS that is used and supported on a wide range of devices
Linux Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.
Bootloader Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.
Boot Manager Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.
Term Description
OpenCore The new hotness on the scene, made with security in mind by the Acidanthera team (opens new window), has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc
ACPI Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup
NVRAM Non-volatile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc
Term Description
XNU Also known as X is Not Unix, XNU is referred to as macOS's "kernel" and the heart of what makes macOS tick
Kexts Also known as Kernel Extensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.
KernelCollection Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience
- PrelinkedKernel: Default caching system since 10.7
- ImmutableKernel: Secure Boot based caching system since 10.13
- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur
IOKit Backbone of how Kernel Extensions (Kexts) probe and attach onto hardware, starts quickly after kernel initiates
WindowServer Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in
OTA Short for Over The Air, refers to native OS updates via System Preferences like a supported Mac
DELTA Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmodified otherwise ~12GB updates will occur.
Term Description
EFI It can denote two things:
- Mac's firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal"
- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.
HFS+ Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks
APFS This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.
32 and 64-Bit CPU The bit number of a CPU determines how much data a CPU can address.
- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.
32-Bit Firmware The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware
- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.
SSE Instructions Also known as SIMD Single-Precision Floating-Point Instructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation:
- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger
- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard
- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra

⟵ ⟶

- + diff --git a/TESTED.html b/TESTED.html index 8a662c905..97a444e88 100644 --- a/TESTED.html +++ b/TESTED.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Tested Models on OpenCore Legacy Patcher

To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.

MacBook
SMBIOS Tested Tester Model Version Comment
MacBook4,1 YES Mami Stock Unknown Couldn't install due to broke USB support
MacBook5,1 air.man 0.0.19 N/A
MacBook5,2 Finder352
MacBook6,1 Finder352
MacBook7,1 MykolaG
Jazzzny
AlexSakha67 0.0.20
MacBook8,1 NO N/A N/A N/A
MacBook Air
SMBIOS Tested Tester Model Version Comment
MacBookAir2,1 YES Bruno Stock 0.4.5 Slow to the point of being unusable.
MacBookAir3,1 uvesten Stock 0.3.3 N/A
MacBookAir3,2 houser42 Unknown
MacBookAir4,1 NO N/A N/A N/A
MacBookAir4,2 YES bdwilson1907 Stock 0.3.1 Intermittent keyboard backlight
MacBookAir5,1 Ausdauersportler 0.0.9 N/A
webg3 Unknown
MacBookAir5,2 Bab-droid 0.0.19
K-Hobert Unknown
cboukouv 0.0.21
MacBookAir6,1 NO N/A N/A N/A N/A
MacBookAir6,2
MacBook Pro
SMBIOS Tested Tester Model Version Comment
MacBookPro4,1 YES cboukouv Stock 0.0.19 N/A
MacBookPro5,1 GURU_Jasho#5736 0.0.21
MacBookPro5,2 hvds
MacBookPro5,3 kommtzeitkonrad 0.0.22
MacBookPro5,4 NO N/A N/A N/A
MacBookPro5,5 YES ASentientHedgehog Stock -
ParaDoX1994 Stock 0.4.5 Camera/Bluetooth not working (connector broken)
MacBookPro6,1 NO N/A N/A N/A N/A
MacBookPro6,2 YES Jakeluke Stock Unknown dGPU broken
MacBookPro7,1 fussel132 0.1.2 N/A
casey1234 Upgraded 0.3.3 Upgraded SSD
MacBookPro8,1 YES AvaQueen Stock 0.0.19 N/A
MacBookPro8,1 charly-black Upgraded 0.3.1 Upgraded BCM94331PCIEBT4CAX
MacBookPro8,2 air.man Stock 0.0.22 dGPU disabled
cboukouv 0.0.19 N/A
MacBookPro8,3 lulujyc 0.1.4 dGPU disabled
MacBookPro9,1 YES jbdamiano Stock 0.0.19 N/A
dennes544
cgrazy
LIPA85
MacBookPro9,2 YES alexx17xx
Arvxistanx
CyberDroid1 0.0.16
woefi Upgraded 0.0.13 Upgraded BCM94331CAX
whgmkeller Stock 0.0.11 N/A
vinaypundith Unknown 0.0.7
casey1234 Upgraded 0.3.3 Upgraded RAM and SSD
crystall1nedev Upgraded 0.4.4
MacBookPro10,1 YES traviswparker Stock 0.0.14 N/A
il-rollino Upgraded 0.0.21 Upgraded BCM94360CSAX
MacBookPro10,2 akidone 0.3.0
MacBookPro11,1 YES ParaDoX1994 Stock 0.4.4 N/A
MacBookPro11,2 casey1234 0.3.3
MacBookPro11,3 NO N/A N/A N/A N/A
Mac mini
SMBIOS Tested Tester Model Version Comment
Macmini3,1 YES ASentientHedgehog Stock N/A N/A
Macmini4,1 YES Towster15#6369 0.4.4 Does not have internal SATA cable, booted and installed to SSD over USB 2.0 instead
MykolaG 0.4.5 SD card reader possibly broken.
Macmini5,1 YES MykolaG 0.4.5 N/A
Macmini5,2 charly-black 0.3.1
MykolaG 0.4.5 SD card reader possibly broken.
Macmini5,3 NO N/A N/A N/A N/A
Macmini6,1 YES cicofz Stock 0.0.21
Stig124 0.0.19
mwidjaya 0.0.18
MykolaG 0.4.5
Macmini6,2 Shelbs 0.0.16
Macmini7,1 YES MykolaG 0.4.5
Macmini8,1 0.4.5
iMac
SMBIOS Tested Tester Model Version Comment
iMac7,1 YES lulujyc Upgraded 0.3.1 Upgraded with BCM94352HMB

The USB 1.1 controller is unstable on Big Sur+, using USB hubs (forcing USB 2.0) can fix unrecognized keyboard/ mouse.
iMac8,1 YES EduCovas Stock 0.0.21 N/A
iMac9,1 YES Allanrfox
Jakeluke
iMac10,1 YES Ausdauersportler Upgraded Unknown Upgraded with WX4150
iMac11,1 internetzel Upgraded RX580 mobile
iMac11,2 MykolaG Stock 0.0.21 N/A
iMac-iPad
vinaypundith Unknown 0.0.19
iMac11,3 Ausdauersportler Upgraded 0.0.21 Upgraded with Polaris GPU and BCM943602CDP
iMac12,1 YES shnockdu Upgraded with Kepler GPU
StephN999 Upgraded with WX4150 GPU and BCM94360CD
iMac12,2 Ausdauersportler Upgraded with Polaris GPU and BCM943602CDP
iMac13,1 YES alexx17xx Stock 0.0.19 N/A
iMac13,2 Alain13
algernonpule
iMac13,3 NO N/A N/A N/A
iMac14,1 YES woefi Upgraded 0.0.21 Upgraded NVMe
mikeboss Stock 0.0.19 N/A
iMac14,2 OKonnel 0.0.22
mibaxx 0.0.21
iMac14,3 StupeFied 0.4.5
iMac15,1 YES JakubMazur Upgraded 0.4.1 Upgraded RAM, Radeon R9 M295X and Quad-Core Intel Core i7
Mac Pro
SMBIOS Tested Tester Model Version Comment
MacPro3,1 YES MykolaG Upgraded 0.1.6 Upgraded RX 470 and BCM94360CD.
Stock Bluetooth card removed.
christiann 0.0.21 Upgraded RX 560 and BCM94322.
Stock Bluetooth card removed.
gw463 0.0.22 Upgraded GTX 680 and BCM94360
AlexSakha67 0.0.20 Upgraded R9 280
nekton1 Upgraded GTX 680
Pri-est Unknown 0.0.9 N/A
vinaypundith Upgraded 0.0.6 Upgraded with GTX 680 and BCM94360CD.
ParaDoX1994 0.4.4 Upgraded with HD 7950.
Stock Bluetooth card removed.
MacPro4,1 YES vinaypundith Unknown 0.0.9 N/A
MacPro5,1 woefi Upgraded 0.0.21 Upgraded with RX 580.
Mabrouk Oscar Unknown N/A
astuffedtiger Flashed 0.0.18 MacPro4,1 flashed to 5,1

+ (opens new window)

# Tested Models on OpenCore Legacy Patcher

To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.

MacBook
SMBIOS Tested Tester Model Version Comment
MacBook4,1 YES Mami Stock Unknown Couldn't install due to broke USB support
MacBook5,1 air.man 0.0.19 N/A
MacBook5,2 Finder352
MacBook6,1 Finder352
MacBook7,1 MykolaG
Jazzzny
AlexSakha67 0.0.20
MacBook8,1 NO N/A N/A N/A
MacBook Air
SMBIOS Tested Tester Model Version Comment
MacBookAir2,1 YES Bruno Stock 0.4.5 Slow to the point of being unusable.
MacBookAir3,1 uvesten Stock 0.3.3 N/A
MacBookAir3,2 houser42 Unknown
MacBookAir4,1 NO N/A N/A N/A
MacBookAir4,2 YES bdwilson1907 Stock 0.3.1 Intermittent keyboard backlight
MacBookAir5,1 Ausdauersportler 0.0.9 N/A
webg3 Unknown
MacBookAir5,2 Bab-droid 0.0.19
K-Hobert Unknown
cboukouv 0.0.21
MacBookAir6,1 NO N/A N/A N/A N/A
MacBookAir6,2
MacBook Pro
SMBIOS Tested Tester Model Version Comment
MacBookPro4,1 YES cboukouv Stock 0.0.19 N/A
MacBookPro5,1 GURU_Jasho#5736 0.0.21
MacBookPro5,2 hvds
MacBookPro5,3 kommtzeitkonrad 0.0.22
MacBookPro5,4 NO N/A N/A N/A
MacBookPro5,5 YES ASentientHedgehog Stock -
ParaDoX1994 Stock 0.4.5 Camera/Bluetooth not working (connector broken)
MacBookPro6,1 NO N/A N/A N/A N/A
MacBookPro6,2 YES Jakeluke Stock Unknown dGPU broken
MacBookPro7,1 fussel132 0.1.2 N/A
casey1234 Upgraded 0.3.3 Upgraded SSD
MacBookPro8,1 YES AvaQueen Stock 0.0.19 N/A
MacBookPro8,1 charly-black Upgraded 0.3.1 Upgraded BCM94331PCIEBT4CAX
MacBookPro8,2 air.man Stock 0.0.22 dGPU disabled
cboukouv 0.0.19 N/A
MacBookPro8,3 lulujyc 0.1.4 dGPU disabled
MacBookPro9,1 YES jbdamiano Stock 0.0.19 N/A
dennes544
cgrazy
LIPA85
MacBookPro9,2 YES alexx17xx
Arvxistanx
CyberDroid1 0.0.16
woefi Upgraded 0.0.13 Upgraded BCM94331CAX
whgmkeller Stock 0.0.11 N/A
vinaypundith Unknown 0.0.7
casey1234 Upgraded 0.3.3 Upgraded RAM and SSD
crystall1nedev Upgraded 0.4.4
MacBookPro10,1 YES traviswparker Stock 0.0.14 N/A
il-rollino Upgraded 0.0.21 Upgraded BCM94360CSAX
MacBookPro10,2 akidone 0.3.0
MacBookPro11,1 YES ParaDoX1994 Stock 0.4.4 N/A
MacBookPro11,2 casey1234 0.3.3
MacBookPro11,3 NO N/A N/A N/A N/A
Mac mini
SMBIOS Tested Tester Model Version Comment
Macmini3,1 YES ASentientHedgehog Stock N/A N/A
Macmini4,1 YES Towster15#6369 0.4.4 Does not have internal SATA cable, booted and installed to SSD over USB 2.0 instead
MykolaG 0.4.5 SD card reader possibly broken.
Macmini5,1 YES MykolaG 0.4.5 N/A
Macmini5,2 charly-black 0.3.1
MykolaG 0.4.5 SD card reader possibly broken.
Macmini5,3 NO N/A N/A N/A N/A
Macmini6,1 YES cicofz Stock 0.0.21
Stig124 0.0.19
mwidjaya 0.0.18
MykolaG 0.4.5
Macmini6,2 Shelbs 0.0.16
Macmini7,1 YES MykolaG 0.4.5
Macmini8,1 0.4.5
iMac
SMBIOS Tested Tester Model Version Comment
iMac7,1 YES lulujyc Upgraded 0.3.1 Upgraded with BCM94352HMB

The USB 1.1 controller is unstable on Big Sur+, using USB hubs (forcing USB 2.0) can fix unrecognized keyboard/ mouse.
iMac8,1 YES EduCovas Stock 0.0.21 N/A
iMac9,1 YES Allanrfox
Jakeluke
iMac10,1 YES Ausdauersportler Upgraded Unknown Upgraded with WX4150
iMac11,1 internetzel Upgraded RX580 mobile
iMac11,2 MykolaG Stock 0.0.21 N/A
iMac-iPad
vinaypundith Unknown 0.0.19
iMac11,3 Ausdauersportler Upgraded 0.0.21 Upgraded with Polaris GPU and BCM943602CDP
iMac12,1 YES shnockdu Upgraded with Kepler GPU
StephN999 Upgraded with WX4150 GPU and BCM94360CD
iMac12,2 Ausdauersportler Upgraded with Polaris GPU and BCM943602CDP
iMac13,1 YES alexx17xx Stock 0.0.19 N/A
iMac13,2 Alain13
algernonpule
iMac13,3 NO N/A N/A N/A
iMac14,1 YES woefi Upgraded 0.0.21 Upgraded NVMe
mikeboss Stock 0.0.19 N/A
iMac14,2 OKonnel 0.0.22
mibaxx 0.0.21
iMac14,3 StupeFied 0.4.5
iMac15,1 YES JakubMazur Upgraded 0.4.1 Upgraded RAM, Radeon R9 M295X and Quad-Core Intel Core i7
Mac Pro
SMBIOS Tested Tester Model Version Comment
MacPro3,1 YES MykolaG Upgraded 0.1.6 Upgraded RX 470 and BCM94360CD.
Stock Bluetooth card removed.
christiann 0.0.21 Upgraded RX 560 and BCM94322.
Stock Bluetooth card removed.
gw463 0.0.22 Upgraded GTX 680 and BCM94360
AlexSakha67 0.0.20 Upgraded R9 280
nekton1 Upgraded GTX 680
Pri-est Unknown 0.0.9 N/A
vinaypundith Upgraded 0.0.6 Upgraded with GTX 680 and BCM94360CD.
ParaDoX1994 0.4.4 Upgraded with HD 7950.
Stock Bluetooth card removed.
MacPro4,1 YES vinaypundith Unknown 0.0.9 N/A
MacPro5,1 woefi Upgraded 0.0.21 Upgraded with RX 580.
Mabrouk Oscar Unknown N/A
astuffedtiger Flashed 0.0.18 MacPro4,1 flashed to 5,1

⟵ ⟶

- + diff --git a/TROUBLESHOOTING.html b/TROUBLESHOOTING.html index 0d6e8d054..b81cf88df 100644 --- a/TROUBLESHOOTING.html +++ b/TROUBLESHOOTING.html @@ -11,7 +11,7 @@ - + @@ -19,11 +19,11 @@ GitHub (opens new window)

# Troubleshooting

Here are some common errors 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 
+     (opens new window)    
 
# Troubleshooting
 
Here are some common errors 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
 
This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore before the macOS installer in the boot picker. Reminder the option will be called EFI Boot
 
Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.
 
# Cannot boot macOS without the USB
 
By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either manually transfer (opens new window) OpenCore to the internal drive's EFI or run this patcher's Option 2 again but 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, simply uninstall OpenCore and reset NVRAM (opens new window).
 
  • Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored
 
# Reboot when entering Hibernation (Sleep Wake Failure)
 
Known issue on some models (opens new window), temporary fix is to disable Hibernation:
 
sudo pmset -a hibernatemode 0
 
# Booting with a non-flashed GPU
 
For Mac Pro, Xserve and iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process. To do so, make sure SIP is disabled(to allow NVRAM write access) and run the following:
 
sudo bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot
 
  • Note you will need to replace VOLNAME with the Volume name of your USB or hard drive with OpenCore
    •  
  • Note 2: Once done, you can re-enable SIP
    •  
  • Note 3: The EFI partition OpenCore was installed on must be mounted, if it's unmounted simply rerun "Install OpenCore to drive"
 
Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with RequestBootVar, all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.
 
# How to Boot Big Sur Recovery
 
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" 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 the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting 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.
 
To work-around, we recommend user 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, we recommend users to manually connect using the "other" option on the Wi-Fi menu bar or manually adding the network on the "Network" preference pane.
 
# No Graphics Acceleration
 
In macOS, each release generally means GPU drivers are dropped from the OS. 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.
 
If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after first boot from installation of macOS. If you need to do this manually, you can within our 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.
 
  • Safe Mode can be started by holding Shift+Enter when selecting macOS Monterey in OCLP's Boot Menu.
 
# No DisplayPort Output on Mac Pros with NVIDIA Kepler
 
If you're having troubles 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 play nicer.
 
 
# 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 the boot volume's hash does not match to what the OS detects, 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 NVRAM reset. However for users wanting to disable SIP entirely, this can be done easily.
 
Head into the GUI, 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.
 
  • 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.
-
    • EHCI is the USB 2.0 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.
 
  • Alternatively, you can try cold starting the hardware and see if macOS recognizes the UHCI controller properly
 
# 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 stange a lot of heavy cryptography is performed, which can make systems appear to be stuck when 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 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.
 
# 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 you will be using the original card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate when swapped.
  

+
  • EHCI is the USB 2.0 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.
 
  • Alternatively, you can try cold starting the hardware and see if macOS recognizes the UHCI controller properly
 
# 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 strange a lot of heavy cryptography is performed, which can make systems appear to be stuck when 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 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.
 
# 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 you will be using the original card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate when swapped.
  

       ⟵
       
       ⟶
- + diff --git a/UNINSTALL.html b/UNINSTALL.html index cec8d3b54..ad4e8abb2 100644 --- a/UNINSTALL.html +++ b/UNINSTALL.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Uninstalling OpenCore

To remove OpenCore is actually quite simply:

  1. Remove OpenCore either from the USB or internal drive
- + diff --git a/UNIVERSALCONTROL.html b/UNIVERSALCONTROL.html index af3a3d03b..b26572304 100644 --- a/UNIVERSALCONTROL.html +++ b/UNIVERSALCONTROL.html @@ -11,7 +11,7 @@ - + @@ -19,8 +19,8 @@ GitHub (opens new window)

# Universal Control on unsupported Macs

Introduced in macOS 12 Monterey, Universal Control is a feature that allows a Mac to control other Macs and/or iPads, share input devices, and share files across them simultaneously. With OpenCore and FeatureUnlock, Universal Control can be unlocked for most unsupported Macs, so long as they meet the technical requirements.

  • Note: Following page is primarily for hobbiests, no proper support is provided outside of Discord support (see bottom of page)

# Enabling Universal Control

If you meet all the requirements, in most cases you can go to Display Preferences and tick the Universal Control settings to enable it. If you're planning to use Universal Control with an iPad, make sure to enable Universal Control on the iPad as well.

Display Preferences Universal Control settings
OCLP GUI Build Finished

Most Macs 2011 and above should work out of the box. However, older Macs like 2008-2011 MacBook Pro's require upgrading to a newer Wi-Fi/Bluetooth card. More info in the requirements section.

Some Monterey-native models are blacklisted, check the blacklisted models section for more info.

# Requirements for Universal Control

Technical requirements:

  • Wi-Fi 4 (802.11n)
  • Bluetooth 4.0
  • macOS Monterey 12.4 or newer
  • iPadOS 15.4 or newer (if applicable)
  • OpenCore Legacy Patcher 0.4.3 or newer

Check the table of models below whether you need to upgrade hardware and exactly what hardware is required to be changed based on the offending Macs. Refer for help on how to upgrade the Wi-Fi card on older 2008-2011 models on the Discord channel #hardware (opens new window) if required.

Other requirements:

  • All devices signed into the same iCloud account.
  • Two Factor Authentication enabled with your Apple ID.
  • Bluetooth and WiFi enabled, neither needs to be connected so long as they are enabled.
  • Handoff turned on from iCloud settings.
  • The devices in question to be in close proximity.

# Table of models

This table shows which models do and don't support Universal Control out of box (OOB) and what is required to gain support. -Note: For AirPort upgrades, only the best/newest cards are listed.

MacBook
SMBIOS WiFi/BT version UC OOB Comment
MacBook4,1 Wi-Fi 4 / BT 2.0 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBook5,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBook5,2 WiFi 4 / BT 2.1 EDR Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBook6,1 Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBook7,1
MacBook8,1 WiFi 4 + BT 4.2 YES Universal Control will work.
MacBook Air
SMBIOS WiFi/BT version UC OOB Comment
MacBookAir2,1 Wi-Fi 4 / BT 2.1 EDR NO Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookAir3,1 Replace stock AirPort card with a BCM94360CS2 card
MacBookAir3,2
MacBookAir4,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
MacBookAir4,2
MacBookAir5,1
MacBookAir5,2
MacBookAir6,1 Wi-Fi 5 + BT 4.0
MacBookAir6,2
MacBookAir7,1 NO Hardware supports UC.
Spoofing required.
MacBookAir7,2
MacBook Pro
SMBIOS WiFi/BT version UC OOB Comment
MacBookPro4,1 Wi-Fi 4 / BT 2.1 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBookPro5,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookPro5,2
MacBookPro5,3
MacBookPro5,4
MacBookPro5,5
MacBookPro6,1
MacBookPro6,2 Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBookPro7,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookPro8,1 Wi-Fi 4 + BT 2.1 EDR Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBookPro8,2
MacBookPro9,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
MacBookPro9,2
MacBookPro10,1
MacBookPro10,2
MacBookPro11,1 Wi-Fi 5 + BT 4.0
MacBookPro11,2
MacBookPro11,3
MacBookPro11,4 Wi-Fi 5 + BT 4.2 NO Hardware supports UC.
Spoofing required.
MacBookPro11,5
MacBookPro12,1
Mac mini
SMBIOS WiFi/BT version UC OOB Comment
Macmini3,1 Wi-Fi 4 + BT 2.1 EDR NO Upgrade requires some heavy electrical and case modifications, so instead used a Broadcom USB Bluetooth 4.0+ Dongle.
Macmini4,1
Macmini5,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
Macmini5,2
Macmini5,3
Macmini6,1
Macmini6,2
Macmini7,1 Wi-Fi 5 + BT 4.0 NO Hardware supports UC.
Spoofing required.
iMac
SMBIOS WiFi/BT version UC OOB Comment
iMac7,1 Wi-Fi 4 + BT 2.0 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CD card
iMac8,1
iMac9,1 Wi-Fi 4 / BT 2.1 EDR
iMac10,1
iMac11,1
iMac11,2
iMac11,3
iMac12,1 Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card
iMac12,2
iMac13,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
iMac13,2
iMac13,3
iMac14,1 Wi-Fi 5 + BT 4.0
iMac14,2
iMac14,3
iMac14,4
iMac15,1
iMac16,1 Wi-Fi 5 + BT 4.2 NO Hardware supports UC.
Spoofing required.
iMac16,2
Mac Pro
SMBIOS WiFi/BT version UC OOB Comment
MacPro3,1 Wi-Fi 4 + BT 2.0 EDR NO Replace stock AirPort card with an mPCIE Adapter board with a BCM943602CD card
MacPro4,1 Wi-Fi 4 + BT 2.1 EDR Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card
MacPro5,1
MacPro6,1 Wi-Fi 5 + BT 4.0 Hardware supports UC.
Spoofing required.
  • Note: Some older Mac Pro configurations may not have shipped with a WiFi card in the base model
Xserve ;p
SMBIOS WiFi/BT version UC OOB Comment
Xserve2,1 N/A NO Install a PCIe BCM943602CD card
Xserve3,1

# Blacklisted models

The following models are blacklisted from using Universal Control by Apple:

  • MacBookAir7,x - MacBook Air Early 2015 11" / 13"
  • MacBookPro11,4 - MacBook Pro Mid 2015 15" (Intel Iris)
  • MacBookPro11,5 - MacBook Pro Mid 2015 15" (dGPU)
  • MacBookPro12,x - MacBook Pro Early 2015 13"
  • iMac16,x - iMac Late 2015 21"
  • Macmini7,x - Mac mini 2014
  • MacPro6,x - Mac Pro Late 2013

The hardware in these models is capable but due to blacklisting, the only solution to use Universal Control on the models above is to spoof their SMBIOS. SMBIOS spoofing essentially fools some aspects of macOS to think they are running on a different machine.

With SMBIOS Spoofing, the Universal Control handshake recognizes a different SMBIOS and thus grants a blacklisted Mac to connect to other iPads and Macs with Universal Control.

Situation Condition Solution
Mac <-> Mac connection Monterey-unsupported No spoofing needed
Mac <-> iPad connection Monterey-unsupported No spoofing needed
Mac <-> Mac connection One or both are blacklisted Spoofing required on blacklisted Macs
Mac <-> iPad connection Blacklisted Mac Spoofing required on blacklisted Mac

WARNING

Before we continue, please keep in mind SMBIOS Spoofing is an advanced feature of OpenCore, that with reckless usage of it, could potentially screw things around and leave your installation non-working. Once you boot into a spoofed state, it is highly recommended you stay spoofed, and avoid booting macOS without OpenCore.

# How to spoof

Firstly, run the GUI version of OpenCore Legacy Patcher, go to Settings and tick Allow native models.

Note: Unless you are building OpenCore on a different machine than it's targeted for, do not change the model in this main settings view. It is important to understand that OCLP targets this model regardless of what you may have spoofed to, as your Mac is still what the Native SMBIOS shows.

Secondly, go to SMBIOS Settings, tick Allow Native Spoofs, set SMBIOS Spoof Level to Moderate. Set SMBIOS Spoof Model to one next to your native model in the table for spoofed models below.

Table for spoofed models (click to expand)

Any model after the list of officially blacklisted Macs should be supported, but these are the earliest Macs with Universal Control support, and thus chosen for the sake of simplicity.

Reminder: Macs that are not listed on this table work without spoofing, including systems that do not natively support Monterey as long as the other requirements are met, since they aren't blacklisted.

Mac by name Native SMBIOS Spoof SMBIOS Tested Tested by
MacBook Air Early 2015 11" / 13" MacBookAir7,x MacBookAir8,1 YES Hzlph
MacBook Pro Early 2015 13" MacBookPro12,x MacBookPro13,1
MacBook Pro Mid 2015 15" MacBookPro11,4 / 11,5 MacBookPro13,3
iMac Late 2015 21" iMac16,x iMac18,2
Mac mini Late 2014 Macmini7,x MacMini8,1 NO N/A
Mac Pro Late 2013 MacPro6,x MacPro7,1 YES Crystall1nedev
Main Settings view SMBIOS settings

Build and install OpenCore again, reboot back to the OS. Enable Universal Control as explained in Enabling Universal Control section.

You should now be prompted to log back into iCloud by your Mac. This means you were successful, otherwise, verify you are correctly following the steps listed above, or else ask on the Discord group for assistance on #misc-help (opens new window).

+ (opens new window)

# Universal Control on unsupported Macs

Introduced in macOS 12 Monterey, Universal Control is a feature that allows a Mac to control other Macs and/or iPads, share input devices, and share files across them simultaneously. With OpenCore and FeatureUnlock, Universal Control can be unlocked for most unsupported Macs, so long as they meet the technical requirements.

  • Note: Following page is primarily for hobbyists, no proper support is provided outside of Discord support (see bottom of page)

# Enabling Universal Control

If you meet all the requirements, in most cases you can go to Display Preferences and tick the Universal Control settings to enable it. If you're planning to use Universal Control with an iPad, make sure to enable Universal Control on the iPad as well.

Display Preferences Universal Control settings
OCLP GUI Build Finished

Most Macs 2011 and above should work out of the box. However, older Macs like 2008-2011 MacBook Pro's require upgrading to a newer Wi-Fi/Bluetooth card. More info in the requirements section.

Some Monterey-native models are blacklisted, check the blacklisted models section for more info.

# Requirements for Universal Control

Technical requirements:

  • Wi-Fi 4 (802.11n)
  • Bluetooth 4.0
  • macOS Monterey 12.4 or newer
  • iPadOS 15.4 or newer (if applicable)
  • OpenCore Legacy Patcher 0.4.3 or newer

Check the table of models below whether you need to upgrade hardware and exactly what hardware is required to be changed based on the offending Macs. Refer for help on how to upgrade the Wi-Fi card on older 2008-2011 models on the Discord channel #hardware (opens new window) if required.

Other requirements:

  • All devices signed into the same iCloud account.
  • Two Factor Authentication enabled with your Apple ID.
  • Bluetooth and WiFi enabled, neither needs to be connected so long as they are enabled.
  • Handoff turned on from iCloud settings.
  • The devices in question to be in close proximity.

# Table of models

This table shows which models do and don't support Universal Control out of box (OOB) and what is required to gain support. +Note: For AirPort upgrades, only the best/newest cards are listed.

MacBook
SMBIOS WiFi/BT version UC OOB Comment
MacBook4,1 Wi-Fi 4 / BT 2.0 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBook5,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBook5,2 WiFi 4 / BT 2.1 EDR Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBook6,1 Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBook7,1
MacBook8,1 WiFi 4 + BT 4.2 YES Universal Control will work.
MacBook Air
SMBIOS WiFi/BT version UC OOB Comment
MacBookAir2,1 Wi-Fi 4 / BT 2.1 EDR NO Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookAir3,1 Replace stock AirPort card with a BCM94360CS2 card
MacBookAir3,2
MacBookAir4,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
MacBookAir4,2
MacBookAir5,1
MacBookAir5,2
MacBookAir6,1 Wi-Fi 5 + BT 4.0
MacBookAir6,2
MacBookAir7,1 NO Hardware supports UC.
Spoofing required.
MacBookAir7,2
MacBook Pro
SMBIOS WiFi/BT version UC OOB Comment
MacBookPro4,1 Wi-Fi 4 / BT 2.1 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card
MacBookPro5,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookPro5,2
MacBookPro5,3
MacBookPro5,4
MacBookPro5,5
MacBookPro6,1
MacBookPro6,2 Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBookPro7,1 Use a Broadcom USB Bluetooth 4.0+ Dongle
MacBookPro8,1 Wi-Fi 4 + BT 2.1 EDR Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card
MacBookPro8,2
MacBookPro9,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
MacBookPro9,2
MacBookPro10,1
MacBookPro10,2
MacBookPro11,1 Wi-Fi 5 + BT 4.0
MacBookPro11,2
MacBookPro11,3
MacBookPro11,4 Wi-Fi 5 + BT 4.2 NO Hardware supports UC.
Spoofing required.
MacBookPro11,5
MacBookPro12,1
Mac mini
SMBIOS WiFi/BT version UC OOB Comment
Macmini3,1 Wi-Fi 4 + BT 2.1 EDR NO Upgrade requires some heavy electrical and case modifications, so instead used a Broadcom USB Bluetooth 4.0+ Dongle.
Macmini4,1
Macmini5,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
Macmini5,2
Macmini5,3
Macmini6,1
Macmini6,2
Macmini7,1 Wi-Fi 5 + BT 4.0 NO Hardware supports UC.
Spoofing required.
iMac
SMBIOS WiFi/BT version UC OOB Comment
iMac7,1 Wi-Fi 4 + BT 2.0 EDR NO Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CD card
iMac8,1
iMac9,1 Wi-Fi 4 / BT 2.1 EDR
iMac10,1
iMac11,1
iMac11,2
iMac11,3
iMac12,1 Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card
iMac12,2
iMac13,1 Wi-Fi 4 + BT 4.0 YES Universal Control will work.
iMac13,2
iMac13,3
iMac14,1 Wi-Fi 5 + BT 4.0
iMac14,2
iMac14,3
iMac14,4
iMac15,1
iMac16,1 Wi-Fi 5 + BT 4.2 NO Hardware supports UC.
Spoofing required.
iMac16,2
Mac Pro
SMBIOS WiFi/BT version UC OOB Comment
MacPro3,1 Wi-Fi 4 + BT 2.0 EDR NO Replace stock AirPort card with an mPCIE Adapter board with a BCM943602CD card
MacPro4,1 Wi-Fi 4 + BT 2.1 EDR Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card
MacPro5,1
MacPro6,1 Wi-Fi 5 + BT 4.0 Hardware supports UC.
Spoofing required.
  • Note: Some older Mac Pro configurations may not have shipped with a WiFi card in the base model
Xserve ;p
SMBIOS WiFi/BT version UC OOB Comment
Xserve2,1 N/A NO Install a PCIe BCM943602CD card
Xserve3,1

# Blacklisted models

The following models are blacklisted from using Universal Control by Apple:

  • MacBookAir7,x - MacBook Air Early 2015 11" / 13"
  • MacBookPro11,4 - MacBook Pro Mid 2015 15" (Intel Iris)
  • MacBookPro11,5 - MacBook Pro Mid 2015 15" (dGPU)
  • MacBookPro12,x - MacBook Pro Early 2015 13"
  • iMac16,x - iMac Late 2015 21"
  • Macmini7,x - Mac mini 2014
  • MacPro6,x - Mac Pro Late 2013

The hardware in these models is capable but due to blacklisting, the only solution to use Universal Control on the models above is to spoof their SMBIOS. SMBIOS spoofing essentially fools some aspects of macOS to think they are running on a different machine.

With SMBIOS Spoofing, the Universal Control handshake recognizes a different SMBIOS and thus grants a blacklisted Mac to connect to other iPads and Macs with Universal Control.

Situation Condition Solution
Mac <-> Mac connection Monterey-unsupported No spoofing needed
Mac <-> iPad connection Monterey-unsupported No spoofing needed
Mac <-> Mac connection One or both are blacklisted Spoofing required on blacklisted Macs
Mac <-> iPad connection Blacklisted Mac Spoofing required on blacklisted Mac

WARNING

Before we continue, please keep in mind SMBIOS Spoofing is an advanced feature of OpenCore, that with reckless usage of it, could potentially screw things around and leave your installation non-working. Once you boot into a spoofed state, it is highly recommended you stay spoofed, and avoid booting macOS without OpenCore.

# How to spoof

Firstly, run the GUI version of OpenCore Legacy Patcher, go to Settings and tick Allow native models.

Note: Unless you are building OpenCore on a different machine than it's targeted for, do not change the model in this main settings view. It is important to understand that OCLP targets this model regardless of what you may have spoofed to, as your Mac is still what the Native SMBIOS shows.

Secondly, go to SMBIOS Settings, tick Allow Native Spoofs, set SMBIOS Spoof Level to Moderate. Set SMBIOS Spoof Model to one next to your native model in the table for spoofed models below.

Table for spoofed models (click to expand)

Any model after the list of officially blacklisted Macs should be supported, but these are the earliest Macs with Universal Control support, and thus chosen for the sake of simplicity.

Reminder: Macs that are not listed on this table work without spoofing, including systems that do not natively support Monterey as long as the other requirements are met, since they aren't blacklisted.

Mac by name Native SMBIOS Spoof SMBIOS Tested Tested by
MacBook Air Early 2015 11" / 13" MacBookAir7,x MacBookAir8,1 YES Hzlph
MacBook Pro Early 2015 13" MacBookPro12,x MacBookPro13,1
MacBook Pro Mid 2015 15" MacBookPro11,4 / 11,5 MacBookPro13,3
iMac Late 2015 21" iMac16,x iMac18,2
Mac mini Late 2014 Macmini7,x MacMini8,1 NO N/A
Mac Pro Late 2013 MacPro6,x MacPro7,1 YES Crystall1nedev
Main Settings view SMBIOS settings

Build and install OpenCore again, reboot back to the OS. Enable Universal Control as explained in Enabling Universal Control section.

You should now be prompted to log back into iCloud by your Mac. This means you were successful, otherwise, verify you are correctly following the steps listed above, or else ask on the Discord group for assistance on #misc-help (opens new window).

⟵

# Updating OpenCore and Patches

With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup, e.g. Bluetooth has stopped working with a new macOS update.

For those who do wish to update, it's actually quite easy. Simply download the latest release (opens new window) and rerun the patcher:

Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!

To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:

# OpenCore Version
+     (opens new window)    
 
# Updating OpenCore and Patches
 
With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup, e.g. Bluetooth has stopped working with a new macOS update.
 
For those who do wish to update, it's actually quite easy. Simply download the latest release (opens new window) and rerun the patcher:
 
 
Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!
 
To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:
 
# OpenCore Version
 nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version
 # Patcher Version
 nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version
@@ -32,6 +32,6 @@ nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version
       
       ⟶
- + diff --git a/WINDOWS.html b/WINDOWS.html index 0a2c6d4c9..be4a96529 100644 --- a/WINDOWS.html +++ b/WINDOWS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Installing UEFI Windows 10

To install UEFI is actually super simple! All it requires is to boot Windows' Installer through OpenCore to force a UEFI setup. Here we'll be going a bit more step by step in the process including partitioning and such.

- + diff --git a/assets/js/10.e1b69fa5.js b/assets/js/10.134d384a.js similarity index 99% rename from assets/js/10.e1b69fa5.js rename to assets/js/10.134d384a.js index 553996a77..0871a6741 100644 --- a/assets/js/10.e1b69fa5.js +++ b/assets/js/10.134d384a.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[10],{411:function(t,o,a){t.exports=a.p+"assets/img/UC-enable-1.956705f7.png"},412:function(t,o,a){t.exports=a.p+"assets/img/UC-enable-2.7d84d4a0.png"},413:function(t,o,a){t.exports=a.p+"assets/img/OCLP-allow-native-models.b64c4aa8.png"},414:function(t,o,a){t.exports=a.p+"assets/img/OCLP-smbios-settings.89bbeffd.png"},455:function(t,o,a){"use strict";a.r(o);var r=a(25),e=Object(r.a)({},(function(){var t=this,o=t.$createElement,r=t._self._c||o;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"universal-control-on-unsupported-macs"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#universal-control-on-unsupported-macs"}},[t._v("#")]),t._v(" Universal Control on unsupported Macs")]),t._v(" "),r("p",[t._v("Introduced in macOS 12 Monterey, Universal Control is a feature that allows a Mac to control other Macs and/or iPads, share input devices, and share files across them simultaneously. With OpenCore and FeatureUnlock, Universal Control can be unlocked for most unsupported Macs, so long as they meet the technical requirements.")]),t._v(" "),r("ul",[r("li",[t._v("Note: Following page is primarily for hobbiests, no proper support is provided outside of Discord support (see bottom of page)")])]),t._v(" "),r("h2",{attrs:{id:"enabling-universal-control"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#enabling-universal-control"}},[t._v("#")]),t._v(" Enabling Universal Control")]),t._v(" "),r("p",[t._v("If you meet all the requirements, in most cases you can go to Display Preferences and tick the Universal Control settings to enable it. If you're planning to use Universal Control with an iPad, make sure to enable Universal Control on the iPad as well.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",{staticStyle:{"text-align":"left"}},[t._v("Display Preferences")]),t._v(" "),r("th",{staticStyle:{"text-align":"left"}},[t._v("Universal Control settings")])])]),t._v(" "),r("tbody",[r("tr",[r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(411),alt:""}})]),t._v(" "),r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(412),alt:"OCLP GUI Build Finished"}})])])])]),t._v(" "),r("p",[t._v("Most Macs 2011 and above should work out of the box. However, older Macs like 2008-2011 MacBook Pro's require upgrading to a newer Wi-Fi/Bluetooth card. More info in the "),r("a",{attrs:{href:"#requirements-for-universal-control"}},[t._v("requirements section.")])]),t._v(" "),r("p",[t._v("Some Monterey-native models are blacklisted, check the "),r("a",{attrs:{href:"#blacklisted-models"}},[t._v("blacklisted models section")]),t._v(" for more info.")]),t._v(" "),r("h2",{attrs:{id:"requirements-for-universal-control"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#requirements-for-universal-control"}},[t._v("#")]),t._v(" Requirements for Universal Control")]),t._v(" "),r("p",[t._v("Technical requirements:")]),t._v(" "),r("ul",[r("li",[t._v("Wi-Fi 4 (802.11n)")]),t._v(" "),r("li",[t._v("Bluetooth 4.0")]),t._v(" "),r("li",[t._v("macOS Monterey 12.4 or newer")]),t._v(" "),r("li",[t._v("iPadOS 15.4 or newer (if applicable)")]),t._v(" "),r("li",[t._v("OpenCore Legacy Patcher 0.4.3 or newer")])]),t._v(" "),r("p",[t._v("Check the "),r("a",{attrs:{href:"#table-of-models"}},[t._v("table of models")]),t._v(" below whether you need to upgrade hardware and exactly what hardware is required to be changed based on the offending Macs. Refer for help on how to upgrade the Wi-Fi card on older 2008-2011 models on the Discord channel "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[t._v("#hardware"),r("OutboundLink")],1),t._v(" if required.")]),t._v(" "),r("p",[t._v("Other requirements:")]),t._v(" "),r("ul",[r("li",[t._v("All devices signed into the same iCloud account.")]),t._v(" "),r("li",[t._v("Two Factor Authentication enabled with your Apple ID.")]),t._v(" "),r("li",[t._v("Bluetooth and WiFi enabled, neither needs to be connected so long as they are enabled.")]),t._v(" "),r("li",[t._v("Handoff turned on from iCloud settings.")]),t._v(" "),r("li",[t._v("The devices in question to be in close proximity.")])]),t._v(" "),r("h3",{attrs:{id:"table-of-models"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#table-of-models"}},[t._v("#")]),t._v(" Table of models")]),t._v(" "),r("p",[t._v("This table shows which models do and don't support Universal Control out of box (OOB) and what is required to gain support.\nNote: For AirPort upgrades, only the best/newest cards are listed.")]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBook4,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 / BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook5,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" Use a Broadcom USB Bluetooth 4.0+ Dongle ")])])]),t._v(" "),r("tr",[r("td",[t._v("MacBook5,2")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("WiFi 4 / BT 2.1 EDR")]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook6,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook7,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook8,1")]),t._v(" "),r("td",[t._v("WiFi 4 + BT 4.2")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",[t._v("Universal Control will work.")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook Air")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBookAir2,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir3,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir3,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir4,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir4,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir5,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir5,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir6,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir6,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir7,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir7,2")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook Pro")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBookPro4,1")]),t._v(" "),r("td",{attrs:{rowspan:"9"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"11"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,1")]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,3")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,4")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,5")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro6,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro6,2")]),t._v(" "),r("td",[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro7,1")]),t._v(" "),r("td",[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro8,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro8,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro9,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro9,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro10,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro10,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,3")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,4")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 5 + BT 4.2")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,5")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro12,1")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Mac mini")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Macmini3,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Upgrade requires some heavy electrical and case modifications, so instead used a Broadcom USB Bluetooth 4.0+ Dongle.")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini4,1")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,1")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,2")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,3")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini6,1")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini6,2")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini7,1")]),t._v(" "),r("td",[t._v("Wi-Fi 5 + BT 4.0")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("iMac")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("iMac7,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"9"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CD card")])]),t._v(" "),r("tr",[r("td",[t._v("iMac8,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac9,1")]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")])]),t._v(" "),r("tr",[r("td",[t._v("iMac10,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac12,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("iMac12,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"8"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"8"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,1")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,4")])]),t._v(" "),r("tr",[r("td",[t._v("iMac15,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac16,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 5 + BT 4.2")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("iMac16,2")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Mac Pro")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacPro3,1")]),t._v(" "),r("td",[t._v("Wi-Fi 4 + BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro4,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro5,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro6,1")]),t._v(" "),r("td",[t._v("Wi-Fi 5 + BT 4.0")]),t._v(" "),r("td",[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])])])]),t._v(" "),r("ul",[r("li",[t._v("Note: Some older Mac Pro configurations may not have shipped with a WiFi card in the base model")])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Xserve ;p")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Xserve2,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("N/A")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Install a PCIe BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("Xserve3,1")])])])])]),t._v(" "),r("h2",{attrs:{id:"blacklisted-models"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#blacklisted-models"}},[t._v("#")]),t._v(" Blacklisted models")]),t._v(" "),r("p",[t._v("The following models are blacklisted from using Universal Control by Apple:")]),t._v(" "),r("ul",[r("li",[t._v('MacBookAir7,x - MacBook Air Early 2015 11" / 13"')]),t._v(" "),r("li",[t._v('MacBookPro11,4 - MacBook Pro Mid 2015 15" (Intel Iris)')]),t._v(" "),r("li",[t._v('MacBookPro11,5 - MacBook Pro Mid 2015 15" (dGPU)')]),t._v(" "),r("li",[t._v('MacBookPro12,x - MacBook Pro Early 2015 13"')]),t._v(" "),r("li",[t._v('iMac16,x - iMac Late 2015 21"')]),t._v(" "),r("li",[t._v("Macmini7,x - Mac mini 2014")]),t._v(" "),r("li",[t._v("MacPro6,x - Mac Pro Late 2013")])]),t._v(" "),r("p",[t._v("The hardware in these models is capable but due to blacklisting, the only solution to use Universal Control on the models above is to spoof their SMBIOS. SMBIOS spoofing essentially fools some aspects of macOS to think they are running on a different machine.")]),t._v(" "),r("p",[t._v("With SMBIOS Spoofing, the Universal Control handshake recognizes a different SMBIOS and thus grants a blacklisted Mac to connect to other iPads and Macs with Universal Control.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("Situation")]),t._v(" "),r("th",[t._v("Condition")]),t._v(" "),r("th",[t._v("Solution")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Mac <-> Mac connection")]),t._v(" "),r("td",[t._v("Monterey-unsupported")]),t._v(" "),r("td",[t._v("No spoofing needed")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> iPad connection")]),t._v(" "),r("td",[t._v("Monterey-unsupported")]),t._v(" "),r("td",[t._v("No spoofing needed")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> Mac connection")]),t._v(" "),r("td",[t._v("One or both are blacklisted")]),t._v(" "),r("td",[t._v("Spoofing required on blacklisted Macs")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> iPad connection")]),t._v(" "),r("td",[t._v("Blacklisted Mac")]),t._v(" "),r("td",[t._v("Spoofing required on blacklisted Mac")])])])]),t._v(" "),r("div",{staticClass:"custom-block warning"},[r("p",{staticClass:"custom-block-title"},[t._v("WARNING")]),t._v(" "),r("p",[t._v("Before we continue, please keep in mind SMBIOS Spoofing is an advanced feature of OpenCore, that with reckless usage of it, could potentially screw things around and leave your installation non-working. Once you boot into a spoofed state, it is highly recommended you stay spoofed, and avoid booting macOS without OpenCore.")])]),t._v(" "),r("h3",{attrs:{id:"how-to-spoof"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-spoof"}},[t._v("#")]),t._v(" How to spoof")]),t._v(" "),r("p",[t._v("Firstly, run the GUI version of OpenCore Legacy Patcher, go to "),r("strong",[t._v("Settings")]),t._v(" and tick "),r("strong",[t._v("Allow native models")]),t._v(".")]),t._v(" "),r("p",[r("strong",[t._v("Note:")]),t._v(" Unless you are building OpenCore on a different machine than it's targeted for, "),r("strong",[t._v("do not")]),t._v(" change the model in this main settings view. It is important to understand that OCLP targets this model regardless of what you may have spoofed to, as your Mac is still what the Native SMBIOS shows.")]),t._v(" "),r("p",[t._v("Secondly, go to "),r("strong",[t._v("SMBIOS Settings")]),t._v(", tick "),r("strong",[t._v("Allow Native Spoofs")]),t._v(", set SMBIOS Spoof Level to "),r("strong",[t._v("Moderate")]),t._v(". Set SMBIOS Spoof Model to "),r("strong",[t._v("one next to your native model in the table for spoofed models below.")])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Table for spoofed models (click to expand)")]),t._v(" "),r("p",[t._v("Any model after the list of officially blacklisted Macs should be supported, but these are the earliest Macs with Universal Control support, and thus chosen for the sake of simplicity.")]),t._v(" "),r("p",[r("strong",[t._v("Reminder:")]),t._v(" Macs that are not listed on this table work without spoofing, including systems that do not natively support Monterey as long as the other requirements are met, since they aren't blacklisted.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("Mac by name")]),t._v(" "),r("th",[t._v("Native SMBIOS")]),t._v(" "),r("th",[t._v("Spoof SMBIOS")]),t._v(" "),r("th",[t._v("Tested")]),t._v(" "),r("th",[t._v("Tested by")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v('MacBook Air Early 2015 11" / 13"')]),t._v(" "),r("td",[t._v("MacBookAir7,x")]),t._v(" "),r("td",[t._v("MacBookAir8,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Hzlph")])]),t._v(" "),r("tr",[r("td",[t._v('MacBook Pro Early 2015 13"')]),t._v(" "),r("td",[t._v("MacBookPro12,x")]),t._v(" "),r("td",[t._v("MacBookPro13,1")])]),t._v(" "),r("tr",[r("td",[t._v('MacBook Pro Mid 2015 15"')]),t._v(" "),r("td",[t._v("MacBookPro11,4 / 11,5")]),t._v(" "),r("td",[t._v("MacBookPro13,3")])]),t._v(" "),r("tr",[r("td",[t._v('iMac Late 2015 21"')]),t._v(" "),r("td",[t._v("iMac16,x")]),t._v(" "),r("td",[t._v("iMac18,2")])]),t._v(" "),r("tr",[r("td",[t._v("Mac mini Late 2014")]),t._v(" "),r("td",[t._v("Macmini7,x")]),t._v(" "),r("td",[t._v("MacMini8,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("N/A")])]),t._v(" "),r("tr",[r("td",[t._v("Mac Pro Late 2013")]),t._v(" "),r("td",[t._v("MacPro6,x")]),t._v(" "),r("td",[t._v("MacPro7,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",[t._v("Crystall1nedev")])])])])]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",{staticStyle:{"text-align":"left"}},[t._v("Main Settings view")]),t._v(" "),r("th",{staticStyle:{"text-align":"left"}},[t._v("SMBIOS settings")])])]),t._v(" "),r("tbody",[r("tr",[r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(413),alt:""}})]),t._v(" "),r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(414),alt:""}})])])])]),t._v(" "),r("p",[t._v("Build and install OpenCore again, reboot back to the OS. Enable Universal Control as explained in "),r("a",{attrs:{href:"#enabling-universal-control"}},[t._v("Enabling Universal Control section.")])]),t._v(" "),r("p",[t._v("You should now be prompted to log back into iCloud by your Mac. This means you were successful, otherwise, verify you are correctly following the steps listed above, or else ask on the Discord group for assistance on "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[t._v("#misc-help"),r("OutboundLink")],1),t._v(".")])])}),[],!1,null,null,null);o.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[10],{411:function(t,o,a){t.exports=a.p+"assets/img/UC-enable-1.956705f7.png"},412:function(t,o,a){t.exports=a.p+"assets/img/UC-enable-2.7d84d4a0.png"},413:function(t,o,a){t.exports=a.p+"assets/img/OCLP-allow-native-models.b64c4aa8.png"},414:function(t,o,a){t.exports=a.p+"assets/img/OCLP-smbios-settings.89bbeffd.png"},455:function(t,o,a){"use strict";a.r(o);var r=a(25),e=Object(r.a)({},(function(){var t=this,o=t.$createElement,r=t._self._c||o;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"universal-control-on-unsupported-macs"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#universal-control-on-unsupported-macs"}},[t._v("#")]),t._v(" Universal Control on unsupported Macs")]),t._v(" "),r("p",[t._v("Introduced in macOS 12 Monterey, Universal Control is a feature that allows a Mac to control other Macs and/or iPads, share input devices, and share files across them simultaneously. With OpenCore and FeatureUnlock, Universal Control can be unlocked for most unsupported Macs, so long as they meet the technical requirements.")]),t._v(" "),r("ul",[r("li",[t._v("Note: Following page is primarily for hobbyists, no proper support is provided outside of Discord support (see bottom of page)")])]),t._v(" "),r("h2",{attrs:{id:"enabling-universal-control"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#enabling-universal-control"}},[t._v("#")]),t._v(" Enabling Universal Control")]),t._v(" "),r("p",[t._v("If you meet all the requirements, in most cases you can go to Display Preferences and tick the Universal Control settings to enable it. If you're planning to use Universal Control with an iPad, make sure to enable Universal Control on the iPad as well.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",{staticStyle:{"text-align":"left"}},[t._v("Display Preferences")]),t._v(" "),r("th",{staticStyle:{"text-align":"left"}},[t._v("Universal Control settings")])])]),t._v(" "),r("tbody",[r("tr",[r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(411),alt:""}})]),t._v(" "),r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(412),alt:"OCLP GUI Build Finished"}})])])])]),t._v(" "),r("p",[t._v("Most Macs 2011 and above should work out of the box. However, older Macs like 2008-2011 MacBook Pro's require upgrading to a newer Wi-Fi/Bluetooth card. More info in the "),r("a",{attrs:{href:"#requirements-for-universal-control"}},[t._v("requirements section.")])]),t._v(" "),r("p",[t._v("Some Monterey-native models are blacklisted, check the "),r("a",{attrs:{href:"#blacklisted-models"}},[t._v("blacklisted models section")]),t._v(" for more info.")]),t._v(" "),r("h2",{attrs:{id:"requirements-for-universal-control"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#requirements-for-universal-control"}},[t._v("#")]),t._v(" Requirements for Universal Control")]),t._v(" "),r("p",[t._v("Technical requirements:")]),t._v(" "),r("ul",[r("li",[t._v("Wi-Fi 4 (802.11n)")]),t._v(" "),r("li",[t._v("Bluetooth 4.0")]),t._v(" "),r("li",[t._v("macOS Monterey 12.4 or newer")]),t._v(" "),r("li",[t._v("iPadOS 15.4 or newer (if applicable)")]),t._v(" "),r("li",[t._v("OpenCore Legacy Patcher 0.4.3 or newer")])]),t._v(" "),r("p",[t._v("Check the "),r("a",{attrs:{href:"#table-of-models"}},[t._v("table of models")]),t._v(" below whether you need to upgrade hardware and exactly what hardware is required to be changed based on the offending Macs. Refer for help on how to upgrade the Wi-Fi card on older 2008-2011 models on the Discord channel "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[t._v("#hardware"),r("OutboundLink")],1),t._v(" if required.")]),t._v(" "),r("p",[t._v("Other requirements:")]),t._v(" "),r("ul",[r("li",[t._v("All devices signed into the same iCloud account.")]),t._v(" "),r("li",[t._v("Two Factor Authentication enabled with your Apple ID.")]),t._v(" "),r("li",[t._v("Bluetooth and WiFi enabled, neither needs to be connected so long as they are enabled.")]),t._v(" "),r("li",[t._v("Handoff turned on from iCloud settings.")]),t._v(" "),r("li",[t._v("The devices in question to be in close proximity.")])]),t._v(" "),r("h3",{attrs:{id:"table-of-models"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#table-of-models"}},[t._v("#")]),t._v(" Table of models")]),t._v(" "),r("p",[t._v("This table shows which models do and don't support Universal Control out of box (OOB) and what is required to gain support.\nNote: For AirPort upgrades, only the best/newest cards are listed.")]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBook4,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 / BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook5,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" Use a Broadcom USB Bluetooth 4.0+ Dongle ")])])]),t._v(" "),r("tr",[r("td",[t._v("MacBook5,2")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("WiFi 4 / BT 2.1 EDR")]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook6,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook7,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBook8,1")]),t._v(" "),r("td",[t._v("WiFi 4 + BT 4.2")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",[t._v("Universal Control will work.")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook Air")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBookAir2,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir3,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir3,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir4,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir4,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir5,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir5,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir6,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir6,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir7,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("MacBookAir7,2")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("MacBook Pro")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacBookPro4,1")]),t._v(" "),r("td",{attrs:{rowspan:"9"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"11"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,1")]),t._v(" "),r("td",{attrs:{rowspan:"6"}},[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,3")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,4")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro5,5")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro6,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro6,2")]),t._v(" "),r("td",[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro7,1")]),t._v(" "),r("td",[t._v("Use a Broadcom USB Bluetooth 4.0+ Dongle")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro8,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro8,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro9,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro9,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro10,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro10,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,2")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,3")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,4")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 5 + BT 4.2")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro11,5")])]),t._v(" "),r("tr",[r("td",[t._v("MacBookPro12,1")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Mac mini")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Macmini3,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Upgrade requires some heavy electrical and case modifications, so instead used a Broadcom USB Bluetooth 4.0+ Dongle.")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini4,1")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,1")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,2")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini5,3")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini6,1")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini6,2")])]),t._v(" "),r("tr",[r("td",[t._v("Macmini7,1")]),t._v(" "),r("td",[t._v("Wi-Fi 5 + BT 4.0")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("iMac")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("iMac7,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"9"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CD card")])]),t._v(" "),r("tr",[r("td",[t._v("iMac8,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac9,1")]),t._v(" "),r("td",{attrs:{rowspan:"7"}},[t._v("Wi-Fi 4 / BT 2.1 EDR")])]),t._v(" "),r("tr",[r("td",[t._v("iMac10,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac11,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac12,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("iMac12,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,1")]),t._v(" "),r("td",{attrs:{rowspan:"3"}},[t._v("Wi-Fi 4 + BT 4.0")]),t._v(" "),r("td",{attrs:{rowspan:"8"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"8"}},[t._v("Universal Control will work.")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac13,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,1")]),t._v(" "),r("td",{attrs:{rowspan:"5"}},[t._v("Wi-Fi 5 + BT 4.0")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,2")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,3")])]),t._v(" "),r("tr",[r("td",[t._v("iMac14,4")])]),t._v(" "),r("tr",[r("td",[t._v("iMac15,1")])]),t._v(" "),r("tr",[r("td",[t._v("iMac16,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 5 + BT 4.2")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])]),t._v(" "),r("tr",[r("td",[t._v("iMac16,2")])])])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Mac Pro")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("MacPro3,1")]),t._v(" "),r("td",[t._v("Wi-Fi 4 + BT 2.0 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("Replace stock AirPort card with an mPCIE Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro4,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Wi-Fi 4 + BT 2.1 EDR")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro5,1")])]),t._v(" "),r("tr",[r("td",[t._v("MacPro6,1")]),t._v(" "),r("td",[t._v("Wi-Fi 5 + BT 4.0")]),t._v(" "),r("td",[t._v("Hardware supports UC. "),r("br"),t._v(" "),r("a",{attrs:{href:"#blacklisted-models"}},[r("strong",[t._v("Spoofing required.")])])])])])]),t._v(" "),r("ul",[r("li",[t._v("Note: Some older Mac Pro configurations may not have shipped with a WiFi card in the base model")])])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Xserve ;p")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("SMBIOS")]),t._v(" "),r("th",[t._v("WiFi/BT version")]),t._v(" "),r("th",[t._v("UC OOB")]),t._v(" "),r("th",[t._v("Comment")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Xserve2,1")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("N/A")]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",{attrs:{rowspan:"2"}},[t._v("Install a PCIe BCM943602CD card")])]),t._v(" "),r("tr",[r("td",[t._v("Xserve3,1")])])])])]),t._v(" "),r("h2",{attrs:{id:"blacklisted-models"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#blacklisted-models"}},[t._v("#")]),t._v(" Blacklisted models")]),t._v(" "),r("p",[t._v("The following models are blacklisted from using Universal Control by Apple:")]),t._v(" "),r("ul",[r("li",[t._v('MacBookAir7,x - MacBook Air Early 2015 11" / 13"')]),t._v(" "),r("li",[t._v('MacBookPro11,4 - MacBook Pro Mid 2015 15" (Intel Iris)')]),t._v(" "),r("li",[t._v('MacBookPro11,5 - MacBook Pro Mid 2015 15" (dGPU)')]),t._v(" "),r("li",[t._v('MacBookPro12,x - MacBook Pro Early 2015 13"')]),t._v(" "),r("li",[t._v('iMac16,x - iMac Late 2015 21"')]),t._v(" "),r("li",[t._v("Macmini7,x - Mac mini 2014")]),t._v(" "),r("li",[t._v("MacPro6,x - Mac Pro Late 2013")])]),t._v(" "),r("p",[t._v("The hardware in these models is capable but due to blacklisting, the only solution to use Universal Control on the models above is to spoof their SMBIOS. SMBIOS spoofing essentially fools some aspects of macOS to think they are running on a different machine.")]),t._v(" "),r("p",[t._v("With SMBIOS Spoofing, the Universal Control handshake recognizes a different SMBIOS and thus grants a blacklisted Mac to connect to other iPads and Macs with Universal Control.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("Situation")]),t._v(" "),r("th",[t._v("Condition")]),t._v(" "),r("th",[t._v("Solution")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("Mac <-> Mac connection")]),t._v(" "),r("td",[t._v("Monterey-unsupported")]),t._v(" "),r("td",[t._v("No spoofing needed")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> iPad connection")]),t._v(" "),r("td",[t._v("Monterey-unsupported")]),t._v(" "),r("td",[t._v("No spoofing needed")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> Mac connection")]),t._v(" "),r("td",[t._v("One or both are blacklisted")]),t._v(" "),r("td",[t._v("Spoofing required on blacklisted Macs")])]),t._v(" "),r("tr",[r("td",[t._v("Mac <-> iPad connection")]),t._v(" "),r("td",[t._v("Blacklisted Mac")]),t._v(" "),r("td",[t._v("Spoofing required on blacklisted Mac")])])])]),t._v(" "),r("div",{staticClass:"custom-block warning"},[r("p",{staticClass:"custom-block-title"},[t._v("WARNING")]),t._v(" "),r("p",[t._v("Before we continue, please keep in mind SMBIOS Spoofing is an advanced feature of OpenCore, that with reckless usage of it, could potentially screw things around and leave your installation non-working. Once you boot into a spoofed state, it is highly recommended you stay spoofed, and avoid booting macOS without OpenCore.")])]),t._v(" "),r("h3",{attrs:{id:"how-to-spoof"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-spoof"}},[t._v("#")]),t._v(" How to spoof")]),t._v(" "),r("p",[t._v("Firstly, run the GUI version of OpenCore Legacy Patcher, go to "),r("strong",[t._v("Settings")]),t._v(" and tick "),r("strong",[t._v("Allow native models")]),t._v(".")]),t._v(" "),r("p",[r("strong",[t._v("Note:")]),t._v(" Unless you are building OpenCore on a different machine than it's targeted for, "),r("strong",[t._v("do not")]),t._v(" change the model in this main settings view. It is important to understand that OCLP targets this model regardless of what you may have spoofed to, as your Mac is still what the Native SMBIOS shows.")]),t._v(" "),r("p",[t._v("Secondly, go to "),r("strong",[t._v("SMBIOS Settings")]),t._v(", tick "),r("strong",[t._v("Allow Native Spoofs")]),t._v(", set SMBIOS Spoof Level to "),r("strong",[t._v("Moderate")]),t._v(". Set SMBIOS Spoof Model to "),r("strong",[t._v("one next to your native model in the table for spoofed models below.")])]),t._v(" "),r("details",{staticClass:"custom-block details"},[r("summary",[t._v("Table for spoofed models (click to expand)")]),t._v(" "),r("p",[t._v("Any model after the list of officially blacklisted Macs should be supported, but these are the earliest Macs with Universal Control support, and thus chosen for the sake of simplicity.")]),t._v(" "),r("p",[r("strong",[t._v("Reminder:")]),t._v(" Macs that are not listed on this table work without spoofing, including systems that do not natively support Monterey as long as the other requirements are met, since they aren't blacklisted.")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("Mac by name")]),t._v(" "),r("th",[t._v("Native SMBIOS")]),t._v(" "),r("th",[t._v("Spoof SMBIOS")]),t._v(" "),r("th",[t._v("Tested")]),t._v(" "),r("th",[t._v("Tested by")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v('MacBook Air Early 2015 11" / 13"')]),t._v(" "),r("td",[t._v("MacBookAir7,x")]),t._v(" "),r("td",[t._v("MacBookAir8,1")]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",{attrs:{rowspan:"4"}},[t._v("Hzlph")])]),t._v(" "),r("tr",[r("td",[t._v('MacBook Pro Early 2015 13"')]),t._v(" "),r("td",[t._v("MacBookPro12,x")]),t._v(" "),r("td",[t._v("MacBookPro13,1")])]),t._v(" "),r("tr",[r("td",[t._v('MacBook Pro Mid 2015 15"')]),t._v(" "),r("td",[t._v("MacBookPro11,4 / 11,5")]),t._v(" "),r("td",[t._v("MacBookPro13,3")])]),t._v(" "),r("tr",[r("td",[t._v('iMac Late 2015 21"')]),t._v(" "),r("td",[t._v("iMac16,x")]),t._v(" "),r("td",[t._v("iMac18,2")])]),t._v(" "),r("tr",[r("td",[t._v("Mac mini Late 2014")]),t._v(" "),r("td",[t._v("Macmini7,x")]),t._v(" "),r("td",[t._v("MacMini8,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"red"}},[t._v(" NO ")])]),t._v(" "),r("td",[t._v("N/A")])]),t._v(" "),r("tr",[r("td",[t._v("Mac Pro Late 2013")]),t._v(" "),r("td",[t._v("MacPro6,x")]),t._v(" "),r("td",[t._v("MacPro7,1")]),t._v(" "),r("td",[r("span",{staticStyle:{color:"#30BCD5"}},[t._v(" YES ")])]),t._v(" "),r("td",[t._v("Crystall1nedev")])])])])]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",{staticStyle:{"text-align":"left"}},[t._v("Main Settings view")]),t._v(" "),r("th",{staticStyle:{"text-align":"left"}},[t._v("SMBIOS settings")])])]),t._v(" "),r("tbody",[r("tr",[r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(413),alt:""}})]),t._v(" "),r("td",{staticStyle:{"text-align":"left"}},[r("img",{attrs:{src:a(414),alt:""}})])])])]),t._v(" "),r("p",[t._v("Build and install OpenCore again, reboot back to the OS. Enable Universal Control as explained in "),r("a",{attrs:{href:"#enabling-universal-control"}},[t._v("Enabling Universal Control section.")])]),t._v(" "),r("p",[t._v("You should now be prompted to log back into iCloud by your Mac. This means you were successful, otherwise, verify you are correctly following the steps listed above, or else ask on the Discord group for assistance on "),r("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[t._v("#misc-help"),r("OutboundLink")],1),t._v(".")])])}),[],!1,null,null,null);o.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/24.ebdb85b0.js b/assets/js/24.8e484bf6.js similarity index 94% rename from assets/js/24.ebdb85b0.js rename to assets/js/24.8e484bf6.js index bd9a82504..8e6c2763e 100644 --- a/assets/js/24.ebdb85b0.js +++ b/assets/js/24.8e484bf6.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{444:function(e,r,t){"use strict";t.r(r);var a=t(25),n=Object(a.a)({},(function(){var e=this,r=e.$createElement,t=e._self._c||r;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"opencore-legacy-patcher-licence"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-licence"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher Licence")]),e._v(" "),t("p",[e._v("This patcher is made of multiple external applications from different people and organizations. See each program for their licensing:")]),e._v(" "),t("ul",[t("li",[e._v('BSD 3-Clause "New" or "Revised" License\n'),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/Lilu/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("Lilu"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/WhateverGreen/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("WhateverGreen"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/AirportBrcmFixup/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("AirportBrcmFixup"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/CPUFriend/blob/master/LICENSE",target:"_blank",rel:"noopener noreferrer"}},[e._v("CPUFriend"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/RestrictEvents/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("RestrictEvents"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/FeatureUnlock/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("FeatureUnlock"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/cdf/Innie/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("Innie"),t("OutboundLink")],1)])])]),e._v(" "),t("li",[e._v("GPL 2.0\n"),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/NVMeFix/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("NVMeFix"),t("OutboundLink")],1)])])]),e._v(" "),t("li",[e._v("All rights reserved to respective authors\n"),t("ul",[t("li",[t("a",{attrs:{href:"https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/",target:"_blank",rel:"noopener noreferrer"}},[e._v("AAAMouSSE"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/post-28447707",target:"_blank",rel:"noopener noreferrer"}},[e._v("telemetrap"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/reenigneorcim/SurPlus",target:"_blank",rel:"noopener noreferrer"}},[e._v("SurPlus"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/4a8f61a01da72b38a4b2250386cc4b497a31a839/payloads/Config/config.plist#L1222-L1281",target:"_blank",rel:"noopener noreferrer"}},[e._v("VMM Patch Set"),t("OutboundLink")],1),e._v(" - parrotgeek1")]),e._v(" "),t("li",[e._v("Apple Binaries - Apple Inc.")])])])]),e._v(" "),t("p",[e._v("Remaining files within OpenCore Legacy Patcher are copyrighted 2020-2022 Mykola Grymalyuk & Dhinak G. For integration into other projects, please request written permission.")])])}),[],!1,null,null,null);r.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{444:function(e,r,t){"use strict";t.r(r);var a=t(25),n=Object(a.a)({},(function(){var e=this,r=e.$createElement,t=e._self._c||r;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"opencore-legacy-patcher-license"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-license"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher License")]),e._v(" "),t("p",[e._v("This patcher is made of multiple external applications from different people and organizations. See each program for their licensing:")]),e._v(" "),t("ul",[t("li",[e._v('BSD 3-Clause "New" or "Revised" License\n'),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/Lilu/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("Lilu"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/WhateverGreen/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("WhateverGreen"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/AirportBrcmFixup/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("AirportBrcmFixup"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/CPUFriend/blob/master/LICENSE",target:"_blank",rel:"noopener noreferrer"}},[e._v("CPUFriend"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/RestrictEvents/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("RestrictEvents"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/FeatureUnlock/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("FeatureUnlock"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/cdf/Innie/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("Innie"),t("OutboundLink")],1)])])]),e._v(" "),t("li",[e._v("GPL 2.0\n"),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/acidanthera/NVMeFix/blob/master/LICENSE.txt",target:"_blank",rel:"noopener noreferrer"}},[e._v("NVMeFix"),t("OutboundLink")],1)])])]),e._v(" "),t("li",[e._v("All rights reserved to respective authors\n"),t("ul",[t("li",[t("a",{attrs:{href:"https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/",target:"_blank",rel:"noopener noreferrer"}},[e._v("AAAMouSSE"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/post-28447707",target:"_blank",rel:"noopener noreferrer"}},[e._v("telemetrap"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/reenigneorcim/SurPlus",target:"_blank",rel:"noopener noreferrer"}},[e._v("SurPlus"),t("OutboundLink")],1),e._v(" - Syncretic")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/4a8f61a01da72b38a4b2250386cc4b497a31a839/payloads/Config/config.plist#L1222-L1281",target:"_blank",rel:"noopener noreferrer"}},[e._v("VMM Patch Set"),t("OutboundLink")],1),e._v(" - parrotgeek1")]),e._v(" "),t("li",[e._v("Apple Binaries - Apple Inc.")])])])]),e._v(" "),t("p",[e._v("Remaining files within OpenCore Legacy Patcher are copyrighted 2020-2022 Mykola Grymalyuk & Dhinak G. For integration into other projects, please request written permission.")])])}),[],!1,null,null,null);r.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/29.bb464292.js b/assets/js/29.40021d7a.js similarity index 58% rename from assets/js/29.bb464292.js rename to assets/js/29.40021d7a.js index 22d33f7b5..07df28a9b 100644 --- a/assets/js/29.bb464292.js +++ b/assets/js/29.40021d7a.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{451:function(e,t,r){"use strict";r.r(t);var o=r(25),a=Object(o.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:"opencore-patcher-terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#opencore-patcher-terminology"}},[e._v("#")]),e._v(" OpenCore Patcher Terminology")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including "),r("code",[e._v("SSE4.1")]),e._v(", "),r("code",[e._v("32-Bit Firmware")]),e._v(", etc. This page is to help users understand what all these confusing words mean.")]),e._v(" "),r("h1",{attrs:{id:"terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#terminology"}},[e._v("#")]),e._v(" Terminology")]),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("macOS")])]),e._v(" "),r("td",[e._v('Apple\'s own UNIX based OS used for Mac machines and "What makes a Mac a Mac".')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Windows")])]),e._v(" "),r("td",[e._v("Microsoft's proprietary OS that is used and supported on a wide range of devices")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Linux")])]),e._v(" "),r("td",[e._v("Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Bootloader")])]),e._v(" "),r("td",[e._v("Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Boot Manager")])]),e._v(" "),r("td",[e._v("Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("OpenCore")])]),e._v(" "),r("td",[e._v("The new hotness on the scene, made with security in mind by the "),r("a",{attrs:{href:"https://github.com/acidanthera",target:"_blank",rel:"noopener noreferrer"}},[e._v("Acidanthera team"),r("OutboundLink")],1),e._v(", has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("ACPI")])]),e._v(" "),r("td",[e._v("Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("NVRAM")])]),e._v(" "),r("td",[e._v("Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("XNU")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("X")]),e._v(" is "),r("strong",[e._v("N")]),e._v("ot "),r("strong",[e._v("U")]),e._v('nix, XNU is referred to as macOS\'s "kernel" and the heart of what makes macOS tick')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Kexts")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("K")]),e._v("ernel "),r("strong",[e._v("Ext")]),e._v("ensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("KernelCollection")])]),e._v(" "),r("td",[e._v("Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience "),r("br"),e._v("- PrelinkedKernel: Default caching system since 10.7 "),r("br"),e._v("- ImmutableKernel: Secure Boot based caching system since 10.13 "),r("br"),e._v("- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("IOKit")])]),e._v(" "),r("td",[e._v("Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("WindowServer")])]),e._v(" "),r("td",[e._v("Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("OTA")])]),e._v(" "),r("td",[e._v("Short for "),r("strong",[e._v("O")]),e._v("ver "),r("strong",[e._v("T")]),e._v("he "),r("strong",[e._v("A")]),e._v("ir, refers to native OS updates via System Preferences like a supported Mac")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("DELTA")])]),e._v(" "),r("td",[e._v("Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmodified otherwise ~12GB updates will occur.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("EFI")])]),e._v(" "),r("td",[e._v("It can denote two things: "),r("br"),e._v('- Mac\'s firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal" '),r("br"),e._v("- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("HFS+")])]),e._v(" "),r("td",[e._v("Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("APFS")])]),e._v(" "),r("td",[e._v("This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32 and 64-Bit CPU")])]),e._v(" "),r("td",[e._v("The bit number of a CPU determines how much data a CPU can address. "),r("br"),e._v("- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32-Bit Firmware")])]),e._v(" "),r("td",[e._v("The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware"),r("br"),e._v("- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("SSE Instructions")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("S")]),e._v("IMD "),r("strong",[e._v("S")]),e._v("ingle-Precision Floating-Point "),r("strong",[e._v("I")]),e._v("nstructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation: "),r("br"),e._v("- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger "),r("br"),e._v("- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard "),r("br"),e._v("- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra")])])])]),e._v(" "),r("hr")])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{451:function(e,t,r){"use strict";r.r(t);var o=r(25),a=Object(o.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:"opencore-patcher-terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#opencore-patcher-terminology"}},[e._v("#")]),e._v(" OpenCore Patcher Terminology")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including "),r("code",[e._v("SSE4.1")]),e._v(", "),r("code",[e._v("32-Bit Firmware")]),e._v(", etc. This page is to help users understand what all these confusing words mean.")]),e._v(" "),r("h1",{attrs:{id:"terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#terminology"}},[e._v("#")]),e._v(" Terminology")]),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("macOS")])]),e._v(" "),r("td",[e._v('Apple\'s own UNIX based OS used for Mac machines and "What makes a Mac a Mac".')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Windows")])]),e._v(" "),r("td",[e._v("Microsoft's proprietary OS that is used and supported on a wide range of devices")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Linux")])]),e._v(" "),r("td",[e._v("Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Bootloader")])]),e._v(" "),r("td",[e._v("Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Boot Manager")])]),e._v(" "),r("td",[e._v("Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("OpenCore")])]),e._v(" "),r("td",[e._v("The new hotness on the scene, made with security in mind by the "),r("a",{attrs:{href:"https://github.com/acidanthera",target:"_blank",rel:"noopener noreferrer"}},[e._v("Acidanthera team"),r("OutboundLink")],1),e._v(", has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("ACPI")])]),e._v(" "),r("td",[e._v("Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("NVRAM")])]),e._v(" "),r("td",[e._v("Non-volatile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("XNU")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("X")]),e._v(" is "),r("strong",[e._v("N")]),e._v("ot "),r("strong",[e._v("U")]),e._v('nix, XNU is referred to as macOS\'s "kernel" and the heart of what makes macOS tick')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Kexts")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("K")]),e._v("ernel "),r("strong",[e._v("Ext")]),e._v("ensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("KernelCollection")])]),e._v(" "),r("td",[e._v("Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience "),r("br"),e._v("- PrelinkedKernel: Default caching system since 10.7 "),r("br"),e._v("- ImmutableKernel: Secure Boot based caching system since 10.13 "),r("br"),e._v("- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("IOKit")])]),e._v(" "),r("td",[e._v("Backbone of how Kernel Extensions (Kexts) probe and attach onto hardware, starts quickly after kernel initiates")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("WindowServer")])]),e._v(" "),r("td",[e._v("Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("OTA")])]),e._v(" "),r("td",[e._v("Short for "),r("strong",[e._v("O")]),e._v("ver "),r("strong",[e._v("T")]),e._v("he "),r("strong",[e._v("A")]),e._v("ir, refers to native OS updates via System Preferences like a supported Mac")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("DELTA")])]),e._v(" "),r("td",[e._v("Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmodified otherwise ~12GB updates will occur.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("EFI")])]),e._v(" "),r("td",[e._v("It can denote two things: "),r("br"),e._v('- Mac\'s firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal" '),r("br"),e._v("- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("HFS+")])]),e._v(" "),r("td",[e._v("Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("APFS")])]),e._v(" "),r("td",[e._v("This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32 and 64-Bit CPU")])]),e._v(" "),r("td",[e._v("The bit number of a CPU determines how much data a CPU can address. "),r("br"),e._v("- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32-Bit Firmware")])]),e._v(" "),r("td",[e._v("The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware"),r("br"),e._v("- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("SSE Instructions")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("S")]),e._v("IMD "),r("strong",[e._v("S")]),e._v("ingle-Precision Floating-Point "),r("strong",[e._v("I")]),e._v("nstructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation: "),r("br"),e._v("- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger "),r("br"),e._v("- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard "),r("br"),e._v("- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra")])])])]),e._v(" "),r("hr")])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/9.0c9a4159.js b/assets/js/9.0c9a4159.js new file mode 100644 index 000000000..f67feb80b --- /dev/null +++ b/assets/js/9.0c9a4159.js @@ -0,0 +1 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[9],{321:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Enabled.53d6d837.png"},322:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Root-Patch.23121f6d.png"},323:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Disabled.d9346b10.png"},409:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-SMBIOS-Minimal.1e3c25a2.png"},410:function(e,t,o){e.exports=o.p+"assets/img/Hash-Mismatch.add9f660.png"},453:function(e,t,o){"use strict";o.r(t);var a=o(25),r=Object(a.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:"troubleshooting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),a("p",[e._v("Here are some common errors users may experience while using this patcher:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("OpenCore Legacy Patcher not launching")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[e._v("Stuck on "),a("code",[e._v("This version of Mac OS X is not supported on this platform")])])]),e._v(" "),a("li",[a("a",{attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("Cannot boot macOS without the USB")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#infinite-recovery-os-reboot"}},[e._v("Infinite Recovery OS Booting")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("Reboot when entering Hibernation ("),a("code",[e._v("Sleep Wake Failure")]),e._v(")")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#booting-with-a-non-flashed-gpu"}},[e._v("Booting with a non-flashed GPU")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#how-to-boot-big-sur-recovery"}},[e._v("How to Boot Big Sur Recovery")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v('Stuck on "Your Mac needs a firmware update"')])]),e._v(" "),a("li",[a("a",{attrs:{href:"#no-brightness-control"}},[e._v("No Brightness Control")])]),e._v(" "),a("li",[a("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(" "),a("li",[a("a",{attrs:{href:"#no-graphics-acceleration"}},[e._v("No Graphics Acceleration")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#black-screen-on-macbookpro113-in-macos-monterey"}},[e._v("Black Screen on MacBookPro11,3 in macOS Monterey")])]),e._v(" "),a("li",[a("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(" "),a("li",[a("a",{attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("Volume Hash Mismatch Error in macOS Monterey")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("Cannot Disable SIP in recoveryOS")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v('Stuck on "Less than a minute remaining..."')])]),e._v(" "),a("li",[a("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(" "),a("h2",{attrs:{id:"opencore-legacy-patcher-not-launching"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher not launching")]),e._v(" "),a("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 "),a("code",[e._v("/Applications")]),e._v(" before this.")]),e._v(" "),a("div",{staticClass:"language-sh extra-class"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[e._v("/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher\n")])])]),a("h2",{attrs:{id:"stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[e._v("#")]),e._v(" Stuck on "),a("code",[e._v("This version of Mac OS X is not supported on this platform")])]),e._v(" "),a("p",[e._v("This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore "),a("strong",[e._v("before")]),e._v(" the macOS installer in the boot picker. Reminder the option will be called "),a("code",[e._v("EFI Boot")])]),e._v(" "),a("p",[e._v("Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.")]),e._v(" "),a("h2",{attrs:{id:"cannot-boot-macos-without-the-usb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("#")]),e._v(" Cannot boot macOS without the USB")]),e._v(" "),a("p",[e._v("By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either "),a("a",{attrs:{href:"https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("manually transfer"),a("OutboundLink")],1),e._v(" OpenCore to the internal drive's EFI or run this patcher's Option 2 again but select your internal drive.")]),e._v(" "),a("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(" "),a("h2",{attrs:{id:"infinite-recovery-os-booting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#infinite-recovery-os-booting"}},[e._v("#")]),e._v(" Infinite Recovery OS Booting")]),e._v(" "),a("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, simply uninstall OpenCore and "),a("a",{attrs:{href:"https://support.apple.com/en-mide/HT201255",target:"_blank",rel:"noopener noreferrer"}},[e._v("reset NVRAM"),a("OutboundLink")],1),e._v(".")]),e._v(" "),a("ul",[a("li",[e._v("Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored")])]),e._v(" "),a("h2",{attrs:{id:"reboot-when-entering-hibernation-sleep-wake-failure"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("#")]),e._v(" Reboot when entering Hibernation ("),a("code",[e._v("Sleep Wake Failure")]),e._v(")")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/issues/72",target:"_blank",rel:"noopener noreferrer"}},[e._v("Known issue on some models"),a("OutboundLink")],1),e._v(", temporary fix is to disable Hibernation:")]),e._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[e._v("sudo pmset -a hibernatemode 0\n")])])]),a("h2",{attrs:{id:"booting-with-a-non-flashed-gpu"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#booting-with-a-non-flashed-gpu"}},[e._v("#")]),e._v(" Booting with a non-flashed GPU")]),e._v(" "),a("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. To do so, make sure SIP is disabled(to allow NVRAM write access) and run the following:")]),e._v(" "),a("div",{staticClass:"language-sh extra-class"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot\n")])])]),a("ul",[a("li",[e._v("Note you will need to replace "),a("code",[e._v("VOLNAME")]),e._v(" with the Volume name of your USB or hard drive with OpenCore")]),e._v(" "),a("li",[e._v("Note 2: Once done, you can re-enable SIP")]),e._v(" "),a("li",[e._v('Note 3: The EFI partition OpenCore was installed on must be mounted, if it\'s unmounted simply rerun "Install OpenCore to drive"')])]),e._v(" "),a("p",[e._v("Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with "),a("code",[e._v("RequestBootVar")]),e._v(", all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.")]),e._v(" "),a("h2",{attrs:{id:"how-to-boot-big-sur-recovery"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-to-boot-big-sur-recovery"}},[e._v("#")]),e._v(" How to Boot Big Sur Recovery")]),e._v(" "),a("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 "Spacebar" inside OpenCore\'s Picker to list all boot options.')]),e._v(" "),a("h2",{attrs:{id:"stuck-on-your-mac-needs-a-firmware-update"}},[a("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(" "),a("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(" "),a("p",[e._v('This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.')]),e._v(" "),a("h2",{attrs:{id:"no-brightness-control"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#no-brightness-control"}},[e._v("#")]),e._v(" No Brightness Control")]),e._v(" "),a("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(" "),a("p",[e._v("To work-around, we recommend user try out the below app:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://actproductions.net/free-apps/brightness-slider/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Brightness Slider"),a("OutboundLink")],1)])]),e._v(" "),a("h2",{attrs:{id:"cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[a("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(" "),a("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(" "),a("p",[e._v('To work-around, we recommend users to manually connect using the "other" option on the Wi-Fi menu bar or manually adding the network on the "Network" preference pane.')]),e._v(" "),a("h2",{attrs:{id:"no-graphics-acceleration"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#no-graphics-acceleration"}},[e._v("#")]),e._v(" No Graphics Acceleration")]),e._v(" "),a("p",[e._v("In macOS, each release generally means GPU drivers are dropped from the OS. 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.")]),e._v(" "),a("p",[e._v("If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after first boot from installation of macOS. If you need to do this manually, you can within our app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.")]),e._v(" "),a("h2",{attrs:{id:"black-screen-on-macbookpro11-3-in-macos-monterey"}},[a("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(" "),a("p",[e._v("Due to Apple dropping NVIDIA Kepler support in macOS Monterey, "),a("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."),a("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(" "),a("ul",[a("li",[e._v("Safe Mode can be started by holding Shift+Enter when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),a("h2",{attrs:{id:"no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[a("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(" "),a("p",[e._v("If you're having troubles 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 play nicer.")]),e._v(" "),a("p",[a("img",{attrs:{src:o(409),alt:""}})]),e._v(" "),a("h2",{attrs:{id:"volume-hash-mismatch-error-in-macos-monterey"}},[a("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(" "),a("p",[e._v('A semi-common popup some users face is the "Volume Hash Mismatch" error:')]),e._v(" "),a("p",{attrs:{align:"center"}},[a("img",{attrs:{src:o(410)}})]),e._v(" "),a("p",[e._v("What this error signifies is that the OS detects the boot volume's hash does not match to what the OS detects, 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(" "),a("ul",[a("li",[e._v("Note that this bug affects native Macs as well and is not due to issues with unsupported Macs: "),a("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"),a("OutboundLink")],1)])]),e._v(" "),a("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(" "),a("h2",{attrs:{id:"cannot-disable-sip-in-recoveryos"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("#")]),e._v(" Cannot Disable SIP in recoveryOS")]),e._v(" "),a("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 NVRAM reset. However for users wanting to disable SIP entirely, this can be done easily.")]),e._v(" "),a("p",[e._v("Head into the GUI, Patcher Settings and toggle the bits you need disabled from SIP:")]),e._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Enabled")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Lowered (Root Patching)")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Disabled")])])]),e._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(321),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(322),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(323),alt:""}})])])])]),e._v(" "),a("h2",{attrs:{id:"intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[a("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(" "),a("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(" "),a("ul",[a("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"),a("ul",[a("li",[e._v("EHCI is the USB 2.0 controller in older Mac Pros")])])])]),e._v(" "),a("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(" "),a("ul",[a("li",[e._v("Alternatively, you can try cold starting the hardware and see if macOS recognizes the UHCI controller properly")])]),e._v(" "),a("h2",{attrs:{id:"stuck-on-less-than-a-minute-remaining"}},[a("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(" "),a("p",[e._v('A common area for systems to get "stuck", namely for units that are missing the '),a("code",[e._v("AES")]),e._v(" CPU instruction/older mobile hardware. During this strange a lot of heavy cryptography is performed, which can make systems appear to be stuck when in reality they are working quite hard to finish up the installation.")]),e._v(" "),a("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 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.")]),e._v(" "),a("h2",{attrs:{id:"no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[a("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(" "),a("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(" "),a("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 '),a("code",[e._v("Command")]),e._v(" + "),a("code",[e._v("Shift")]),e._v(" + "),a("code",[e._v(".")])]),e._v(" "),a("p",[e._v("The reason for this is that the autopatcher will assume you will be using the original card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate when swapped.")])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/9.23f068a0.js b/assets/js/9.23f068a0.js deleted file mode 100644 index 3039f5090..000000000 --- a/assets/js/9.23f068a0.js +++ /dev/null @@ -1 +0,0 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[9],{321:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Enabled.53d6d837.png"},322:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Root-Patch.23121f6d.png"},323:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-Settings-SIP-Disabled.d9346b10.png"},409:function(e,t,o){e.exports=o.p+"assets/img/OCLP-GUI-SMBIOS-Minimal.1e3c25a2.png"},410:function(e,t,o){e.exports=o.p+"assets/img/Hash-Mismatch.add9f660.png"},453:function(e,t,o){"use strict";o.r(t);var a=o(25),r=Object(a.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:"troubleshooting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),a("p",[e._v("Here are some common errors users may experience while using this patcher:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("OpenCore Legacy Patcher not launching")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[e._v("Stuck on "),a("code",[e._v("This version of Mac OS X is not supported on this platform")])])]),e._v(" "),a("li",[a("a",{attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("Cannot boot macOS without the USB")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#infinite-recovery-os-reboot"}},[e._v("Infinite Recovery OS Booting")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("Reboot when entering Hibernation ("),a("code",[e._v("Sleep Wake Failure")]),e._v(")")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#booting-with-a-non-flashed-gpu"}},[e._v("Booting with a non-flashed GPU")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#how-to-boot-big-sur-recovery"}},[e._v("How to Boot Big Sur Recovery")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-your-mac-needs-a-firmware-update"}},[e._v('Stuck on "Your Mac needs a firmware update"')])]),e._v(" "),a("li",[a("a",{attrs:{href:"#no-brightness-control"}},[e._v("No Brightness Control")])]),e._v(" "),a("li",[a("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(" "),a("li",[a("a",{attrs:{href:"#no-graphics-acceleration"}},[e._v("No Graphics Acceleration")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#black-screen-on-macbookpro113-in-macos-monterey"}},[e._v("Black Screen on MacBookPro11,3 in macOS Monterey")])]),e._v(" "),a("li",[a("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(" "),a("li",[a("a",{attrs:{href:"#volume-hash-mismatch-error-in-macos-monterey"}},[e._v("Volume Hash Mismatch Error in macOS Monterey")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("Cannot Disable SIP in recoveryOS")])]),e._v(" "),a("li",[a("a",{attrs:{href:"#stuck-on-less-than-a-minute-remaining"}},[e._v('Stuck on "Less than a minute remaining..."')])]),e._v(" "),a("li",[a("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(" "),a("h2",{attrs:{id:"opencore-legacy-patcher-not-launching"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#opencore-legacy-patcher-not-launching"}},[e._v("#")]),e._v(" OpenCore Legacy Patcher not launching")]),e._v(" "),a("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 "),a("code",[e._v("/Applications")]),e._v(" before this.")]),e._v(" "),a("div",{staticClass:"language-sh extra-class"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[e._v("/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher \n")])])]),a("h2",{attrs:{id:"stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"}},[e._v("#")]),e._v(" Stuck on "),a("code",[e._v("This version of Mac OS X is not supported on this platform")])]),e._v(" "),a("p",[e._v("This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore "),a("strong",[e._v("before")]),e._v(" the macOS installer in the boot picker. Reminder the option will be called "),a("code",[e._v("EFI Boot")])]),e._v(" "),a("p",[e._v("Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.")]),e._v(" "),a("h2",{attrs:{id:"cannot-boot-macos-without-the-usb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#cannot-boot-macos-without-the-usb"}},[e._v("#")]),e._v(" Cannot boot macOS without the USB")]),e._v(" "),a("p",[e._v("By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either "),a("a",{attrs:{href:"https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("manually transfer"),a("OutboundLink")],1),e._v(" OpenCore to the internal drive's EFI or run this patcher's Option 2 again but select your internal drive.")]),e._v(" "),a("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(" "),a("h2",{attrs:{id:"infinite-recovery-os-booting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#infinite-recovery-os-booting"}},[e._v("#")]),e._v(" Infinite Recovery OS Booting")]),e._v(" "),a("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, simply uninstall OpenCore and "),a("a",{attrs:{href:"https://support.apple.com/en-mide/HT201255",target:"_blank",rel:"noopener noreferrer"}},[e._v("reset NVRAM"),a("OutboundLink")],1),e._v(".")]),e._v(" "),a("ul",[a("li",[e._v("Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored")])]),e._v(" "),a("h2",{attrs:{id:"reboot-when-entering-hibernation-sleep-wake-failure"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#reboot-when-entering-hibernation-sleep-wake-failure"}},[e._v("#")]),e._v(" Reboot when entering Hibernation ("),a("code",[e._v("Sleep Wake Failure")]),e._v(")")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/issues/72",target:"_blank",rel:"noopener noreferrer"}},[e._v("Known issue on some models"),a("OutboundLink")],1),e._v(", temporary fix is to disable Hibernation:")]),e._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[e._v("sudo pmset -a hibernatemode 0\n")])])]),a("h2",{attrs:{id:"booting-with-a-non-flashed-gpu"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#booting-with-a-non-flashed-gpu"}},[e._v("#")]),e._v(" Booting with a non-flashed GPU")]),e._v(" "),a("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. To do so, make sure SIP is disabled(to allow NVRAM write access) and run the following:")]),e._v(" "),a("div",{staticClass:"language-sh extra-class"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot\n")])])]),a("ul",[a("li",[e._v("Note you will need to replace "),a("code",[e._v("VOLNAME")]),e._v(" with the Volume name of your USB or hard drive with OpenCore")]),e._v(" "),a("li",[e._v("Note 2: Once done, you can re-enable SIP")]),e._v(" "),a("li",[e._v('Note 3: The EFI partition OpenCore was installed on must be mounted, if it\'s unmounted simply rerun "Install OpenCore to drive"')])]),e._v(" "),a("p",[e._v("Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with "),a("code",[e._v("RequestBootVar")]),e._v(", all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.")]),e._v(" "),a("h2",{attrs:{id:"how-to-boot-big-sur-recovery"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-to-boot-big-sur-recovery"}},[e._v("#")]),e._v(" How to Boot Big Sur Recovery")]),e._v(" "),a("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 "Spacebar" inside OpenCore\'s Picker to list all boot options.')]),e._v(" "),a("h2",{attrs:{id:"stuck-on-your-mac-needs-a-firmware-update"}},[a("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(" "),a("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(" "),a("p",[e._v('This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.')]),e._v(" "),a("h2",{attrs:{id:"no-brightness-control"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#no-brightness-control"}},[e._v("#")]),e._v(" No Brightness Control")]),e._v(" "),a("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(" "),a("p",[e._v("To work-around, we recommend user try out the below app:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://actproductions.net/free-apps/brightness-slider/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Brightness Slider"),a("OutboundLink")],1)])]),e._v(" "),a("h2",{attrs:{id:"cannot-connect-wi-fi-on-monterey-with-legacy-cards"}},[a("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(" "),a("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(" "),a("p",[e._v('To work-around, we recommend users to manually connect using the "other" option on the Wi-Fi menu bar or manually adding the network on the "Network" preference pane.')]),e._v(" "),a("h2",{attrs:{id:"no-graphics-acceleration"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#no-graphics-acceleration"}},[e._v("#")]),e._v(" No Graphics Acceleration")]),e._v(" "),a("p",[e._v("In macOS, each release generally means GPU drivers are dropped from the OS. 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.")]),e._v(" "),a("p",[e._v("If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after first boot from installation of macOS. If you need to do this manually, you can within our app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.")]),e._v(" "),a("h2",{attrs:{id:"black-screen-on-macbookpro11-3-in-macos-monterey"}},[a("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(" "),a("p",[e._v("Due to Apple dropping NVIDIA Kepler support in macOS Monterey, "),a("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."),a("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(" "),a("ul",[a("li",[e._v("Safe Mode can be started by holding Shift+Enter when selecting macOS Monterey in OCLP's Boot Menu.")])]),e._v(" "),a("h2",{attrs:{id:"no-displayport-output-on-mac-pros-with-nvidia-kepler"}},[a("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(" "),a("p",[e._v("If you're having troubles 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 play nicer.")]),e._v(" "),a("p",[a("img",{attrs:{src:o(409),alt:""}})]),e._v(" "),a("h2",{attrs:{id:"volume-hash-mismatch-error-in-macos-monterey"}},[a("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(" "),a("p",[e._v('A semi-common popup some users face is the "Volume Hash Mismatch" error:')]),e._v(" "),a("p",{attrs:{align:"center"}},[a("img",{attrs:{src:o(410)}})]),e._v(" "),a("p",[e._v("What this error signifies is that the OS detects the boot volume's hash does not match to what the OS detects, 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(" "),a("ul",[a("li",[e._v("Note that this bug affects native Macs as well and is not due to issues with unsupported Macs: "),a("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"),a("OutboundLink")],1)])]),e._v(" "),a("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(" "),a("h2",{attrs:{id:"cannot-disable-sip-in-recoveryos"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#cannot-disable-sip-in-recoveryos"}},[e._v("#")]),e._v(" Cannot Disable SIP in recoveryOS")]),e._v(" "),a("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 NVRAM reset. However for users wanting to disable SIP entirely, this can be done easily.")]),e._v(" "),a("p",[e._v("Head into the GUI, Patcher Settings and toggle the bits you need disabled from SIP:")]),e._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Enabled")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Lowered (Root Patching)")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("SIP Disabled")])])]),e._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(321),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(322),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:o(323),alt:""}})])])])]),e._v(" "),a("h2",{attrs:{id:"intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"}},[a("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(" "),a("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(" "),a("ul",[a("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"),a("ul",[a("li",[e._v("EHCI is the USB 2.0 controller in older Mac Pros")])])])]),e._v(" "),a("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(" "),a("ul",[a("li",[e._v("Alternatively, you can try cold starting the hardware and see if macOS recognizes the UHCI controller properly")])]),e._v(" "),a("h2",{attrs:{id:"stuck-on-less-than-a-minute-remaining"}},[a("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(" "),a("p",[e._v('A common area for systems to get "stuck", namely for units that are missing the '),a("code",[e._v("AES")]),e._v(" CPU instruction/older mobile hardware. During this stange a lot of heavy cryptography is performed, which can make systems appear to be stuck when in reality they are working quite hard to finish up the installation.")]),e._v(" "),a("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 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.")]),e._v(" "),a("h2",{attrs:{id:"no-acceleration-after-a-metal-gpu-swap-on-mac-pro"}},[a("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(" "),a("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(" "),a("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 '),a("code",[e._v("Command")]),e._v(" + "),a("code",[e._v("Shift")]),e._v(" + "),a("code",[e._v(".")])]),e._v(" "),a("p",[e._v("The reason for this is that the autopatcher will assume you will be using the original card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate when swapped.")])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/app.80ddb062.js b/assets/js/app.1e4fc89e.js similarity index 90% rename from assets/js/app.80ddb062.js rename to assets/js/app.1e4fc89e.js index f3b1021f9..13ba99d2e 100644 --- a/assets/js/app.80ddb062.js +++ b/assets/js/app.1e4fc89e.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" +