Skip to content

Releases: dortania/OpenCore-Legacy-Patcher

2.1.2

06 Nov 19:17
Compare
Choose a tag to compare

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 if TypeError: unsupported type: <class 'NoneType'> error occurs

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

05 Nov 15:53
ab74037
Compare
Choose a tag to compare

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

01 Nov 17:17
Compare
Choose a tag to compare

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

27 Sep 22:05
Compare
Choose a tag to compare

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:

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 and iMac8,1 failing to apply root patches on macOS Sequoia
  • Avoid downgrading AppleGVA stack on AMD GCN and newer GPUs
  • 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
  • Resolve diskutil failing to be located in the installer creation process
  • 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 and VOL_CAP_INT_CLONE flag
    • Helps improve performance on APFS volumes
  • 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
  • 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.
  • Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
  • 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

16 Sep 17:27
Compare
Choose a tag to compare

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:

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 and VOL_CAP_INT_CLONE flag
    • Helps improve performance on APFS volumes
  • 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
  • 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.
  • Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
  • 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

14 Sep 17:00
Compare
Choose a tag to compare

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:

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 and VOL_CAP_INT_CLONE flag
    • Helps improve performance on APFS volumes
  • 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
  • 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.
  • Implement new MetallibSupportPkg system to support macOS Sequoia on Metal 3802-based GPUs.
  • 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

31 May 17:05
Compare
Choose a tag to compare

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
    • Documentation:
      • Move images to docs/images
    • Payloads:
      • Remove redundant/unused files bundled in payloads.dmg
  • 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
  • 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 installation
    • OpenCore-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 and productbuild for package creation through macOs-Pkg-Builder Python module
  • 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

31 Mar 21:52
Compare
Choose a tag to compare

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

11 Mar 16:57
Compare
Choose a tag to compare

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

1.4.1

08 Mar 02:59
Compare
Choose a tag to compare

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.1 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.1 beforehand to ensure a smooth update.

WARNING 3: Upgrading to 14.4 may break Auto Joining WiFi Networks

To restore Auto-Join support, forget the network and re-add it.

WARNING 4: Do not install macOS 12.7.4 or 13.6.5 if you have a Mac with Legacy Wireless patches

A recent change has broken the legacy wireless patches on macOS Monterey 12.7.4 and Ventura 13.6.5. A fix will arrive in the next version of OCLP.


With the release of OpenCore Legacy Patcher v1.4.1, this build is primarily targeted for macOS 14.4 and all Macs to ensure proper functionality. Over 1.4.0, 1.4.1 resolves Keyboard and Trackpad support for the mid 2013 MacBook Air (MacBookAir6,x).

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