Skip to content

installer path fix #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
felikafelix wants to merge 4 commits into
base: master
Choose a base branch
from
Open

installer path fix #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
072b8cb
Change installation directory to /usr/local/bin
felikafelix Feb 11, 2026
3135cd4
Change ALCPlugFix path from /usr/bin to /usr/local/bin
felikafelix Feb 11, 2026
cb2b1bd
Add README for ALCPlugFix fork
felikafelix Feb 11, 2026
4dd7dff
Add root user check to install script
felikafelix Feb 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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)
Comment on lines +8 to +9
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling/style: Apple’s branding is "macOS" (lowercase m). Consider changing "MacOS" to "macOS" for consistency with the rest of the README.

Copilot uses AI. Check for mistakes.

## 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.
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "entier" should be "entire".

Suggested change
- Previously, the only temporary fixes were manually switching microphone inputs to "reset" the codec, or restarting the entier device.
- Previously, the only temporary fixes were manually switching microphone inputs to "reset" the codec, or restarting the entire device.

Copilot uses AI. Check for mistakes.

Change in this Fork
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section title "Change in this Fork" is missing a markdown heading marker (e.g., ##), which makes the README structure inconsistent with the surrounding sections.

Suggested change
Change in this Fork
## Change in this Fork

Copilot uses AI. Check for mistakes.
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:
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "Moden" should be "Modern".

Suggested change
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:
Modern 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:

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "wit" should be "with".

Suggested change
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:
Moden MacOS versions implement Signed System Volume (SSV), making the /usr/bin directory `read-only`. This fork updates the installation process to comply with these security measures:

Copilot uses AI. Check for mistakes.
- **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.
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "deploymen" should be "deployment".

Suggested change
- **Script Fix**: Patched install.sh to ensure successful deploymen on modern macOS file structures.
- **Script Fix**: Patched install.sh to ensure successful deployment on modern macOS file structures.

Copilot uses AI. Check for mistakes.

## 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`:
Comment on lines +29 to +33
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The ordered list under "How To Use" skips from 1. to 3.. Some Markdown renderers preserve the written numbers, which can look broken—use consecutive numbering (or all 1.) for clarity.

Suggested change
3. Navigate to the fix folder:
```
cd ALCPlugFix/alc_fix
```
5. Run the installation script with `sudo`:
2. Navigate to the fix folder:

cd ALCPlugFix/alc_fix

3. Run the installation script with `sudo`:

Copilot uses AI. Check for mistakes.
```
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.
2 changes: 1 addition & 1 deletion alc_fix/good.win.ALCPlugFix.plist
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
<string>good.win.ALCPlugFix</string>
<key>ProgramArguments</key>
<array>
<string>/usr/bin/ALCPlugFix</string>
<string>/usr/local/bin/ALCPlugFix</string>
</array>
<key>RunAtLoad</key>
<true/>
Expand Down
19 changes: 13 additions & 6 deletions alc_fix/install.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Comment on lines +8 to +12
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/usr/local/bin may not exist on a clean macOS install (it’s commonly created by Homebrew). If it’s missing, the cp lines will fail and the script will still continue. Create the directory (e.g., mkdir -p /usr/local/bin) and fail fast if that step can’t be completed.

Copilot uses AI. Check for mistakes.
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
Comment on lines +9 to 18
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The script enforces running as root (EUID==0), but the subsequent install commands still use sudo. This is redundant and can fail in non-interactive setups where sudo requires a TTY/config. Prefer either: keep the root check and remove sudo from the commands, or drop the root check and rely on sudo per command.

Suggested change
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
cp ALCPlugFix /usr/local/bin/
chmod 755 /usr/local/bin/ALCPlugFix
chown root:wheel /usr/local/bin/ALCPlugFix
cp hda-verb /usr/local/bin
chmod 755 /usr/local/bin/hda-verb
chown root:wheel /usr/local/bin/hda-verb
cp good.win.ALCPlugFix.plist /Library/LaunchAgents/
chmod 644 /Library/LaunchAgents/good.win.ALCPlugFix.plist
chown root:wheel /Library/LaunchAgents/good.win.ALCPlugFix.plist
launchctl load /Library/LaunchAgents/good.win.ALCPlugFix.plist

Copilot uses AI. Check for mistakes.
echo "[INFO] Done"

exit 0
Loading