{"id":16973336,"url":"https://github.com/lzhoang2801/OpCore-Simplify","last_synced_at":"2026-02-19T03:30:17.769Z","repository":{"id":250388870,"uuid":"834074806","full_name":"lzhoang2801/OpCore-Simplify","owner":"lzhoang2801","description":"A tool designed to simplify the creation of OpenCore EFI","archived":false,"fork":false,"pushed_at":"2024-10-25T13:54:43.000Z","size":3516,"stargazers_count":246,"open_issues_count":2,"forks_count":17,"subscribers_count":9,"default_branch":"main","last_synced_at":"2024-10-25T15:13:13.320Z","etag":null,"topics":["hackintosh","hackintosh-efi","lzhoang2601","lzhoang2801","macos","opencore","opencore-efi","opencoresimplify"],"latest_commit_sha":null,"homepage":"https://lzhoang2801.github.io/gathering-files/opencore-efi","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lzhoang2801.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://buymeacoffee.com/lzhoang2801","https://paypal.me/lzhoang2601"]}},"created_at":"2024-07-26T11:10:31.000Z","updated_at":"2024-10-25T13:54:46.000Z","dependencies_parsed_at":"2024-10-26T20:08:16.611Z","dependency_job_id":null,"html_url":"https://github.com/lzhoang2801/OpCore-Simplify","commit_stats":null,"previous_names":["lzhoang2801/opcore-simplify"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhoang2801%2FOpCore-Simplify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhoang2801%2FOpCore-Simplify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhoang2801%2FOpCore-Simplify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhoang2801%2FOpCore-Simplify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lzhoang2801","download_url":"https://codeload.github.com/lzhoang2801/OpCore-Simplify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239838059,"owners_count":19705476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hackintosh","hackintosh-efi","lzhoang2601","lzhoang2801","macos","opencore","opencore-efi","opencoresimplify"],"created_at":"2024-10-14T01:01:11.439Z","updated_at":"2026-02-19T03:30:17.729Z","avatar_url":"https://github.com/lzhoang2801.png","language":"Python","readme":"\u003cbr/\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ch3 align=\"center\"\u003eOpCore Simplify\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A tool designed to simplify the creation of \u003ca href=\"https://github.com/acidanthera/OpenCorePkg\"\u003eOpenCore\u003c/a\u003e EFI. Whether you're a beginner or experienced user, OpCore Simplify takes away much of the complexity associated with Hackintosh setups.\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#-how-to-use\"\u003eHow To Use\u003c/a\u003e •\n    \u003ca href=\"#-contributing\"\u003eContributing\u003c/a\u003e •\n    \u003ca href=\"#-license\"\u003eLicense\u003c/a\u003e •\n    \u003ca href=\"#-credits\"\u003eCredits\u003c/a\u003e •\n    \u003ca href=\"#-contact\"\u003eContact\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003e [!IMPORTANT]\n\u003e If the installation process is successful using OpCore Simplify, please confirm it at [Successful Hackintosh Setup with OpCore Simplify](https://github.com/lzhoang2801/OpCore-Simplify/discussions/23). \n\u003e This will greatly assist others in the community.\n\u003e\n\u003e Whatever the outcome, just enjoy what an automated tool can accomplish!\n\n## ✨ **Features**\n\n1. **Comprehensive Hardware and macOS Support**  \n   Fully supports modern hardware. Use `Compatibility Checker` to check supported/unsupported devices and macOS version supported.\n\n   | **Component**  | **Supported**                                                                                       |\n   |----------------|-----------------------------------------------------------------------------------------------------|\n   | **CPU**        | Intel: Nehalem and Westmere (1nd Gen) → Arrow Lake (15th Gen/Core Ultra Series 2) \u003cbr\u003e AMD: Ryzen and Threadripper with [AMD Vanilla](https://github.com/AMD-OSX/AMD_Vanilla) |\n   | **GPU**        | Intel iGPU: Iron Lake (1nd Gen) → Ice Lake (10th Gen) \u003cbr\u003e AMD APU: The entire Vega Raven ASIC family (Ryzen 1xxx → 5xxx, 7x30 series) \u003cbr\u003e AMD dGPU: Navi 23, Navi 22, Navi 21 generations, and older series \u003cbr\u003e NVIDIA: Kepler, Pascal, Maxwell, Fermi, Tesla generations |\n   | **macOS**      | macOS High Sierra → macOS Sequoia |\n\n2. **ACPI Patches and Kexts**  \n   Automatically detects and adds ACPI patches and kexts based on hardware configuration.\n   \n   - Integrated with [SSDTTime](https://github.com/corpnewt/SSDTTime) for common patches (e.g., FakeEC, FixHPET, PLUG, RTCAWAC).\n   - Includes custom patches:\n      - Prevent kernel panics by directing the first CPU entry to an active CPU, disabling the UNC0 device, and creating a new RTC device for HEDT systems.\n      - Disable unsupported or unused PCI devices, such as the GPU (using Optimus and Bumblebee methods or adding the disable-gpu property), Wi-Fi card, and NVMe storage controller.\n      - Fix sleep state values in _PRW methods (GPRW, UPRW, HP special) to prevent immediate wake.\n      - Add devices including ALS0, BUS0, MCHC, PMCR, PNLF, RMNE, IMEI, USBX, XOSI, along with a Surface Patch.\n      - Enable ALSD and GPI0 devices.\n\n3. **Automatic Updates**  \n    Automatically checks for and updates OpenCorePkg and kexts from [Dortania Builds](https://dortania.github.io/builds/) and GitHub releases before each EFI build.\n\n   - All download links are stored in `bootloader_kexts_data.json`.\n            \n4. **EFI Configuration**  \n   Apply additional customization based on both widely used sources and personal experience.\n\n   - Spoof GPU IDs for certain AMD GPUs not recognized in macOS.\n   - Use CpuTopologyRebuild kext for Intel CPUs with P-cores and E-cores to enhance performance.\n   - Disable System Integrity Protection (SIP).\n   - Spoof CPU IDs for Intel Pentium, Celeron, Core, and Xeon processors.\n   - Add custom CPU names for AMD CPUs, as well as Intel Pentium, Celeron, Xeon, and Core lines from the Rocket Lake (11th) generation and newer.\n   - Add a patch to allow booting macOS with unsupported SMBIOS.\n   - Add NVRAM entries to bypass checking the internal Bluetooth controller.\n   - Properly configure ResizeAppleGpuBars based on specific Resizable BAR information.\n   - Allow flexible iGPU configuration between headless and driving a display when a supported discrete GPU is present.\n   - Force Intel GPUs into VESA mode with HDMI and DVI connectors to simplify installation process.\n   - Use random layout IDs have comment based on author or motherboard brand for better sound quality.\n   - Provide configuration required for using OpenCore Legacy Patcher.\n   - Add built-in device property for network devices (fix 'Could not communicate with the server' when using iServices) and storage controllers (fix internal drives shown as external).\n   - Prioritize SMBIOS optimized for both power management and performance.\n   - Re-enable CPU power management on legacy Intel CPUs in macOS Ventura 13 and newer.\n\n   and more...\n\n5. **Easy Customization**  \n   In addition to the default settings applied, users can easily make further customizations if desired.\n\n   - Custom ACPI patches, kexts, and SMBIOS adjustments (**not recommended**).\n   - Force load kexts on unsupported macOS versions.\n   - Support AirportItlwm on macOS Sequoia 15 with **temporary workaround**. Manually select AirportItlwm, IOSkywalkFamily IO80211FamilyLegacy and AMFIPass kexts, then apply the root patch from OpenCore Legacy Patcher.\n\n## 🚀 **How To Use**\n\n1. **Download OpCore Simplify**:\n   - Click **Code** → **Download ZIP**, or download directly via this [link](https://github.com/lzhoang2801/OpCore-Simplify/archive/refs/heads/main.zip).  \n   - Extract the downloaded ZIP file to your desired location.\n\n   ![Download OpCore Simplify](https://i.imgur.com/mcE7OSX.png)\n\n2. **Running OpCore Simplify**:\n   - On **Windows**, run `OpCore-Simplify.bat`.\n   - On **macOS**, run `OpCore-Simplify.command`.\n\n   ![OpCore Simplify Menu](https://i.imgur.com/vTr1V9D.png)\n\n3. **Selecting hardware report**:\n   - On Windows, there will be an option for `E. Export hardware report`. It's recommended to use this for the best results with your hardware configuration and BIOS at the time of building.\n   - Alternatively, use [**Hardware Sniffer**](https://github.com/lzhoang2801/Hardware-Sniffer) to create a `Report.json` and ACPI dump for configuration manully.\n\n   ![Selecting hardware report](https://i.imgur.com/MbRmIGJ.png)\n\n   ![Loading ACPI Tables](https://i.imgur.com/SbL6N6v.png)\n\n   ![Compatibility Checker](https://i.imgur.com/kuDGMmp.png)\n\n4. **Selecting macOS Version and Customizing OpenCore EFI**:\n   - By default, the latest compatible macOS version will be selected for your hardware.\n   - OpCore Simplify will automatically apply essential ACPI patches and kexts. \n   - You can manually review and customize these settings as needed.\n\n   ![OpCore Simplify Menu](https://i.imgur.com/TSk9ejy.png)\n\n5. **Building OpenCore EFI**:\n   - Once you've customized all options, select **Build OpenCore EFI** to generate your EFI.\n   - The tool will automatically download the necessary bootloader and kexts, which may take a few minutes.\n\n   ![Building OpenCore EFI](https://i.imgur.com/deyj5de.png)\n\n6. **USB Mapping**:\n   - After building your EFI, follow the steps for mapping USB ports.\n\n   ![Results](https://i.imgur.com/MIPigPF.png)\n\n7. **Create USB and Install macOS**: \n   - Use [**UnPlugged**](https://github.com/corpnewt/UnPlugged) on Windows to create a USB macOS installer, or follow [this guide](https://dortania.github.io/OpenCore-Install-Guide/installer-guide/mac-install.html) for macOS.\n   - For troubleshooting, refer to the [OpenCore Troubleshooting Guide](https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/troubleshooting.html).\n\n\u003e [!NOTE]\n\u003e 1. After a successful installation, if OpenCore Legacy Patcher is required, simply apply root patches to activate the missing features (such as modern Broadcom Wi-Fi card and graphics acceleration).\n\u003e \n\u003e 2. For AMD GPUs, after applying root patches from OpenCore Legacy Patcher, you need to remove the boot argument `-radvesa`/`-amd_no_dgpu_accel` for graphics acceleration to work.\n\n## 🤝 **Contributing**\n\nContributions are **highly appreciated**! If you have ideas to improve this project, feel free to fork the repo and create a pull request, or open an issue with the \"enhancement\" tag.\n\nDon't forget to ⭐ star the project! Thank you for your support! 🌟\n\n## 📜 **License**\n\nDistributed under the BSD 3-Clause License. See `LICENSE` for more information.\n\n## 🙌 **Credits**\n\n- [OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) and [kexts](https://github.com/lzhoang2801/OpCore-Simplify/blob/main/Scripts/datasets/kext_data.py) – The backbone of this project.\n- [SSDTTime](https://github.com/corpnewt/SSDTTime) – SSDT patching utilities.\n\n## 📞 **Contact**\n\n**Hoang Hong Quan**\n\u003e Facebook [@macforce2601](https://facebook.com/macforce2601) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e Telegram [@lzhoang2601](https://t.me/lzhoang2601) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e Email: lzhoang2601@gmail.com\n\n## 🌟 **Star History**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=lzhoang2801/OpCore-Simplify\u0026type=Date)](https://star-history.com/#lzhoang2801/OpCore-Simplify\u0026Date)\n","funding_links":["https://buymeacoffee.com/lzhoang2801","https://paypal.me/lzhoang2601"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzhoang2801%2FOpCore-Simplify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flzhoang2801%2FOpCore-Simplify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzhoang2801%2FOpCore-Simplify/lists"}