:-26.07.27-blueviolet.svg){kind=icon}
OC-Little Translated started as a translated adaptation of Daliansky's OC-Little but has since grown far beyond its origins into an independently expanded reference. What began as a translation project now covers substantially more ground than the original — with new chapters, a complete Appendix (A–Z), rewritten sections, and ongoing additions reflecting the latest developments in the Hackintosh scene. 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 applicable to Clover bootloader as well.
-
🚫 Not an Installation or Configuration Guide
This is not a macOS installation nor OC Configuration guide. For setting up OpenCore for macOS usage on a Wintel System, use the OpenCore Install Guide. OC-Little focuses primarily on post-install tuning and hardware enablement.
-
✅ ACPI-Compliant Methods Only This project avoids DSDT patching and other invasive mods. It adheres to the philosophy of a clean, vanilla Hackintosh using only ACPI hotpatching. For more on this philosophy, see this InsanelyMac thread.
- Translation Process: Uses AI-based tools (DeepL, Google Translate) with manual copyediting for accuracy.
- Restructuring: Organized the repo into logical sections based on issue types, components, and methods.
- Expansion: Extended well beyond the original scope — added Chapters 7–20 and a full Appendix A–Z, none of which exist in Daliansky's original repo.
- Improvements: Rewritten confusing sections (e.g., ACPI, USB Port Mapping), added missing descriptions, and included new content such as USB Port Mapping via ACPI.
- Accuracy Note: As the translator does not speak Chinese, minor inaccuracies in the translated portions may exist.
- 🧠 ACPI Basics and Guides
- ➕ Adding Missing Devices (SSDTs)
- ➖ Disabling Devices
- 🧩 Populating the MMIO Whitelist
- 🧷 Merging SSDTs into one table
- 💻 Fixing CPU Power Management
- 🎮 Fixing Graphics (iGPU/dGPU/APU)
- 🔌 Fixing USB
- 😴 Fixing Sleep & Wake
- 🔄 Fixing OTA System Updates
- 🖱️ Fixing issues with peripherals
- 🧮 Fixing RAM Speed Reporting
- 🔋 CMOS-Related Fixes
- 🛠️ macOS 14.4+ Install Workaround
- 💻 Laptop Patches (Battery, FN keys, etc.)
- 🖥️ Modifying Framebuffer Patch for detecting External Displays
- ⚙️ Boot-Args Explained
- 📦 Kext Loading Order Examples
- 📡 Sensor Plugins for Monitoring
- 🧬 Compiling Slimmed-Down Kexts
- 🗂️ BOOT Folder Configuration
- 💡 Config Tips & Tricks
- 🎛️ Quirks Explained
- 📋 EFI Upload Checklist
- 🧮 OpenCore Calculators
- 🎨 Featured OpenCanopy Themes
- 🧠 Tips for working with ProperTree
- 🔄 Updating OpenCore with OCAT
- 💡 OCAT Tips & Tricks
- 🧰 Generating EFIs with OCAT
- 🚫 Switching to NO_ACPI Build
- 🧼 Using OCLP on Wintel PCs
- 🧰 Generating EFIs with OpCore Simplify
- 🎧 Creating a custom AppleALC Layout-ID
- 🔀 Using Clover & OpenCore Together
- 🧃 Utilities & Resources
- 💻 List of helpful Terminal Commands
- 🖥️ AI-Assisted OpenCore Bootlog Analysis & Config Optimization
- 📄 Converting Spindumps to Text for Further Analysis
- 🐛 Debugging with SysReport
- 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.