HDAUniversal - AppleHDA-like Audio Kext for macOS Tahoe and Hackintosh Systems

[MaLd0n]

HDAUniversal is a modern AppleHDA-like audio kernel extension for macOS and Hackintosh systems, created to deliver clean, stable, and natural onboard audio with a behavior closer to Apple’s native audio stack.

This release represents an important milestone for the project. After extensive development, testing, debugging, and fine tuning across desktop and laptop configurations, HDAUniversal now provides a solid AppleHDA-like foundation with native-style volume handling, reliable output routing, combo-jack support, and compatibility with AppleALC-style layout IDs.

The goal has always been clear: make audio feel native, predictable, and stable on supported Hackintosh systems.

Donations help keep the project alive, supporting development time, testing hardware, hosting, maintenance, and future improvements.

If HDAUniversal helps your system, consider supporting the work so the project can continue growing. Link HERE

A New AppleHDA-like Audio Solution

HDAUniversal was designed with a strong focus on native macOS behavior. Instead of relying on artificial volume tricks or unstable routing workarounds, the kext follows a cleaner AppleHDA-like approach for codec initialization, output selection, mute handling, and endpoint switching.

The current release includes support for:

• Internal Speakers

• Headphones

• Line-out

• Internal Microphone

• Headset Microphone

• Laptop combo-jack detection

• Desktop non-combo audio paths

• AppleHDA-like selector/source behavior

• Stable speaker/headphone switching

• Correct headset microphone handling

• Native-style output volume

• Proper mute and unmute lifecycle

• Clean Power/EAPD restore order

This release is the result of careful iteration and real-world testing, with each change validated to avoid regressions in volume, routing, combo-jack behavior, or system stability.

Installation

1- Remove VoodooHDA, AppleAlc or other and inject bootarg alcid=xx or Device Properties. Check Instructions HERE

2- Run the .pkg installer, then open System Settings > Privacy & Security and allow the HDAUniversal kernel extension if macOS asks for permission.

Example: In my ALC897 i'm using alcid=98 and HDAUniversal, only it.

Why HDAUniversal Must Be Installed in /Library/Extensions

HDAUniversal is designed to work as a system-installed macOS audio kext, not as a simple bootloader-injected kext.

For this first release, the correct and supported installation path is:

/Library/Extensions/HDAUniversal.kext

This requirement is intentional.

Unlike small helper kexts that can usually be injected from EFI, HDAUniversal publishes real IOAudio devices, IOAudio engines, selectors, controls, volume ranges, mute controls, input/output sources, and AppleHDA-like audio endpoints. These objects are used not only by the kernel, but also by macOS user-space audio services such as CoreAudio, Sound Settings, Audio MIDI Setup, Control Center, and coreaudiod.

Installing the kext in /Library/Extensions gives macOS a proper on-disk bundle with the expected structure, metadata, permissions, cache handling, and resource visibility. This is important for stable audio registration, correct IOAudio behavior, system audio discovery, sleep/wake lifecycle, and future localization or UI-related metadata.

Loading HDAUniversal only from EFI may load the binary, but it can produce incomplete or inconsistent behavior because macOS may not treat the kext as a fully installed audio bundle. In that case, CoreAudio and the system UI may not reliably see all metadata, resources, localized names, or audio endpoint information the same way they do when the kext is installed properly in /Library/Extensions.

For this reason, EFI injection is not supported for the first public release.

Supported Installation Method

Install HDAUniversal here:

/Library/Extensions/HDAUniversal.kext

Then rebuild the kext cache / kernel collection and reboot.

Not Supported

EFI/OC/Kexts/HDAUniversal.kext
EFI/CLOVER/kexts/Other/HDAUniversal.kext
Temporary manual loading
Mixed copies in EFI and /Library/Extensions

Only one copy of HDAUniversal should be present on the system. Multiple copies can cause duplicate matching, wrong versions being loaded, broken audio registration, or inconsistent behavior after reboot or sleep/wake.

This approach keeps HDAUniversal closer to the way a real macOS audio driver is expected to live in the system and helps provide the most stable AppleHDA-like experience.

Compatible with AppleALC-style Layout IDs

HDAUniversal works with the same layout-id concept used by AppleALC, making it familiar and practical for Hackintosh users who already understand AppleALC layouts. 

This allows users to test audio using known layout IDs while HDAUniversal provides its own AppleHDA-like engine, routing logic, and runtime behavior.

The layout-based approach makes the kext easier to configure, easier to compare, and easier to integrate into existing Hackintosh setups.

Native Volume Philosophy

One of the main goals of HDAUniversal is to provide a correct and natural volume experience.

The output volume model is designed around real codec capabilities and AppleHDA-like behavior:

• Output volume reaches 0 dB

• No positive output boost is used

• No artificial -dB cap is applied

• No defensive volume lock is used

• Volume range follows real AmpCaps

• Mute is handled independently from logical volume

• Volume 0 provides real silence

• Unmute restores the previous logical volume

