Changelog.md
XhciPortLimit compatibility with macOS Tahoe, thx @laobamacEFI mode without DuetOC_STORAGE_SAFE_PATH_MAX to 192 to support various plugin kextsbackground-color NVRAM variable to fix 10.9 boot screenSysReport-- prefix from OpenNetworkBoot arguments (modify driver arguments if using this driver)Unload option to unload drivers in reverse of the order in which they were loadedMSR_IA32_TSC_ADJUST access on unsupported CPUs (e.g. Virtualization.framework), thx @t0rr3sp3dr0ClearTaskSwitchBit Booter quirk to fix crashes when using 32-bit versions of macOS on Hyper-V Gen2 VMsProvideCurrentCpuInfo and CPUID patching on older versions of macOS 10.4SSDT-HV-DEV.dslSSDT-HV-DEV-WS2022.dsl as it is no longer requiredSysReportAMD_CPU_EXT_FAMILY_1AH, thx @Shaneeesign.command to insert signature in correct location in some circumstancesAMD_CPU_EXT_FAMILY_1AH, thx @ShaneeeXcpmExtraMsrs MSR_MISC_PWR_MGMT patch back on macOS 12+XcpmExtraMsrs MSR_MISC_PWR_MGMT patch on macOS 15UEFI Unload option to unload existing firmware driversnvramdump with LogoutHook releaseFATBIN32=1 makeXcpmExtraMsrs MSR_MISC_PWR_MGMT patch on macOS 12+ due to non-existenceThirdPartyDrives quirk on macOS 14.4 and aboveAllowRelocationBlock support for 32-bit versionLaunchd.command to recreate its log file if deletedLaunchd.command to work with macOS Sonoma (re-run ./Launchd.command install after upgrading to Sonoma)macserial, thx @MacschrauberOC_ATTR_USE_REVERSED_UI to allow access to previous default Shutdown and Restart button arrangementOC_ATTR_USE_GENERIC_LABEL_IMAGEOC_ATTR_REDUCE_MOTION to optionally disable non-required OpenCanopy menu animationsExclude strategy for mkextFirmwareSettingsEntry.efi driver which adds menu entry to reboot into UEFI firmware settingsPickerAudioAssistSecureBootModel DisabledEnableGop vBiosInsert.shW^X settings rather than fixing them in loaded imagesFixupAppleEfiImages quirk to fix W^X errors in all non-Secure Boot Apple signed binariesAppleEfiSignTool to work with new PE COFF loaderProvideCurrentCpuInfo quirk to support CPUID leaf 0x2 cache size reporting on Mac OS X 10.5 and 10.6efidebug.tool to support new standard image formatefidebug.tool support for 32-bit on 32-bit using GDB or LLDBFixupAppleEfiImages quirk to allow booting Mac OS X 10.4 and 10.5 boot.efi images on modern secure image loadersShimRetainProtocol, allowing OpenCore chained from shim to verify Linux using shim's certificatesOpenLegacyBoot driver for supporting legacy OS bootingshim-make.tool to download and build rhboot/shim, for Linux SBAT and MOK integrationExclude strategy for prelinked on 32-bit versions of macOSForceAquantiaEthernet quirk on macOS 14 beta 2, thx @ShikumoInstanceIdentifier to OpenCore and option to target .contentVisibility to specific instances (thx @dakanji)LapicKernelPanic quirk on legacy versions of macOS.contentVisibility in same boot FS root locations as .VolumeIcon.icns, in order to survive macOS updatesFadtEnableReset on NVIDIA nForce chipset platformsForceResolution option--force-codec option to AudioDxe, thx @xCuri0Builtin renderer console fontBuiltin text renderer ignore UI Scale, when required to ensure that text mode reaches minimum UEFI supported size of 80x25--enable-mouse-click argument to CrScreenshotDxe driver to additionally respond on mouse click--use-conn-none option to AudioDxe driver to discover additional usable output channels on some systemsPciIo protocol override used to fix Aptio IV compatiblity with Above 4G BARs, thx @xCuri0AppleXcpmForceBoost quirk on macOS 14ConsoleFont option to load custom console font for Builtin rendererXhciPortLimit quirk on macOS 11 to 14DisableIoMapperMapping quirk, thx @CaseySJGopBurstMode on systems where it's not neededGopBurstMode with some very non-standard GOP implementationsGopBurstMode enabled on DEBUG buildsGopBurstMode even with natively supported cards, in EnableGop firmware driverExternalDiskIcons quirk on macOS 13.3+, thx @fusion71auBuiltin text rendererBuiltin text rendererInitialMode option to allow fine control over text renderer operating modeConsoleMode text resolution setting to Builtin rendererRebaseRegions and SyncTableIdsEnableGopPickerMode AppleLogModules and added ? filter for matching non-standard log linesAppleCpuPmCfgLock quirk on macOS 13gdbSysReportGopBurstMode quirk for faster GOP operation on older firmwareThirdPartyDrives quirk on macOS 13.3 and aboveProvideCurrentCpuInfo support for macOS 13.3 DPEfiRom and GenFfs in Utilities/BaseTools with OpenCore releasesResizeUsePciRbIo quirk to workaround broken PciIo on some UEFI firmwares, thx @xCuri0SysReport on older Atom systems.rdata) to all drivers for better memory protection when supportedSysReport on systems with non-audio HDA codecsKernel -> Block entries not being processed if one was skipped due to Arch.contentVisibility to hide and disable boot entriesMisc -> Boot -> HibernateSkipsPicker not to show picker if waking from macOS hibernationcom.apple.recovery.boot by default, thx @dreamwhiteBootKicker.efi or PickerMode Apple) when running GPUs without Mac-EFI support on units such as the MacPro5,1 (thx @cdf, @tsialex)PickerMode Apple to successfully launch selected entryBootKicker.efi to successfully launch selected entry (via reboot) (thx @cdf)SSDT-HV-DEV-WS2022.dslDriver -> LoadEarly in ocvalidateFullNvramAccess option for tools which require direct access to NVRAMSSDT-HV-CPU.dsl with SSDT-HV-DEV.dsl for compatiblity with older macOS versions on Windows 10 and newerSysReport on Pentium 4 systems--force-device option to AudioDxe, allowing UEFI audio on HDA contollers which misreport themselves as non-HDA audio devices--codec-setup-delay argument to AudioDxeAudio -> SetupDelay from microseconds to milliseconds (divide previous value by 1000 if using this setting)--show-csr option for Toggle SIP boot menu entryAllowRelocationBlock Booter quirkProvideCurrentCpuInfo quirkDriver -> LoadEarly for drivers which need to be loaded before NVRAM initAppleCpuPmCfgLock on macOS 13DummyPowerManagement on macOS 13AvoidRuntimeDefrag Booter quirkExtendBTFeatureFlags quirk on newer macOS versions, thx @lvs1974ForceAquantiaEthernet, thx @kokowskiLauncherOption property, thx @stevezhengshiqiCustomPciSerialDevice, thx @joevtReset NVRAM and Toggle SIP to configurable boot entry protocol driverscsr-active-config value for Toggle SIPEnabled and Disabled flavours for Toggle SIP (allows theme designers to provide distinct icons)python /path/to/script to force Python 2)ForceAquantiaEthernet for Aquantia AQtion AQC-107s based 10GbE network cards support, thx @Mieze and @ShikumoMisc -> Serial section to customise serial port propertiesCustomPciSerialDevice quirk for XNU to correctly recognise customised external serial devicesmacOS Installer volume name for use when .disk_label file cannot be displayed--restore-nosnoop flag to AudioDxe, making v0.7.7 fix for Windows sound opt-inSetApfsTrimTimeout is set to zeroSetApfsTrimTimeout on macOS 12 (only works when set to zero)SecureBootModel on hypervisors (should be x86legacy)Strategy for prelinked and newerProvideCurrentCpuInfo, allowing -cpu host in KVMLogModules for positive and negative log filtering by modulespartuuidopts:{PARTUUID} to autoopts:{PARTUUID}/boot partition without /loader/entries files (user must specify full kernel boot options)DmgLoading with secure SecureBootModel (already disallowed in runtime)SystemAudioVolumeDBProvideCustomSlide enabled.contentFlavour and .contentDetails files for boot entry protocol entries including OpenLinuxBootLINUX_BOOT_ADD_RW flag to OpenLinuxBoot to support e.g. EndeavourOSflags+= and flags-= arguments to OpenLinuxBoot to simplify setting driver flags if neededLINUX_BOOT_USE_LATEST flag is clearProvideCurrentCpuInfo support for Intel Alder LakeCpuid1Data recommendations for Intel Rocket Lake and newerintel-hda driver to allow UEFI sound in QEMUAudioOutMask--gpio-setup AudioDxe driver argument for UEFI sound on Apple hardware)ResizeAppleGpuBars to 0 and -1ProvideConsoleGop not disabling blit-only modes (e.g. on Z690)ReconnectGraphicsOnConnect option for enabling alternative UEFI graphics driversReconnectGraphicsOnConnectFadtEnableReset to avoid unreliable keyboard controller resetEnableVmx quirk to allow virtualization in other OS on some MacsProtectUefiServices to prevent GRUB shim overwriting service pointers when chainloading with Secure Boot enabledAdviseFeaturesBridgeOSHardwareModel NVRAM variable to fix T2 SB AP models on macOS 12Default Apple Secure Boot model to match SMBIOS for macOS 12opencore-version not being added to NVRAM variablesx86legacyForceOcWriteFlash UEFI quirk to enable writing OC system variablesGraphicsInputMirroring to fix lost keystrokes in some non-Apple graphical UEFI appsDefault Apple Secure Boot model to x86legacy for better security and compatibilityMinDate and MinVersion to macOS Big Sur for better securitySyncTableIds quirk to sync modified table OEM identifiersSysReportPowerTimeoutKernelPanic on macOS 12SysReportSetApfsTrimTimeout on macOS 12Apple12 and Windows11 flavoursTpmInfo tool to DEBUG TPM statusProvideCurrentCpuInfo MSR patch on macOS 12AppleXcpmForceBoost patch on macOS 12BootOptionSupportAcidanthera\GoldenGate<BOOTPATH>.icns and <TOOLPATH>.icns supportProvideCurrentCpuInfo quirk to provide correct TSC/FSB for Hyper-V virtual machinesApple variant of GopPassThrough to handle only AppleFramebufferInfo handlesCsrUtil.efi tool, similar to Apple csrutil<TOOLPATH>.lbl/.l2x pre-drawn entry labelsGopPassThrough and UgaPassThroughmemtest86 config in sample .plist filesProvideCurrentCpuInfo quirkcsr-data Apple NVRAM var to docsAdviseWindows with AdviseFeatures to support APFSForgeUefiSupport quirk to workaround legacy EFI 1.x firmwares compatibilityReloadOptionRoms quirk to force-load Option ROMs on PCI devicesOC_ATTR_USE_MINIMAL_UI to allow running pickers with no Shutdown and Restart buttonsManufacturer value to NO DIMM for empty slotsAutomatic modeDisableSingleUser not being enabled in certain casesForceBooterSignature quirk for Mac EFI firmwareBase and BaseSkip lookup for ACPI patchesdevices command to support misaligned device names returned by some Apple firmware(dmg) suffix to DMG boot options in OpenCanopyAppleEvent protocol properties and featuresControlMsrE2) without arguments from pickerNormalizeHeaders ACPI quirkOEM values to PlatformInfo in Automatic modeSSN (and HW_SSN) variable supportSetupVirtualMap quirkGopPassThrough option to support GOP protocol over UGAKeyMergeThreshold as it never functioned anywayacdtinfo utility to lookup certain productsFSBFrequency calculation with fractional multiplierResetTrafficClass to reset TCSEL to T0 on legacy HDAActivateHpetSupport quirk to activate HPET supportopencore-version reporting the incorrect version in rare casesMaxBIOSVersion option to GenericVBoxHfs driver with OpenHfsPlusSysReportHdaCodecDump application in favor of SysReportSetApfsTrimTimeout to tune APFS trim commandOpenCore.efi to application to improve FW compatibilityDisableSecurityPolicy UEFI quirk to workaround driver loadingSetVirtualAddressMap for non-macOS systemsSystemUuid from DataHub in non-Automatic mode for SMBIOSGeneric to match non-Automatic modeBootProtect with LauncherOption and LauncherPathOpenPartitionDxe with Apple Partition Management schemeMisc, NVRAM, and UEFI sectionssystem-id being accidentally stored in Little Endian formatUseRawUuidEncoding to choose SMBIOS UUID encoding styleDeduplicateBootOrder quirkSetupDelay to configure audio setup delayPickerVariant for more theme variantsOC_ATTR_HIDE_THEMED_ICONS PickerAttribute for Time MachineBlacklistAppleUpdate to fix macOS 11 broken update optoutRealPathTextModeEnableSafeModeSlide on macOS 11AllowRelocationBlock quirk for older macOS and safe modeDisableSingleUser quirk when Apple Secure Boot is enabledBootstrapShort to workaround buggy Insyde firmwareBootstrap(Short) to choose dynamic entry (requires NVRAM reset)Boot prefix in RequestBootVarRouting to workaround AMI issuesBooter Patch sectionPickerAttributesStartupMute variable in PlayChimeBOOTx64.efi and BOOTIA32.efi conventionSSDT-UNC.dsl ACPI sample to resolve X99 issues, thx @RemBScanPolicy NVMe handling on MacPro5,1ForceResolution option for enabling non-default resolutionsx86legacy Secure Boot modelsystem-id NVRAM variableForceSecureBootScheme quirk for virtual machinesProcessorType option to Generic allowing custom CPU namesUnblockFsConnect option not working with APFS JumpStartType to ReservedMemory to fulfil hibernation hack needsPreboot instead of Macintosh HDSystemMemoryStatus to override memory replacement on some modelsExtendBTFeatureFlags to properly set FeatureFlags for Bluetooth (which substitutes BT4LEContinuityFixup)MinKernel/MaxKernel to CPUID emulation and DummyPowerManagement-legacy not being added in KernelArch Auto modei386-user32 not forcing i386 on macOS 10.7 on X64 firmwarei386-user32 being incorrectly enabled in macOS 10.4, 10.5, and 10.7KernelCache Auto modemacserial compatibility with iMac20,x serials and other models from 2020LegacyCommpage quirk to improve pre-SSSE3 userspace compatibilityDmgLoadingBuiltinText variant for TextRenderer for older laptopsSyncRuntimePermissions creating invalid MAT tableXhciPortLimit quirk on 10.12.6 and possibly other versionsIncreasePciBarSize quirk on 10.11.5 and possibly other versionsLapicKernelPanic quirk on 10.8.5 and possibly other versionsFuzzyMatch option to support fuzzy kernelcache matching on 10.6 and earlierKernelArch option to specify architecture preference on older kernelsKernelCache option to specify kernel caching preference for older kernelsForce section to provide support for injecting drivers in older macOSArch filtering option to Add, Block, Force, and Patch sectionsDisableLinkeditJettison quirk to workaround 11.0b5 kernel panicsFirmware mode to ResetSystem to reboot into preferencesBlacklistAppleUpdate with run-efi-updater NVRAM variableFadtEnableReset ACPI quirkProvideMaxSlide quirk to improve laptop stability, thx @zhen-zenConfigValidity utility to ocvalidate for consistencyGlobalConnect for APFS loading to workaround older firmware issuesAvoidRuntimeDefrag Booter quirkProvideConsoleGop quirkUgaPassThrough option to support UGA protocol over GOPAppleFramebufferInfo protocol implementation and overrideSerialInit option to perform serial initialisation separatelyPlatformInfo Automatic for all modelsBoot#### options support in boot entry listingHideSelf by pattern recognising BOOTx64.efiBlacklistAppleUpdate to avoid Apple FW updatescom.apple.recovery.boot entriesBootProtect boot optionsApplePanic to store panic logs on ESP rootReconnectOnResChange reconnecting even without res changeFadtEnableReset with too small FACP tables and some laptopsRequestBootVarFallback due to numerous bugsDeduplicateBootOrder UEFI quirkDirectGopCacheMode due to being ineffective# in DeviceProperty and NVRAM DeleteBlock to Delete in ACPI,DeviceProperties, and NVRAMTscSyncTimeout quirk to workaround debug kernel assertionsLapicKernelPanic kernel quirk on 10.9CrScreenshotDxe driverSysReport option for DEBUG builds to dump system infoCustom UpdateSMBIOSMode modifying SMBIOSv3 tableUpdateSMBIOSModePatchAppleRtcChecksum kernel quirkAppleRtcRam protocol implementationProtocols to ProtocolOverrides for clarityBootProtect Security optionPs2KeyboardDxe driver for DuetPkgBootInstall DuetPkg version (now opensource)DirectGopCacheMode option for FB cache policyKeyFiltering option to workaround buggy KB driversOpenControl tool to configure full NVRAM access from Shellboot.efi debug protocol support for 10.15.4+boot.efi performance logging for 10.15.4+ProtectUefiServices quirk to fix DevirtualiseMmio on Z390BOOTCAMP Windows with Windows to match the originalOpenShell originally available as OpenCoreShellreadlabel utility into disklabel with encoding supportFwRuntimeServices driver to OpenRuntimeAppleUsbKbDxe driver to OpenUsbKbDxePowerTimeoutKernelPanic on 10.15.4OpenRuntime to fix Linux booting on SKLSyncRuntimePermissions to fix multiple memory permission flawsRebuildAppleMemoryMap to fix macOS booting on Dell 5490ShrinkMemoryMap in favour of more advanced RebuildAppleMemoryMapEnableWriteUnprotector as deprecated on modern systemsProtectMemoryRegions to fix memory region handlingProtectCsmRegion in favour of ProtectMemoryRegionsPickerAttributes to ConsoleAttributesPickerAttributes as a matter of UI configurationAvoidHighAlloc quirk due to removed I/O over 4GBConsoleMode, Resolution options to Output sectionOutput sectionConsoleControl and BuiltinTextRenderer with TextRendererConsoleBehaviourOs and ConsoleBehaviourUiPickerAttributes option to colour pickerProtectSecureBoot option through FwRuntimeServicesRequireVault and RequireSignature with VaultBootKicker tool to support launching Apple BootPickerPickerModeDirectGopRendering option to use direct GOP outputDefaultBackgroundColor variable handlingHideAuxiliary and Auxiliary options# not being skippedPickerAudioAssist option for audio assistance in pickerHdaCodecDump.efi tool in default packageOcSupportPkg with OpenCorePkg for easier bisectionExposeSensitiveDataSanitiseClearScreen to avoid mode switchingSupportsCsm with AdviseWindows enabling UEFI modeAdviseWindows not setting FirmwareFeatures in NVRAMTakeoffDelay option for improved action hotkey supportProvideConsoleGop quirkBuiltinTextRenderer boot optionDummyPowerManagement kernel quirk to disable CPU PMSupportsCsm and option in PlatformInfo/GenericOSInfo protocol supportSignalAppleOS Booter quirk to enable IGPU on Macs in other OSAppleSmcIoprotocol support (replaces VirtualSmc UEFI driver)AuthRestart security property for VirtualSMC authenticated restartAllowSetDefault Security optionWriteFlash NVRAM option to enable writing variables in AddLegacyOverwrite NVRAM option to allow overwriting variables by nvram.plistAppleXcpmForceBoost kernel quirk to maximise select Xeon performanceIncreasePciBarSize kernel quirk for select platforms with PCI space issuesUnblockFsConnect UEFI quirk to fix missing filesystems on some laptopsRequestBootVarFallback UEFI quirk to circumvent firmware boot option issuesThirdPartyDrives kernel quirk fixing SSD trim and 10.15 SATA hibernation (thx @lvs1974)ThirdPartyTrim kernel quirk in favour of ThirdPartyDrivesMinKernel and MaxKernel logic (thx @dhinakg, @reitermarkus)MmioWhitelist configuration optionPowerTimeoutKernelPanic kernel quirkReconnectOnResChange to a user-configurable quirk to avoid freezesExposeSensitiveDataMatchKernel with MinKernel and MaxKernelArguments to Tools and Entries sectionsInput section for mouse and keyboard aggregation$HOMEReplaceTabWithSpace quirk to improve Shell experienceClearScreenOnModeSwitch quirk to avoid visual glitchesMISC_PWR_MGMT patch to AppleXcpmExtraMsrs quirk (thx @mrmiller)DevirtualiseMmio quirk to Booter sectionScanPolicyOPT, CMD+R, CMD+OPT+P+R boot action hotkey supportPollAppleHotKeys to register boot.efi hotkeys in the pickerDisableSingleUser quirk to prohibit single user modeLogoutHook script used for emulated NVRAM savingAvoidHighAlloc UEFI quirk to avoid high memory allocsBooter section for Apple bootloader preferencesAptioMemoryFix.efi support for Booter and FwRuntimeServices.efiRequestBootVarRoutingBlessOverrideMisc -> EntriesDisableVariableWrite quirk to disable hardware NVRAM write in macOSDisableIoMapper kernel quirkIgnoreForWindows quirk legacyMisc -> Tools section to add third-party toolsKernel -> Emulate section for CPUID patchesCustomSMBIOSGuid quirk for Custom SMBIOS update modePanicNoKextDump quirk to avoid kext dump in panicsLapicKernelPanic kernel quirkAppleXcpmExtraMsrs quirk and improved XCPM patches(external) suffix for external drives in boot menuUsePicker option, do enable for OC boot managementResetHwSig ACPI quirk to workaround hibernationCustom subfolder requirement from ACPI tablesDebug -> Target enable bitResetLogoStatus ACPI quirkSpoofVendor PlatformInfo featureExposeBootPath with ExposeSensitiveDataUpdateSMBIOSMode Auto mode in favour of CreateConsoleControl configuration to ProtocolsSecurity -> ScanPolicy preferenceboard-rev exposure in Data Hub