github dortania/OpenCore-Legacy-Patcher 1.5.0

one month ago

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

Don't miss a new OpenCore-Legacy-Patcher release

NewReleases is sending notifications on new releases.