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