✍️
OpenCore Visual Beginners Guide
  • 📗Step-by-Step
    • Intro & Hardware
    • Create EFI & Config - OCAuxiliaryTools
    • Create macOS Installer - OCLP
    • Install & Postinstall
      • USB Port Mapping
    • Use Debug Versions
    • Upgrade OpenCore
    • Hackintosh Checklist
    • Tools and Boot Keys
  • 📙Alternatives
    • Create macOS Installer - TINU
    • USB Mapping on Windows
  • 📘Advanced Topics
    • Open Core Legacy Patcher (OCLP)
      • Broadcom Wifi on macOS Sequoia
    • Using Alder Lake (or Raptor Lake)
    • BIOS Settings Explained
    • OpenCore UEFI Shell
      • acpiview - command
    • Dual-Boot Options
      • Dual-Boot on Single Disk
      • Create rEFInd BOOTer
    • Common Boot Args for macOS
    • Block Update Notifications
    • Low End GPUs
    • Tips & Tricks (WIP)
  • Hackintosh Opinions
    • Olarila - Not Recommended
    • Hack Studio SFF
Powered by GitBook
On this page
  • Using OpenCore Auxiliary Tools to Create EFI & Config
  • ACPI
  • Booter
  • Device Properties
  • Kernel
  • Misc
  • NVRAM
  • Platform Info
  • UEFI
  • Notes

Was this helpful?

Edit on GitHub
  1. Step-by-Step

Create EFI & Config - OCAuxiliaryTools

An unoffical User Guide for OCAuxiliaryTools

PreviousIntro & HardwareNextCreate macOS Installer - OCLP

Last updated 5 months ago

Was this helpful?

This guide uses specific for the purpose of illustrating the workflow of OCAuxiliaryTools tools. Presumably your hardware will differ, which means that your configuration will probably differ in each section. Do not just copy the settings shown for this example, but look up the recommended settings in the in the section relevant for your CPU architecture.

Using OpenCore Auxiliary Tools to Create EFI & Config

  • OCAuxiliaryTools is an excellent configuration and update utility. It will be used to create the complete OpenCore EFI folder including the Config.plist. (You may use this alongside a plist editor such as or ).

  • If you are following this example, but are using different hardware, just open the relevant sections for your CPU generation in alongside OCAuxiliaryTools.

  • Download & install and launch the OCAuxiliaryTools application.

  • Click the Database/Configuration Template button (highlighted in the screenshot)

  • Open this configuration in OCAuxiliaryTools. Then click the Save button so that OCvalidate will update its messages accordingly, which should get rid of any errors.

  • Then select Menu -> Edit -> Generate EFI on the Desktop

This will generate the EFI folder including the most recent official release version of OpenCore on your desktop. For now ignore any missing kexts (which can be added later), as all the essential ones should be included already (as shown below)

ACPI

  • Add any additional SSDTs, if needed by clicking on the [+] button for downloaded SSDTs or by clicking on the […] button for the most common prebuilt SSDTs available within OCAuxiliaryTools

Booter

Device Properties

Therefore change AAPL,ig-platform-id to 0300913E

  • Note, that keys which start with a # are commented out and will not be used by OpenCore

Kernel

  • Click on the [...] button to open the most common kexts available within OCAuxiliaryTools. Just drag-and-drop IntelMausi.kext into the app window. It will automatically be added to the Config.plist and enabled.

  • Add any additional kexts, if needed by clicking on the [+] button for kexts downloaded from elsewhere.

  • For changing the order of the kexts, select a kext and click on the [<] and [>] buttons to move the kext up or down which will determine the order in which they are loaded.

Optionally display the Preselection for your CPU platform, especially if you have opened an older EFI and you want to ensure that the recommended options have been enabled. The Preselection feature will display those option in Bold-Italic type without actually changing your settings. You will need to decide if the recommendations are relevant to you.

  • Again just hover with the mouse over each option to read the explanation from the OpenCore reference documentation. Alternatively right click over an option and select Show Tips to see the tip in a tool window.

Misc

  • By default the EFI created by OCAuxiliaryTools uses the most recent release version of OpenCore. If you want to show additional debug information change Target to 67 and switch to the debug version of OpenCore, which will be explained at the end of this guide.

NVRAM

  • Add the following string in boot-args for debugging and for audio: -v debug=0x100 keepsyms=1 alcid=1

  • Change prev-lang:kbd to use a String and input en-US:0 (or your language code) instead of using the HEX value.

