/OC-Little-Translated

ACPI Hotpatches and Guides for the OpenCore Bootmanager. Enhance and fine-tune your system by adding devices and enabling additional features not covered in the OpenCore Install Guide.

Primary LanguageASLBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

OC-Little: ACPI Hotpatch Samples and Guides for OpenCore

OpenCore Version macOS Last Update
maciasl

TABLE of CONTENTS

PREFACE

MAIN

APPENDIX


DISCLAIMER

  1. OC-Little Translated is not an installation guide for getting your system up and running with macOS – use Dortania's excellent OpenCore Install Guide for that! Instead, it's a supplementary resource that offers guides and fixes for various issues related to hackintosh systems, along with explanations and context about how they work. It is regularly updated to reflect the latest discoveries and developments of the hackintosh community.
  2. The material presented in this repo is designed to empower users to create a proper working system running macOS without breaking ACPI-compliancy! Therefore, OC-Little Translated does not support methods which do not hold up to this premise – such as patching the DSDT – since it's not an appropriate measure to get the "Real Vanilla Hackintosh" experience. In fact, it's quite the opposite, as discussed here.

ABOUT

Collection of guides, ACPI Hotpatches and Binary Renames for use with the OpenCore Boot Manager based on OC-Little by Daliansky translated from Chinese.

Besides the original translated guides, this repo contains additional guides complementary to the ones provided by the OpenCore Package and Dortania's OpenCore Guides. It covers a wide range of hackintosh-related topics, including:

  • ACPI basics
  • Enabling devices and features
  • Fixing sleep/wake and other power-related issues
  • Guides for Mapping USB Ports
  • Fixing Laptop-specific issues
  • Fixing graphics-related issues
  • Config-related tips
  • Guides for using OpenCore Legacy Patcher on Wintel Systems

Check the table of contents for more. Although aimed primarily at OpenCore users, all of the SSDTs and most of the guides/techniques are applicable to Clover as well.

About the translation

  • AI-based translation using deepL, google translator as well as manual copyediting.
  • Restructured the repository into more plausible (sub-)sections and categories based on types of issues, components, methods, etc.
  • Restructured Texts for better readability and comprehensibility
  • Rewrote whole sections which were confusing/misleading (ACPI and USB Port Mapping for example)
  • Added missing descriptions
  • Added further explanations where necessary
  • Added new content (USB Port Mapping via ACPI, Chapters 7 to 14 as well as the whole "Appendix" section)

Note

Due to the fact that I don't speak Chinese the translation might not be 100% accurate.

CONTRIBUTIONS

If you would like to contribute to the information provided in this repo in order to improve/expand it, feel free to create an issue with a meaningful title, link to the chapter/section and describe what you like to add, change, correct or expand upon.

5T33Z0's 5H0UT 0UT5

  • Thanks to the contributors for improving and expanding the repo. Additional credits for contributors outside of the github realm are listed in the respective sections of the repo.
  • sascha_77 for Kext Updater, ANYmacOS and helping me to unbrick my Lenovo T530 BIOS!
  • Apfelnico for introducing me to ASL/AML Basics
  • Bluebyte for having good conversations
  • Cyberdevs from insanelymac for his Z170X Gaming 5 Guide and for being a prime example of a Moderator who treats others with respect!
Daliansky's original Credits
  • Special credit to:
    • @XianWu write these ACPI component patches that useable to OpenCore
    • @Bat.bat, @DalianSky, @athlonreg, @iStar丶Forever their proofreading and finalization.
  • Credits and thanks to:
    • @冬瓜-X1C5th
    • @OC-xlivans
    • @Air 13 IWL-GZ-Big Orange (OC perfect)
    • @子骏oc IWL
    • @大勇-小新air13-OC-划水小白
    • @xjn819
    • Acidanthera for maintaining OpenCorePkg