Skip to content

Releases: dortania/OpenCore-Legacy-Patcher

2.2.0

11 Dec 17:06
@khronokernel khronokernel
2.2.0
5f1e21e
Compare
Choose a tag to compare
2.2.0 Latest
Latest

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
Assets 6
Loading

2.1.2

06 Nov 19:17
@khronokernel khronokernel
2.1.2
e94f6ac
Compare
Choose a tag to compare
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 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
Assets 6
Loading

2.1.1

05 Nov 15:53
@khronokernel khronokernel
2.1.1
ab74037
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
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
  • 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
Assets 6
Loading

2.1.0

01 Nov 17:17
@khronokernel khronokernel
2.1.0
737aed5
Compare
Choose a tag to compare
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
  • 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
Assets 6
Loading

2.0.2

27 Sep 22:05
@khronokernel khronokernel
2.0.2
15ad0c5
Compare
Choose a tag to compare
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:

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

Contributors

niklasravnsborg and Ausdauersportler
Assets 6
Loading

2.0.1

16 Sep 17:27
@khronokernel khronokernel
2.0.1
56c9fd5
Compare
Choose a tag to compare
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:

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

Contributors

Ausdauersportler
Assets 6
Loading

2.0.0

14 Sep 17:00
@khronokernel khronokernel
2.0.0
8eebf7e
Compare
Choose a tag to compare
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.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

Contributors

Ausdauersportler
Assets 6
Loading

1.5.0

31 May 17:05
@khronokernel khronokernel
1.5.0
a8ecd1c
Compare
Choose a tag to compare
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
    • 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
Assets 6
Loading

1.4.3

31 Mar 21:52
@khronokernel khronokernel
1.4.3
ae8d692
Compare
Choose a tag to compare
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
Assets 4
Loading

1.4.2

11 Mar 16:57
@khronokernel khronokernel
1.4.2
e494906
Compare
Choose a tag to compare
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
  • 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

Contributors

Ausdauersportler
Assets 4
Loading