mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-04-13 20:28:21 +10:00
565589ae50962b5394ace5565d1833edc7c3c47f
OpenCore Legacy Patcher
A python script for building and booting OpenCore on legacy Macs, see Supported SMBIOS on whether your model is supported.
Supported features:
- System Integrity Protection, FileVault 2 and .im4m Secure Boot
- Native OTA OS updates
- Recovery OS, Safe Mode and Single-user Mode booting
- Zero firmware patching required(ie. APFS ROM patching)
- GPU Switching on MacBook Pro models(2012 and newer)
Note: Only clean-installs and upgrades are supported, installs already patched with Patched-Sur or bigmac cannot be used due to broken file integrity with APFS snapshots and SIP.
- You can however reinstall macOS with this patcher and retain your original data
How to use
To use, simply:
- Ensure your hardware is compatible(See Supported SMBIOS)
- Download and build macOS Installer
- Download the latest release: OpenCore Legacy Patcher Releases
- Run the
OpenCore-Patcherbinary - Run
Build OpenCore(if building for another machine, please selectChange Model)
| First Run | Build EFI |
|---|---|
![]() |
![]() |
- Run
Install OpenCore to USB/internal drive
| Select Drive | Select EFI/FAT32 Partition |
|---|---|
![]() |
![]() |
- Ensure you install OpenCore onto a FAT32 partition to ensure your Mac is able to boot it, you may need to format your drive as GUID/GPT in Disk Utility
- Reboot machine while holding
Optionto select OpenCore, then boot the macOS Installer
| Mac Boot Picker | OpenCore Picker |
|---|---|
![]() |
![]() |
For nightly builds, you can either run OpenCore-Patcher.command from main or grab the binary from Github Actions. Note the latter does not require a py3 install.
How to uninstall OpenCore?
To remove OpenCore is actually quite simply:
- Remove OpenCore either from the USB or internal drive
- You'll need to mount the drive's EFI partition, and delete the EFI folder
- See here for example how to mount
- Reset NVRAM
Know that if you are on Big Sur when you remove the EFI folder, your Mac will no longer boot and show the prohibited symbol. Be ready to install an older version of macOS before you uninstall Open Core.
Troubleshooting
Languages
Python
95.4%
Shell
3.3%
ASL
0.9%
Objective-C
0.4%





