Skip to content

Releases: dortania/OpenCore-Legacy-Patcher

0.5.2

22 Nov 15:22
Compare
Choose a tag to compare

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)
    • 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)
  • 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

27 Oct 15:09
Compare
Choose a tag to compare

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

0.5.0

25 Oct 16:00
Compare
Choose a tag to compare

After many months of heavy anticipation, OpenCore Legacy Patcher 0.5.0 adds 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!


Other machines such as the 2013 Mac Pro 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.

Full Changelog

0.5.0 Changelog (click to expand)
  • Ventura Specific Updates:
    • Switch boot.efi model patch to iMac18,1
    • Resolve pre-Force Touch Trackpad support in Ventura
    • Add Ventura-dropped Models:
      • MacPro6,1
      • Macmini7,1
      • iMac16,x, iMac17,1
      • MacBook9,1
      • MacBookAir7,x
      • MacBookPro11,4/5, MacBookPro12,1, MacBookPro13,x
    • Add Ventura Software Catalog parsing
    • Add Kernel Debug Kit checks to Ventura root patching
    • Add USB map injection for dropped models
    • Resolve Ethernet support on MacPro3,1-5,1
    • Fix VMM patch set
    • Allow dyld shared cache swapping on pre-Haswell
    • Fix MouSSE/SSE4,2 emulation in macOS 13.0 Beta 3 (22A5295h)
    • Graphics Acceleration for legacy Metal GPUs
      • Intel: Ivy Bridge, Haswell, Broadwell and Skylake
      • Nvidia: Kepler
      • AMD: GCN 1 through 3
      • AMD: Polaris (on pre-AVX2.0 systems)
        • Boot in safe mode to avoid stock driver loading
    • Raise SIP requirement to 0x803 for root patching
    • Add Ventura Boot Picker icons
    • Implement KDK-less root patching for Metal Intel and Nvidia GPUs
      • AMD GCN will still require a KDK installed for patching
    • Resolve OpenCL support for legacy Metal GPUs
    • Implement Automatic Rosetta Cryptex installation on OS installs and updates
      • Drops need for manual OS.dmg swapping on pre-Haswell
    • Implement automatic Kernel Debug Kit downloader for systems requiring Boot/SysKC rebuilding
      • ex. AMD GCN
      • Relies on N-1 system for when matching KDK is not present
    • Delete unused KDKs in /Library/Developer/KDKs during root patching
    • Resolve Power Management support for Ivy Bridge and older
    • Drop AMFI requirement for Nvidia Kepler and AMD GCN 1-3
    • Resolve numerous AMD GCN 1-3 issues (ex. Photos.app, Screen Saver, etc.)
    • Resolve dGPU support for MacBookPro13,3
  • Add work-around to Catalyst Buttons not responding on non-Metal in macOS Monterey
  • Re-export OpenCanopy icons to better support Haswell and newer Macs
  • Increment Binaries:
    • OpenCorePkg 0.8.5 release
    • Lilu 1.6.2 - release
    • FeatureUnlock 1.0.9 release
    • PatcherSupportPkg 0.7.1 - release
    • BrcmPatchRAM 2.6.4 - release
    • AutoPkgInstaller 1.0.1 - release
    • CryptexFixup 1.0.1 - rolling (cf3a1e4)

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 use manually

0.4.11

19 Sep 01:37
Compare
Choose a tag to compare

This release is dedicated to bug fixes, no Ventura support is available with this build. See following issue for more info: macOS Ventura and OpenCore Legacy Patcher Support


With Apple's release on macOS Monterey 12.6, we wanted to release some fixes associated with this OS. Main one is WebKit support with Safari 16.0 on Ivy Bridge iGPUs and non-Metal GPUs.

  • If you've installed/updated to 12.6, Safari 16.0 will be an additional update separate from the OS (12.6 comes with Safari 15.6.1 by default). If you find Google text elements not rendering correctly, re-run the root volume patcher. See images below for symptoms

Otherwise we hope everyone enjoys the new release!

