Open-source project
dortania/OpenCore-Legacy-Patcher avatar
dortania/OpenCore-Legacy-Patcher

OpenCore Legacy Patcher: running Big Sur and newer on Macs Apple left behind

Experience macOS just like before

18,375 stars2,002 forksPythonNOASSERTION

At a glance

What is it?
A Python front end for Acidanthera's OpenCorePkg that installs and patches macOS Big Sur through Sequoia on unsupported Macs, with a GUI, zero firmware patching, and a hard limit on which installs it can touch.
Who is it for?
Adopt OpenCore Legacy Patcher if you have a Penryn-era or newer Mac that Apple has dropped, you can work from the Dortania guide, and you accept that the project is offered AS-IS with community support on Discord.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository last received commits 10 days ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 30, 2026, and from our analysis. They are not legal advice.

Editorial analysis

The problem OCLP solves, and the Macs it is aimed at

Apple drops macOS support on a schedule tied to hardware generation, not to whether the machine still works. OpenCore Legacy Patcher exists to close that gap. The README states the goal plainly: "breathe new life into Macs no longer supported by Apple, allowing for the installation and usage of macOS Big Sur and newer on machines as old as 2007." It supports Penryn and newer Macs, which puts the floor at the 2007 to 2008 era. The audience is narrow and specific: people holding a working Intel Mac whose last supported macOS is several versions behind, who want current Safari, current Xcode, or current security updates without buying new hardware. The README lists the supported target systems as Big Sur, Monterey, Ventura, Sonoma and Sequoia, and then contradicts itself slightly in a note: official support covers Big Sur through Sonoma installs, while Sequoia appears in the feature list. Read that discrepancy as a signal about how fast the project moves relative to its documentation. For Mojave and Catalina the README points elsewhere, to dosdude1's patchers. That is an honest boundary: OCLP is not a general-purpose old-Mac tool, it is a tool for the Big Sur and later era.

How OpenCore Legacy Patcher works: OpenCore as the boot layer, patches as the payload

The mechanism is two-layered, and the split matters. The first layer is Acidanthera's OpenCorePkg plus Lilu, the bootloader and kernel extension framework that OCLP configures. OpenCore presents a boot environment that a Mac Apple never intended to run this OS on will accept. The README calls out the properties this buys: System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting, plus booting Recovery OS, Safe Mode and Single-user Mode on non-native OSes. The second layer is the patch set, which is where most of the engineering effort lives. The credits section reads like an inventory of hardware-specific fixes: non-Metal frameworks for nVidia Tesla, Fermi, Maxwell and Pascal, AMD TeraScale 1 and 2, and Intel first and second generation GPUs; Metal bundle patches and shims for nVidia Kepler, AMD GCN 1 through 5, and Intel third and fourth generation graphics; a legacy Wi-Fi patch set covering 2007 to 2017 models; a T1 patch set restoring Touch ID and Apple Pay on 2016 and 2017 machines; an AppleGVA downgrade for accelerated video decoding on 2012 to 2016 models; and an IOSurface offset patch for Sonoma 14.4. Each of those is a separate compatibility problem solved by intercepting or replacing a framework. The README also claims zero firmware patching, meaning no APFS ROM patching. That is the design decision that makes OCLP reversible in a way earlier patchers were not, and it is the single most important architectural difference to understand.

Installing OpenCore Legacy Patcher and running a first patch

The README does not put install commands in the repository root. It points at the in-depth guide at dortania.github.io/OpenCore-Legacy-Patcher, and that guide is the actual installation path for end users. What the repository does document is running from source, via SOURCE.md, and the dependency list in requirements.txt tells you what that environment expects: requests, pyobjc, wxpython, pyinstaller, packaging, py_sip_xnu, py-applescript, markdown2, macos-pkg-builder and mac-signing-buddy. Note what that list implies. pyobjc and wxpython are macOS-bound, and mac-signing-buddy and macos-pkg-builder are packaging tools for signed macOS installers. There is no Windows path in these dependencies, which is why the related searches for a Windows version have no answer here: the project is built to run on a Mac. To set up a source checkout, the repository expects a Python environment populated from that file. The two top-level entry points are shell commands, OpenCore-Patcher-GUI.command for the graphical application and Build-Project.command for building the project.

bash
pip install -r requirements.txt
./OpenCore-Patcher-GUI.command

Running the GUI command starts the patcher interface; from there the guide walks through building and installing OpenCore to a target disk, then applying root patches after macOS is installed. The README is explicit that only clean installs and upgrades are supported, and that reinstalling macOS with this patcher retains your original data. It is equally explicit that a Big Sur install already patched with another patcher, naming Patched Sur and bigmac, cannot be used because of broken file integrity with APFS snapshots and SIP.

Where OpenCore Legacy Patcher fails or is the wrong tool

