Skip to content

OpenCore Legacy Patcher - Tahoe Patch Set based on commit lzhoang2801 from December 24, 2025, and adapts it to the new macOS Tahoe environment.

License

Notifications You must be signed in to change notification settings

YBronst/OpenCore-Legacy-Patcher

Repository files navigation

OpenCore Legacy Patcher 3.1.6 - Tahoe Patch Set (YBronst)

This project continues the Tahoe patch set based on commit lzhoang2801 from December 24, 2025, and adapts it to the new macOS Tahoe environment.

Important Compatibility Notice

This repository supports:

  • macOS Tahoe 26.0 – 26.3
  • Support for macOS Tahoe 26.4 and later will be implemented as soon as possible

Important

Starting with macOS 26.4 beta 1, Apple made significant changes to the system update process. The previous Tahoe update process cannot function without modifications in these versions.

In particular:

  • Previous handling of HFS-based patch images is no longer accepted by the OS.
  • Mounting images via hdiutil now requires elevated privileges and cannot be executed in a normal user context. Because of this, the original OCLP 3.0.0 Nightly workflow cannot complete the root patch installation process on macOS 26.4 without modification.

Key Changes in 3.1.6

Added a toggle to the 'Root Patches' sector to enable/disable the 'Modern Audio' patch for AppleHDA restoration. This prevents unrecoverable kernel panics in macOS Tahoe without an installed KDK.

Key Changes in 3.1.5

  • Backward compatibility with macOS Tahoe 26.0–26.3 has been preserved.
  • Patch image processing has been migrated to APFS for compatibility with macOS 26.4.
  • Privileged mount logic has been added, which is necessary for accessing internal patch images and system resources.
  • AMFIPass cannot be used with OCLP 3.1.5 due to a persistent kernel panic. Instead, use amfi=0x80 boot argument and handling application permissions based on tccplus.

Modern Audio (AppleHDA)

On macOS 26.4 beta 1, installing the Modern Audio patch is temporarily not recommended until the corresponding kernel debug kit (KDK) becomes available.

For systems requiring a fully functional reference environment (including sound) on macOS 26.3 and earlier, I recommend a saved and working patch snapshot from December 24th, available here: OCLP-lzhoang2801

Note: This patch set still requires the amfi=0x80 boot argument.


Credits

  • Acidanthera
    • OpenCorePkg, as well as many of the core kexts and tools
  • DhinakG
    • Main co-author
  • Khronokernel
    • Main co-author
  • Ausdauersportler
    • iMacs Metal GPUs Upgrade Patch set and documentation
    • Great amounts of help with debugging, and code suggestions
  • vit9696
    • Endless amount of help troubleshooting, determining fixes and writing patches
  • EduCovas
  • ASentientHedgehog
    • non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
  • ASentientBot
  • cdf
  • Syncretic
  • dosdude1
    • Main author of the original GUI
    • Development of previous patchers, laying out much of what needs to be patched
  • parrotgeek1
  • BarryKN
    • Development of previous patchers, laying out much of what needs to be patched
  • mario_bros_tech and the rest of the Unsupported Mac Discord
    • Catalyst that started OpenCore Legacy Patcher
  • arter97
    • SimpleMSR to disable firmware throttling in Nehalem+ MacBooks without batteries
  • Mr.Macintosh
    • Endless hours helping architect and troubleshoot many portions of the project
  • flagers
    • Aid with Nvidia Web Driver research and development
    • non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
    • Metal bundle interposer for AMD GCN 1 - 5 and Intel Core 5th/6th Generation GPUs
    • LegacyRVPL, SnapshotIsKill, etc. to aid in rapid testing and development
  • joevt
  • Jazzzny
    • Research and various contributions to the project
    • UEFI Legacy XHCI research and development
    • NVIDIA OpenCL research and development
    • MacBook5,2 research and development
      • LegacyKeyboardInjector
    • Pre-Ivy Bridge Aquantia Ethernet Patch
    • Non-Metal Photo Booth Patch for Monterey+
    • GUI and Backend Development
      • Updater UI
      • macOS Downloader UI
      • Downloader UI
      • USB Top Case probing
      • Developer root patching
    • Vaulting implementation
    • macOS 15 3802 Helios Research
    • UEFI bootx64.efi research
    • universal2 build research
    • Various documentation contributions
  • Amazing users who've graciously donate hardware:
  • MacRumors and Unsupported Mac Communities
    • Endless testing and reporting issues
  • Apple
    • for macOS and many of the kexts, frameworks and other binaries we reimplemented into newer OSes

Disclaimer

This is not an official Dortania release and is intended for complex Hackintosh configurations.

Thanks to:

  • Dortania OCLP team
  • lzhoang2801
  • All PatcherSupportPkg contributors

Community discussion: InsanelyMac thread

About

OpenCore Legacy Patcher - Tahoe Patch Set based on commit lzhoang2801 from December 24, 2025, and adapts it to the new macOS Tahoe environment.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Languages