Missing WebKit Patch WebKit Patch installed
Screenshot 2022-09-15 at 8 47 28 PM Screenshot 2022-09-15 at 8 46 06 PM

  • WebGL note: If you notice Google Maps in Safari is broken on Ivy Bridge and Haswell, know that this is an Apple bug resolved in Safari Tech Preview 16.1
    • Alternatively, disable "WebGL via Metal" in Safari's Developer Settings if you're on Safari 16.0

Full Changelog

0.4.11 Changelog (click to expand)
  • Enable AppleMCEReporterDisabler whenever spoofing affected SMBIOS
    • ie. iMacPro1,1, MacPro6,1 and MacPro7,1
  • Verify host's disk space before downloading macOS Installers
  • Remove duplicate OS builds in macOS downloader
    • Avoids Apple's odd bug of publishing 2 different 12.5.1 products
  • Implement deeper macOS installer parsing
    • Provides better version detection than Apple provides in .app
  • Ensure WhateverGreen is always installed on Mac Pro configurations
  • Resolve Safari 16 rendering in macOS 12.6
  • Increment Binaries:
    • PatcherSupportPkg 0.5.4 - release
  • Add missing OpenCL resources for Nvidia GPUs

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 use manually

0.4.10

06 Aug 05:04
Compare
Choose a tag to compare

This release is dedicated to bug fixes, no Ventura support is available with this build. See following issue for more info: macOS Ventura and OpenCore Legacy Patcher Support


After much research, development and testing, we've finally resolved support for Nvidia Kepler GPUs in macOS 12.5 and 12.5.1!

This release of OpenCore Legacy Patcher will allow users to freely install macOS Monterey on any of our supported units without concerns for GPU support. This includes iMacs, MacBooks and Mac Pros with Nvidia Kepler GPUs.

We hope everyone appreciates the new release!

Screen Shot 2022-08-05 at 10 42 40 PM


Full Changelog

0.4.10 Changelog (click to expand)
  • Resolve Nvidia Kepler support in macOS 12.5 Beta 3 and newer
  • Increment Binaries:
    • PatcherSupportPkg 0.5.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 use manually

0.4.9

20 Jul 17:41
Compare
Choose a tag to compare

This release is dedicated to bug fixes, no Ventura support is available with this build. See following issue for more info: macOS Ventura and OpenCore Legacy Patcher Support


Warning for Macs with Nvidia Kepler: macOS 12.5 breaks graphics acceleration with this build

Stay on 12.4 or older if your Mac has a Kepler GPU. 0.4.9 will prevent the installation of Kepler acceleration patches, instead only installing basic framebuffer in 12.5. macOS 12.4 and older are not affected, and can still be used normally.

For information can be found on the associated issue: macOS 12.5: Nvidia Kepler and WindowServer crashing #1004

Affected Models (stock):

  • MacBookPro9,1
  • MacBookPro10,1
  • MacBookPro11,3
  • iMac13,x (units with dGPUs)
  • iMac14,x (units with dGPUs)

Affected Models (user upgraded):

  • iMac11,x (units with upgraded Kepler GPUs)
  • iMac12,x (units with upgraded Kepler GPUs)
  • MacPro3,1 (units with upgraded Kepler GPUs)
  • MacPro4,1 (units with upgraded Kepler GPUs)
  • MacPro5,1 (units with upgraded Kepler GPUs)
  • Xserve2,1 (units with upgraded Kepler GPUs)
  • Xserve3,1 (units with upgraded Kepler GPUs)

Full Changelog

0.4.9 Changelog (click to expand)
  • Split Kepler userspace and kernel space patches

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 use manually

0.4.8

17 Jul 20:47
Compare
Choose a tag to compare

