Skip to content
@osy osy
Compare
Choose a tag to compare

Changes

  • Fix Metal issues on macOS Monterey 12.3

Known Issues

  • LAN2 is not working on macOS Monterey (#947). This requires a driver update from Small Tree.

Messages

  • Important: Apple has started requiring Secure Boot for updating to macOS Monterey 12.2 and above. See the mini-guide below for more details.
  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.

Enabling Secure Boot

As of macOS Monterey 12.2, Apple has started requiring Secure Boot for OTA updates. HaC mini already supports Secure Boot but if you have not enabled it before, you need to perform some extra steps.

  1. (Re)install HaC Mini and in the installer choose "Customize" and check "Boot Options -> Enable boot security".
  2. After rebooting, repeatedly press the Alt/Cmd key at BIOS to toggle the OpenCore boot picker. Select the recovery partition.
  3. Open Utilities -> Terminal and type the following: bless --folder "/Volumes/Macintosh HD/System/Library/CoreServices" --bootefi --personalize (replace "Machintosh HD" with the name of your Monterey boot volume if needed)
  4. Reboot and you should be able to boot into Monterey again. If you still do not see OTA updates, open Terminal and run sudo /System/Library/PrivateFrameworks/Seeding.framework/Versions/A/Resources/seedutil unenroll

If these steps do not work, you may have to re-install macOS Monterey from recovery to get secure boot to work. More details about secure boot can be found in the guide.

Note: When Secure Boot is enabled, you can no longer manually modify the EFI partition (config.plist, KEXTs, etc). If you wish to make modifications, you must re-install HaC mini and uncheck the boot security option.

@osy osy
Compare
Choose a tag to compare

Changes

  • Fix SD card reader on macOS Monterey (#613)
  • Fix APFS boot not found on macOS Mojave and Catalina (#939)

Known Issues

  • LAN2 is not working on macOS Monterey (#947). This requires a driver update from Small Tree.

Messages

  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.
@osy osy
6f2b35d
Compare
Choose a tag to compare

Changes

Driver Updates

  • AppleALC 1.6.5 -> 1.6.6
  • BrcmPatchRAM 2.6.0 -> 2.6.1
  • Lilu 1.5.6 -> 1.5.7
  • OpenCore 0.7.4 -> 0.7.5
  • WhateverGreen 1.5.4 -> 1.5.5

Messages

  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.
@osy osy
Compare
Choose a tag to compare

Note: there are issues reported with the Intel Bluetooth driver and macOS Monterey. Do NOT select Intel Bluetooth if you are on or plan to upgrade to Monterey.

Changes (v3.1.0)

  • macOS Monterey support
  • Fix warning message on OC boot (#585)
  • SATA workaround is optional since it may break NVMe in some circumstances (#604)

Changes (v3.1.1)

  • Add Bluetooth support for Broadcom/Intel chips in Monterey (#923)

Changes (v3.1.2)

  • Fixed error during install of macOS 12.0 beta 8
  • Fixed OTA updates of macOS 12.0 beta 6 and up
  • Fixed Secure Boot

Driver Updates (v3.1.0)

  • AirportBrcmFixup 2.1.2 -> 2.1.3
  • AppleALC 1.6.0 -> 1.6.4
  • BrcmPatchRAM 2.5.8 -> 2.6.0
  • IntelBluetoothFirmware 1.1.2 -> 2.0.0
  • IntelMausi 1.0.6 -> 1.0.7
  • Lilu 1.5.3 -> 1.5.6
  • NVMeFix 1.0.7 -> 1.0.9
  • OpenCore 0.6.9 -> 0.7.3
  • OpenIntelWireless 1.3.0 -> 2.0.0
  • Polaris22Fixup 1.3.3 -> 1.3.4
  • VirtualSMC 1.2.3 -> 1.2.7
  • WhateverGreen 1.4.9 -> 1.5.3

Driver Update (v3.1.2)

  • AppleALC 1.6.4 -> AppleALC 1.6.5
  • IntelBluetoothFirmware 2.0.0 -> 2.0.1
  • OpenCore 0.7.3 -> 0.7.4
  • WhateverGreen 1.5.3 -> WhateverGreen 1.5.4

Messages

  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.
@osy osy
d7e84d5
Compare
Choose a tag to compare

Changes (v3.1.0)

  • macOS Monterey support
  • Fix warning message on OC boot (#585)
  • SATA workaround is optional since it may break NVMe in some circumstances (#604)

Changes (v3.1.1)

  • Add Bluetooth support for Broadcom/Intel chips in Monterey (#923)

Driver Updates (v3.1.0)

  • AirportBrcmFixup 2.1.2 -> 2.1.3
  • AppleALC 1.6.0 -> 1.6.4
  • BrcmPatchRAM 2.5.8 -> 2.6.0
  • IntelBluetoothFirmware 1.1.2 -> 2.0.0
  • IntelMausi 1.0.6 -> 1.0.7
  • Lilu 1.5.3 -> 1.5.6
  • NVMeFix 1.0.7 -> 1.0.9
  • OpenCore 0.6.9 -> 0.7.3
  • OpenIntelWireless 1.3.0 -> 2.0.0
  • Polaris22Fixup 1.3.3 -> 1.3.4
  • VirtualSMC 1.2.3 -> 1.2.7
  • WhateverGreen 1.4.9 -> 1.5.3

Messages

  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • Currently, secure boot does not work on macOS 12, if you wish to install or upgrade to macOS 12, you must disable secure boot first.
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.
@osy osy
Compare
Choose a tag to compare

v3.1.0

Pre-release
Pre-release

Changes

  • macOS Monterey support
  • Fix warning message on OC boot (#585)
  • SATA workaround is optional since it may break NVMe in some circumstances (#604)

Driver Updates

  • AirportBrcmFixup 2.1.2 -> 2.1.3
  • AppleALC 1.6.0 -> 1.6.4
  • BrcmPatchRAM 2.5.8 -> 2.6.0
  • IntelBluetoothFirmware 1.1.2 -> 2.0.0
  • IntelMausi 1.0.6 -> 1.0.7
  • Lilu 1.5.3 -> 1.5.6
  • NVMeFix 1.0.7 -> 1.0.9
  • OpenCore 0.6.9 -> 0.7.3
  • OpenIntelWireless 1.3.0 -> 2.0.0
  • Polaris22Fixup 1.3.3 -> 1.3.4
  • VirtualSMC 1.2.3 -> 1.2.7
  • WhateverGreen 1.4.9 -> 1.5.3

Messages

  • If you are upgrading from v2.17 and below, please read the notes at the top of v3.0.1
  • Currently, secure boot does not work on macOS 12, if you wish to install or upgrade to macOS 12, you must disable secure boot first.
  • As announced a few months ago, this project will be transitioning to a long-term support model (a few stability updates per year). Following Apple's own deprecation model, we expect the EOL of this project to be no earlier than 2023.
@osy osy
Compare
Choose a tag to compare

IMPORTANT READ THE FOLLOWING BEFORE UPDATING: The new OpenCore has an incompatible change with v2.17 and below. As a result, if you run the update and restart, you will not be able to find the boot device. There are a few ways to complete the update:

  • Option 1: install v3.0 on a USB drive with the "Show boot menu" option set. Then boot into the USB drive which loads OpenCore and select the Reset NVRAM option. Then you must boot from the USB again and select macOS and install v3.0 on your main partition.
  • Option 2: install v3.0 on your main partition and also on a USB drive (with “Show boot menu” set). Reboot and select your USB drive. Select Reset NVRAM and remove the USB drive when it reboots.
  • Option 3: if you've already installed v3.0 on your main partition without doing the above, you can get into UEFI Shell and type in fs0:\EFI\OC\OpenCore.efi from the shell prompt.
  • Option 4: if all else fails, you can do a BIOS reset which should reset all settings as well as the boot options. Make sure to set up the BIOS settings again with your old settings!

Changes (v3.0.1)

  • Fixed an issue where Intel Wireless caused panic on boot

Changes (v3.0)

  • Add fans, voltage, and temperature sensors (#553)
  • Translate to German (thanks @SkyrilHD)
  • Intel wireless option now installs AirportItlwm instead of Itlwm

Driver Updates (v3.0)

  • AppleALC 1.5.6 => 1.6.0
  • BrcmPatchRAM 2.5.5 => 2.5.8
  • IntelMausi 1.0.5 => 1.0.6
  • Lilu 1.5.0 => 1.5.3
  • NVMeFix 1.0.5 => 1.0.7
  • OpenCore 0.6.5 => 0.6.9
  • VirtualSMC 1.1.9 => 1.2.3
  • WhateverGreen 1.4.6 => 1.4.9

Release Schedule

As this project reaches maturity, HaC mini will only be updated for bug fixes and major features. We will no longer be updating the driver KEXTs monthly.

We aim to have two major releases a year: one targeting a major update for macOS due to anticipated major changes (for example when macOS 12 comes out). A second one mid-way through the update cycle. Each major update will increment the second version number (for example v3.0 => v3.1). A major update will include any new features as well as bumping all drivers to the latest released versions.

When bug fixes are needed, we will only update the relevant drivers and the third version number will be incremented (for example v3.0 => v3.0.1).

Each major update will first be released as a pre-release as marked on Github. If some time passes and no major bugs are reported, then the pre-release will be promoted to the full release and will be the recommended build to install. Non-advanced users are recommended to only install full release builds as they will be more stable.

When reporting an issue, please make sure to include the version you are using.

@osy osy
3846a97
Compare
Choose a tag to compare

v3.0

Pre-release
Pre-release

Outdated.

@osy osy
4d2e49e
Compare
Choose a tag to compare

Changes

  • Updated OpenIntelWireless driver (#528)
  • Fixed graphics issue in macOS 11.3 (#537)
  • Removed GK701HIDDevice drive (use the signed DEXT instead)

Driver Updates

  • OpenIntelWireless 1.1.0 => 1.2.0
  • Polaris22Fixup 1.3.2 => 1.3.3

Note: For stability reasons, we are no longer updating acidanthera projects unless there is an explicit bug fix that affects HaC mini OR a new feature that we wish to support. The reasoning for this is to minimize the chance that an update breaks working configurations.

@osy osy
a2a5ded
Compare
Choose a tag to compare

Changes

  • Fixed missing mouse pointer in boot picker (#462)
  • Boot stuck at “PCI configuration” on some NVMe devices (thanks @keatliang2005) (#461)

Driver Updates

  • AppleALC 1.5.5 => 1.5.6
  • IntelMausi 1.0.4 => 1.0.5
  • NVMeFix 1.0.4 => 1.0.5
  • OpenCore 0.6.4 => 0.6.5
  • WhateverGreen 1.4.5 => 1.4.6