mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-04-15 21:28:55 +10:00
Compare commits
42 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e2a6d35c27 | ||
|
|
b3cc808e8d | ||
|
|
31539dc0a6 | ||
|
|
0db0ab00f5 | ||
|
|
950d189bfe | ||
|
|
cd461b0239 | ||
|
|
084b77e0ab | ||
|
|
97369bf6e6 | ||
|
|
b8aaeac614 | ||
|
|
72a1e0c103 | ||
|
|
c6a187401c | ||
|
|
eeec1fd2dd | ||
|
|
77085548fa | ||
|
|
978ef88a9b | ||
|
|
5a8cc14286 | ||
|
|
240ebb33ee | ||
|
|
504d16f57f | ||
|
|
09ebe821cb | ||
|
|
115339e3a4 | ||
|
|
8c835a25b9 | ||
|
|
87fb4fb34d | ||
|
|
af197f56b3 | ||
|
|
5376ab7819 | ||
|
|
c70b18b01e | ||
|
|
a2ae2fbb38 | ||
|
|
879edfd2db | ||
|
|
c5a3d657da | ||
|
|
2031ee40dc | ||
|
|
9f8367f070 | ||
|
|
7df5add2ff | ||
|
|
d47d1def94 | ||
|
|
3c01fb7de6 | ||
|
|
fc428b3cc2 | ||
|
|
e49b1d0f90 | ||
|
|
e4838d3803 | ||
|
|
05e237c7bd | ||
|
|
1868ce4117 | ||
|
|
978ce9ea0b | ||
|
|
fd66f87f00 | ||
|
|
85c6a0d682 | ||
|
|
3ba9fdc8e1 | ||
|
|
56b9d8ec93 |
2
.github/ISSUE_TEMPLATE/config.yml
vendored
2
.github/ISSUE_TEMPLATE/config.yml
vendored
@@ -1 +1 @@
|
||||
blank_issues_enabled: false
|
||||
blank_issues_enabled: true
|
||||
|
||||
@@ -40,6 +40,9 @@ tr
|
||||
&:nth-child(2n)
|
||||
background-color var(--sideBgColor)
|
||||
|
||||
h4
|
||||
font-size 1.08rem
|
||||
|
||||
|
||||
|
||||
.dropdown-wrapper .nav-dropdown
|
||||
@@ -65,4 +68,4 @@ tr
|
||||
color: var(--accentColor) !important
|
||||
|
||||
.search-box .suggestion.focused a
|
||||
color: var(--navItemHoverColor) !important
|
||||
color: var(--navItemHoverColor) !important
|
||||
|
||||
24
docs/FAQ.md
24
docs/FAQ.md
@@ -3,7 +3,7 @@
|
||||
* [Application requirements](#application-requirements)
|
||||
* [Application versioning](#application-versioning)
|
||||
* [How do I make sure I'm all up to date?](#how-do-i-make-sure-i-m-all-up-to-date)
|
||||
* [Why are the settings "not saving"?](#why-are-the-settings-not-saving)
|
||||
* [Where are the GUI settings saved?](#where-are-the-gui-settings-saved)
|
||||
* [Can I use the same USB install media as a universal installer?](#can-i-use-the-same-usb-install-media-as-a-universal-installer)
|
||||
* [Can I use OTA updates?](#can-i-use-ota-updates)
|
||||
* [Can I use automatic updates?](#can-i-use-automatic-updates)
|
||||
@@ -21,8 +21,10 @@
|
||||
|
||||
## Application requirements
|
||||
The patcher application requires **OS X Yosemite 10.10** or later to run.
|
||||
* **El Capitan 10.11** or later is required to make installers for macOS Ventura
|
||||
* **High Sierra 10.13** or later is required to make installers for macOS Sonoma and newer.
|
||||
|
||||
Due to limitations with Apple's `createinstallmedia` tool used for installer creation, the following are required:
|
||||
* **El Capitan 10.11** to make installers for macOS Ventura.
|
||||
* **High Sierra 10.13** to make installers for macOS Sonoma and newer.
|
||||
|
||||
The patcher is designed to target **macOS Big Sur 11.x to macOS Sequoia 15.x**.
|
||||
* Other versions may work, albeit in a broken state. No support is provided for any version outside of the above.
|
||||
@@ -66,9 +68,9 @@ When building OpenCore on a different system, OCLP cannot be aware of all the ha
|
||||
|
||||
## Can I use OTA updates?
|
||||
|
||||
You can. However it is extremely recommended to use USB drive for major OS upgrades (such as 13 -> 14) to avoid larger issues from potentially occurring.
|
||||
You can. However it is extremely recommended to use USB drive for major OS upgrades (such as 13 -> 14) to avoid larger issues from potentially occurring. General updates are usually fine, though it is always a good idea to wait few days to see whether patches break and have to be fixed.
|
||||
|
||||
General updates are usually fine, though it is always a good idea to wait few days to see whether patches break and have to be fixed.
|
||||
See more information about updating in [Preparing OCLP for macOS update.](https://dortania.github.io/OpenCore-Legacy-Patcher/UPDATE.html#preparing-oclp-for-macos-update)
|
||||
|
||||
## Can I use automatic updates?
|
||||
|
||||
@@ -106,7 +108,7 @@ macOS doesn't allow direct downgrades, as such you will have to wipe the disk in
|
||||
|
||||
## Why is my system slow?
|
||||
|
||||
**Lacking or broken root patches**
|
||||
#### Lacking or broken root patches
|
||||
|
||||
If your system is being **really** slow and macOS is lacking wallpaper and transparency in Dock and menubar, make sure to install root patches to get proper drivers and functionality. Refer to [Applying post install volume patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches) section for more information.
|
||||
|
||||
@@ -114,15 +116,15 @@ If your system is being **really** slow and macOS is lacking wallpaper and trans
|
||||
|
||||
Patches can also break if automatic updates are enabled and an update prematurely modifies the system volume, refer to [System version mismatch error when root patching](https://dortania.github.io/OpenCore-Legacy-Patcher/TROUBLESHOOT-APP.html#system-version-mismatch-error-when-root-patching) for more information.
|
||||
|
||||
**Spotlight**
|
||||
#### Spotlight
|
||||
|
||||
If your macOS installation is recent, Spotlight starts creating a full disk index which can cause high CPU load, high temps and general slowness. It's recommended to keep the system running for few hours, once Spotlight has indexed the load will ease. A way to check whether it's caused by Spotlight is to open Activity Monitor, choosing "All Processes" from the "View" menu item, then sorting by the CPU value to see if a process called ```mds_stores``` is using a lot of CPU resources.
|
||||
|
||||
**Heavier macOS versions**
|
||||
#### Heavier macOS versions
|
||||
|
||||
Newer operating systems are harder to run and can appear more slow. If this is the case, there is not a whole lot to do about it.
|
||||
|
||||
**Thermal issues or bad/missing battery**
|
||||
#### Thermal issues or bad/missing battery
|
||||
|
||||
If you see ```kernel_task``` hogging a lot of CPU resources in Activity Monitor (this also requires View -> All Processes), this means the system is being throttled mostly due to the following reasons:
|
||||
|
||||
@@ -245,3 +247,7 @@ Apple Intelligence requires Neural Engine, which is only found in Apple Silicon
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -120,7 +120,7 @@ You can install and revert Root Patching manually from the app.
|
||||
|
||||
### Packages requiring networking
|
||||
|
||||
**MetallibSupportPkg**
|
||||
#### MetallibSupportPkg
|
||||
|
||||
Required for Ivy Bridge, Haswell and NVIDIA Kepler based systems (3802) running Sequoia or newer. You can download it manually from the following link:
|
||||
|
||||
@@ -138,7 +138,7 @@ Required for Ivy Bridge, Haswell and NVIDIA Kepler based systems (3802) running
|
||||
|
||||
:::
|
||||
|
||||
**KDK / Kernel Debug Kit**
|
||||
#### KDK / Kernel Debug Kit
|
||||
|
||||
Macs with AMD Legacy GCN GPUs (ie. Metal) running Ventura or newer require Apple's Kernel Debug Kit to start root patching. You can manually download the KDK from the following link:
|
||||
|
||||
|
||||
@@ -14,11 +14,13 @@ This time Apple dropped surprisingly few amount of Macs. With the release of Ope
|
||||
|
||||
## Current status
|
||||
|
||||
OpenCore Legacy Patcher 2.0.0 will support Sequoia for most models normally supported by the Patcher, however some challenges remain. You can find information about them below.
|
||||
OpenCore Legacy Patcher 2.0.0 supports Sequoia for the models below, however some challenges remain. You can find information about them further down this page.
|
||||
|
||||
Unfortunately due to T2 related problems, the recently dropped MacBookAir8,x models cannot be supported at this time. We have made some progress on this issue, but panics are still occurring and there is still a significant amount of development work to do before T2 machines may even get to the install screen. We cannot provide any estimate on when T2 machines will be supported.
|
||||
<img width="625" alt="" src="./images/OCLP-200-Initial-Support.png">
|
||||
|
||||
[More information here](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1136)
|
||||
Unfortunately due to T2 related problems, the recently dropped MacBookAir8,x models cannot be supported at this time. We have made some progress on this issue, but panics are still occurring and there is still a significant amount of development work to do before T2 machines may even get to the install screen. We cannot provide any estimate on when T2 machines will be supported.
|
||||
|
||||
[More information here.](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1136)
|
||||
|
||||
## Non-functional features
|
||||
|
||||
|
||||
@@ -18,7 +18,9 @@ Apple has yet again dropped a bunch of models, continuing their journey on disco
|
||||
|
||||
## Current status
|
||||
|
||||
OpenCore Legacy Patcher 1.0.0 will support Sonoma for all models normally supported by the Patcher, however some challenges remain. You can find information about them below.
|
||||
OpenCore Legacy Patcher 1.0.0 supports Sonoma for all models below, however some challenges remain. You can find information about them further down on this page.
|
||||
|
||||
<img width="625" alt="" src="./images/OCLP-100-Initial-Support.png">
|
||||
|
||||
## Issues
|
||||
|
||||
@@ -36,7 +38,9 @@ Dual boots may also bring the issue back even after the reset.
|
||||
|
||||
### T1 Security chip
|
||||
|
||||
::: details Support for the T1 Security chip (Resolved in 1.1.0 and newer)
|
||||
**Resolved in 1.1.0 and newer, original explainer below**
|
||||
|
||||
::: details Support for the T1 Security chip
|
||||
|
||||
Sonoma has removed support for T1 chips found in most 2016 and 2017 Macs. Therefore on these systems, the following will not function:
|
||||
|
||||
@@ -50,7 +54,7 @@ Sonoma has removed support for T1 chips found in most 2016 and 2017 Macs. Theref
|
||||
:::
|
||||
|
||||
::: warning
|
||||
Note that erasing the entire drive will remove the T1 firmware and it won't be reinstalled.
|
||||
Note that erasing the entire drive will remove the T1 firmware and it won't be reinstalled. Refer to [troubleshooting](https://dortania.github.io/OpenCore-Legacy-Patcher/TROUBLESHOOT-HARDWARE.html#no-t1-functionality-after-installing-sonoma-or-newer) for more information.
|
||||
:::
|
||||
|
||||
### USB 1.1 (OHCI/UHCI) Support
|
||||
|
||||
@@ -99,9 +99,11 @@ In this example, it is telling that a version 13.7.5 (Ventura) is expected which
|
||||
There are few options to resolve it:
|
||||
|
||||
1. Update/upgrade to the version already staged.
|
||||
* This option works only if the newer version is currently supported by OCLP.
|
||||
2. Reinstall macOS.
|
||||
* You can try doing an in-place install without wiping the disk to keep your data but this may not be possible due to the OS being partially on newer version and it will complain about downgrade.
|
||||
4. Use an experimental "PurgePendingUpdate" tool [from the Discord server](https://discord.com/channels/417165963327176704/1253268648324235345/1257348959454625985).
|
||||
3. Use an experimental "PurgePendingUpdate" tool [from the Discord server](https://discord.gg/rqdPgH8xSN).
|
||||
* Navigate to `support-forum` and then to the `Information and known issues` post to find the link to the tool.
|
||||
* Download it and then run it in Terminal to get rid of a pending update, then repatch again. If "purge failed" appears, you can ignore it.
|
||||
* Sometimes you may have to give the file an execution permission with `chmod +x` and putting the application path after the command (type or drag the file) before the tool can be ran.
|
||||
* This may be integrated into OCLP later on, however there is currently no ETA.
|
||||
@@ -124,3 +126,6 @@ System Preferences -> Software Update -> Advanced -> Disable "Download new updat
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Hardware issues
|
||||
|
||||
**General**
|
||||
#### General
|
||||
|
||||
* [No Brightness Control](#no-brightness-control)
|
||||
* [Cannot connect Wi-Fi on Monterey with legacy cards](#cannot-connect-wi-fi-on-monterey-with-legacy-cards)
|
||||
@@ -11,8 +11,7 @@
|
||||
* [Keyboard, Mouse and Trackpad not working in installer or after update](#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update)
|
||||
* [No T1 functionality after installing Sonoma or newer](#no-t1-functionality-after-installing-sonoma-or-newer)
|
||||
|
||||
**Non-Metal**
|
||||
|
||||
#### Non-Metal
|
||||
|
||||
* [Keyboard Backlight broken](#keyboard-backlight-broken)
|
||||
* [Wake from sleep heavily distorted on AMD/ATI from macOS 11.3 to Monterey](#wake-from-sleep-heavily-distorted-on-ati-amd-terascale-1-from-macos-11-3-to-monterey)
|
||||
@@ -42,7 +41,9 @@ To work-around this, we recommend that users manually connect using the "Other"
|
||||
|
||||
In macOS, GPU drivers are often dropped from the OS with each major release of it. If you're using OCLP v0.4.4 or newer, you should have been prompted to install Root Volume patches after the first boot from installation of macOS. If you need to do this manually, you can do so within the patcher app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.
|
||||
|
||||
See [Applying Post Install Volume Patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches) for more information.
|
||||
See [Applying Post Install Volume Patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches) for more information.
|
||||
|
||||
If you swapped a GPU from stock to a Metal GPU in a Mac Pro after installing OS, see [No acceleration after a Metal GPU swap on Mac Pro](#no-acceleration-after-a-metal-gpu-swap-on-mac-pro) for instructions.
|
||||
|
||||
Check the list below to see what GPUs require patching in which OS versions.
|
||||
|
||||
@@ -164,11 +165,11 @@ Starting with macOS Sequoia, OCLP has to disable the secondary CPU in these syst
|
||||
|
||||
## No acceleration after a Metal GPU swap on Mac Pro
|
||||
|
||||
If you finished installing macOS 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. In macOS Ventura and newer, repatching is needed after reversion.
|
||||
If you finished installing macOS 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.
|
||||
|
||||
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` + `.`
|
||||
To fix this, open OCLP and revert root patches to get your Metal-supported GPU work again. In macOS Ventura and newer, repatching is needed for most configurations after reversion. Reason why this happens is automatic root patching during USB install and the autopatcher assuming you will be using the original graphics card and therefore doing non-Metal patching. **Metal and non-Metal GPUs cannot be used at the same time** as Non-Metal patching completely bypasses Metal and requires removing some parts such as drivers for other cards, which causes Metal cards to not accelerate after swapping.
|
||||
|
||||
The reason for this is that the autopatcher will assume that you will be using the original graphics card and therefore does non-metal patching, which includes removing some drivers for other cards. This causes Metal cards to not accelerate after swapping.
|
||||
Alternatively, you can remove "AutoPkg-Assets.pkg" from /Library/Packages on the USB drive before proceeding with the installation. This package includes the assets for root patching and the system won't be autopatched if they aren't present. To see the folder, enable hidden files with `Command` + `Shift` + `.`
|
||||
|
||||
## Keyboard, Mouse and Trackpad not working in installer or after update
|
||||
|
||||
@@ -293,7 +294,7 @@ However, if your machine does not have the dGPU disabled via NVRAM, you'll exper
|
||||
* Press Cmd+S in OpenCore's menu when you turn the Mac on
|
||||
2. When the command line prompt appears, enter the dGPU disabler argument (at the bottom)
|
||||
3. Reboot and patched macOS should work normally
|
||||
4. If you still want to use the dGPU, run OpenCore Legacy Patcher and enable TS2 Acceleration from settings. Go to `Patcher Settings -> Developer Settings -> Set TeraScale 2 Accel`, then root patch again.
|
||||
4. If you still want to use the dGPU, run OpenCore Legacy Patcher and enable TS2 Acceleration from settings. Go to `Settings -> Root Patching -> TeraScale 2 Acceleration`, then root patch again.
|
||||
5. Either Reset NVRAM or set `gpu-power-prefs` to zeros to re-enable the dGPU
|
||||
|
||||
```sh
|
||||
@@ -330,3 +331,6 @@ For more information, see [ASentientBot's post](https://forums.macrumors.com/thr
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Booting, installer and other issues
|
||||
|
||||
**Booting**
|
||||
#### Booting
|
||||
|
||||
* [Stuck on `This version of Mac OS X is not supported on this platform` or (🚫) Prohibited Symbol](#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-🚫-prohibited-symbol)
|
||||
* [Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb)
|
||||
@@ -9,14 +9,14 @@
|
||||
* [Booting Recovery through OpenCore Legacy Patcher](#booting-recovery-through-opencore-legacy-patcher)
|
||||
* [Black Screen on MacBookPro11,3 in macOS Monterey](#black-screen-on-macbookpro11-3-in-macos-monterey)
|
||||
|
||||
**Installer**
|
||||
#### Installer
|
||||
|
||||
* [Stuck on hard disk selection with greyed out buttons in installer](#stuck-on-hard-disk-selection-with-greyed-out-buttons-in-installer)
|
||||
* [Installer fails with "an error occurred preparing the software update"](#installer-fails-with-an-error-occurred-preparing-the-software-update)
|
||||
* [Stuck on "Less than a minute remaining..."](#stuck-on-less-than-a-minute-remaining)
|
||||
* [Stuck on "Your Mac needs a firmware update"](#stuck-on-your-mac-needs-a-firmware-update)
|
||||
|
||||
**Other**
|
||||
#### Other
|
||||
|
||||
* [Reboot when entering Hibernation (`Sleep Wake Failure`)](#reboot-when-entering-hibernation-sleep-wake-failure)
|
||||
* [Volume Hash Mismatch Error in macOS Monterey](#volume-hash-mismatch-error-in-macos-monterey)
|
||||
@@ -144,3 +144,4 @@ Head into the GUI, go to Patcher Settings, and toggle the bits you need disabled
|
||||
|  |  |  |
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
The below page is for users experiencing issues with their overall usage of macOS Big Sur and newer and the Legacy Graphics Acceleration patches. For those unfamiliar with what is considered a non-Metal GPU, see the chart in [FAQ](https://dortania.github.io/OpenCore-Legacy-Patcher/FAQ.html#what-is-metal-and-non-metal)
|
||||
|
||||
* [Broken Firefox and Thunderbird (HD 3000)](#broken-firefox-and-thunderbird-hd-3000)
|
||||
* [Broken Background Blurs](#broken-background-blurs)
|
||||
* [Downloading older non-Metal Apps](#downloading-older-non-metal-apps)
|
||||
* [Unable to run Zoom](#unable-to-run-zoom)
|
||||
@@ -10,6 +11,19 @@ The below page is for users experiencing issues with their overall usage of macO
|
||||
* [Cannot press "Done" when editing a Sidebar Widget](#cannot-press-done-when-editing-a-sidebar-widget)
|
||||
* [Unable to allow Safari Extensions](#unable-to-allow-safari-extensions)
|
||||
|
||||
|
||||
## Broken Firefox and Thunderbird (HD 3000)
|
||||
|
||||
[Due to removal of HD 3000 support workarounds](https://hg-edge.mozilla.org/releases/mozilla-release/rev/32d4368e5a2a869bdc1f4556f020c1a6bea2a9c0) in Firefox/Thunderbird v145, Firefox and Thunderbird on HD 3000 are now broken. This may lead to system freezes and other erratic behavior on systems with this GPU, which is found in Mac models from 2011. As a workaround, hardware acceleration has to be disabled. If your system is locking up in normal mode, boot into Safe Mode by holding `Shift` on boot and disable hardware acceleration for Firefox and Thunderbird wherever applicable.
|
||||
|
||||
::: details Affected Mac models (click to expand)
|
||||
|
||||
* MacBook Pro 2011 13", 15" and 17"
|
||||
* MacBook Air 2011 11" and 13"
|
||||
* Mac mini 2011 models without Radeon dGPU
|
||||
|
||||
:::
|
||||
|
||||
## 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:
|
||||
|
||||
@@ -1,35 +1,30 @@
|
||||
# Updating OpenCore and Patches
|
||||
# Updating
|
||||
|
||||
This guide explains how to get fully up to date application, bootloader and patches.
|
||||
|
||||
## Updating the application
|
||||
## Updating the application, OpenCore and patches
|
||||
|
||||
Latest versions of OCLP can download updates by themselves, you will get notified of a new update with the changelog.
|
||||
|
||||
[You can also manually download the latest release here.](https://github.com/dortania/OpenCore-Legacy-Patcher/releases)
|
||||
|
||||
|
||||
<div align="left">
|
||||
<img src="./images/OCLP_Update_Available.png" alt="Update Avaialble" />
|
||||
</div>
|
||||
|
||||
|
||||
## Updating patches
|
||||
|
||||
After the update, the application asks if you want to update OpenCore and root patches.
|
||||
|
||||
If you do not need to change any settings, you can click "Yes" and follow the procedure. If you want to change settings, select "No" from here and do your settings, then manually build and install OpenCore to update to the latest version of the bootloader.
|
||||
|
||||
Finally install new root patches to ensure you're running on the latest fixes for on-disk patches.
|
||||
* If you do not need to change any settings, click "Yes" on the patch update question and follow the procedure to update OpenCore and root patches automatically.
|
||||
* If you do want to change settings, select "No" and do your settings.
|
||||
* In case you selected "No", you will have to manually build and install OpenCore and then manually install new root patches to ensure you're running on the latest OpenCore with your settings and the fixes for on-disk patches.
|
||||
|
||||
|
||||
<div align="left">
|
||||
<img src="./images/OCLP_Update_Successful.png" alt="Update Successful" />
|
||||
</div>
|
||||
| Update available | App update success, patch update question |
|
||||
| :--- | :--- |
|
||||
| <img src="./images/OCLP_Update_Available.png" alt="Update Available" width="500" /> | <img src="./images/OCLP_Update_Successful.png" alt="Update Successful" width="400" /> |
|
||||
|
||||
## Checking OCLP and OpenCore versions
|
||||
|
||||
To check what version of OpenCore bootloader and the Patcher you're currently running, you can run the following in the terminal:
|
||||
#### Checking OCLP and OpenCore versions
|
||||
|
||||
To check what version of OpenCore bootloader and the Patcher you're currently running, open the OCLP application and navigate to `Settings -> App` and look for "Booted Information". Alternatively you can check the version from Terminal using the following commands.
|
||||
|
||||
Check the status and version of root patches from `Post Install Volume Patch` section in the main menu.
|
||||
|
||||
```bash
|
||||
# OpenCore Version
|
||||
@@ -38,8 +33,47 @@ nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version
|
||||
nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version
|
||||
```
|
||||
|
||||
<div align="left">
|
||||
<img src="./images/oclp-version.png" alt="OCLP version" width="600" />
|
||||
</div>
|
||||
|
||||
From this, we can see that we're running a RELEASE version of OpenCore 0.9.0 built on January 1st, 2023 with Patcher Version 0.6.0!
|
||||
| Version in app | Version in Terminal | Root patch version |
|
||||
| :--- | :--- | :--- |
|
||||
| <img src="./images/OCLP_Booted_Version.png" alt="Build start" width="600" /> | <img src="./images/oclp-version.png" alt="OCLP version" width="900" /> | <img src="./images/OCLP_Root_Patch_Version.png" alt="Root Patch Version" width="900" /> |
|
||||
|
||||
|
||||
## Preparing OCLP for macOS update
|
||||
|
||||
It is usually recommended to be on the latest OCLP version for macOS updates. This part details how to prepare OCLP for latest update.
|
||||
|
||||
### Major upgrades
|
||||
|
||||
This part is for major upgrades, such as `Sonoma (14)` -> `Sequoia (15)`
|
||||
|
||||
1. Make sure the OCLP app is up to date.
|
||||
2. After app has updated, rebuild OpenCore to the internal disk to update the bootloader.
|
||||
* You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
|
||||
2. Download the macOS version you want and create an installer USB drive using OCLP as detailed in the original [Creating macOS Installers](https://dortania.github.io/OpenCore-Legacy-Patcher/INSTALLER.html) guide, then follow the [Booting OpenCore and macOS](https://dortania.github.io/OpenCore-Legacy-Patcher/BOOT.html) guide boot to into the installer on your USB drive.
|
||||
3. Start macOS installation and follow the process, do not use Disk Utility if you don't want to wipe your disk.
|
||||
4. After installation, reinstall [root patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches).
|
||||
|
||||
**Note:** Major upgrades may work using System Settings but this is not recommended.
|
||||
|
||||
### Minor updates
|
||||
|
||||
This part is for minor updates, which are also called the "dot updates". Such as `12.x`, `13.x` etc.
|
||||
|
||||
1. Make sure the OCLP app is up to date.
|
||||
2. Rebuild OpenCore to the internal disk to update the bootloader.
|
||||
* You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
|
||||
3. Start update from System Settings.
|
||||
* If your system requires [KDKSupportPkg](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#kdk-kernel-debug-kit), OCLP will start downloading it automatically as long as you are connected to the internet and have the [background process](https://dortania.github.io/OpenCore-Legacy-Patcher/PROCESS.html) enabled.
|
||||
4. Once installed, go into OCLP app and reinstall [root patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches).
|
||||
|
||||
::: warning Important
|
||||
|
||||
Some systems on Sequoia require [MetallibSupportPkg](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#metallibsupportpkg) during root patching after an update, which requires internet connection to download. If OCLP doesn't see internet connection, it will first offer a patch for WiFi only. You will have to reboot, connect to the internet and rerun root patching for the rest of the patches.
|
||||
|
||||
:::
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -26,17 +26,19 @@ Ventura's release dropped a large amount of Intel hardware, thus requiring the u
|
||||
|
||||
## Current status
|
||||
|
||||
OpenCore Legacy Patcher supports Ventura for the models below, however some challenges remain. You can find information about them further down on this page.
|
||||
|
||||
<img width="625" alt="" src="./images/OCLP-060-Initial-Support.png">
|
||||
|
||||
For older hardware, see below sections:
|
||||
|
||||
* [Currently Unsupported/Broken Hardware in Ventura](#currently-unsupportedbroken-hardware-in-ventura)
|
||||
* [Current issues](#current-issues)
|
||||
* [AMD Polaris, Vega and Navi support on pre-2019 Mac Pros and pre-2012 iMacs](#amd-polaris-vega-and-navi-support-on-pre-2019-mac-pros-and-pre-2012-imacs)
|
||||
* [USB 1.1 (OHCI/UHCI) Support](#usb-11-ohciuhci-support)
|
||||
|
||||
The team is doing their best to investigate and fix the aforementioned issues, however no estimated time can be provided.
|
||||
|
||||
## Currently Unsupported/Broken Hardware in Ventura
|
||||
## Current issues
|
||||
|
||||
### AMD Polaris, Vega and Navi support on pre-2019 Mac Pros and pre-2012 iMacs
|
||||
|
||||
@@ -65,13 +67,17 @@ For Penryn systems and pre-2013 Mac Pros, USB 1.1 support was outright removed i
|
||||
|
||||
Refer to [the troubleshooting page](https://dortania.github.io/OpenCore-Legacy-Patcher/TROUBLESHOOT-HARDWARE.html#keyboard-mouse-and-trackpad-not-working-in-installer-or-after-update) on how to workaround this issue.
|
||||
|
||||
### Graphics and wireless support
|
||||
### Graphics support and issues
|
||||
|
||||
Refer to the following links for more information about Legacy Metal and non-Metal support and their respective issues.
|
||||
|
||||
* [Legacy Metal](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1008)
|
||||
* [Non-Metal](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108)
|
||||
|
||||
### Resolved issues
|
||||
|
||||
::: details Legacy Wireless Support (Resolved in v0.6.0 and newer)
|
||||
|
||||
|
||||
### Legacy Wireless Support
|
||||
|
||||
For systems that required Root Patches in macOS Monterey to achieve Wireless support, unfortunately macOS Ventura has broken the patch set. Currently the following Wifi cards are unsupported:
|
||||
|
||||
* Atheros: All models
|
||||
@@ -95,9 +101,6 @@ Currently BCM943224, BCM94331, BCM94360 and BCM943602 are still fully supported
|
||||
|
||||
::: details Non-Metal Graphics Acceleration (Resolved in v0.6.0 and newer)
|
||||
|
||||
|
||||
### Non-Metal Graphics Acceleration
|
||||
|
||||
Regarding non-Metal, the team is hard at work to get non-Metal working, however this is our greatest challenge since Big Sur.
|
||||
|
||||
Apple has made significant changes to the graphics stack in order to facilitate fancy effects, and in particularly, Stage Manager. We will update you as we work on development, however, now is not the best time to ask about ETAs.
|
||||
@@ -123,5 +126,3 @@ The following machines shipped stock with an unsupported GPU:
|
||||
* MacPro3,1 - MacPro5,1
|
||||
* Xserve2,1 - Xserve3,1
|
||||
|
||||
|
||||
:::
|
||||
|
||||
BIN
docs/images/OCLP-100-Initial-Support.png
Normal file
BIN
docs/images/OCLP-100-Initial-Support.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.7 MiB |
BIN
docs/images/OCLP-200-Initial-Support.png
Normal file
BIN
docs/images/OCLP-200-Initial-Support.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.0 MiB |
BIN
docs/images/OCLP_Booted_Version.png
Normal file
BIN
docs/images/OCLP_Booted_Version.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 628 KiB |
BIN
docs/images/OCLP_Root_Patch_Version.png
Normal file
BIN
docs/images/OCLP_Root_Patch_Version.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 431 KiB |
@@ -354,6 +354,10 @@ class Constants:
|
||||
def link_rate_driver_path(self):
|
||||
return self.payload_path / Path("Drivers/FixPCIeLinkRate.efi")
|
||||
|
||||
@property
|
||||
def apfs_driver_path(self):
|
||||
return self.payload_path / Path("Drivers/apfs_aligned.efi")
|
||||
|
||||
@property
|
||||
def installer_sh_path(self):
|
||||
return self.payload_path / Path("Installer.sh")
|
||||
|
||||
@@ -355,6 +355,7 @@ xw
|
||||
|
||||
logging.info("- Adding OpenCanopy GUI")
|
||||
shutil.copy(self.constants.gui_path, self.constants.oc_folder)
|
||||
shutil.copy(self.constants.apfs_driver_path, self.constants.drivers_path)
|
||||
support.BuildSupport(self.model, self.constants, self.config).get_efi_binary_by_path("OpenCanopy.efi", "UEFI", "Drivers")["Enabled"] = True
|
||||
support.BuildSupport(self.model, self.constants, self.config).get_efi_binary_by_path("OpenRuntime.efi", "UEFI", "Drivers")["Enabled"] = True
|
||||
support.BuildSupport(self.model, self.constants, self.config).get_efi_binary_by_path("OpenLinuxBoot.efi", "UEFI", "Drivers")["Enabled"] = True
|
||||
|
||||
@@ -2842,7 +2842,7 @@
|
||||
<key>APFS</key>
|
||||
<dict>
|
||||
<key>EnableJumpstart</key>
|
||||
<true/>
|
||||
<false/>
|
||||
<key>GlobalConnect</key>
|
||||
<false/>
|
||||
<key>HideVerbose</key>
|
||||
@@ -3056,6 +3056,18 @@
|
||||
<key>LoadEarly</key>
|
||||
<false/>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>Comment</key>
|
||||
<string></string>
|
||||
<key>Path</key>
|
||||
<string>apfs_aligned.efi</string>
|
||||
<key>Enabled</key>
|
||||
<true/>
|
||||
<key>Arguments</key>
|
||||
<string></string>
|
||||
<key>LoadEarly</key>
|
||||
<false/>
|
||||
</dict>
|
||||
</array>
|
||||
<key>Input</key>
|
||||
<dict>
|
||||
|
||||
BIN
payloads/Drivers/apfs_aligned.efi
Normal file
BIN
payloads/Drivers/apfs_aligned.efi
Normal file
Binary file not shown.
Reference in New Issue
Block a user