This avoids common issues such as distorted sound, excessive loudness, broken volume steps, mute getting stuck, or inconsistent speaker/headphone volume behavior.

Combo-Jack Support

Combo-jack support is one of the strongest points of this release.

HDAUniversal now supports AppleHDA-like endpoint behavior for laptops with shared headphone/headset microphone jacks. When a headset is connected, the kext can switch the output source to Headphones and the input source to Headset Microphone. When removed, it can safely return to Internal Speakers and Internal Microphone.

This behavior was carefully tuned to preserve desktop non-combo systems while improving laptop combo-jack handling.

Built for Stability and Real Hardware Testing

HDAUniversal has been developed with stability as a priority. Every major stage of the project focused on avoiding regressions, protecting working audio paths, and keeping the kext predictable under real macOS usage.

The release was fine tuned around:

• Boot stability

• Runtime audio stability

• Speaker/headphone separation

• Combo-jack switching

• Headset microphone detection

• Mute/unmute behavior

• Sleep/wake restore order

• Output volume correctness

• Avoiding artificial boost and distortion

• Keeping validated code paths intact

This is not just a feature update. It is a carefully tested release built around practical Hackintosh audio behavior.

Download HDA-Universal HERE

Credits and Acknowledgements

HDAUniversal exists because of years of work from Apple, open-source developers, and the Hackintosh audio community.

Special thanks to Fabiano and Mirone

Credits:

Apple

For the original AppleHDA architecture, macOS audio stack, IOAudioFamily, codec handling concepts, and the native behavior that inspired the AppleHDA-like design goals of this project.

AppleALC

For the layout-id ecosystem, codec research, audio patching knowledge, layout data, and years of Hackintosh audio development that helped define how modern macOS audio should be configured on non-Apple hardware.

HDAUniversal follows the same layout-id concept familiar to AppleALC users, making testing and configuration easier for the community.

VoodooHDA

For its long history as one of the most important open-source Hackintosh audio projects, providing valuable knowledge about HDA codecs, routing, mixer handling, and alternative audio implementation strategies.

The Hackintosh Community

For continuous testing, codec dumps, bug reports, layout experiments, logs, real hardware validation, and years of shared knowledge that make projects like this possible.

Olarila

For development, testing, debugging, validation, and maintaining tools, guides, patches, and resources for the Hackintosh community.

Project development by Daniel Maldonado / MaLd0n - Olarila.com.

Disclaimer

HDAUniversal is an independent project. It is not affiliated with, endorsed by, or sponsored by Apple, AppleALC, VoodooHDA, or any hardware vendor.

Apple, macOS, AppleHDA, and related names are trademarks of Apple Inc.

AppleALC and VoodooHDA are separate projects with their own authors, licenses, and development history. Full respect and credit belong to their respective developers and contributors.

Reporting Issues

If you find a problem with HDAUniversal, please report it with proper logs.

Before posting, run the included log collector: 

Collect-HDAUniversal.command Download HERE

This script collects the information needed to understand what is happening on your system, including codec data, IORegistry audio devices, IOAudio engines, CoreAudio state, loaded kexts, system audio information, and relevant HDAUniversal logs.

When reporting an issue, please include:

1. The zip generated by Collect-HDAUniversal.command
2. Your codec model
3. Your layout-id
4. macOS version
5. Bootloader used
6. Whether the kext is installed in /Library/Extensions
7. A clear description of the problem
8. Steps to reproduce the issue

Please avoid reports without logs. Messages such as “audio does not work” or “headphones are broken” are not enough to debug the problem.

Useful examples:

- Internal speakers work, but headphones do not switch after plug/unplug.
- Headset microphone is not detected on a combo-jack laptop.
- Audio works after boot, but not after sleep/wake.
- Volume is too low or too high compared to AppleHDA.
- The wrong input or output source is selected.

For best results, reproduce the problem first, then run Collect-HDAUniversal.command immediately after the issue happens. This gives the log collector a better chance of capturing the real failure.

Reports with complete logs are much easier to analyze and help improve HDAUniversal for more codecs, layouts, laptops, and desktop systems.

[AllanCardozo]

Thank you @MaLd0n

alcid=12 and HDAUniversal and all is working niceeeeee

[belengoww]

WoW

alcid=66 in my Asus laptop

Combo-Jack work perfect. Thanksss!

[AnonymousWriter]

Tested HDAUniversal on my Hackintosh and it’s running really smooth. Combo-jack works, headphones switch correctly, and the headset mic is detected. 🤩

[oliver121519]

wtf

agora vc brincou

obrigado

[Alpha22]

@MaLd0n 

Tested HDAUniversal on my Hackintosh and it works perfectly

Question: The kext detects my monitor via DisplayPort, but I have no sound

  

[MaLd0n]

Can u extract a dump with this? https://olarila.com/files/macOS-Applications/Collect-HDAUniversal-Release.zip

Comming from native things from Apple

[arturcostajr]

BIG THANKSSSSS TO YOU MALDONNNNNN