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.
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
diff --git a/alc_fix/install.sh b/alc_fix/install.sh
index 421dc2e..32ffa5a 100755
--- a/alc_fix/install.sh
+++ b/alc_fix/install.sh
@@ -1,14 +1,21 @@
#!/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
+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
+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