This fork provides a fix for audio jack issues running Hackintosh macOS Tahoe. It addresses the common problem where audio output through the 3.5mm jack malfunctions after the system wakes from sleep.
- ThinkPad T480s
- MacOS Tahoe 26
- Audio Codec: ALC257 (using alcid=11)
After waking from sleep, the external audio jack (headphones / speakers) often experiences the following symptoms:
- Extremely low volume or no sound at all.
- Distorted or "crackling" audio quality.
- Previously, the only temporary fixes were manually switching microphone inputs to "reset" the codec, or restarting the entier device.
Change in this Fork
Moden MacOS versions implement Signed System Volume (SSV), making the /usr/bin directory read-only. This fork updates the installation process to comply wit these security measures:
- Path Migration: Moved the executable binary from
/usr/binto/usr/local/bin. - Config Update: Updated the
LaunchAgents(.plistfile) binary path to point to/usr/local/bin. - Script Fix: Patched install.sh to ensure successful deploymen on modern macOS file structures.
- Clone this repository:
git clone https://github.com/felikafelix/ALCPlugFix.git - Navigate to the fix folder:
cd ALCPlugFix/alc_fix - Run the installation script with
sudo:sudo ./install.sh
After running the script, it is recommended to restart your device to ensure the LaunchAgents is properly loaded and the background service is active.
Special thanks to goodwin for creating the original ALCPlugFix. This fork exists to maintain compatibility with modern macOS system architectures.