Platform Info

  • Click Generate (near the SystemProductName field)

  • You should see “… we’re unable to check coverage for this serial number” or something similar in your language. This is the response you want, because your Hackintosh should not reuse someone else’s existing serial from a real Mac.

  • The SerialInfo tab of OCAuxiliaryTools displays the info of the new serial generated for the EFI you are working on.

UEFI

  • You can add additional drivers using the [+] or […] button.

  • The OpenCanopy boot GUI should work out-of-the-box as OCAuxiliaryTools activates it by default.

Notes

  • Remember to save your Config.plist by clicking the Save button or with Menu -> File -> Save.

This page also serves as an unofficial introductory user guide for OCAuxiliaryTools. It has been updated with OCAuxiliaryTools version 20240001 using OpenCore 1.0.0. As this page is only infrequently updated, newer versions may have different features or require different settings.

This links to a where you can download the relevant configuration. (The steps are also explained there.)

Click on Config_Templates.zip and then the Download Raw File button on that Github page to download the . Unzip the templates on your Desktop for example.

Check which is relevant for your hardware. For this example we will use iMac20,1 and the corresponding file Desktop_10thGen_Comet_Lake_iMac20,1.plist

In uncheck what is not needed (as shown below)

For example we may not need in Comet Lake any more, as the NVRAM works without it.

Check the relevant section of the for more details.

In , uncheck ResetLogoStatus. ('It is enabled by default in sample.plist. This Quirk didn't exist at the time the OpenCore Install Guide was written, so it's unknown if it's a requirement. Most likely it's not.' @5T33Z0)

You can hover with your mouse over each option (or right click and Show Tips) to see the explanation from the official OpenCore reference manual. This is a really helpful feature of OCAuxiliaryTools, as it enables you to quickly understand options which are only clearly explained in the very detailed document:

No changes in

In enable the iGPU for computing tasks only (not intended to drive a display), as you will be using a compatible dedicated AMD GPU.

In the section add IntelMausi.kext, the Intel onboard Ethernet driver for macOS.

No changes in the section

Since we are installing Monterey or Ventura for this example, we do not enable the hacky XhciPortLimit setting any more: "With macOS 11.3 (Big Sur) and newer, ."

In the section you may choose PickerVariant GoldenGate for the OpenCore booter GUI

In the section: DisplayLevel click the Select button and enable Debug__Warn and Debug__Error

In the section change SecureBootModel to Default if installing macOS Monterey or newer.

In , click the […] button and add OpenShell.efi by dragging it into the list

In change csr-active-config to 00000000 to enable SIP.

In the section, use the built-in Generator of OCAuxiliaryTools for setting up the SMBIOS info (instead of using the GenSMBIOS terminal application).

Also check the serial on the webpage.

No changes needed in the section

If you want to enable the Boot Chime, you can configure it in the UEFI-Audio section during post-install. See .

If your motherboard uses the Intel’s I225-V 2.5GBe ethernet controller, additional settings are required in the relevant sections. Just refer to the and use the applicable presets in OCAuxiliaryTools.

Several additional features of OCAuxiliaryTools will be discussed on the page .

Except where otherwise noted, content on this site is licensed under the license. Attribution by link to .

📗
Github repo
templates
Platform Info
ACPI - Add
SSDT-PMC
Desktop Comet Lake | OpenCore Install Guide
ACPI - Quirks
OpenCore Reference Manual
Booter
Device Properties
Kernel
Kernel - Quirks
XhciPortLimit is broken resulting in boot loops
Misc - Boot
Misc - Debug
Misc - Security
Misc - Tools
NVRAM - Add
Platform Info - Generic
Apple Support
UEFI
Setting up Boot-chime with AudioDxe
OpenCore Install Guide
Debug and Upgrade OpenCore
example 10th Gen Intel hardware
OpenCore Install Guide
ProperTree
Xplist
config.plist Setup | OpenCore Install Guide
OpenCore Auxiliary Tools - OCAT
Creative Commons — Attribution-NonCommercial 4.0 International — CC BY-NC 4.0
chriswayg · GitHub
OCAuxiliaryTools initial Window
Configuration Templates locally downloaded
Edit Menu
ACPI - Add Section
ACPI Quirks Section
Booter - Quirks Section
Device Properties - Add Section
Kernel Add Section
Misc - Debug Section
Misc - Security Section
Misc - Tools Section
NVRAM - Add Section
Platform Info - Generic Section
UEFI Drivers Section
Configuration.pdf