Repository navigation
v0.3.0
Mutes your Mac's audio output every time it sleeps, locks, wakes, or unlocks — and now lives in your menu bar.
Install from a clone (recommended — you get mutewake update):
git clone https://github.com/00mkp/mutewake.git
cd mutewake && ./install.shInstall from the archives below:
tar -xzf mutewake-0.3.0.tar.gz
cd mutewake-0.3.0 && ./install.shAlready installed? mutewake update (from a clone) or mutewake update ~/Downloads/mutewake-0.3.0.tar.gz.
Requires macOS 13+ and the Xcode Command Line Tools. The daemon is built from
source on your machine rather than shipped as a binary, so you never hit
Gatekeeper quarantine.
What's new
- Menu bar item — a sleeping-speaker icon (dimmed when off) with a native menu:
on/off status, current audio, Turn On/Off, Mute Now / Unmute Now, the last five
events, Open Log, About, and Quit. - "Off" keeps the icon.
offnow just sets the flag, and the daemon stays up
idle so the menu can turn it back on. Off still survives a reboot, and nothing is
muted while it's set. Quit from the menu to stop the daemon until next login or
mutewake on. - The menu and CLI stay in sync —
mutewake offin a terminal dims the icon immediately. updateand reinstalls now keep mutewake on or off as you left it.- Hardening: a stuck
osascriptcall is killed after 3s instead of freezing the daemon. - 31 integration tests (
./test/verify.sh).
Muting behavior itself — what happens on sleep, lock, wake, and unlock — is unchanged.
Known limitation
The banner is attributed to Script Editor, not mutewake — macOS refuses to
register an ad-hoc-signed app with the notification center. See the README.