OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

Overview

OC-Little is a comprehensive resource for OpenCore users, offering ACPI hotpatch samples, guides, and fixes to enhance macOS compatibility on hackintosh systems. This repository, based on OC-Little by Daliansky, provides translated and expanded content, focusing on achieving a "Real Vanilla Hackintosh" experience while maintaining ACPI compliance.

• Disclaimer
• About OC-Little
• Translation Notes

Core Guides

ACPI and Device Configuration

• ACPI Basics and Guides
• Adding Missing Devices and Enabling Features with SSDTs
• Disabling Devices
• MMIO Whitelist
• Merging SSDTs into a sigle file (SSDT-ALL)

System Fixes

• Fixing Graphics (Integrated/Discrete)
• Fixing USB
• Fixing Sleep and Wake Issues
• Fixing Peripherals
• Fixing Falsely Reported RAM Speed
• CMOS-Related Fixes

Laptop-Specific

• Laptop-Specific Patches

Boot and Kext Management

• Boot Arguments Explained
• Kext Loading Sequence Examples
• Compiling Slimmed-Down Variants of Kexts
• BOOT Folder Configuration

Advanced Configuration

OpenCore Configuration

• Config Tips & Tricks
• Quirks
• EFI Upload Checklist
• OpenCore Calculators
• Featured OpenCanopy Themes
• Board-ID check skip and VMM Spoof
• ProperTree Secrets

OpenCore Auxiliary Tools (OCAT)

• Updating OpenCore
• Switching to NO_ACPI Build of OpenCore
• Generating EFIs with OCAT

macOS-Specific

• Terminal Commands
• Compatibility Charts
• Fixing System Update Notifications
• macOS 14.4 Install Workaround
• Creating a Multi-macOS USB Installer
• macOS Virtualization

Other Operating Systems

• Windows-Related Guides
• Enabling Linux Boot Entries

Special Topics

• Generating OpenCore EFIs with OpCore Simplify
• Using OpenCore-Patcher on Wintel Machines
• Creating/Modifying a Layout-ID for AppleALC
• Debugging with SysReport
• Using Clover Alongside OpenCore
• Utilities and Resources

Disclaimer

1. Not an Installation Guide: OC-Little is not a guide for installing macOS. For that, refer to Dortania's OpenCore Install Guide. This repository provides supplementary guides, fixes, and explanations for hackintosh systems.
2. ACPI Compliance: OC-Little emphasizes methods that maintain ACPI compliance, avoiding techniques like DSDT patching, which deviate from a "Real Vanilla Hackintosh" experience. See this discussion on InsanelyMac for more details.

About OC-Little

OC-Little is a collection of ACPI hotpatches, binary renames, and guides for OpenCore, translated from Daliansky's OC-Little. It complements Dortania's OpenCore Guides and covers topics like ACPI basics, device enabling, USB mapping, graphics fixes, and more. While tailored for OpenCore, most SSDTs and techniques are compatible with Clover.

Translation Notes

• Translation Process: Uses AI-based tools (DeepL, Google Translate) with manual copyediting for accuracy.
• Restructuring: Organized into logical sections based on issue types, components, and methods.
• Improvements: Rewritten confusing sections (e.g., ACPI, USB Port Mapping), added missing descriptions, and included new content (e.g., USB Port Mapping via ACPI, Chapters 7–14, and the Appendix).
• Accuracy Note: As the translator does not speak Chinese, minor inaccuracies may exist.

Contributions

To contribute, create an issue with a clear title, link to the relevant chapter/section, and describe your proposed additions, changes, or corrections.

Star History

OC Commits Over Time

The chart below shows commit frequency for Acidanthera's OpenCorePkg repository from 2019 to June 6, 2025:

Acknowledgments

• Contributors: Thanks to all contributors for improving this repo. Additional credits are listed in relevant chapters.
• Special Thanks:
  • sascha_77: For Kext Updater, ANYmacOS, and BIOS unbricking assistance.
  • Apfelnico: For introducing ASL/AML basics.
  • Bluebyte: For insightful discussions.
  • Cyberdevs: For the Z170X Gaming 5 Guide and exemplary moderation.
• Daliansky's Original Credits:
  • XianWu: For ACPI component patches.
  • Bat.bat, DalianSky, athlonreg, iStar丶Forever: For proofreading and finalization.
  • Additional Credits: 冬瓜-X1C5th, OC-xlivans, Air 13 IWL-GZ-Big Orange, 子骏oc IWL, 大勇-小新air13-OC-划水小白, xjn819, and Acidanthera for OpenCorePkg.