Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lzhoang2801/OpCore-Simplify

A tool designed to simplify the creation of OpenCore EFI
https://github.com/lzhoang2801/OpCore-Simplify

hackintosh hackintosh-efi lzhoang2601 lzhoang2801 macos opcore opcore-simplify opencore opencore-efi opencoresimplify

Last synced: 3 months ago
JSON representation

A tool designed to simplify the creation of OpenCore EFI

Awesome Lists containing this project

README

        




OpCore Simplify


A tool designed to simplify the creation of OpenCore EFI. It streamlines the Hackintosh installation process by automating tasks such as auto-patching DSDT, adding suitable kexts, and customizing the config.plist. Whether you're a beginner or experienced user, OpCore Simplify takes away much of the complexity associated with Hackintosh setups.




Report Bug
·
Request Feature


Table of Contents


  1. Features

  2. Support the Project

  3. Usage Guide

  4. Contributing

  5. License

  6. Acknowledgments & Credits

  7. Contact

---

## ✨ **Features**

1. **Automatic Updates**: Automatically check and update OpenCorePkg, kexts and AMD Vanilla Patches.

2. **Hardware Information Gathering**: Leverages the [Hardware Sniffer](https://github.com/lzhoang2801/Hardware-Sniffer) tool to gather detailed hardware information. It uses USB ID and PCI ID databases to ensure precise hardware compatibility checks.

3. **Comprehensive Hardware Support**: Fully supports most modern hardware (excluding legacy devices). Use the Compatibility Checker to view supported/unsupported devices.

4. **Enhanced ACPI Patching**: Add and customize various ACPI patches with integrated support from [SSDTTime](https://github.com/corpnewt/SSDTTime).

5. **Device-Specific Kexts**: Automatically identifies and adds kexts for devices like WiFi, ethernet, sound codec, Bluetooth, keyboard, mouse, touchpad, USB controller, and SATA controller based on their hardware IDs.

6. **Custom Tweaks**: Apply additional customization based on both widely used sources and personal experience.

---

### ☕ **Support the Project**:

If you love what I'm building, consider buying me a coffee! Your support fuels new features and improvements. ☕✨





Thank you for your support! Every little bit helps! 😊

---

## 🚀 **Usage Guide**

1. **Running OpCore Simplify**:
- On **Windows**, run `OpCore-Simplify.bat`.
- On **macOS**, run `OpCore-Simplify.command`.

2. **Selecting a Hardware Report**:
- Use [**Hardware Sniffer**](https://github.com/lzhoang2801/Hardware-Sniffer) to generate a hardware report and an ACPI dump.
- Select your hardware report (`Report.json`) and ACPI folder to proceed with configuration.

3. **Selecting macOS Version and Customizing EFI**:
- By default, the latest compatible macOS version will be selected for your hardware.
- OpCore Simplify will automatically apply essential ACPI patches and kexts.
- You can manually review and customize these settings as needed.

4. **Building OpenCore EFI**:
- Once you've customized all options, select **Build OpenCore EFI** to generate your EFI.
- The tool will automatically download the necessary bootloader and kexts, which may take a few minutes.

5. **USB Mapping**:
- After building your EFI, follow the steps for mapping USB ports.

6. **Create USB and Install macOS**: Follow the guide at [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/installer-guide/) and use the generated OpenCore EFI.
- For troubleshooting, refer to the [OpenCore Troubleshooting Guide](https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/troubleshooting.html).

#### Reference Resources

- [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide) (some parts may be outdated)
- [ChefKiss](https://chefkissinc.github.io/guides/hackintosh/) (dedicated to AMD CPU systems)

---

## 🤝 **Contributing**

Contributions 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.

Don't forget to ⭐ star the project! Thank you for your support! 🌟

---

## 📜 **License**

Distributed under the BSD 3-Clause License. See `LICENSE` for more information.

---

## 🙌 **Acknowledgments & Credits**

- [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.
- [SSDTTime](https://github.com/corpnewt/SSDTTime) – SSDT patching utilities.
- [Hardware Sniffer](https://github.com/lzhoang2801/Hardware-Sniffer) – For hardware information gathering.
- [USBToolBox](https://github.com/USBToolBox/tool) – A USB mapping tool.
- [ProperTree](https://github.com/corpnewt/ProperTree) – For editing `config.plist` files.

---

## 📞 **Contact**

**Hoang Hong Quan**
- Facebook: [@macforce2601](https://facebook.com/macforce2601)
- Telegram: [@lzhoang2601](https://t.me/lzhoang2601)
- Email: [email protected]