This release is dedicated to bug fixes, no Ventura support is available with this build. See following issue for more info: macOS Ventura and OpenCore Legacy Patcher Support


  • Ensure Apple Silicon-specific installers are not listed
    • ie. M2 specific build (21F2092)
  • Avoid adding OpenCore icon in boot picker if Windows bootloader on same partition
  • Add error-handling to corrupt/non-standard NVRAM variables
  • Add warning prompt when using 'Allow native models'
    • Attempt to avoid misuse of option
  • Work-around Failed to extract AssetData during installer creation
    • Apple bug, resolved by using CoW into a different directory than /Applications
  • Avoid listing beta installers in downloader
  • Warn about downloading macOS Ventura installers, unsupported by current patcher
  • Fix AppleGVA regression introduced in 0.4.6
    • Applicable for Ivy Bridge-only systems

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 use manually

0.4.7

16 Jun 16:39
Compare
Choose a tag to compare

This release is a simple bug fix, see 0.4.6's release notes for previous changes and noteworthy updates:


With the initial developer beta of macOS Ventura, we've seen many drastic changes to the patcher process that creates many challenges for us. Thus we've decided to do this release which prioritizes Monterey support, before trying to tackle larger issues.

This release will not have any support for Ventura, and we don't expect to have public support for some time. See macOS Ventura and OpenCore Legacy Patcher Support for more info.


Full Changelog

0.4.7 and 0.4.6 Changelog (click to expand)

0.4.7

  • Fix crashing on defaults parsing

0.4.6

  • Fix Bluetooth support in 12.4 Release
    • Applicable for BCM2046 and BCM2070 chipsets
    • Fix backported to 0.4.5 release
  • GUI Enhancements:
    • Greatly improve GUI load times (300-800% on average)
    • Resolve failing to find new updates
    • Implement Modal Sheets for longer windows
      • Avoids UI elements getting under the dock
    • Add return to disk when selecting partitions
    • Add "Search for disks again" option during OpenCore Install
    • Prevent Idle Sleep while running long processes (ie. downloading, flashing)
    • Start OpenCore build automatically when entering Build menu
    • Standardize Application Identifier for defaults
  • Resolve failing to find binaries with --patch_sys_vol argument
  • Downgrade AppleFSCompressionTypeZlib to 12.3.1 on pre-Sandy Bridge Macs
    • Resolves ZLib decompression kernel panics on 12.4 and newer
  • Resolve AppleGVACore crashing on MacBookPro11,3 in Monterey 12.4+
  • Add Nvidia Web Driver support for Maxwell and Pascal
  • Enable Beta Blur settings on non-Metal by default
    • For slower hardware, disabling may slightly improve performance
  • Deprecate TUI support
    • Users may still manually run from source for future builds
    • Binaries will no longer be provided on future release
  • Switch boot.efi model patch to iMac18,1

0.4.6

11 Jun 14:42
Compare
Choose a tag to compare

With the initial developer beta of macOS Ventura, we've seen many drastic changes to the patcher process that creates many challenges for us. Thus we've decided to do a release of 0.4.6 which prioritizes Monterey support, before trying to tackle larger issues.

This release will not have any support for Ventura, and we don't expect to have public support for some time. See macOS Ventura and OpenCore Legacy Patcher Support for more info.

Regarding note worthy features of this release:

  • Resolve Bluetooth 2.1 support in macOS 12.4
  • Greatly speed up GUI load times
  • Resolve Zlib kernel panics on 12.4 with pre-Sandy Bridge CPUs
  • Early support for Nvidia Web Drivers in non-Metal mode

Finally, this will be the final release where TUI binaries are uploaded on release. We have no plans to kill the TUI outright, but no effort will be made to maintain it. Developers can still compile TUIs from source, regular end users should transition to the GUI.

Otherwise, we hope everyone enjoys the new release!


Full Changelog

