Releases: dortania/OpenCore-Legacy-Patcher
2.2.0
With the release of OpenCore Legacy Patcher 2.2.0, this version will primarily focus on macOS 15.2 support (dropping later today).
Primary changes include:
- Resolve JavaScriptCore crashes on macOS 15.2 and Safari 18,2 (including macOS Ventura and Sonoma)
- Applicable for Macs without AVX support (pre-Sandy Bridge)
- Resolve a number of non-Metal graphical issues in macOS Sonoma and Sequoia
See changelog for more information. Otherwise hope everyone enjoys the new release!
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.2.0 Changelog (click to expand)
- Resolved non-metal accessibility zoom on macOS Sonoma/Sequoia
- Resolved non-metal photos app on macOS Sequoia
- Resolved non-metal Screen Sharing on macOS Sequoia
- Resolved non-metal inverted screenshots on macOS Sequoia
- Improved non-metal beta menubar reliability
- Disabled non-metal broken weather background animations on macOS Sequoia
- Resolved non-metal safari hide distracting items crash on macOS Sequoia
- Resolved non-metal full screen transition on macOS Sonoma/Sequoia
- Resolved T1 Apple Pay on macOS Sequoia
- Resolved T1 TouchID support on macOS Sequoia 15.2
- Resolved iCloud sync problems
- Resolved JavaScriptCore on pre-AVX Macs on macOS Sequoia 15.2/Safari 18.2
- Increment binaries:
- PatcherSupportPkg 1.9.1 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.1.2
2.1.2 is a bug fix release for 2.1.0/2.1.1 regarding certain GUI settings saving incorrectly. See 2.1.0 release notes for general changes.
With the release of OpenCore Legacy Patcher 2.1.2, this version will primarily focus on stability and bug fixes. However, this release does support settings retention in the GUI, allowing users to save settings between runs and updates.
Changes include:
- Support saving settings from the GUI between app launches.
- Note this only applies for on-model settings, changing Mac models resets settings.
- Disabling FeatureUnlock and mediaanalysisd (Live Text) by default for stability.
- If either features are desired, can be re-enabled in settings.
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as a download option.
- Resolve WhatsApp crash on 15.1.
See changelog for more information. Otherwise hope everyone enjoys the new release!
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.1.2, 2.1.1 and 2.1.0 Changelog (click to expand)
2.1.2
- Add additional error handling for when building OpenCore errors out
- Prevents broken EFI from being installed to disk
- Add additional error handling for broken settings file from OCLP 2.1.0
- If typing for settings is wrong, app will skip setting it, delete from settings file and use default
- Delete
/Users/Shared/.com.dortania.opencore-legacy-patcher.plist
and restart app to avoid this issue
- Add additional warning about OCLP 2.1.0 bug where certain settings saved incorrectly
- Delete
/Users/Shared/.com.dortania.opencore-legacy-patcher.plist
and restart app ifTypeError: unsupported type: <class 'NoneType'>
error occurs
- Delete
2.1.1
- Resolve boolean GUI settings saving incorrectly as Python's None type
2.1.0
- Disable FeatureUnlock by default
- Intended to maintain long term stability
- If features unlocked by FeatureUnlock desired, can be enabled in settings
- Disable mediaanalysisd on Metal 3802-based GPUs
- Intended to maintain long term stability
- If Live Text support desired, can be enabled in settings
- Support for retaining GUI settings when building on-model
- When switching to a different model, model-specific GUI settings will be reset
- Note resetting saved settings not implemented yet
- Delete
/Users/Shared/.com.dortania.opencore-legacy-patcher.plist
and restart app to reset settings
- Delete
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as download option
- Resolve WhatsApp crashing on 15.1
- Increment binaries:
- PatcherSupportPkg 1.8.4 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.1.1
2.1.1 is a bug fix release for 2.1.0 regarding certain GUI settings saving incorrectly. See 2.1.0 release notes for general changes.
With the release of OpenCore Legacy Patcher 2.1.0/2.1.1, this version will primarily focus on stability and bug fixes. However, this release does support settings retention in the GUI, allowing users to save settings between runs and updates.
Changes include:
- Support saving settings from the GUI between app launches.
- Note this only applies for on-model settings, changing Mac models resets settings.
- Disabling FeatureUnlock and mediaanalysisd (Live Text) by default for stability.
- If either features are desired, can be re-enabled in settings.
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as a download option.
- Resolve WhatsApp crash on 15.1.
See changelog for more information. Otherwise hope everyone enjoys the new release!
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.1.1 and 2.1.0 Changelog (click to expand)
2.1.1
- Resolve boolean GUI settings saving incorrectly as Python's None type
2.1.0
- Disable FeatureUnlock by default
- Intended to maintain long term stability
- If features unlocked by FeatureUnlock desired, can be enabled in settings
- Disable mediaanalysisd on Metal 3802-based GPUs
- Intended to maintain long term stability
- If Live Text support desired, can be enabled in settings
- Support for retaining GUI settings when building on-model
- When switching to a different model, model-specific GUI settings will be reset
- Note resetting saved settings not implemented yet
- Delete
/Users/Shared/.com.dortania.opencore-legacy-patcher.plist
and restart app to reset settings
- Delete
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as download option
- Resolve WhatsApp crashing on 15.1
- Increment binaries:
- PatcherSupportPkg 1.8.4 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.1.0
With the release of OpenCore Legacy Patcher 2.1.0, this version will primarily focus on stability and bug fixes. However, this release does support settings retention in the GUI, allowing users to save settings between runs and updates.
Changes include:
- Support saving settings from the GUI between app launches.
- Note this only applies for on-model settings, changing Mac models resets settings.
- Disabling FeatureUnlock and mediaanalysisd (Live Text) by default for stability.
- If either features are desired, can be re-enabled in settings.
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as a download option.
- Resolve WhatsApp crash on 15.1.
See changelog for more information. Otherwise hope everyone enjoys the new release!
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.1.0 Changelog (click to expand)
- Disable FeatureUnlock by default
- Intended to maintain long term stability
- If features unlocked by FeatureUnlock desired, can be enabled in settings
- Disable mediaanalysisd on Metal 3802-based GPUs
- Intended to maintain long term stability
- If Live Text support desired, can be enabled in settings
- Support for retaining GUI settings when building on-model
- When switching to a different model, model-specific GUI settings will be reset
- Note resetting saved settings not implemented yet
- Delete
/Users/Shared/.com.dortania.opencore-legacy-patcher.plist
and restart app to reset settings
- Delete
- Resolve macOS 15.1 (24B2083) Apple Silicon installer appearing as download option
- Resolve WhatsApp crashing on 15.1
- Increment binaries:
- PatcherSupportPkg 1.8.4 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.0.2
2.0.2 is a bug fix release for 2.0.0/2.0.1 to handle some bugs with Nvidia GPUs, general graphics bugs and macOS 15.1 support. See below for new changes introduced with 2.0.0:
With the release of OpenCore Legacy Patcher 2.0.0, we're proud to announce macOS Sequoia support! And with it, 83 unsupported Mac models will be able to run Apple's latest operating system!
With macOS Sequoia, we spent many months working tirelessly to get these old machines running. And because of the sheer number of different hardware we support and the challenges of working on a closed-source operating system, not all features are currently available.
Main limitations with macOS Sequoia:
- Lack of support for recently dropped 2018 T2 MacBook Airs (MacBookAir8,x).
- Single CPU limitation on 2008 Mac Pro (MacPro3,1) and 2008 Xserve (Xserve2,1).
- Booting with more than 4 cores breaks Sequoia, OpenCore Legacy Patcher will automatically disable additional cores.
- When running an older OS, you can disable this limitation in Settings.
- Photos Application is non-functional for non-Metal-based graphics cards.
- Applicable for pre-2012 Macs (See table below).
Non-Metal Graphics Models:
- MacBook5,1 - MacBook7,1 (Early 2008 - Mid 2010)
- MacBookAir2,1 - MacBookAir4,x (Mid 2008 - Mid 2011)
- MacBookPro4,1 - MacBookPro8,x (Late 2008 - Late 2011)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 - Macmini5,x (Early 2009 - Mid 2011)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
Affected GPU Models (click to expand)
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 |
We hope as time passes, we'll be able to tackle these issues. However for now, we're unable to provide any timeline when it'll be resolved.
Additionally we recommend users check the graphics issues to see what may not be fully supported:
- Legacy Metal Graphics Support and macOS Ventura - Sequoia #1008
- Legacy Non-Metal GPUs and MacOS Big Sur - Sequoia #108
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.0.2, 2.0.1 and 2.0.0 Changelog (click to expand)
2.0.2
- Fix Nvidia Kepler patches not installing on Monterey
- Fix
iMac7,1
andiMac8,1
failing to apply root patches on macOS Sequoia - Avoid downgrading AppleGVA stack on AMD GCN and newer GPUs
- Resolves VTDecoderXPC crashes
- Thanks @Ausdauersportler for the catch!
- Resolve glitched widgets on 3802-based GPUs running macOS Sequoia 15.1
- Resolve CoreImage crashes on 3802-based GPUs running macOS Sequoia
- Resolve missing screen capture crop borders on non-Metal GPUs running macOS Sequoia
- Resolve TeraScale 2 HDCP kernel panic
- Resolve specific Wallpaper locking up on non-Metal GPUs running macOS Sequoia
- Removes unsupported Metal-based wallpaper (Macintosh Wallpaper)
- Resolve firmware upload incompatibilities on pre-2012 Macs with 2012+ Airport cards
- Thanks @Ausdauersportler for the catch!
- Resolve
diskutil
failing to be located in the installer creation process- Thanks @niklasravnsborg for the report!
- Increment binaries:
- PatcherSupportPkg 1.8.3 - release
2.0.1
- Fix MacBookPro13,3 listing 'Available patches' after having installed all applicable patches
- Fix Nvidia Tesla and Kepler patches not installing on Monterey (and older if applicable)
- Fix Nvidia Web Drivers incorrectly listing 'OpenGL', 'compat' and 'nvda_drv(_vrl)' missing
2.0.0
- Set
AssociatedBundleIdentifiers
property in launch services as an array - Move to auto-generated pre/postinstall scripts for PKGs
- Streamlines PKG creation process, ensuring Install and AutoPKG scripts are always in sync
- Add support for
gktool
in PKG postinstall scripts- Removes Gatekeeper "verifying" prompt on first launch after PKG installation
- Note
gktool
is only available on macOS Sonoma and newer
- Resolve unpatching crash edge case when host doesn't require patches.
- Implement new Software Update Catalog Parser for macOS Installers
- Implement new Copy on Write detection mechanism for all file copying operations
- Implemented using
getattrlist
andVOL_CAP_INT_CLONE
flag - Helps improve performance on APFS volumes
- Implemented using
- Increase model range for S1X/S3X patching to include Haswell Macs and
MacPro6,1
- Helps avoid an issue where older machines with newer, unsupported SSDs would fail to boot
- Only affects building EFI from another machine
- Resolve AMD Navi MXM GPU detection for modded iMac9,x-12,x
- Thanks @Ausdauersportler for the patch!
- Implement early macOS Sequoia support:
- Supporting Macs with Metal and non-Metal-based graphics:
- MacBook5,x - 10,1
- MacBookAir2,x - 7,x
- MacBookPro4,1 - 14,x
- Macmini3,1 - 7,1
- iMac7,1 - 18,x
- MacPro3,1 - 6,1
- MacPro3,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Xserve2,1 - 3,1
- Xserve2,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Excludes the newly dropped MacBookAir8,x series.
- No estimate can be given when support will be added.
- For non-Metal graphics, Photos app will be broken.
- No estimate can be given when support will be added.
- Supporting Macs with Metal and non-Metal-based graphics:
- Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
- See repository for more details: MetallibSupportPkg.
- Implement new Patchset Detection architecture.
- Implement new kernel cache building architecture.
- Resolve "Label" error in com.dortania.opencore-legacy-patcher.os-caching.plist.
- Add macOS Sequoia icons to boot picker and GUI.
- Resolve Memoji crashes on 3802 GPUs.
- Resolve Photos Memories tab crash on Intel Ivy Bridge/Haswell iGPUs.
- Increment Binaries:
- PatcherSupportPkg 1.8.0 - release
- OpenCorePkg 1.0.1 - release
- Lilu 1.6.8 - release
- WhateverGreen 1.6.7 - release
- RestrictEvents 1.1.4 - release
- FeatureUnlock 1.1.6 - release
- DebugEnhancer 1.0.9 - release
- CPUFriend 1.2.8 - release
- AutoPkgInstaller 1.0.4 - release
- CryptexFixup 1.0.3 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.0.1
2.0.1 is a bug fix release for 2.0.0 to handle some bugs with Nvidia GPUs and UI. See below for new changes introduced with 2.0.0:
With the release of OpenCore Legacy Patcher 2.0.0, we're proud to announce macOS Sequoia support! And with it, 83 unsupported Mac models will be able to run Apple's latest operating system!
With macOS Sequoia, we spent many months working tirelessly to get these old machines running. And because of the sheer number of different hardware we support and the challenges of working on a closed-source operating system, not all features are currently available.
Main limitations with macOS Sequoia:
- Lack of support for recently dropped 2018 T2 MacBook Airs (MacBookAir8,x).
- Single CPU limitation on 2008 Mac Pro (MacPro3,1) and 2008 Xserve (Xserve2,1).
- Booting with more than 4 cores breaks Sequoia, OpenCore Legacy Patcher will automatically disable additional cores.
- When running an older OS, you can disable this limitation in Settings.
- Photos Application is non-functional for non-Metal-based graphics cards.
- Applicable for pre-2012 Macs (See table below).
Non-Metal Graphics Models:
- MacBook5,1 - MacBook7,1 (Early 2008 - Mid 2010)
- MacBookAir2,1 - MacBookAir4,x (Mid 2008 - Mid 2011)
- MacBookPro4,1 - MacBookPro8,x (Late 2008 - Late 2011)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 - Macmini5,x (Early 2009 - Mid 2011)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
Affected GPU Models (click to expand)
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 |
We hope as time passes, we'll be able to tackle these issues. However for now, we're unable to provide any timeline when it'll be resolved.
Additionally we recommend users check the graphics issues to see what may not be fully supported:
- Legacy Metal Graphics Support and macOS Ventura - Sequoia #1008
- Legacy Non-Metal GPUs and MacOS Big Sur - Sequoia #108
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.0.1 and 2.0.0 Changelog (click to expand)
2.0.1
- Fix MacBookPro13,3 listing 'Available patches' after having installed all applicable patches
- Fix Nvidia Tesla and Kepler patches not installing on Monterey (and older if applicable)
- Fix Nvidia Web Drivers incorrectly listing 'OpenGL', 'compat' and 'nvda_drv(_vrl)' missing
2.0.0
- Set
AssociatedBundleIdentifiers
property in launch services as an array - Move to auto-generated pre/postinstall scripts for PKGs
- Streamlines PKG creation process, ensuring Install and AutoPKG scripts are always in sync
- Add support for
gktool
in PKG postinstall scripts- Removes Gatekeeper "verifying" prompt on first launch after PKG installation
- Note
gktool
is only available on macOS Sonoma and newer
- Resolve unpatching crash edge case when host doesn't require patches.
- Implement new Software Update Catalog Parser for macOS Installers
- Implement new Copy on Write detection mechanism for all file copying operations
- Implemented using
getattrlist
andVOL_CAP_INT_CLONE
flag - Helps improve performance on APFS volumes
- Implemented using
- Increase model range for S1X/S3X patching to include Haswell Macs and
MacPro6,1
- Helps avoid an issue where older machines with newer, unsupported SSDs would fail to boot
- Only affects building EFI from another machine
- Resolve AMD Navi MXM GPU detection for modded iMac9,x-12,x
- Thanks @Ausdauersportler for the patch!
- Implement early macOS Sequoia support:
- Supporting Macs with Metal and non-Metal-based graphics:
- MacBook5,x - 10,1
- MacBookAir2,x - 7,x
- MacBookPro4,1 - 14,x
- Macmini3,1 - 7,1
- iMac7,1 - 18,x
- MacPro3,1 - 6,1
- MacPro3,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Xserve2,1 - 3,1
- Xserve2,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Excludes the newly dropped MacBookAir8,x series.
- No estimate can be given when support will be added.
- For non-Metal graphics, Photos app will be broken.
- No estimate can be given when support will be added.
- Supporting Macs with Metal and non-Metal-based graphics:
- Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
- See repository for more details: MetallibSupportPkg.
- Implement new Patchset Detection architecture.
- Implement new kernel cache building architecture.
- Resolve "Label" error in com.dortania.opencore-legacy-patcher.os-caching.plist.
- Add macOS Sequoia icons to boot picker and GUI.
- Resolve Memoji crashes on 3802 GPUs.
- Resolve Photos Memories tab crash on Intel Ivy Bridge/Haswell iGPUs.
- Increment Binaries:
- PatcherSupportPkg 1.8.0 - release
- OpenCorePkg 1.0.1 - release
- Lilu 1.6.8 - release
- WhateverGreen 1.6.7 - release
- RestrictEvents 1.1.4 - release
- FeatureUnlock 1.1.6 - release
- DebugEnhancer 1.0.9 - release
- CPUFriend 1.2.8 - release
- AutoPkgInstaller 1.0.4 - release
- CryptexFixup 1.0.3 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
2.0.0
With the release of OpenCore Legacy Patcher 2.0.0, we're proud to announce macOS Sequoia support! And with it, 83 unsupported Mac models will be able to run Apple's latest operating system!
With macOS Sequoia, we spent many months working tirelessly to get these old machines running. And because of the sheer number of different hardware we support and the challenges of working on a closed-source operating system, not all features are currently available.
Main limitations with macOS Sequoia:
- Lack of support for recently dropped 2018 T2 MacBook Airs (MacBookAir8,x).
- Single CPU limitation on 2008 Mac Pro (MacPro3,1) and 2008 Xserve (Xserve2,1).
- Booting with more than 4 cores breaks Sequoia, OpenCore Legacy Patcher will automatically disable additional cores.
- When running an older OS, you can disable this limitation in Settings.
- Photos Application is non-functional for non-Metal-based graphics cards.
- Applicable for pre-2012 Macs (See table below).
Non-Metal Graphics Models:
- MacBook5,1 - MacBook7,1 (Early 2008 - Mid 2010)
- MacBookAir2,1 - MacBookAir4,x (Mid 2008 - Mid 2011)
- MacBookPro4,1 - MacBookPro8,x (Late 2008 - Late 2011)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 - Macmini5,x (Early 2009 - Mid 2011)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
Affected GPU Models (click to expand)
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 |
We hope as time passes, we'll be able to tackle these issues. However for now, we're unable to provide any timeline when it'll be resolved.
Additionally we recommend users check the graphics issues to see what may not be fully supported:
- Legacy Metal Graphics Support and macOS Ventura - Sequoia #1008
- Legacy Non-Metal GPUs and MacOS Big Sur - Sequoia #108
As to be expected, macOS Sequoia support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
2.0.0 Changelog (click to expand)
- Set
AssociatedBundleIdentifiers
property in launch services as an array - Move to auto-generated pre/postinstall scripts for PKGs
- Streamlines PKG creation process, ensuring Install and AutoPKG scripts are always in sync
- Add support for
gktool
in PKG postinstall scripts- Removes Gatekeeper "verifying" prompt on first launch after PKG installation
- Note
gktool
is only available on macOS Sonoma and newer
- Resolve unpatching crash edge case when host doesn't require patches.
- Implement new Software Update Catalog Parser for macOS Installers
- Implement new Copy on Write detection mechanism for all file copying operations
- Implemented using
getattrlist
andVOL_CAP_INT_CLONE
flag - Helps improve performance on APFS volumes
- Implemented using
- Increase model range for S1X/S3X patching to include Haswell Macs and
MacPro6,1
- Helps avoid an issue where older machines with newer, unsupported SSDs would fail to boot
- Only affects building EFI from another machine
- Resolve AMD Navi MXM GPU detection for modded iMac9,x-12,x
- Thanks @Ausdauersportler for the patch!
- Implement early macOS Sequoia support:
- Supporting Macs with Metal and non-Metal-based graphics:
- MacBook5,x - 10,1
- MacBookAir2,x - 7,x
- MacBookPro4,1 - 14,x
- Macmini3,1 - 7,1
- iMac7,1 - 18,x
- MacPro3,1 - 6,1
- MacPro3,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Xserve2,1 - 3,1
- Xserve2,1 can only boot with 4 cores max currently
- 8 cores can be re-enabled for older OSes in the GUI:
- Settings -> Build -> MacPro3,1/Xserve2,1 Workaround
- Excludes the newly dropped MacBookAir8,x series.
- No estimate can be given when support will be added.
- For non-Metal graphics, Photos app will be broken.
- No estimate can be given when support will be added.
- Supporting Macs with Metal and non-Metal-based graphics:
- Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
- See repository for more details: MetallibSupportPkg.
- Implement new Patchset Detection architecture.
- Implement new kernel cache building architecture.
- Resolve "Label" error in com.dortania.opencore-legacy-patcher.os-caching.plist.
- Add macOS Sequoia icons to boot picker and GUI.
- Resolve Memoji crashes on 3802 GPUs.
- Resolve Photos Memories tab crash on Intel Ivy Bridge/Haswell iGPUs.
- Increment Binaries:
- PatcherSupportPkg 1.8.0 - release
- OpenCorePkg 1.0.1 - release
- Lilu 1.6.8 - release
- WhateverGreen 1.6.7 - release
- RestrictEvents 1.1.4 - release
- FeatureUnlock 1.1.6 - release
- DebugEnhancer 1.0.9 - release
- CPUFriend 1.2.8 - release
- AutoPkgInstaller 1.0.4 - release
- CryptexFixup 1.0.3 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
1.5.0
With the release of OpenCore Legacy Patcher v1.5.0, some noteworthy improvements are dropping!
- New Privileged Helper Tool.
- Removes requirement of password prompts for installing patches, creating installers, etc.
- New Package-based distribution.
- Help support the new helper tool installation, and streamline future updates.
OpenCore-Patcher.pkg
will be the recommend way to install OpenCore Legacy Patcher.
And more fixes and improvements listed in the changelog below. Hope everyone enjoys the new release!
As to be expected, macOS Sonoma support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
1.5.0 Changelog (click to expand)
- Restructure project directories
- Python:
- Move logic into
opencore_legacy_patcher
directory - Use relative imports for local libraries
- Move logic into
- Documentation:
- Move images to
docs/images
- Move images to
- Payloads:
- Remove redundant/unused files bundled in payloads.dmg
- Python:
- Resolve unpatching Nvidia Web Drivers failing to clean up
/Library/Extensions
- Implement preflight code signature checks for macOS installer creation
- Ensures validity of
createinstallmedia
binary before execution
- Ensures validity of
- Modularize AutoPkg's pre/postinstall scripts
- Adjusted to use functions for better readability
- Implements ZSH shebang
- Removes OS logging
- Disable usage of
OpenLegacyBoot.efi
- Resolves boot issues on certain CSM-based Macs
- Implement new PKG-based installer
OpenCore-Patcher.pkg
is now the recommended method for installationOpenCore-Patcher-Uninstaller.pkg
is now available for uninstallation- Note this only removes the application, not any patches applied
OpenCore-Patcher-GUI.app.zip
is deprecated and will be removed in future versions
- Implement new Privileged Helper Tool
- Removes need for password prompts when installing patches, creating installers, etc.
- Installed at
/Library/PrivilegedHelperTools/com.dortania.opencore-legacy-patcher.privileged-helper
- No launch services required
- For running from source, recompile tool with debug configuration (
make debug
)
- Resolve OpenCore-Patcher.app window not appearing as topmost window on launch
- Reworked CI tooling:
- New build script with reworked parameters:
Build-Project.command
- Remove reliance on WhiteBox's Packages for AutoPkg creation
- Now implements
pkgbuild
andproductbuild
for package creation throughmacOs-Pkg-Builder
Python module
- Now implements
- New build script with reworked parameters:
- Implement additional sanity checks before performing root patches
- Checks for mismatched snapshots vs root volume macOS versions
- Increment Binaries:
- OpenCorePkg 1.0.0 - release
Asset Information
- OpenCore-Patcher.pkg:
- Visual GUI-based app installer
- Recommended for all users
- OpenCore-Patcher-Uninstaller.pkg:
- Uninstalls OpenCore-Patcher.app and additional utilities
- Does not revert any patches installed
- OpenCore-Patcher-GUI.app:
- Legacy app, installs OpenCore-Patcher.pkg internally
- Direct app download is deprecated, and planned for remove in the future
- AutoPkg-Assets.pkg:
- Additional resources used by OpenCore-Patcher
- Automatically pulled when needed, don't download
1.4.3
WARNING: Upgrading to 12.7.4, 13.6.5 or 14.4 may break Auto Joining WiFi Networks on legacy Wireless Cards
To restore Auto-Join support, forget the network and re-add it.
This only applies for legacy WiFi cards, included with the following models:
- MacBook5,x (Early 2008 - Early 2009)
- MacBookAir2,1 - MacBookAir3,x (Mid 2008 - Late 2010)
- MacBookPro4,1 - MacBookPro7,1 (Late 2008 - Mid 2010)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 (Early 2009 - Late 2009)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
With the release of OpenCore Legacy Patcher v1.4.3, this build is primarily targeted for macOS 14.4/14.4.1 and Macs with non-Metal graphics cards. This build resolves support for the following machines with non-Metal GPUs:
- MacBook5,1 - MacBook7,1 (Early 2008 - Mid 2010)
- MacBookAir2,1 - MacBookAir4,x (Mid 2008 - Mid 2011)
- MacBookPro4,1 - MacBookPro8,x (Late 2008 - Late 2011)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 - Macmini5,x (Early 2009 - Mid 2011)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
Affected GPU Models (click to expand)
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 |
We hope everyone enjoys the new release!
As to be expected, macOS Sonoma support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
1.4.3 Changelog (click to expand)
- Update non-Metal Binaries for macOS Sonoma:
- Resolve TeraScale 2 screen recording kernel panic
- Resolve Dock location after changing screen resolution
- Resolve 14.4 loginwindow crashes
- Patch SkipLogo on Macs that natively support Monterey or newer
- Resolves missing Apple logo on boot screen
- Increment Binaries:
- OpenCorePkg 0.9.9 - 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
1.4.2
WARNING 1: Do not upgrade to macOS 14.4 if you have a non-Metal Mac
macOS 14.4 is currently unsupported with Macs equipped with non-Metal Graphics Cards, see macOS 14.4 non-Metal sessions bug #1125 for more information. Affected Macs:
- MacBook5,1 - MacBook7,1 (Early 2008 - Mid 2010)
- MacBookAir2,1 - MacBookAir4,x (Mid 2008 - Mid 2011)
- MacBookPro4,1 - MacBookPro8,x (Late 2008 - Late 2011)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 - Macmini5,x (Early 2009 - Mid 2011)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
Affected GPU Models (click to expand)
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 |
WARNING 2: If upgrading to macOS 14.4, you MUST install OCLP 1.4.2 beforehand.
A lot of hardware, including Metal GPUs, WiFi cards, T1 chipsets, etc have new patches made for macOS 14.4. We highly recommend installing OCLP 1.4.2 beforehand to ensure a smooth update.
WARNING 3: Upgrading to 12.7.4, 13.6.5 or 14.4 may break Auto Joining WiFi Networks on legacy Wireless Cards
To restore Auto-Join support, forget the network and re-add it.
This only applies for legacy WiFi cards, included with the following models:
- MacBook5,x (Early 2008 - Early 2009)
- MacBookAir2,1 - MacBookAir3,x (Mid 2008 - Late 2010)
- MacBookPro4,1 - MacBookPro7,1 (Late 2008 - Mid 2010)
- iMac7,1 - iMac12,x (Mid 2007 - Mid 2011)
- Macmini3,1 (Early 2009 - Late 2009)
- MacPro3,1 - MacPro5,1 (Early 2008 - Mid 2012)
With the release of OpenCore Legacy Patcher v1.4.2, this build is primarily targeted for macOS 14.4 and all Macs to ensure proper functionality. Over 1.4.0 and 1.4.1, 1.4.2 resolves Auto Join for WiFi on modern Wireless Cards, legacy WiFi support for 12.7.4 and 13.6.5 and a USB 1.1 regression for macOS Ventura.
We hope everyone enjoys the new release!
As to be expected, macOS Sonoma support is 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.
Supporting OpenCore Legacy Patcher
If you enjoy the work we do, consider donating! This helps us get new hardware, and help improve the project!
Full Changelog
1.4.2 Changelog (click to expand)
- Resolve Auto-Join support for Modern Wireless on macOS 14.4
- Applicable for BCM94360, 4360, 4350, 4331 and 43224 chipsets
- Resolve WiFi support for Legacy Wireless on macOS 12.7.4 and 13.6.5
- Applicable for BCM94328, BCM94322 and Atheros chipsets
- Resolve USB 1.1 on macOS Ventura regression from OCLP 1.4.0
- Increment Binaries:
- PatcherSupportPkg 1.4.8 - release
1.4.1 Changelog (click to expand)
- Update updater implementation
- Resolve Keyboard/Trackpad support for MacBookAir6,x running macOS 14.4 and newer
- Expands SPI Keyboard and Trackpad patch to include MacBookAir6,x
- Publish Bluetooth NVRAM variables for BCM2046 and BCM2070 chipsets
- Reduces need for NVRAM reset to restore Bluetooth support in newer OSes (Thanks @Ausdauersportler)
1.4.0 Changelog (click to expand)
- Refactor subprocess invocations
- Resolve RecoveryOS support (Regression resolved in OpenCorePkg)
- Restore SPI Keyboard and Trackpad support for macOS 14.4 and newer
- Applicable for MacBook8,1, MacBookAir7,x and MacBookPro12,1-14,x
- Restore support for T1 on macOS 14.4 and newer
- Applicable for MacBookPro13,2, MacBookPro13,3, MacBookPro14,2, MacBookPro14,3
- Restore support for legacy Metal GPUs on macOS 14.4 and newer
- Applicable for:
- Intel Ivy Bridge through Skylake
- Nvidia Kepler
- AMD legacy GCN
- Applicable for:
- Restore support for USB 1.1 on macOS 14.4 and newer
- Applicable for Penryn Macs, Xserve3,1 and MacPro4,1/5,1
- Resolve support for legacy and modern WiFi on macOS 14.4 and newer
- Applicable for all WiFi-equipped Macs
- Note with 14.4: Auto-Join may not work until you forget and rejoin the network
- Increment binaries:
- OpenCorePkg 0.9.7 - 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