The most consequential limitation is the one buried in the first note: an existing patched Big Sur from Patched Sur or bigmac is a dead end. The README attributes this to broken file integrity with APFS snapshots and SIP, and the only documented remedy is reinstalling macOS, which the README says can retain your original data. That is not a migration path, it is a rebuild. The second limitation is support scope. The README says OCLP officially supports patching to run macOS Big Sur through Sonoma installs, and states that for older OSes OpenCore may function but support is not provided by Dortania. So a user on Mojave or Catalina should take the README's own advice and use dosdude1's patchers instead. Third, graphics support is not uniform. The credit list separates Metal from non-Metal patch sets and names specific GPU families, which means a machine outside those families gets a patched OS without accelerated graphics, or does not get there at all. Fourth, the support model is AS-IS: "we do not guarantee support for any issues that may arise." Help comes from a community Discord server, and the README directs people to the debugging documentation before asking. If you need a vendor SLA, this is the wrong project. Finally, the repository's LICENSE.txt is present but the license is reported as NOASSERTION, so anyone planning to redistribute a built patcher should read that file rather than assume terms.

OpenCore Legacy Patcher compared with dosdude1's patchers

The README itself names the alternative, which is unusual and useful. dosdude1's patchers cover macOS Mojave and Catalina, and Dortania recommends them for those releases. The difference in approach is structural. OCLP is built around OpenCorePkg and Lilu, so the boot environment is a configurable bootloader that handles SIP, FileVault 2, .im4m Secure Boot and Vaulting, and boots Recovery, Safe Mode and Single-user Mode on a non-native OS. The README also states OCLP requires zero firmware patching, explicitly no APFS ROM patching. dosdude1's work predates that architecture and is credited in the README as having laid out much of what needs to be patched, with dosdude1 also the main author of the original GUI. So the honest comparison is era-based rather than quality-based: use OCLP for Big Sur and newer on Penryn and later hardware, use dosdude1's patchers for Mojave and Catalina. The related search asking whether Clover or OpenCore is better is not answered by this repository, which builds on OpenCorePkg and does not discuss Clover.

Maintenance, upgrade cost and license position

The repository is not archived and the last push was on 2026-09-19, the same timestamp as the 2.5.1 release. The release history shows 2.5.1 on 2026-09-19, 2.5.0 on 2026-09-08, and 2.4.1 back on 2025-09-01. That gap between 2.4.1 and 2.5.0 is worth noting if you are planning around release cadence: roughly a year passed with no tagged release before the 2.5.x line arrived. The upgrade cost is real and recurring, because OCLP has to track Apple's macOS changes. The IOSurface offset patch for Sonoma 14.4 in the credits is a concrete example of a point release forcing new patch work. Native over the air system updates are listed as a feature, so the intended upgrade path is in-place, but a major macOS release can invalidate GPU patches and Wi-Fi patches until the maintainers catch up. Budget for that. On licensing, LICENSE.txt exists at the repository root and the license is reported as NOASSERTION. That means the repository does not present a machine-readable SPDX identifier, so read LICENSE.txt directly before redistributing anything, and note that the project bundles or references third-party components from Acidanthera and multiple patch authors whose terms are separate.

Editorial conclusion

Adopt OpenCore Legacy Patcher if you have a Penryn-era or newer Mac that Apple has dropped, you can work from the Dortania guide, and you accept that the project is offered AS-IS with community support on Discord. Do not adopt it for a machine that already runs a patched Big Sur from another patcher, since the README says broken APFS snapshot integrity and SIP make those installs unusable, and do not plan a Windows-based install, because the requirements.txt pulls in pyobjc and wxpython and the README points only at the Dortania guide for getting started. Before you start, verify three things: that your model is covered by the guide, that your GPU falls under the Metal or non-Metal patch sets the README credits, and that you can reinstall macOS while keeping your data, which the README explicitly allows.

Frequently asked questions

What is OpenCore Legacy Patcher for Mac?

It is a Python-based project built around Acidanthera's OpenCorePkg and Lilu that runs and unlocks features in macOS on supported and unsupported Macs. Its stated goal is installing and using macOS Big Sur and newer on machines as old as 2007, with support for Penryn and newer Macs.

Is OpenCore Legacy Patcher illegal?

The README makes no legal claim either way; it describes the project as offered on an AS-IS basis and points to a community Discord for help. The repository carries a LICENSE.txt file, and the license is reported as NOASSERTION, so read that file rather than assume terms.

Is OpenCore Legacy Patcher OCLP safe?

The README states the project is offered AS-IS and that support is not guaranteed for any issues that may arise. It also warns that Big Sur installs already patched with other patchers such as Patched Sur or bigmac cannot be used because of broken file integrity with APFS snapshots and SIP.

Can you use OpenCore Legacy Patcher on Windows?

The repository gives no Windows path. requirements.txt lists pyobjc, wxpython, macos-pkg-builder and mac-signing-buddy, and the README points to the Dortania guide and to SOURCE.md for running from source, with OpenCore-Patcher-GUI.command as the graphical entry point.

How do you install OpenCore Legacy Patcher?

The README directs users to the in-depth guide at dortania.github.io/OpenCore-Legacy-Patcher for getting started. For a source checkout, the repository documents running from source in SOURCE.md and lists dependencies in requirements.txt.

How do you use OpenCore Legacy Patcher to update macOS?

Native over the air system updates are listed as a feature, so the intended path is updating in place rather than reinstalling. The README supports clean installs and upgrades, and says reinstalling macOS with this patcher retains your original data.

Official sources

  1. dortania/OpenCore-Legacy-Patcher on GitHub
  2. Issues
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/dortania-opencore-legacy-patcher.svg)](https://hysenlabs.com/projects/dortania-opencore-legacy-patcher)