laobamac/SimpleHDA
laobamac/SimpleHDA has 140 GitHub stars and 13 forks. GitHot measured +1 stars in 24 hours and +15 in 7 days. Last checked 2026-11-17 01:58 UTC. Last push 2026-11-04.
Measured star growth
- in 24h
- +1
- in 7 days
- +15
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Restore native AppleHDA on macOS Tahoe through OpenCore and Lilu
Creative & MediaREADME.en.md
OriginalSimpleHDA
Restore native AppleHDA on macOS Tahoe
简体中文 · English
OpenCore injection · Native audio stack · Automatic HAL detection · Localized device names
SimpleHDA is a Lilu plug-in that restores the original AppleHDA stack through OpenCore injection, allowing AppleALC to use your existing audio configuration. It does not modify the system volume or rebuild kernel collections.
Requirements
| Component | Requirement |
|---|---|
| System | macOS Tahoe 26 / Darwin 25.x |
| Architecture | Intel / AMD x86_64 |
| Bootloader | OpenCore with Kernel → Quirks → DisableLinkeditJettison enabled |
| Dependencies | Lilu ≥ 1.7.1 and AppleALC |
| Configuration | A working alcid or layout-id |
Installation
- Download the
RELEASEpackage from Releases, extract it and copySimpleHDA.kexttoEFI/OC/Kexts. - Add it to
Kernel → Addin this order: Lilu → AppleALC → SimpleHDA. The package includes an example entry inOpenCore-Kernel-Add.plist. - Ensure
Kernel → Quirks → DisableLinkeditJettisonistrueand retain the working AppleALC, layout and ACPI configuration for your machine. - Optionally install
SimpleHDA-HAL-1.0.1.pkg. - Reboot.
Remove other AppleHDA restoration solutions or root patches before installation to avoid loading the stack twice.
Boot arguments
| Argument | Purpose |
|---|---|
-shdaoff |
Disable the driver |
-shdahaloff |
Manually disable HAL for troubleshooting |
shda-lang=en |
Override the automatically detected language of device names |
-shdadbg |
Enable logging in the Debug build |
The keepsyms=1 boot argument is not required. OpenCore's DisableLinkeditJettison preserves the symbol tables needed for runtime linking, so this quirk must take effect successfully.
Use the appropriate alcid for your codec. If the layout is configured through device properties, an additional alcid argument is unnecessary.
Languages supported by shda-lang (41 locales)
The language is detected from NVRAM prev-lang:kbd by default. Priority: valid shda-lang → NVRAM language → zh_CN. For example, shda-lang=ja forces Japanese. Reboot after changing it.
OpenCore may fix prev-lang:kbd to a value that differs from the logged-in user's language. Use shda-lang to override it when needed.
| Value | Language |
|---|---|
ar |
Arabic |
ca |
Catalan |
cs |
Czech |
da |
Danish |
de |
German |
el |
Greek |
en |
English |
en_AU |
English (Australia) |
en_GB |
English (United Kingdom) |
es |
Spanish |
es_419 |
Spanish (Latin America) |
es_US |
Spanish (United States) |
fi |
Finnish |
fr |
French |
fr_CA |
French (Canada) |
he |
Hebrew |
hi |
Hindi |
hr |
Croatian |
hu |
Hungarian |
id |
Indonesian |
it |
Italian |
ja |
Japanese |
ko |
Korean |
ms |
Malay |
nl |
Dutch |
no |
Norwegian |
pl |
Polish |
pt_BR |
Portuguese (Brazil) |
pt_PT |
Portuguese (Portugal) |
ro |
Romanian |
ru |
Russian |
sk |
Slovak |
sl |
Slovenian |
sv |
Swedish |
th |
Thai |
tr |
Turkish |
uk |
Ukrainian |
vi |
Vietnamese |
zh_CN |
Simplified Chinese (fallback) |
zh_HK |
Traditional Chinese (Hong Kong) |
zh_TW |
Traditional Chinese (Taiwan) |
Values are case-insensitive, and - and _ are interchangeable, such as zh-CN and zh_CN.
Chinese aliases: zh-Hans and zh-Hans-CN → zh_CN; zh-Hant and zh-Hant-TW → zh_TW; zh-Hant-HK → zh_HK.
If a regional value is unavailable, the base language is tried, such as en_US → en or ja_JP → ja. Invalid boot arguments do not override automatic detection.
HAL
HAL provides AppleHDA-specific properties and controls to CoreAudio. SimpleHDA detects it automatically: installed HAL is enabled; without HAL, the ordinary IOAudio path is used. Neither configuration requires a switch.
The installer places the original signed plug-in at:
/Library/Audio/Plug-Ins/SimpleHDA/AppleHDAHALPlugIn.bundle
Reboot after installation or removal. Mounting the EFI partition is unnecessary. To uninstall:
sudo zsh Tools/uninstall_hal.zsh
Building
Requires full Xcode, Git and Python 3.
zsh Tools/build.zsh
python3 Tools/package.py
Separate DEBUG and RELEASE packages are written to Dist. Each includes the HAL installer and SHA-256 manifest. Use RELEASE for daily use and DEBUG for troubleshooting. To build only Release, run zsh Tools/build.zsh Release.
For Xcode, run zsh Tools/prepare.zsh once before opening SimpleHDA.xcodeproj. Press ⌘B to build. The build phase also prepares dependencies and generated sources automatically.
Dependencies are pinned in VendorVersions.json; the original payload is in Resources/AppleHDA.kext. Info.plist supplies the version, and the bundle identifier is cn.laobamac.SimpleHDA.
Each push updates the v1.0.1-alpha prerelease, keeping only the latest prerelease and assets. Release notes list the five most recent commits. Filenames include the short commit hash, such as SimpleHDA-Tahoe-v1.0.1-RELEASE-alpha-abcdef0.zip.
Publishing a formal Release automatically uploads DEBUG and RELEASE packages, such as SimpleHDA-Tahoe-v1.0.1-RELEASE.zip. Use 1.0.1 or v1.0.1 as the tag, matching Info.plist.
Acknowledgments
Lilu · MacKernelSDK · AppleALC · Apple XNU
See NOTICE for third-party components and licenses.
Copyright © 2026 laobamac. All rights reserved.