0.4.6 Changelog (click to expand)
  • Fix Bluetooth support in 12.4 Release
    • Applicable for BCM2046 and BCM2070 chipsets
    • Fix backported to 0.4.5 release
  • GUI Enhancements:
    • Greatly improve GUI load times (300-800% on average)
    • Resolve failing to find new updates
    • Implement Modal Sheets for longer windows
      • Avoids UI elements getting under the dock
    • Add return to disk when selecting partitions
    • Add "Search for disks again" option during OpenCore Install
    • Prevent Idle Sleep while running long processes (ie. downloading, flashing)
    • Start OpenCore build automatically when entering Build menu
    • Standardize Application Identifier for defaults
  • Resolve failing to find binaries with --patch_sys_vol argument
  • Downgrade AppleFSCompressionTypeZlib to 12.3.1 on pre-Sandy Bridge Macs
    • Resolves ZLib decompression kernel panics on 12.4 and newer
  • Resolve AppleGVACore crashing on MacBookPro11,3 in Monterey 12.4+
  • Add Nvidia Web Driver support for Maxwell and Pascal
  • Enable Beta Blur settings on non-Metal by default
    • For slower hardware, disabling may slightly improve performance
  • Deprecate TUI support
    • Users may still manually run from source for future builds
    • Binaries will no longer be provided on future release
  • Switch boot.efi model patch to iMac18,1

0.4.5

16 May 19:22
Compare
Choose a tag to compare

With this release of 0.4.5, we're primarily focused on resolving issues involving today's release of macOS 12.4 to the public as well as more general fixes. These include:

  • Non-Metal fixes:
    • Double menubar clock
    • Non-functional dismiss buttons
    • VNC support on TeraScale 2 GPUs
    • and other cosmetic fixes
  • 12.4 Installers not listing by default when downloading
  • More robust root volume patcher
  • Resolve Bluetooth support for BT2.1 controllers in 12.4

And many more changes we hope everyone will appreciate! See full changelog for all changes.

We hope this will be our last release before macOS 13's announcement!


And a quick thank you again to everyone who's donated to my GoFundMe, it's amazing how quickly we reached our goal! I can't express how grateful I am to everyone for giving me this opportunity. Can't wait to see everyone at WWDC2022!


Asset Information

  • OpenCore-Patcher-GUI.app:
    • Visual GUI based app
    • Recommended for all users
  • OpenCore-Patcher-TUI.app:
    • Terminal/Command Line based app
    • Only use if already familiar
  • AutoPkg-Assets.pkg:
    • Additional resources used by OpenCore-Patcher
    • Automatically pulled when needed, don't use manually

Full Changelog

0.4.5 Changelog (click to expand)
  • Fix AutoPatcher.pkg download on releases
    • Fix backported to 0.4.4 release binaries
  • Add Macmini8,1 FeatureUnlock support
    • Drops CPU check, supports all machines
  • Refactor Root Patching System
    • Adds preflight checks validating patch set data and presence
    • Adds dynamic Sandy Bridge Board ID patching
      • Allows for unrestricted SMBIOS usage with AppleIntelSNBGraphicsFB
    • Adds OpenCL downgrade for TeraScale 2
      • Resolves VNC support (credit IronApple#2711)
    • Fix SecureBootModel detection
  • Add OpenCore-Legacy-Patcher.plist for applied patch info
    • Located under /System/Library/CoreServices
    • Lists patch sets applied including files installed and removed
  • Add preinstall script to AutoPatcher
    • Removes old patcher files before installing new
  • Add Serial Number Spoofing
    • For recycled machines where MDM was mistakenly left on
  • Add sys_patch file validation during CI
  • GUI Enhancements:
    • Add GUI Prompt for booting mismatched OpenCore configs
      • ex. Booting MacBookPro8,1 config on MacBookPro11,1
    • Add Checksum verification to InstallAssistant.pkg download
    • Fix showing latest 12.4 remote installers
    • Add local Root Patcher version info when previously patched
      • Helps notify users they already patched, or should be repatched with a newer version
  • Add error handling to non-standard/malformed OpenCore Boot Path
  • Non-Metal Enhancements:
    • Add work-around to double clock bug introduced in macOS 12.4
    • Resolve non-functioning Dismiss buttons bug introduced in macOS 12.4
    • Refresh Status Bar when item length changes
    • Add smoother transition for auto appearance
  • Increment Binaries:
    • PatcherSupportPkg 0.4.1 - release
  • Fix Bluetooth support in 12.4 Release
    • Applicable for BCM2046 and BCM2070 chipsets