BlueToolFixup

BlueToolFixup

by Acidanthera
Network Lilu Plugin

Lilu plugin that fixes Bluetooth support on macOS Monterey and later by patching the Bluetooth framework

Download GitHub
Advertisement
Advertisement (336×280)

BlueToolFixup

Note

This kext requires Lilu to be installed and loaded first.

BlueToolFixup is a Lilu plugin that patches the macOS Bluetooth framework to restore Bluetooth functionality for third-party Bluetooth kexts on macOS Monterey (12.0) and later. Starting with macOS 12, Apple restructured the Bluetooth stack, breaking compatibility with existing Hackintosh Bluetooth kexts. BlueToolFixup bridges this gap by patching the framework at load time.

Why It’s Needed

On macOS Big Sur (11.x) and earlier, Bluetooth kexts like BrcmPatchRAM and IntelBluetoothFirmware worked directly. macOS Monterey introduced a new Bluetooth stack that requires Apple’s own firmware uploader, which isn’t available on Hackintosh systems. BlueToolFixup patches the framework to allow third-party kexts to function.

Installation

  1. Install Lilu first
  2. Download from GitHub
  3. Copy BlueToolFixup.kext to EFI/OC/Kexts/
  4. Ensure it loads after Lilu but before your Bluetooth kext

Compatibility

BlueToolFixup is required on macOS Monterey (12+) and later for:

On macOS Big Sur (11.x) and earlier, BlueToolFixup is not needed.

FAQ

Do I need BlueToolFixup on macOS Big Sur or earlier?

No. BlueToolFixup only patches the macOS 12+ Bluetooth framework. On macOS 11.x and earlier, your Bluetooth kexts work without it.

Where do I download BlueToolFixup?

BlueToolFixup is bundled with BrcmPatchRAM releases. Download the latest release from the BrcmPatchRAM GitHub repository.

Should I use BrcmBluetoothInjector instead?

On macOS 12+, you need both BlueToolFixup and BrcmBluetoothInjector (for Broadcom cards). BlueToolFixup patches the framework; BrcmBluetoothInjector handles firmware upload. For Intel cards, use BlueToolFixup with IntelBluetoothFirmware.

Resources