# acidanthera/BrcmPatchRAM

Repository: https://github.com/acidanthera/BrcmPatchRAM
Canonical: https://ross.abutalabs.com/products/brcmpatchram
Language: C++
License: GPL-2.0
License Family: copyleft
Last push: 2026-03-20T15:15:00+00:00

## Health v2 (maintenance only)
Score: 68/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 73, release rhythm 43, longevity 100
- inputs: {"age_days": 2540, "days_push": 166, "days_rel": 166, "gap_med": 182, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1164, forks 154 (observed 2026-08-28T04:03:49.851986+00:00)

## What it is
A macOS kernel extension (kext) that applies PatchRAM firmware updates to Broadcom RAMUSB-based Bluetooth devices at every startup or wakeup, replicating the behavior of the Windows Broadcom driver. It includes firmware kexts extracted from Windows drivers and supports different macOS versions via BrcmPatchRAM, BrcmPatchRAM2, and BrcmPatchRAM3 variants.

## Use cases
- get Broadcom USB Bluetooth dongle working on macOS
- fix Bluetooth not working after wake from sleep on Hackintosh
- upload firmware to Broadcom Bluetooth adapter on macOS startup
- replace Windows RAMUSB firmware mechanism on macOS
- enable non-Apple Broadcom Bluetooth card in a Hackintosh build
- inject Broadcom Bluetooth firmware via OpenCore bootloader

## When to choose
- you run macOS (especially a Hackintosh) with a Broadcom RAMUSB Bluetooth device that lacks firmware on boot
- Bluetooth disappears after sleep/wake and needs firmware re-upload
- you need bootloader-injectable firmware kexts for Broadcom Bluetooth

## When to avoid
- your Bluetooth device is an original Apple Broadcom chipset (not RAMUSB)
- you are on Linux or Windows where native drivers already handle firmware
- you use a non-Broadcom Bluetooth adapter

## Facets
- artifact type: plugin
- maturity: active
- function: embedded, sdk, developer-tools
- domain: hardware, operating-systems, developer-tools
- platform: cpp
- tags: hackintosh, kext, bluetooth, broadcom, firmware-upload, macos-driver, macos

## Member repositories
- acidanthera/BrcmPatchRAM (main) score 68

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:49.851986+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:29:35.324136+00:00, confidence not recorded.
  - readme: https://github.com/acidanthera/BrcmPatchRAM (fetched 2026-08-28T04:03:49.851986+00:00, sha 1be7f392024c)
- Data as of 2026-08-30T08:39:29.467469+00:00.