How acidanthera/applealc works
AppleALC is a macOS kernel extension that enables native audio for unsupported HD-audio codecs, with configuration-driven controller patching and codec layout/platform injection. Its main runtime starts the enabler, detects and validates audio hardware, and applies patches and properties; the separate alc-verb utility sends diagnostic or custom verbs through an IOKit user-client path. The README also documents installer/recovery support, digital-only audio, and arbitrary kext patching. Detailed internal links are limited to the excerpts; broader capabilities are represented as documented responsibilities.
Main entry points: kern_alc.cpp ALC enabler · main.c alc-verb CLI · ALCUserClient.cpp IOKit user client · ALCUserClientProvider.cpp Verb provider
Components 14
Kernel runtime
- Plugin startup
AppleALC/kern_start.cpp - ALC enabler
AppleALC/kern_alc.cpp
Audio enablement
- Controller detection
AppleALC/kern_alc.cpp - Codec detection
AppleALC/kern_alc.cpp - Controller patching
AppleALC/kern_alc.cpp - Layout injection
AppleALC/kern_alc.cpp
Codec resources
- Codec configurations
Resources - Resource definitions
AppleALC/kern_resources.hpp
Verb interface
- alc-verb CLI
alc-verb/main.c - HDA verb tables
alc-verb/hdaverb.h - IOKit user client
AppleALC/ALCUserClient/ALCUserClient.cpp - Verb provider
AppleALC/ALCUserClientProvider/ALCUserClientProvider.cpp - Shared method IDs
AppleALC/UserKernelShared.h
Other components
- macOS
Connections 15
- macOS → Plugin startup: loads extension
README.md - Plugin startup → ALC enabler: initializes
AppleALC/kern_start.cpp - ALC enabler → Controller detection: detects
AppleALC/kern_alc.cpp - ALC enabler → Codec detection: detects
AppleALC/kern_alc.cpp - ALC enabler → Controller patching: patches hardware
AppleALC/kern_alc.cpp - ALC enabler → Layout injection: injects layouts
AppleALC/kern_alc.cpp - ALC enabler → Resource definitions: uses definitions
AppleALC/kern_alc.cpp - Resource definitions → Codec configurations: describes resources
AppleALC/kern_resources.hpp - macOS → alc-verb CLI: runs utility
- alc-verb CLI → HDA verb tables: looks up verbs
alc-verb/main.c - alc-verb CLI → Verb provider: opens service
alc-verb/main.c - alc-verb CLI → IOKit user client: calls method
alc-verb/main.c - IOKit user client → Shared method IDs: uses method IDs
- IOKit user client → Verb provider: dispatches verbs
AppleALC/ALCUserClient/ALCUserClient.cpp - Verb provider → ALC enabler: executes codec verb
AppleALC/ALCUserClientProvider/ALCUserClientProvider.cpp