# OC-Little Translated: ACPI hotpatch samples for OpenCore beyond the install guide > OC-Little Translated is a reference and sample collection of ACPI hotpatches for OpenCore on Intel Macs, covering sleep and wake, graphics, USB, CPU power management, boot arguments and much more, deliberately avoiding DSDT patching. It suits a Hackintosh user who already has a working install and wants to fix specific hardware behaviours, and it is not a guide to installing macOS in the first place. **5T33Z0/OC-Little-Translated** — ACPI hotpatches, fixes, and guides for OpenCore. Optimize your Hackintosh and run macOS 13+ on Wintel PCs with OpenCore Legacy Patcher. - Repository: https://github.com/5T33Z0/OC-Little-Translated - Stars: 746 · Forks: 92 - Language: ASL - License: BSD-3-Clause - Published: 2026-10-21 · Updated: 2026-10-21 · Language: en - Canonical page: https://hysenlabs.com/projects/5t33z0-oc-little-translated ## A post-install tuning manual, and it insists on that framing OC-Little Translated is a collection of ACPI hotpatches, fixes and guides for OpenCore, aimed at people running macOS on Intel PCs through OpenCore Legacy Patcher. The project is written in ASL, which is the source language for ACPI tables, and the repository is dominated by a Content directory of Markdown chapters with the SSDT samples beside them. The first thing the README does is set boundaries, and that boundary is the most useful thing about the project. It says plainly that this is not a macOS installation nor an OpenCore configuration guide, and that for setting up OpenCore for macOS on an Intel system you should use the Dortania OpenCore Install Guide. What OC-Little focuses on is post-install tuning and hardware enablement. That division of labour is what makes the project usable rather than confusing. Dortania's guide takes you from an empty USB stick to a booted system. This repository assumes the system boots and asks a different question: why does sleep fail, why does the external display stay black on wake, why is the CPU running at a low frequency, why does the touchpad work but not the fingerprint reader. Each of those is a chapter. The second boundary is a method constraint. The project avoids DSDT patching and other invasive modifications, and states that it adheres to the philosophy of a clean, vanilla Hackintosh using only ACPI hotpatching, with a link to a thread on that philosophy. In practice this means the fixes are SSDT tables dropped into the ACPI folder of the EFI, which is the approach that tends to survive a macOS update, rather than edits to the original DSDT that get overwritten. ## From a translation project into a reference of its own The history matters for evaluating the content, because it explains both the breadth and the caveats. OC-Little Translated started as a translated adaptation of Daliansky's OC-Little, and the README says it 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 from A to Z, rewritten sections and ongoing additions reflecting recent developments in the Hackintosh scene. The extension is quantified. The project states that it added Chapters 7 to 20 and a full Appendix A to Z, none of which exist in the original repository, that it rewrote confusing sections such as the ACPI and USB Port Mapping ones, added missing descriptions, and included new content such as USB Port Mapping via ACPI. It is described as complementary to Dortania's OpenCore Guides, covering topics like ACPI basics, device enabling, USB mapping and graphics fixes. One practical note is included: while the project is tailored for OpenCore, most SSDTs and techniques apply to Clover as well. Two caveats come with that, and they are stated rather than hidden. The translation process uses AI based tools, DeepL and Google Translate, with manual copyediting for accuracy. And the accuracy note says that as the translator does not speak Chinese, minor inaccuracies in the translated portions may exist. That second caveat is the one to hold in mind. The original text was written in Chinese, and the parts this project inherited are a machine-assisted translation of it that the maintainer has copyedited without being able to read the source language. The chapters written in English from scratch do not have that problem, and the distinction is not marked per chapter. ## The chapter map is the index of what goes wrong in practice The Content directory is organised by the symptom you are trying to fix rather than by subsystem, and the top level index in the README is effectively a table of contents for a Hackintosh support forum. The ACPI and devices group covers ACPI basics and guides, adding missing devices and enabling features, disabling devices, populating the MMIO whitelist, and a page on merging single SSDTs into one table, which is a practical technique for keeping the ACPI folder small and for avoiding a name clash between two tables that both define the same device. The system fixes group is the part most people will use. There is a chapter on fixing CPU power management, one on fixing graphics covering iGPU, dGPU and APU, one on fixing USB, one on fixing sleep and wake issues, one on fixing OTA system updates, one on peripherals, one on RAM speed reporting, one on CMOS related fixes, and a macOS 14.4 and later install workaround. There is also a laptop specific section covering battery and function key patches, and a page on modifying the framebuffer patch so that external displays are detected. The boot and kext group covers boot arguments explained, kext loading order examples, sensor plugins for monitoring, compiling slimmed down kexts, and BOOT folder configuration. The advanced configuration group covers config tips and tricks, Quirks explained, an EFI upload checklist, OpenCore calculators, featured OpenCanopy themes, and tips for working with ProperTree. There is also a chapter on AI assisted OpenCore bootlog analysis and config optimisation, and a chapter on converting spindumps to text. The last of these tells you something about where the project is going: it is starting to treat the accumulated knowledge as something to feed to a tool. ## Where ACPI hotpatching differs from editing the DSDT The core technical decision of this project is the one stated in the disclaimer, and it is worth explaining because it determines how the fixes behave over time. DSDT patching means extracting the original ACPI table from your firmware, decompiling it, editing it in a text editor, and injecting the modified table into the EFI. The result can express anything, because you are rewriting the machine's own description of its hardware. The cost is fragility. A firmware update replaces the DSDT, and a macOS update can change what the original table needs to say, so a patch that was correct becomes wrong, and the fix is silent until something stops working. ACPI hotpatching works at a different level. Instead of editing the existing table, you add new tables, usually SSDTs, that define or override specific devices. The original DSDT is left alone, and the new tables sit alongside it. When macOS updates and the firmware stays the same, the added tables continue to describe the same devices. That is why the project calls this a clean, vanilla Hackintosh approach, and why it explicitly declines to do DSDT patching and other invasive modifications. The tradeoff is expressiveness. A hotpatch can add a device that is missing, or redefine the properties of one, but it cannot restructure the machine's whole ACPI description. Some problems are only solvable by editing the original table, and those are outside the scope here. The project is honest about the boundary rather than pretending a hotpatch can do anything. The compilation tool is IASL, and the ASL sources in the repository are what you compile into the binary SSDT files that the OpenCore config references. ## Practicalities: version badges, tools, and where the work is actually done Several details in the README affect how you should treat the content. The version badges matter most. The project declares support for OpenCore up to 1.0.9 and macOS up to 26.x, with a last update stamp of 2026-10-16, and the last push was on 2026-10-21. An ACPI patch interacts with the bootloader and the operating system in ways that change between releases, so a chapter written against one OpenCore version can be wrong for another. The badges are the project's own statement of the range it is current for, and they are the first thing to check. The tooling is named throughout. OpenCore Auxiliary Tools, OCAT, has a chapter on updating OpenCore and one on generating EFIs, and there is a separate page on switching to a NO_ACPI build. OpenCanopy themes, ProperTree, and a chapter on generating EFIs with OpCore Simplify all appear. A boot-args chapter and a Quirks chapter cover the parts of the configuration that are most often guessed at rather than understood. The repository is a document set rather than a software project, and that is visible in the layout. The top level holds a Content directory, a Terminal_Commands.md file with a list of helpful terminal commands, the LICENSE, the README and some Git configuration files. There is no build system, no test suite and no package to install, and the last update is a text change rather than a release. The repository has no GitHub releases, so there is no version to pin and no changelog beyond the update badge and the commit history. For a reader, the practical consequence is that you copy SSDT sources, compile them with IASL, drop the results into the ACPI folder of your EFI, and add entries to the config. The compilation step is the part that the README does not walk through in detail, and it is the step where a mistake in a table name or a path will surface as a boot that does not behave as expected. ## How this differs from the install guide and from a support forum There are two other places a Hackintosh user can look, and this project is not the same as either. Dortania's OpenCore Install Guide is procedural and prescriptive. It has a defined order, it tells you which setting to use, and it produces one specific outcome, a working install. OC-Little Translated is the opposite shape. Each chapter is a self-contained treatment of one problem, and the chapters are meant to be read selectively, by symptom. The README is explicit that it is not an installation or configuration guide, and it points to Dortania for that, so the two are meant to be used in sequence rather than as alternatives. A support forum is the third option, and the difference there is about kind rather than content. A forum post contains the fix for one machine with one BIOS, written by the person who solved it, and it is often a DSDT patch from that specific firmware. The content here is meant to be general. That is the point of the ACPI-only constraint: a hotpatch written to be general does not need to know your exact firmware revision, because it does not touch the table that your firmware supplied. There is also a translation lineage to keep in mind when comparing with the original OC-Little, since this project is a fork of that work in translation form and has since diverged with new chapters. Content that appears in both may differ in wording, and the README claims improvements in the rewritten sections, but a reader comparing a translated chapter against the Chinese original will be comparing against a version that the maintainer admits may carry minor inaccuracies. ## Conclusion OC-Little Translated fits a Hackintosh owner who has a working macOS install and now needs to solve one concrete problem, a sleep issue, a display that does not wake, a USB port map, a CPU power management quirk, and who prefers ACPI hotpatches to DSDT patching because those changes survive an OS update. It does not fit someone setting up OpenCore for the first time, since the project says plainly that it is not an installation or configuration guide and points to the Dortania OpenCore Install Guide for that. Before following any chapter, confirm the OpenCore version badge still matches the version you are running, and read the disclaimer about the project avoiding invasive DSDT modifications, because a chapter written for a different OpenCore release can leave you with a configuration that boots differently than you expect. ## FAQ ### What is OC-Little Translated used for? It is a collection of ACPI hotpatch samples and guides for OpenCore, covering post-install tuning and hardware enablement topics such as ACPI basics, adding and disabling devices, the MMIO whitelist, CPU power management, graphics, USB, sleep and wake, OTA updates and peripherals. ### Does OC-Little Translated show how to install macOS? No. The README states that it is not a macOS installation nor an OpenCore configuration guide, and directs readers to the Dortania OpenCore Install Guide for setting up OpenCore on an Intel system. It focuses on post-install tuning and hardware enablement. ### Does OC-Little Translated use DSDT patching? No. The project states that it avoids DSDT patching and other invasive modifications, and that it adheres to the philosophy of a clean, vanilla Hackintosh using only ACPI hotpatching, where new SSDT tables are added rather than the original table being edited. ### Which OpenCore and macOS versions does OC-Little Translated target? The badges in the README state support for OpenCore up to 1.0.9 and macOS up to 26.x, with a last update stamp of 2026-10-16. The repository has no GitHub releases, so the badges and the commit history are the version record. ### What is the relationship between OC-Little Translated and Daliansky's OC-Little? It started as a translated adaptation of Daliansky's OC-Little and has since grown into an independently expanded reference, with new chapters 7 to 20 and a full Appendix A to Z that do not exist in the original. The README also notes that minor inaccuracies in the translated portions may exist because the translator does not speak Chinese. ## Sources - [5T33Z0/OC-Little-Translated on GitHub](https://github.com/5T33Z0/OC-Little-Translated) - [Issues](https://github.com/5T33Z0/OC-Little-Translated/issues) - [License: BSD-3-Clause](https://github.com/5T33Z0/OC-Little-Translated/blob/main/LICENSE) - [README](https://github.com/5T33Z0/OC-Little-Translated/blob/main/README.md) --- Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/5t33z0-oc-little-translated