From 072b8cba9fec6a6096b075365b8872d85852ec4c Mon Sep 17 00:00:00 2001 From: felikafelix <177607570+felikafelix@users.noreply.github.com> Date: Wed, 11 Feb 2026 20:22:53 +0700 Subject: [PATCH 1/4] Change installation directory to /usr/local/bin Updated installation paths to /usr/local/bin and added info messages. --- alc_fix/install.sh | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/alc_fix/install.sh b/alc_fix/install.sh index 421dc2e..04110c8 100755 --- a/alc_fix/install.sh +++ b/alc_fix/install.sh @@ -1,14 +1,16 @@ #!/bin/bash -sudo cp ALCPlugFix /usr/bin -sudo chmod 755 /usr/bin/ALCPlugFix -sudo chown root:wheel /usr/bin/ALCPlugFix -sudo cp hda-verb /usr/bin -sudo chmod 755 /usr/bin/hda-verb -sudo chown root:wheel /usr/bin/hda-verb +echo "[INFO] Installing..." +sudo cp ALCPlugFix /usr/local/bin/ +sudo chmod 755 /usr/local/bin/ALCPlugFix +sudo chown root:wheel /usr/local/bin/ALCPlugFix +sudo cp hda-verb /usr/local/bin +sudo chmod 755 /usr/local/bin/hda-verb +sudo chown root:wheel /usr/local/bin/hda-verb sudo cp good.win.ALCPlugFix.plist /Library/LaunchAgents/ sudo chmod 644 /Library/LaunchAgents/good.win.ALCPlugFix.plist sudo chown root:wheel /Library/LaunchAgents/good.win.ALCPlugFix.plist sudo launchctl load /Library/LaunchAgents/good.win.ALCPlugFix.plist +echo "[INFO] Done" exit 0 From 3135cd4182911ff8630c526fe9ae6c9610f8618b Mon Sep 17 00:00:00 2001 From: felikafelix <177607570+felikafelix@users.noreply.github.com> Date: Wed, 11 Feb 2026 20:23:24 +0700 Subject: [PATCH 2/4] Change ALCPlugFix path from /usr/bin to /usr/local/bin --- alc_fix/good.win.ALCPlugFix.plist | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/alc_fix/good.win.ALCPlugFix.plist b/alc_fix/good.win.ALCPlugFix.plist index e865a69..b7a4c72 100644 --- a/alc_fix/good.win.ALCPlugFix.plist +++ b/alc_fix/good.win.ALCPlugFix.plist @@ -8,7 +8,7 @@ good.win.ALCPlugFix ProgramArguments - /usr/bin/ALCPlugFix + /usr/local/bin/ALCPlugFix RunAtLoad From cb2b1bd139eb2746a18ed41f68765344d4321ccb Mon Sep 17 00:00:00 2001 From: felikafelix <177607570+felikafelix@users.noreply.github.com> Date: Wed, 11 Feb 2026 20:47:22 +0700 Subject: [PATCH 3/4] Add README for ALCPlugFix fork This README provides details about the ALCPlugFix fork, including the problem it addresses, the tested environment, installation instructions, and credits. --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..acbae06 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# ALCPlugFix +--- +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. + + +## Tested Environment +- ThinkPad T480s +- MacOS Tahoe 26 +- Audio Codec: ALC257 (using alcid=11) + +## The Problem +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/bin` to `/usr/local/bin`. +- **Config Update**: Updated the `LaunchAgents` (`.plist` file) binary path to point to `/usr/local/bin`. +- **Script Fix**: Patched install.sh to ensure successful deploymen on modern macOS file structures. + +## How To Use + +1. Clone this repository: + ``` + git clone https://github.com/felikafelix/ALCPlugFix.git + ``` +3. Navigate to the fix folder: + ``` + cd ALCPlugFix/alc_fix + ``` +5. Run the installation script with `sudo`: + ``` + sudo ./install.sh + ``` + +## Post Installation +After running the script, it is recommended to **restart your device** to ensure the `LaunchAgents` is properly loaded and the background service is active. + + +## Credits +Special thanks to [goodwin](https://github.com/goodwin) for creating the original **ALCPlugFix**. This fork exists to maintain compatibility with modern macOS system architectures. From 4dd7dff6e91849e3a9c6daa39b4d09f462f04490 Mon Sep 17 00:00:00 2001 From: felikafelix <177607570+felikafelix@users.noreply.github.com> Date: Wed, 11 Feb 2026 20:49:29 +0700 Subject: [PATCH 4/4] Add root user check to install script --- alc_fix/install.sh | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/alc_fix/install.sh b/alc_fix/install.sh index 04110c8..32ffa5a 100755 --- a/alc_fix/install.sh +++ b/alc_fix/install.sh @@ -1,5 +1,10 @@ #!/bin/bash +if [[ $EUID -ne 0 ]]; then + echo "[ERROR] This script must be run as root (use sudo)" + exit 1 +fi + echo "[INFO] Installing..." sudo cp ALCPlugFix /usr/local/bin/ sudo chmod 755 /usr/local/bin/ALCPlugFix