Skip to content

YBronst/OCLP-Plus

Repository files navigation

🌟 Key Features

🏔️ Full macOS Tahoe Support

  • Modern root patching support for macOS Tahoe 26.0 (25A5316i) through macOS 26.4.1 (25E253) and later versions.

  • Supported Mac Models (SMBIOS): For macOS Tahoe, this patch set is designed for the following native or spoofed models:

    • iMac: iMac20,1, iMac20,2
    • MacBook Pro: MacBookPro16,1, MacBookPro16,2, MacBookPro16,4
    • Mac Pro: MacPro7,1
  • Legacy root patching support for macOS Sequoia 15.7.5 (24G624) and earlier, as in OpenCore Legacy Patcher 2.4.1.

  • Note: For macOS Sequoia and earlier, compatibility and SMBIOS requirements follow the standard limits of each respective operating system.

📶 Wireless & Continuity

  • Restores full functionality for Broadcom-based wireless chipsets (BCM4360 and similar), including:

    • AWDL support specifically for macOS Tahoe 26.x.
    • Stable Wi-Fi (2.4GHz / 5GHz).
    • AirDrop, Handoff, and AirPlay via fully synchronized frameworks.

🚫 Intel Wi-Fi (AirportItlwm) is NOT supported

  • This fork is exclusively optimized for Broadcom-based wireless chipsets.
    • If you require Intel Wi-Fi patches for Tahoe, please use OCLP-Mod.

🔊 Modern Audio (AppleHDA Restoration)

Starting with macOS Tahoe Beta 2, Apple removed the legacy AppleHDA.kext. This patch set brings it back, ensuring built-in audio works on supported legacy systems.

  • Manual Toggle: A new "Modern Audio" toggle in the Root Patches menu allows you to enable or disable this restoration manually.
  • KDK Integration: Automatically handles the necessary Kernel Debug Kit (KDK) requirements for audio driver linking.

🛠️ macOS 26.4 Compatibility Fixes

  • APFS-Only Environment: Adapted the patching logic to handle the removal of HFS+ in macOS 26.4. The patcher now utilizes APFS for all internal resource mounting and operations.

Elevated hdiutil Permissions: Fixed a critical issue where macOS 26.4 disallowed mounting disk images without root privileges.

The patcher now correctly escalates via the Privileged Helper Tool.

⚠️ Important Technical Notes

  • Graphics patches for Deprecated accelerators in Tahoe are officially impossible. Use Sequoia for full acceleration.

🔑 AMFI & Security

  • AMFI Alert: To successfully bypass Apple Mobile file integrity checks, you must use AMFIPass.kext with the -amfipassbeta boot argument.
  • Note: If third-party browsers (e.g., Firefox) or camera/mic permissions fail, ensure the -amfipassbeta boot argument is present.
  • SIP Requirements: System Integrity Protection must be set properly.
  • Typical Value: (CSR_ALLOW_UNTRUSTED_KEXTS | CSR_ALLOW_UNRESTRICTED_FS).
  • OpenCore config.plist: NVRAM > Add > 7C436110-AB2A-4BBB-A880-FE41995C9F82 > csr-active-config (data) <03080000>.
  • Clover config.plist: Set RtVariables > CsrActiveConfig (string) 0x803.
  • Secure Boot Model: To allow root patching for Wi-Fi and other drivers, Apple Secure Boot must be disabled.
  • OpenCore: Set Misc > Security > SecureBootModel to Disabled.

Clover: Ensure RtVariables > HWTarget is NOT set (must be empty) or commented out (e.g., HWTarget?) to keep Apple Secure Boot inactive.

🔄 Apply Changes: Reset NVRAM

To ensure these new security settings (SIP, AMFI, and Secure Boot) take effect, you MUST perform a Reset NVRAM after saving your config.plist. OpenCore: Select "Reset NVRAM" from the boot picker menu (or press Space if it's hidden). Clover: Press F11 at the boot screen to clear NVRAM and restart.

💾 Installation Requirements

💡 Before Running Post-Install Patches:

  • KDK is mandatory: For macOS 13 through Tahoe (26.x), the Kernel Debug Kit must be installed for drivers like AppleHDA to link correctly. Use the Help > Download KDK button.

⚠️ Resource Dependency Notice

  • Patcher Resources: This version relies on the PatcherSupportPkg for native Tahoe binaries.

Important: Please be aware that if this resource becomes unavailable for any reason (e.g., server downtime or repository removal), the OCLP-3.1.9 Tahoe Patch Set will lose its ability to fetch the necessary binaries, and root patching will fail.

📜 Credits

⚖️ Disclaimer

This is an experimental Project intended for advanced users and complex Hackintosh/Legacy Mac configurations. Use at your own risk.

Community Discussion: InsanelyMac Thread

About

The OCLP-Plus (Tahoe Patch Set), optimized for macOS 26.x, being a deep evolution of lzhoang2801's original OpenCore-Legacy-Patcher. https://github.com/lzhoang2801/OpenCore-Legacy-Patcher

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors

Languages