Releases: dortania/OpenCore-Legacy-Patcher
0.6.6
With WWDC2023 2 weeks away, we're eagerly awaiting for macOS 14 to be announced! Do keep in mind that supporting new versions of macOS is an intensive process, so we cannot predict when (or potentially if) support will be added to OpenCore Legacy Patcher. Regardless, we're excited to try and see our old Macs run the latest OS!
Otherwise, this release of OpenCore Legacy Patcher contains a ton of new features:
- New UI layout
- In-App update installation
- Easier for users to update from 0.6.6 to newer Patcher releases
- Quicker root patching on older hardware
- Reduced extraction times for PatcherSupportPkg
- Resolves low power mode support for 2013 Mac Pro
- Resolve AMD TeraScale 1 Graphics Corruption in macOS Ventura
And many more improvements and fixes listed in the changelog below.
As to be expected, many of these features are still in active development. This is a community-driven project, and as such we ask users to keep expectations in check and use older OSes if you encounter issues that affect you.
Full Changelog
0.6.6 Changelog (click to expand)
- Implement option to disable ColorSync downgrade on HD 3000 Macs
- Allows for Display Profiles support on some units
- Note: black box rendering issues will likely appear
- Thanks @jazzzny
- Allows for Display Profiles support on some units
- Rename payloads.dmg volume name to "OpenCore Patcher Resources (Base)"
- Allows for better identification when mounted (ex. Disk Utility while app is running)
- Implement DMG-based PatcherSupportPkg system
- Reduces both app size and root patching time
- Resolve incorrect remote KDK matching for macOS betas
- ex. Beta 4 KDK being recommended for Beta 3 install
- Resolve low power mode on MacPro6,1
- Credit to CaseyJ's PCI Bus Enumeration Patch
- Resolve PCI eject menu appearing on unsupported hardware
- Resolve kernel panic on wake for AMD TeraScale 1 and Nvidia Tesla 8000 series GPUs
- Resolve loss of Ethernet after wake on MacPro3,1 in Ventura
- Resolve graphics corruption on wake for TeraScale 1
- Patch currently limited to Ventura and newer
- Restore Function Keys on MacBook5,2 and MacBook4,1
- Implementation by @jazzzny
- Update non-Metal Binaries:
- Resolves cryptexd and sshd crashes
- Resolves screen recording regression
- Resolves Photo Booth on macOS Monterey and later
- May require tccplus for permissions
- Resolve Application alias not being created with AutoPatcher
- Backend changes:
- Rename OCLP-Helper to OpenCore-Patcher
- Allows for better identification when displaying prompts
- Reimplement wxPython GUI into modularized system:
- Allows for easier maintenance and future expansion
- Changes include:
- Reworked settings UI
- Unified download UI with time remaining
- Implement in-app update system
- Guides users to update OpenCore and Root Patches once update's installed
- Expand app update checks to include nightly users
- ex. 0.6.6 nightly -> 0.6.6 release
- Implement macOS installer verification after flashing
- Implement proper UI call backs on long processes
- ex. Root patching
- Implement default selections for disks and installers
- Set about and quit items
- Utilize
py-applescript
for authorization prompts- Avoids displaying prompts with
osascript
in the title - Due to limitations, only used for installer creation and OpenCore installation
- Avoids displaying prompts with
- Resolve exception handler not logging to file
- Display raised exceptions from main thread to users
- Rename OCLP-Helper to OpenCore-Patcher
- Increment Binaries:
- PatcherSupportPkg 1.1.0 - release
- OpenCorePkg 0.9.2 - release
- Lilu 1.6.6 - rolling (d8f3782)
- RestrictEvents 1.1.1 - release
- FeatureUnlock 1.1.4 - release
- BlueToolFixup 2.6.6 - release
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.6.5
This release of OpenCore Legacy Patcher 0.6.5 is primarily targeted against Rapid Security Responses introduced with macOS 13.3.1 (a). This should resolve the WindowServer crashing some users experienced, primarily on Haswell iGPU-only Macs.
- Do note that RSRs are currently only supported on Haswell and newer Macs, they'll error out on older units. See associated issue for more info: Rapid Security Response with legacy Macs #1019
Otherwise this build of OpenCore Legacy Patcher includes additional noteworthy improvements:
- Additional graphics patches for 3802 GPUs on 13.3+
- ie. Intel Ivy Bridge and Haswell, and Nvidia Kepler
- Add support for USB1.1 and USB3.0 controller co-existence
- ie. 2008-2012 Mac Pros with USB3.0 add-in card
- Resolves canvas rendering in Safari on non-Metal GPUs
And many more bug fixes listed in the changelog below.
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you.
Full Changelog
0.6.5 Changelog (click to expand)
- Update 3802 Patchset Binaries:
- Resolves additional 3rd party app crashes on Metal with macOS 13.3+
- ex: PowerPoint's "Presentation Mode"
- Update non-Metal Binaries:
- Resolves Safari 16.4 frozen canvas rendering
- ex: Google Docs
- Allow for coexistence of USB 3.0 controllers and USB 1.1 patches on macOS 13+
- Restores USB 3.0 expansion card support on USB 1.1 machines such as MacPro5,1
- Resolve OpenCL rendering on Nvidia Web Drivers
- thanks @jazzzny
- Resolve UI unable to download macOS installers on unknown models
- ex. M2 Macs and Hackintoshes
- Implement minimum OS check for installer creation
- Prevents vague errors when creating Ventura installers on Yosemite
- Resolve WindowServer crashing with Rapid Security Response (RSR) installation
- Primarily applicable for Haswell iGPUs on 13.3.1 (a)
- Update legacy Wireless binaries
- Resolve wifi crashing on 13.4 with BCM94322, BCM943224 and Atheros chipsets
- Backend changes:
- macos_installer_handler.py:
- Expand OS support for IA parsing in SUCatalog
- gui_main.py:
- Fix spacing regression introduced with
.AppleSystemUIFont
implementation
- Fix spacing regression introduced with
- macos_installer_handler.py:
- Increment Binaries:
- PatcherSupportPkg 0.9.7 - release
- Build Server Changes:
- Upgrade CI Host to macOS Monterey
- Upgrade Xcode to 14.2
- Switch from
altool
tonotarytool
for notarization
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.6.4
WARNING: Do not install macOS 13.3.1 (a) Rapid Security Response Update, currently unsupported on Macs running OpenCore Legacy Patcher. If you installed the update by accident, you can recover by booting into Safe Mode, and repatch macOS
This release of OpenCore Legacy Patcher 0.6.4 is primarily a hot fix release for 2012 Macs with Ivy Bridge CPUs that experienced Safari Rendering Issues.
Additionally this build does implement a new backend for crash and analytics reporting to help with bug reports and better understanding the project. More info can be found with the associated Pull Request:
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you.
Full Changelog
0.6.4 Changelog (click to expand)
- Backend changes:
- Implement new analytics_handler.py module
- Adds support for anonymous analytics including host info (and crash reports in the future)
- Can be disabled via GUI or
defaults write com.dortania.opencore-legacy-patcher DisableCrashAndAnalyticsReporting -bool true
- Implement new analytics_handler.py module
- Resolve Safari rendering error on Ivy Bridge in macOS 13.3+
- Increment Binaries:
- RestrictEvents 1.1.1 - rolling (495f4d5)
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.6.3
With the release of OpenCore Legacy Patcher 0.6.3, some quite useful bugs fixes are dropping related to macOS 13.3 and newer:
- Resolves 3rd party apps erroring due to broken Metal API on 3802 GPUs
- ie. Intel Ivy Bridge and Haswell, and Nvidia Kepler
- Resolve Safari 16.4 rendering issues on non-Metal GPUs
- Resolve CoreGraphics.framework crashes on Ivy Bridge CPUs
And many more bug fixes listed in the changelog below.
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you.
Full Changelog
0.6.3 Changelog (click to expand)
- Update non-Metal Binaries:
- Resolves Safari 16.4 rendering issue
- Resolves left side menubar selections
- Implements automatic menubar text color
- New experimental Menubar implementation can be enabled via
defaults write -g Amy.MenuBar2Beta -bool true
- Note: If you experience issues with the new implementation, you can revert back to the old implementation by running
defaults delete -g Amy.MenuBar2Beta
- Note: If you experience issues with the new implementation, you can revert back to the old implementation by running
- Implement full IOUSBHostFamily downgrade for UHCI/OHCI
- Resolves panics on certain iMac models
- Resolve unused KDKs not being properly cleaned up
- Implement MXM graphics handling for iMac9,1
- Credit to @Ausdauersportler for implementation
- Resolve CoreGraphics.framework crashing on Ivy Bridge CPUs in macOS 13.3+
- Disables f16c sysctl reporting
- Resolve accidental CPU renaming with RestrictEvents
- Resolve backlight and internal display support for AMD Navi MXM GPUs
- Credit to @Ausdauersportler for bug fix
- Resolve 3rd Party Apps erroring on Metal with macOS 13.3
- Applicable Software: Applications directly using Metal (ex. Blender, Parallels Desktop)
- Applicable Hardware: 3802-based GPUs (ie. Intel Ivy Bridge and Haswell iGPUs, Nvidia Kepler dGPUs)
- Backend changes:
- Use
.AppleSystemUIFont
for wxPython text rendering (thanks @jazzzny) - Add extra error handling for network errors:
- Handles
RemoteDisconnected('Remote end closed connection without response')
exceptions
- Handles
- Move root volume patch set generation to dedicated sys_patch_generate.py module
- Refactored integrity_verification.py:
- Implemented Object-Oriented design
- Reduced disk I/O and main thread monopolization
- Use
- Increment Binaries:
- PatcherSupportPkg 0.9.3 - release
- OpenCorePkg 0.9.1 - release
- AirPortBrcmFixup 2.1.7 - release
- RestrictEvents 1.1.0 - release
- BrcmPatchRAM 2.6.5 - release
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.6.2
With the release of OpenCore Legacy Patcher 0.6.2, more long awaited features are finally dropping! These include:
- Support for macOS 13.3 on 3802-based Metal GPUs
- ie. Intel Ivy Bridge and Haswell, and Nvidia Kepler
- Support for DRM on AMD GCN GPUs
- ie. GCN 1 - 3, Polaris and Vega
- Continuity Camera unlocking for all models
- Resolve Intel HD3000 black box rendering issues
And many more bug fixes listed in the changelog below.
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you. See individual sections for more information.
Support for macOS 13.3 on 3802-based Metal GPUs
With macOS 13.3, Apple broke support for the legacy 3802-based Metal GPUs. With OpenCore Legacy patcher v0.6.2, we've been able to restore support for the following models:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook Air | Mid 2012 - Mid 2017 | MacBookAir5,x - MacBookAir7,x | |
MacBook Pro | Mid 2012 - Mid 2015 | MacBookPro9,x - MacBookPro11,x | |
iMac | Late 2012 - Mid 2015 | iMac13,x - iMac15,1 | |
Mac mini | Late 2012 - Late 2014 | Macmini6,x - Macmini7,1 | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 | If Nvidia Kepler GPU installed |
Xserve | Early 2008 - Early 2009 | Xserve2,1 - Xserve3,1 | If Nvidia Kepler GPU installed |
Note: To restore support for these models, AMFI has to be disabled. If your workflow requires AMFI enabled, we recommend staying on macOS 13.2.1 or older
Support for DRM on AMD GCN GPUs
With this release, we've finally been able to restore DRM support for AMD GCN GPUs in macOS Ventura! Applicable models include:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook Pro | Mid 2015 - Late 2016 | MacBookPro11,5, MacBookPro13,3 | 15" dGPU models only |
iMac | Late 2014 - Late 2015 | iMac15,1, iMac17,1 | 27" models only |
iMac (modded) | Late 2009 - Late 2011 | iMac11,x - iMac12,x | If Metal-based AMD MXM GPU installed |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 | If Metal-based AMD GPU installed |
Xserve | Early 2008 - Early 2009 | Xserve2,1 - Xserve3,1 | If Metal-based AMD GPU installed |
Full Changelog
0.6.2 Changelog (click to expand)
- Work around Black Box rendering issues on certain Display Color Profiles
- Limited to Ventura currently due to limitations with other color profiles
- Applicable for HD3000-based machines (ex. MacBookAir4,x, MacBookPro8,x, Macmini5,x)
- Ensure
Moraea_BlurBeta
is set on non-Metal systems - Implement proper Root Unpatching verification in GUI
- Removes arbitrary patch requirements used against unpatching (ex. network connection)
- Implement Kernel Debug Kit installation during OS installs
- Avoids network requirement for first time installs
- Paired along side AutoPkgInstaller
- Implement Kernel Debug Kit backup system
- Allows for easy restoration of KDKs if OS updates corrupted installed KDKs
- Update Wireless binaries
- Fixed WiFi preferences crash with legacy wifi patches
- Update non-Metal Binaries
- Improved menubar blur saturation
- Fixed System Settings hover effects, including Bluetooth connect button
- Add Books hacks (reimplement cover image generation, disable broken page curl animation)
- Fixed unresponsive buttons
- Implement Hardware Encoding support for AMD GCN 1-3, Polaris and Vega GPUs
- Applicable for pre-Haswell Macs on macOS Ventura
- Resolves DRM playback issues on Netflix, Disney+, etc.
- Note: GCN 1-3 DRM is functional, however hardware video encoding is still experimental
- AppleTV+ may be unstable due to this
- Note: GCN 1-3 DRM is functional, however hardware video encoding is still experimental
- Implement support for AMD Navi and Lexa MXM GPUs in 2009-2011 iMacs
- Primarily applicable for MXM 3.0 variants of AMD WX3200 (0x6981) and AMD RX5500XT (0x7340)
- Credit to Ausdauersportler for implementation
- Implement Continuity Camera Unlocking for pre-Kaby Lake CPUs
- Applicable for all legacy Macs in macOS Ventura
- Resolve boot support for 3802-based GPUs with macOS 13.3
- Applicable for following GPUs:
- Intel Ivy Bridge and Haswell iGPUs
- Nvidia Kepler dGPUs
- Note: patchset now requires AMFI to be disabled, patchset still in active development to remove this requirement
- Applicable for following GPUs:
- Backend Changes:
- Refactored kdk_handler.py
- Prioritizes KdkSupportPkg repository for downloads
- Skips calls to Apple's now defunct Developer Portal API
- Support local loose matching when no network connection is available
- Implement pkg receipt verification to validate integrity of KDKs
- Prioritizes KdkSupportPkg repository for downloads
- Implemented logging framework usage for more reliable logging
- Logs are stored under
~/Library/Logs/OpenCore-Patcher.log
- Subsequent runs are appended to the log, allowing for easy debugging
- Logs are stored under
- Implemented new network_handler.py module
- Allows for more reliable network calls and downloads
- Better supports network timeouts and disconnects
- Dramatically less noise in console during downloads
- Implemented new macOS Installer handler
- Removed unused modules:
- sys_patch_downloader.py
- run.py
- TUI modules
- Refactored kdk_handler.py
- Build Server Changes:
- Upgrade Python backend to 3.10.9
- Upgrade Python modules:
- requests - 2.28.2
- pyobjc - 9.0.1
- wxpython - 4.2.0
- pyinstaller - 5.7.0
- packaging - 23.0
- Increment Binaries:
- PatcherSupportPkg 0.8.7 - release
- AutoPkgInstaller 1.0.2 - release
- FeatureUnlock 1.1.4 - rolling (0e8d87f)
- Lilu 1.6.4 - release
- WhateverGreen 1.6.4 - release
- NVMeFix 1.1.0 - release
- Innie 1.3.1 - release
- OpenCorePkg 0.9.0 - release
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.6.1
With the release of OpenCore Legacy Patcher 0.6.1, many long awaited features are finally landing! These include support for a number of hardware and services in macOS Ventura:
- Non-Metal Graphics Acceleration
- Legacy Wireless Networking
- UHCI/OHCI USB 1.1 Controllers
- AMD Vega Graphics on pre-Haswell Macs
- Rapid Security Responses for Haswell+ Macs using Kernel Debug Kits
This release also expands the range of hardware users can run on Ventura!
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you. See individual sections for more information.
Add support for non-Metal Graphics Cards in macOS Ventura
For systems that shipped with non-Metal Graphics Cards, including the following GPUs:
Vendor | Architecture | Generation |
---|---|---|
AMD | TeraScale 1 and 2 | 2000 - 6000 series |
Nvidia | Tesla | 8000 - 200 series |
Nvidia | Maxwell and Pascal | 900 - 1000 series |
Intel | Iron Lake | HD series |
Intel | Sandy Bridge | HD 3000 series |
- Notes:
- Stage Manager is unsupported
- AMFI needs to be disabled
- Bluetooth Pairing is currently semi-functional, see here for work around: Tab+Space work-around
For overall non-Metal support, see associated issue:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Mid 2010 | MacBook5,1 - MacBook7,1 | |
MacBook Air | Mid 2008 - Mid 2011 | MacBookAir2,1 - MacBookAir4,x | |
MacBook Pro | Late 2008 - Late 2011 | MacBookPro4,1 - MacBookPro8,x | |
iMac | Mid 2007 - Mid 2011 | iMac7,1 - iMac12,x | Excludes Metal GPU upgrades |
Mac mini | Early 2009 - Mid 2011 | Macmini3,1 - Macmini5,x | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 | Excludes Metal GPU upgrades |
Add support for legacy Wireless Cards in macOS Ventura
For systems that shipped with Broadcom BCM94328 and BCM94322, as well as Atheros Wireless cards. Applicable models include:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Early 2009 | MacBook5,1 - MacBook5,x | |
MacBook Air | Mid 2008 - Late 2010 | MacBookAir2,1 - MacBookAir3,x | |
MacBook Pro | Late 2008 - Mid 2010 | MacBookPro4,1 - MacBookPro7,1 | Excludes Mid 2010 15" and 17" (MacBookPro6,x) |
iMac | Mid 2007 - Mid 2011 | iMac7,1 - iMac12,x | |
Mac mini | Early 2009 - Late 2009 | Macmini3,1 | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 |
Add support for UHCI/OHCI USB 1.1 Controllers in macOS Ventura
For systems with internal low speed USB controllers (UHCI/OHCI), this adds support for low speed USB devices including Keyboards, Mice, Trackpads and Bluetooth controllers.
- Note: This implementation is not entirely complete, namely that macOS installer and post-OS updates will not function with USB 1.1. See associated issue for more info: Legacy UHCI/OHCI support in Ventura #1021
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Mid 2010 | MacBook5,1 - MacBook7,1 | |
MacBook Air | Mid 2008 - Late 2010 | MacBookAir2,1 - MacBookAir3,x | |
MacBook Pro | Late 2008 - Mid 2010 | MacBookPro4,1 - MacBookPro7,x | Excludes Mid 2010 15" and 17" (MacBookPro6,x) |
iMac | Mid 2007 - Late 2009 | iMac7,1 - iMac10,x | Excludes Core i5/7 27" late 2009 iMac (iMac11,1) |
Mac mini | Early 2009 - Mid 2010 | Macmini3,1 - Macmini4,x | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 |
Add support for AMD Vega Graphics on pre-Haswell Macs in macOS Ventura
For Mac Pro and iMac users who manually upgraded their Graphics Card to an AMD Vega unit. Applicable models include:
AMD Radeon Vega 56
AMD Radeon Vega 64
AMD Radeon VII
For overall support, see associated issue:
And a huge thanks to @SpiGAndromeda for their donation of an AMD Radeon Vega 64. Without their generosity, we wouldn't be able to get these GPUs working!
Add support for Rapid Security Responses for Haswell+ Macs using Kernel Debug Kits
With this release, we've added support for Apple's newly introduced Rapid Security Response system for more machines, namely those reliant on Kernel Debug Kits with Haswell and newer CPUs. Applicable models include:
| iMac15,1 | Late 2014 - Mid 2015 27" 5k iMac |
| iMac17,1 | Late 2015 27" 5k iMac |
| MacBookPro11,5 | Mid 2015 15" MacBook Pro (AMD dGPU) |
| MacBookPro13,3 | Late 2016 15" MacBook Pro |
This update means all Macs with Haswell or newer CPUs can easily install RSRs without issue when Apple deploys them. For pre-Haswell Macs, RSRs currently will not install. Users can ignore for the time being until OCLP can add support.
- See here for more info: Rapid Security Response with legacy Macs #1019
Full Changelog
0.6.1 and 0.6.0 Changelog (click to expand)
0.6.1
- Avoid usage of KDKlessWorkaround on hardware not requiring it
- Resolves AMD Graphics Regression from 0.5.3
- Increment Binaries:
- KDKlessWorkaround 1.0.0 - rolling (8e41f39)
0.6.0
- Resolve external NVMe reporting regression from 0.5.2
- Implement Legacy Wireless support for Ventura
- Applicable for BCM94328, BCM94322 and Atheros chipsets
- Implement Wifi-only patches when no internet connection available but required (ie. KDKs)
- Allows users to install Legacy Wireless patches, then connect to the internet to install remaining patches
- Resolve
/Library/Extensions
not being cleaned on KDK-less root patches - Add AMD Vega Graphics support for pre-AVX2.0 systems on Ventura
- ex. AMD Vega 56 and 64, AMD Radeon VII
- Note: As with Polaris, Vega GPUs cannot be mixed with AMD GCN 1-3 patches
- Patcher will prioritize the AMD GCN 1-3 (assumption that GCN is primary GPU, ex. MacPro6,1)
- Implement proper
APPLE SSD TS0128F/256F
detection- Allows all Macs to utilize patch if required
- Avoids usage of patch when host lacks affected drive (ex. MacBookAir6,x with upgraded SSD)
- Prompt with auto patcher when booted OpenCore is out of date to root patcher
- ex. Booted OCLP is 0.5.2, root patcher is 0.5.3
- Disable native AMD Graphics on pre-Haswell Macs in Ventura
- Allows for easy root patching, dropping reliance on Safe Mode to boot
- Primarily applicable for iMacs and Mac Pros with AMD Polaris and Vega GPUs
- Implement mini validation during GUI build
- Add early UHCI/OHCI support (USB1.1)
- Implemented via Root Volume patching, ie. no installer support at this time
- Support should be seen as experimental, especially for laptops
- Applicable for Penryn Macs and Cheese Grater Mac Pros (MacPro3,1 - MacPro5,1)
- See associated issue for current limitations: Legacy UHCI/OHCI support in Ventura
- USB 3.0 controllers cannot be used along side USB 1.1 patches, OCLP will prioritize USB 3.0 support
- Implemented via Root Volume patching, ie. no installer support at this time
- Add early non-Metal Graphics Acceleration support for macOS Ventura
- Applicable for following GPU architectures:
- Intel Ironlake and Sandy Bridge
- Nvidia Tesla, Maxwell and Pascal
- AMD TeraScale 1 and 2
- Notes:
- Bluetooth Pairing is currently semi-fun...
- Applicable for following GPU architectures:
0.6.0
With the release of OpenCore Legacy Patcher 0.6.0, many long awaited features are finally landing! These include support for a number of hardware and services in macOS Ventura:
- Non-Metal Graphics Acceleration
- Legacy Wireless Networking
- UHCI/OHCI USB 1.1 Controllers
- AMD Vega Graphics on pre-Haswell Macs
- Rapid Security Responses for Haswell+ Macs using Kernel Debug Kits
This release also expands the range of hardware users can run on Ventura!
As to be expected, many of these features are still in active development. This is a community driven project, and as such we ask users to keep expectations in check and use Monterey if you encounter issues that affect you. See individual sections for more information.
Add support for non-Metal Graphics Cards in macOS Ventura
For systems that shipped with non-Metal Graphics Cards, including the following GPUs:
Vendor | Architecture | Generation |
---|---|---|
AMD | TeraScale 1 and 2 | 2000 - 6000 series |
Nvidia | Tesla | 8000 - 200 series |
Nvidia | Maxwell and Pascal | 900 - 1000 series |
Intel | Iron Lake | HD series |
Intel | Sandy Bridge | HD 3000 series |
- Notes:
- Stage Manager is unsupported
- AMFI needs to be disabled
- Bluetooth Pairing is currently semi-functional, see here for work around: Tab+Space work-around
For overall non-Metal support, see associated issue:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Mid 2010 | MacBook5,1 - MacBook7,1 | |
MacBook Air | Mid 2008 - Mid 2011 | MacBookAir2,1 - MacBookAir4,x | |
MacBook Pro | Late 2008 - Late 2011 | MacBookPro4,1 - MacBookPro8,x | |
iMac | Mid 2007 - Mid 2011 | iMac7,1 - iMac12,x | Excludes Metal GPU upgrades |
Mac mini | Early 2009 - Mid 2011 | Macmini3,1 - Macmini5,x | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 | Excludes Metal GPU upgrades |
Add support for legacy Wireless Cards in macOS Ventura
For systems that shipped with Broadcom BCM94328 and BCM94322, as well as Atheros Wireless cards. Applicable models include:
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Early 2009 | MacBook5,1 - MacBook5,x | |
MacBook Air | Mid 2008 - Late 2010 | MacBookAir2,1 - MacBookAir3,x | |
MacBook Pro | Late 2008 - Mid 2010 | MacBookPro4,1 - MacBookPro7,1 | Excludes Mid 2010 15" and 17" (MacBookPro6,x) |
iMac | Mid 2007 - Mid 2011 | iMac7,1 - iMac12,x | |
Mac mini | Early 2009 - Late 2009 | Macmini3,1 | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 |
Add support for UHCI/OHCI USB 1.1 Controllers in macOS Ventura
For systems with internal low speed USB controllers (UHCI/OHCI), this adds support for low speed USB devices including Keyboards, Mice, Trackpads and Bluetooth controllers.
- Note: This implementation is not entirely complete, namely that macOS installer and post-OS updates will not function with USB 1.1. See associated issue for more info: Legacy UHCI/OHCI support in Ventura #1021
Applicable Models (click to expand)
Family | Year | Model | Notes |
---|---|---|---|
MacBook | Early 2008 - Mid 2010 | MacBook5,1 - MacBook7,1 | |
MacBook Air | Mid 2008 - Late 2010 | MacBookAir2,1 - MacBookAir3,x | |
MacBook Pro | Late 2008 - Mid 2010 | MacBookPro4,1 - MacBookPro7,x | Excludes Mid 2010 15" and 17" (MacBookPro6,x) |
iMac | Mid 2007 - Late 2009 | iMac7,1 - iMac10,x | Excludes Core i5/7 27" late 2009 iMac (iMac11,1) |
Mac mini | Early 2009 - Mid 2010 | Macmini3,1 - Macmini4,x | |
Mac Pro | Early 2008 - Mid 2012 | MacPro3,1 - MacPro5,1 |
Add support for AMD Vega Graphics on pre-Haswell Macs in macOS Ventura
For Mac Pro and iMac users who manually upgraded their Graphics Card to an AMD Vega unit. Applicable models include:
AMD Radeon Vega 56
AMD Radeon Vega 64
AMD Radeon VII
For overall support, see associated issue:
And a huge thanks to @SpiGAndromeda for their donation of an AMD Radeon Vega 64. Without their generosity, we wouldn't be able to get these GPUs working!
Add support for Rapid Security Responses for Haswell+ Macs using Kernel Debug Kits
With this release, we've added support for Apple's newly introduced Rapid Security Response system for more machines, namely those reliant on Kernel Debug Kits with Haswell and newer CPUs. Applicable models include:
| iMac15,1 | Late 2014 - Mid 2015 27" 5k iMac |
| iMac17,1 | Late 2015 27" 5k iMac |
| MacBookPro11,5 | Mid 2015 15" MacBook Pro (AMD dGPU) |
| MacBookPro13,3 | Late 2016 15" MacBook Pro |
This update means all Macs with Haswell or newer CPUs can easily install RSRs without issue when Apple deploys them. For pre-Haswell Macs, RSRs currently will not install. Users can ignore for the time being until OCLP can add support.
- See here for more info: Rapid Security Response with legacy Macs #1019
Full Changelog
0.6.0 Changelog (click to expand)
- Resolve external NVMe reporting regression from 0.5.2
- Implement Legacy Wireless support for Ventura
- Applicable for BCM94328, BCM94322 and Atheros chipsets
- Implement Wifi-only patches when no internet connection available but required (ie. KDKs)
- Allows users to install Legacy Wireless patches, then connect to the internet to install remaining patches
- Resolve
/Library/Extensions
not being cleaned on KDK-less root patches - Add AMD Vega Graphics support for pre-AVX2.0 systems on Ventura
- ex. AMD Vega 56 and 64, AMD Radeon VII
- Note: As with Polaris, Vega GPUs cannot be mixed with AMD GCN 1-3 patches
- Patcher will prioritize the AMD GCN 1-3 (assumption that GCN is primary GPU, ex. MacPro6,1)
- Implement proper
APPLE SSD TS0128F/256F
detection- Allows all Macs to utilize patch if required
- Avoids usage of patch when host lacks affected drive (ex. MacBookAir6,x with upgraded SSD)
- Prompt with auto patcher when booted OpenCore is out of date to root patcher
- ex. Booted OCLP is 0.5.2, root patcher is 0.5.3
- Disable native AMD Graphics on pre-Haswell Macs in Ventura
- Allows for easy root patching, dropping reliance on Safe Mode to boot
- Primarily applicable for iMacs and Mac Pros with AMD Polaris and Vega GPUs
- Implement mini validation during GUI build
- Add early UHCI/OHCI support (USB1.1)
- Implemented via Root Volume patching, ie. no installer support at this time
- Support should be seen as experimental, especially for laptops
- Applicable for Penryn Macs and Cheese Grater Mac Pros (MacPro3,1 - MacPro5,1)
- See associated issue for current limitations: Legacy UHCI/OHCI support in Ventura
- USB 3.0 controllers cannot be used along side USB 1.1 patches, OCLP will prioritize USB 3.0 support
- Implemented via Root Volume patching, ie. no installer support at this time
- Add early non-Metal Graphics Acceleration support for macOS Ventura
- Applicable for following GPU architectures:
- Intel Ironlake and Sandy Bridge
- Nvidia Tesla, Maxwell and Pascal
- AMD TeraScale 1 and 2
- Notes:
- Bluetooth Pairing is currently semi-functional, see here for work around: Tab+Space work-around
- AMFI currently needs to be outright disabled in ...
- Applicable for following GPU architectures:
0.5.3
This release of OpenCore Legacy Patcher 0.5.3 is primarily a bug fix release. Main fixes implemented include:
- Resolves audio support regression on certain pre-2012 machines
- Resolves WindowServer crashing on KDK-less installs in 13.2 with Rapid Security Response updates
- Resolves AirPlay to Mac support in macOS Ventura on VMM configs
- Resolves AppleIntelCPUPowerManagement kernel panic in safe mode
And other miscellaneous fixes and improvements listed in the full changelog.
Other machines such as 2008-2012 Mac Pros and non-Metal Graphics Card machines are still in active development. We'd appreciate your patience as we work through these issues. Stay on macOS Monterey until the Patcher has been updated to support your model.
- Installing macOS Ventura on older models will likely result in lack of Graphics Acceleration, broken USB 1.1, Keyboard, TrackPad and Bluetooth and other issues. Zero support is offered for those systems at this time.
For machines with legacy Metal Graphics Cards, we'd recommend checking out macOS Ventura and OpenCore Legacy Patcher Support #1008 for overall support with these cards.
Reminder: For proper support, remain on macOS Monterey.
Full Changelog
0.5.3 Changelog (click to expand)
- Integrate FixPCIeLinkrate.efi v0.1.0
- Fixes link rate for PCIe 3.0 devices on MacPro3,1
- Resolve AppleIntelCPUPowerManagement Panic in Safe Mode
- Applicable for pre-Haswell Macs on Ventura
- Revert AppleALC 1.7.6 update back to 1.6.3
- Resolves audio issues on certain Intel HDEF devices
- Regression currently being investigated within AppleALC
- Remove
Force Web Drivers
option- Avoids accidental use of non-Metal Web Drivers on Kepler GPUs
- Resolve silent auto patcher crash when new OCLP version is available
- Implement
py_sip_xnu
module - Resolve Content Caching Patch Regression
- Resolve KDK Versioning Fallback crashing when primary KDK site is down
- Resolve AirPlay to Mac support on Ventura with VMM
- Resolve WindowServer crashing on KDK-less with macOS 13.2 and Rapid Security Response updates
- Resolve Host Versioning when RSR is installed
- Resolve iMac7,1-8,1 and MacBookPro4,1 boot support in Ventura
- Increment Binaries:
- OpenCorePkg 0.8.7 - release
- FeatureUnlock 1.1.2 - rolling (94e29ce)
- WhateverGreen 1.6.2 - release
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.5.2
This release of OpenCore Legacy Patcher 0.5.2 is primarily a bug fix release. Main fixes implemented include:
- Alleviates
mediaanalysisd
kernel panics on prolonged sleep - Alleviates AMD Polaris display output support
- Work-around Apple's Developer Portal block on OCLP
And other miscellaneous fixes and improvements listed in the full changelog.
Other machines such as 2008-2012 Mac Pros and non-Metal Graphics Card machines are still in active development. We'd appreciate your patience as we work through these issues. Stay on macOS Monterey until the Patcher has been updated to support your model.
- Installing macOS Ventura on older models will likely result in lack of Graphics Acceleration, broken USB 1.1, Keyboard, TrackPad and Bluetooth and other issues. Zero support is offered for those systems at this time.
For machines with legacy Metal Graphics Cards, we'd recommend checking out macOS Ventura and OpenCore Legacy Patcher Support #1008 for overall support with these cards.
Reminder: Ventura support in 0.5.2 is in Beta, stay on Monterey for proper support
Full Changelog
0.5.2 Changelog (click to expand)
- Ventura Specific Updates:
- Resolve AMD Polaris external display output support
- AMD Polaris and legacy GCN cannot be mixed in the same system
- Legacy GCN support will be prioritized when both are present
- AMD Polaris GPU can still be used headless for rendering with legacy GCN (ex. macOS: Prefer External GPU option)
- AMD Polaris and legacy GCN cannot be mixed in the same system
- Disables unsupported
mediaanalysisd
on Metal 1 GPUs- Alleviates kernel panic when on prolonged idle
- Automatically remove unsupported News Widgets on Ivy Bridge and Haswell iGPUs
- Alleviates Notification Centre Crashing
- Implement downloading from Kernel Debug Kit Backup Repository
- Alleviates issues with Apple blocking KDK downloads from OCLP (Ref: Issue #1016)
- Resolve AMD Polaris external display output support
- Work-around MacPro6,1 and Lilu race condition
- Ensure Model and Board ID are set correctly before Lilu loads
- Publish Application Version in UI header
- Allows for easier identification of version when reporting issues
- Drop usage of
HW_BID
rerouting in boot.efi- Patch out PlatformSupport.plist instead, allows for less maintenance overall
- Add support for AMD GOP injection (AMDGOP.efi)
- For MXM iMacs and Mac Pros with GPU VBIOS lacking GOP support (ie. no UEFI output even after OC loads)
- Hide OpenCore Boot Picker when waking from hibernation
- Increment Binaries:
- AirPortBrcmFixup 2.1.6 - release
- AppleALC 1.7.6 - release
- CryptexFixup 1.0.1 - release
- DebugEnhancer 1.0.7 - release
- FeatureUnlock 1.1.0 - release
- OpenCorePkg 0.8.7 - rolling (fcb4e33)
- RestrictEvents 1.0.9 - release
- WhateverGreen 1.6.1 - release
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
0.5.1
After many months of heavy anticipation, OpenCore Legacy Patcher 0.5.1 adds beta support for macOS Ventura 🎉
With this release, most users with a 2012 or newer Mac listed below should be able to install Apple's latest OS with ease!
This release is an extension to the initial 0.5.0 build, with additional improvements including support for the 2013 Trash Can Mac Pro and resolving SSD support on the Mid 2013-2014 MacBook Airs!
Other machines such as 2008-2012 Mac Pros and non-Metal Graphics Card machines are still in active development. We'd appreciate your patience as we work through these issues. Stay on macOS Monterey until the Patcher has been updated to support your model.
- Installing macOS Ventura on older models will likely result in lack of Graphics Acceleration, broken USB 1.1, Keyboard, TrackPad and Bluetooth and other issues. Zero support is offered for those systems at this time.
For machines with legacy Metal Graphics Cards, we'd recommend checking out macOS Ventura and OpenCore Legacy Patcher Support #1008 for overall support with these cards.
Reminder: Ventura support in 0.5.1 is in Beta, stay on Monterey for proper support
WARNING: If you have a Mac with an AMD GCN 1-3 GPU, note that Apple recently broke our Kernel Debug Kit downloader. To work-around, see instructions below:
Following models are affected:
iMac15,1 - Mid 2014 27" 5k iMac
iMac17,1 - Mid 2015 27" 5k iMac
MacPro6,1 - Late 2013 Mac Pro
MacBookPro11,5 - Mid 2015 15" MacBook Pro with Radeon Graphics
MacBookPro13,3 - Late 2016 15" MacBook Pro
Full Changelog
0.5.1 Changelog (click to expand)
- Add support for
APPLE SSD TS0128F/256F
SSDs in macOS Ventura- ie. stock SSD found in MacBookAir6,x
- Lax KDK N-1 logic to allow 1 minor version difference
- ex. Allow 13.0 KDK on 13.1
- Clean out
/Library/Extensions
on KDK-less root patches- Ensures old, incompatible kexts are not linked against
- Old kexts are relocated to
/Library/Relocated Extensions
- Add OpenCore Picker timeout selection
- Partially resolve MacPro6,1 support
- Allows for install and usage of 2013 Mac Pros on Ventura
- Currently CPU Power Management is not supported
Asset Information
- OpenCore-Patcher-GUI.app:
- Visual GUI based app
- Recommended for all users
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download