OpenCore Legacy Patcher

OpenCore Legacy Patcher is a Python-based project built on Acidanthera's OpenCorePkg and Lilu that lets you install and run modern macOS releases on Macs that Apple has officially dropped from its supported-device list. It targets owners of older Mac hardware, going back as far as 2007 models, who want current macOS features and security updates without buying new hardware, and developers who want to tinker with OpenCore-based boot patching.

The project works by injecting OpenCore configuration and kexts at boot time and applying root patches to the OS, rather than flashing firmware. This keeps the approach reversible and avoids permanently modifying the Mac's ROM.

Key features

• Broad OS support: installs and boots macOS Big Sur, Monterey, Ventura, Sonoma, and Sequoia on unsupported Macs, with Penryn and newer models supported.
• OTA updates: supports native Over the Air system updates so patched machines can update like supported Macs.
• Wi-Fi and Hotspot: full WPA Wi-Fi and Personal Hotspot support on BCM943224 and newer wireless chipsets.
• Security features retained: System Integrity Protection, FileVault 2, .im4m Secure Boot, and vaulting all continue to work on patched systems.
• Alternate boot modes: Recovery OS, Safe Mode, and Single-user Mode all boot correctly on non-native OS installs.
• Feature unlocking: enables Sidecar and AirPlay to Mac even on natively supported Macs that lack the hardware checks.
• Storage power management: enhanced SATA and NVMe power management for non-Apple storage devices.
• No firmware patching: zero ROM or firmware patching required, meaning no APFS ROM patches or permanent hardware changes.
• Graphics acceleration: Metal and non-Metal GPU acceleration patch sets, covering a wide range of older GPU architectures.

Ideal use cases

This tool fits Mac owners who want to extend the useful life of older Intel Macs (2007 and later, Penryn-class CPUs and up) by running current macOS versions with working Wi-Fi, graphics acceleration, and system security features. It's also a reasonable fit for anyone running a natively supported Mac who wants to unlock features like Sidecar or AirPlay to Mac that Apple gates behind hardware checks.

It is not a fit if you're running macOS Mojave or Catalina specifically; the project recommends dosdude1's patchers for those older releases instead, since official support here starts at Big Sur. It also won't work on a Mac already patched with a different tool like Patched Sur or bigmac, since those break APFS snapshot and SIP integrity in ways this patcher can't repair; a clean install or upgrade through OpenCore Legacy Patcher itself is required in that case (though you can reinstall and keep your existing data). If you need firmware-level ROM patching, note this project deliberately avoids that approach entirely.

Installation

The project is distributed with an in-depth setup guide hosted separately from the README:

• Follow the official guide at the OpenCore Legacy Patcher Guide for the standard install path using the packaged application.

To run the project directly from source instead of using a release build:

# See SOURCE.md in the repository for full build-from-source instructions

Refer to SOURCE.md in the repository root for the exact Python environment and build steps, since the project is written in Python and built around OpenCorePkg payloads bundled into the app.

For troubleshooting, the project documents a debug procedure before asking for help:

• Review the debugging with OpenCore guide to gather logs and diagnostic info.
• Ask in the community-run OpenCore Patcher Paradise Discord Server.

The project is offered on an as-is basis; the maintainers don't guarantee support for issues, though the Discord community is active.