Skip to content
hfustercabrePublic

About

A macOS menu bar app that pauses what's playing (music, podcasts or videos) while other apps play audio, and resumes it afterwards.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks


AutoHush

Whatever's playing steps aside when something else needs your ears.

Latest release Downloads macOS 14.4 or later GPL-3.0 license

Buy me a coffee

Meet AutoHush

AutoHush is a small menu bar app for macOS. When another app starts making sound (a YouTube video, a call, a game), it pauses what's playing in your media player: music, podcasts or videos. When that sound stops, it brings it back. You don't have to touch anything.

  • 🎵 Automatic: pauses your player when another app plays, resumes it about 2 seconds after that app goes quiet.
  • 🎚️ Gentle: playback fades out over 1 second before pausing and fades back in over 2 seconds when it resumes, and your volume is always left as it was.
  • 🙋 Respects you: if you pause, play or quit your media player yourself, AutoHush takes that as your decision and won't override it (while another app plays, only a play from a key press or click in the player counts).
  • 🔕 Ignores the noise: notification sounds, alert beeps and short chat tones don't interrupt what's playing.
  • 📱 Knows where you're listening: if Spotify plays on your phone, speaker or TV (Spotify Connect), it's left alone.
  • 🚫 Your rules: choose apps that should never pause your player, or turn Auto-Pause off for a while.
  • 🟣 AntiDot mode: an option that never shows macOS's purple recording dot.
  • 🔒 Minds its own business: no accounts, no analytics, no tracking. It never records or saves sound, and it only goes online to check GitHub for updates, and to check once that a site you add as a web app answers (more under Privacy).
  • 🪶 Featherweight: built to sip, not gulp: about 0.1 to 0.2 % CPU and 30 MB of memory while it waits or your player plays, and under 1 % while it's working, so your battery won't notice it.

Works with Spotify, Apple Music, VLC, Apple Podcasts, TIDAL and QuickTime Player, for music, podcasts and videos, and, as an experiment, with websites added to the Dock from Safari, such as YouTube Music, Amazon Music or Deezer (Safari web apps): choose yours in the menu or in Settings.

Thanks to Background Music

AutoHush was inspired by Background Music, the free, open-source audio utility by Kyle Neideck and its contributors. Among many other things, it pauses your music while other apps play, and it did so long before AutoHush existed. My sincere thanks to Kyle for building it and sharing it with everyone: it showed me this could be done, and it's still well worth a look if you also want to set each app's volume.

So why write another one? To get your Mac's sound, Background Music routes it through a virtual audio device and reads it back from there, and macOS counts that as using a microphone. So while it runs, there's a yellow dot in the top-right corner of the screen and a yellow microphone icon in the menu bar, permanently. Nothing is being recorded, and macOS is right to point it out. Still, a yellow dot that never goes away tickles my 'tism in ways I couldn't ignore, so I built AutoHush with a different approach.

AutoHush leaves your sound where it is and only checks which apps are playing. It never uses the microphone, so the yellow dot never shows up. The only dot it ever shows is macOS's purple one, and only while another app has its sound on as your player plays, which to my eyes is easier to ignore. If it still bothers you, AntiDot mode gets rid of it entirely, at the cost of slightly less precise detection.

Yes, this whole app exists because of a yellow dot.

Contents

Install

You need macOS 14.4 or later, on a Mac with Apple silicon or an Intel processor, and one of the supported players: Spotify, TIDAL or VLC (their desktop apps), Apple Music, Apple Podcasts or QuickTime Player (the Music, Podcasts and QuickTime Player apps that come with macOS), or a Safari web app, such as YouTube Music, Amazon Music or Spotify's web player added to the Dock from Safari (see Safari web apps). Another app that plays can be your player too, once Add an App… has checked how to control it.

AutoHush is free and isn't sold through Apple. It's signed, but not notarized by Apple, because notarization needs a paid developer account. All that means for you is one extra confirmation the first time you open it, and Homebrew handles even that.

With Homebrew (easiest)

brew install --cask hfustercabre/tap/autohush

This adds AutoHush's own tap, hfustercabre/homebrew-tap, and installs from it.

Moved AutoHush to the Trash yourself after installing it this way? Homebrew then stops with "the App source … is not there". Add --force: brew install --cask --force hfustercabre/tap/autohush.

By hand

  1. Download AutoHush-<version>.dmg from the releases page.
  2. Open it and drag AutoHush onto Applications.
  3. Open AutoHush. macOS refuses the first time, which is expected.
  4. Go to System Settings → Privacy & Security, scroll down and click Open Anyway next to the AutoHush message. You only do this once: AutoHush installs later versions itself.

Prefer the Terminal? This replaces step 4:

xattr -dr com.apple.quarantine /Applications/AutoHush.app

From the source code

git clone https://github.com/hfustercabre/AutoHush.git
cd AutoHush
bash Scripts/build-app.sh release
cp -R AutoHush.app /Applications/
open /Applications/AutoHush.app

Building needs Xcode 27 (macOS 26.6 or later). A copy you build can't install AutoHush's updates (DEVELOPMENT.md: Build and test, Signing and releases).

First launch

AutoHush lives in the menu bar; it shows in the Dock only while one of its windows is open, with the Mac's usual menus and keyboard shortcuts (⌘V to paste, ⌘W to close, ⌘Q to quit, ⌘[ and ⌘] to go back and forward in Settings, Return and Escape for a window's buttons). The first time it opens, it asks which media player to control. A player counts as installed when it's in /Applications, your own ~/Applications or /System/Applications, not when it's elsewhere, such as on the disk image it came from. You can change your choice any time in the menu or in Settings.

The welcome window, Choose Your Media Player: a search, then Spotify picked among the Supported Apps (Spotify, Apple Music, VLC, Apple Podcasts, TIDAL and QuickTime Player); below them Other Apps, with Add…; then the Safari Web Apps, marked Experimental: SoundCloud and YouTube Music added, Spotify, Amazon Music and Deezer to add, Apple Music untested; then Continue

macOS then asks for these permissions:

Permission What it's for Needed?
Control your media player (Automation) Pausing and resuming Spotify, Apple Music, VLC or QuickTime Player, or an app you added with Add an App… by its AppleScript. macOS asks for each player the first time you choose it Yes, for Spotify, Apple Music, VLC and QuickTime Player, and an added app controlled by its AppleScript
Accessibility Pausing and resuming TIDAL, Apple Podcasts and Safari web apps, which can't be scripted: AutoHush presses Play/Pause in TIDAL's Playback or Podcasts' Controls menu, or the web app's own Play/Pause button, and nothing else. An app you added is pressed the same way, in its menu, its page or its row in the menu bar's Now Playing panel, or by the keyboard's Play/Pause key (only while macOS says it's Now Playing), and Add an App's check needs it too. Every player is backed up the same ways when its own fails: its menu, Spotify's page, the Play/Pause key or the Now Playing panel Only with TIDAL, Apple Podcasts, Safari web apps and Add an App…; for the others' backups
Audio Recording (Screen & System Audio Recording, in System Settings → Privacy & Security) Telling an app that's playing from one that just has its sound switched on but is silent, muting an added app that can only be muted, and judging one only its sound tells about Yes, unless AntiDot mode is on (which doesn't use it, and can't mute or hear an app)
Notifications Telling you about updates (without them, the menu bar icon still shows when one is found) Optional

The audio permission sounds scarier than it is: AutoHush only measures how loud other apps are, in memory, and never records or saves anything (see Privacy). Without it, AutoHush still works, but a paused video may keep your player paused until you close it.

Right after you choose your player, the welcome window lists what it needs, each with a button: Open Spotify (macOS asks for Automation only while the player is open), Allow… (macOS's own prompt, or the right place in System Settings; AutoHush asks for audio recording only then, never by itself at launch), or Use AntiDot Mode Instead, which needs no audio permission. Done unlocks once everything is allowed, and each line ticks by itself as you go. Wherever something else needs a permission (learning a web app, adding one, Settings), it says what's missing, offers the same button, and waits until it's allowed.

If you said no by mistake, or haven't allowed audio recording yet, the menu, Settings (General for the media player, Behavior for audio recording) and those windows show the button that fixes it. While your player's own control isn't allowed but its backup controls are, one that tells whether it plays (its menu or its page) among them (with Use backup controls on), AutoHush controls it by those meanwhile, and uses its own again once you allow it. Once you allow it, AutoHush starts by itself within a few seconds. Audio recording switched on in System Settings is the exception: macOS applies it only once AutoHush is opened again, so the button becomes Reopen AutoHush, and the line says to turn it on there, then reopen. If you take a permission away later, AutoHush notices when another app starts playing or when you open the menu, and asks for it again.

Start it automatically: click Settings at the bottom of the menu and turn on Launch at login.

Keep its icon in sight: the first time it starts, AutoHush puts its menu bar icon beside the system's icons (Control Center, the clock), where the notch or other apps' icons don't hide it, unless you've already moved it. To move it, hold ⌘ and drag it; macOS remembers where. To have it go back beside the system's icons each time AutoHush opens, turn on Keep icon next to system icons in Settings → General. Can't find the icon? Open AutoHush again (from Finder, Spotlight or Launchpad): it opens Settings → General, which says when the notch or other icons hide it (or brings back a window of its own you minimized).

Using AutoHush

Every way through AutoHush, from its first launch to quitting it, is drawn as flowcharts in WORKFLOWS.md.

Click the menu bar icon to see what's going on. Its menu is AutoHush's own panel: it grows and shrinks smoothly (at once with Reduce Motion), and Escape or a click elsewhere closes it. As in macOS's own menus, the card at the top and the buttons at the bottom stay put; when the menu is taller than your screen, only what's between them scrolls, a small arrow at the bottom saying more is below (in the players' window beside it too). The keys work as in macOS's menus: ↑ and ↓ move through it row by row, Tab and Shift-Tab control by control, Page Up, Page Down, Home and End a page or to the ends, ← and → along a row, Return or Space presses, → opens a side window and ← closes it. With the keyboard on the menu bar icon (Control-F8), Space, Return or ↓ open the menu.

AutoHush's menu: Spotify paused while Safari plays, with the Auto-Pause switch and what AutoHush can do with it (Automation allowed, fades); and Change Player at the card's foot; buttons to turn AutoHush off for 5 minutes to 24 hours; Safari and VLC playing now, VLC ignored; Ignored Apps, VLC; and the Settings, Updates, About and Quit buttons

  • The card shows your media player and what's happening, such as "Playing", "Paused — Safari is playing", "Playing silently" (it says it plays but nothing of it is heard, like a muted trailer, so AutoHush leaves it alone) or "Playing on another device", and under it, as in Settings, what AutoHush can do with it: its permission allowed, and whether it fades. Anything that needs your attention shows in orange, with what fixes it under it: Allow… when AutoHush needs a permission to control your player, Try Again when the player didn't answer (also when AutoHush couldn't resume it: "Couldn't resume — Spotify didn't answer"). When the player answered with an error ("Can't control TIDAL right now") or refused to pause and couldn't be muted ("Couldn't pause — Safari is playing"), an ⓘ ends the line: click it to see why. Settings → Diagnostics shows it too, as Last error.
  • Auto-Pause, on the card, turns everything on or off: its switch, or a click anywhere on the card. Turning it off brings back what AutoHush paused.
  • Change Player, the card's last row, opens the players to choose from in a window beside the menu, as a submenu (a click, or the pointer resting on it) (choosing one keeps the menu open, the card showing what the new one can do), with a checkmark on yours (↑ and ↓ move through them, and Return chooses the one highlighted or, while you search, the first left): under Supported Apps, the most used first; those not on your Mac are dimmed and listed after them. The apps you added yourself follow, under Other Apps (see Other apps), with Add an App… after them, and your Safari web apps come last, under their own heading: the tested ones first (Spotify, YouTube Music, Amazon Music, Deezer, SoundCloud), then those of them you haven't added yet, then any other, marked Untested. With eight players or more, not counting the ones you haven't added, a search comes first (and in the welcome window too). The players you didn't choose count like any other app: if one plays, it pauses your player, unless you ignore it.
  • Turn off for pauses AutoHush itself, from 5 minutes to 24 hours, in one click. While it runs, it reads Turned off for, with the time chosen selected and the time left; it hides while Auto-Pause is off.
  • Playing Now lists the apps playing sound, each with a switch (as on every row with a switch, a click anywhere on the row flips it): turn it off for an app that shouldn't interrupt your player, such as a game whose soundtrack you don't mind. They're listed while your player isn't open too, as long as Auto-Pause is on.
  • Recently Played, under it, lists the apps that played in the last 30 minutes, the last four at most, with the same switches: handy for one that stopped before you could switch it off.
  • Ignored Apps names the apps you've switched off; its row opens them beside the menu, each with its switch: switch one back on to undo. Ignore an App… under them (Ignore Another App… once you've ignored one) picks apps to ignore, several at once (an alert names any it can't ignore). It's there even before you've ignored any, saying None. AutoHush adds BetterDisplay, MonitorControl and Lunar itself the first time they run (and again after Reset List…), since they play only the volume sound.
  • The buttons at the bottom open Settings (every setting is there), check for updates, open Settings → About, and quit. When an update is available, Updates shows in the accent color and a row above the buttons offers to install it.
  • The menu bar icon shows what's happening: sound bars while your player plays, a dot and a pause sign when AutoHush paused it, three dots when nothing plays or your player plays silently, an arrow when it plays on another device, hollow bars while starting, and "!" when something needs your attention. It's dimmed and slashed while Auto-Pause is off.

Safari web apps

Any website you add to the Dock from Safari (open it, then File → Add to Dock) can be your media player: YouTube Music, Amazon Music, Spotify's web player, or any other. AutoHush lists your web apps under Safari Web Apps wherever it offers players, each with Safari's icon on its own, so a web app isn't taken for an app of the same name (Spotify's web player and its app). Support for them is experimental, and says so: every website works differently, so a web app may not pause or resume as expected. AutoHush has been tested with Spotify, YouTube Music, Amazon Music, Deezer and SoundCloud: their web apps are listed first. Any other web app is listed after them, marked Untested: it may work just as well, but nobody has checked. A tested site's web app is listed under the site's name ("YouTube Music", whatever Safari called it), and any other under its page's title without the slogan after " | " or a dash.

AutoHush can make one for you, too: choose Add a Web App… (last among the players in the menu, or the last tile in Settings → Media Player and the welcome window) and paste the website's address. The tested sites, Spotify, YouTube Music, Amazon Music, Deezer and SoundCloud, are listed with a download symbol until you add them; choosing one opens the window with its address filled in. Amazon Music has its own site in some countries, and you can sign in only on your account's: the window opens the one for your Mac's region and, under the address, lets you choose your account's country (or Other Countries, for music.amazon.com). Then:

  1. AutoHush checks the address and asks the site once whether it answers, then opens it in Safari.
  2. Once the site shows there, click Add to Dock in AutoHush's window: AutoHush opens Safari's own Add to Dock window, where you can change the web app's name, and you click Add there. If you close Safari's window with Cancel, the step says so and Add to Dock opens it again.
  3. AutoHush then chooses the new web app and opens it, and the same window learns its controls.

While it adds and learns, the window stays above other apps, in the top-right corner of the screen, so Safari and the web app don't hide it (the learning window does too). While Safari's Add to Dock window shows, it moves beside it.

  • Safari makes the web app from the page it shows, so if the site asks something first on another of its addresses (YouTube's cookie page on consent.youtube.com, in Europe, or a sign-in page), an Answer the site in Safari step waits until you've answered and the site itself shows. Answer anything else it asks (a cookie banner) before clicking Add to Dock.
  • If a Safari extension asks for access to the site while it opens, answer it first: Safari can't add the site while it waits.
  • A website that already has a web app isn't added again.
  • Cancel, or closing the window, stops it before anything is added (Safari's dialog is cancelled too); once added, the Safari tab AutoHush opened is closed (its window, when it's the only tab there).
  • Adding it this way needs the Accessibility permission, as controlling it does.

Web apps can't be scripted and have no playback menu, so AutoHush presses the site's own Play/Pause button, and the site stays in step. Sites differ, and their buttons are named in the site's language, so AutoHush learns the button with you:

  1. When you choose a web app, a window asks you to play something in it and click It's Playing. Log in to the site first if it asks (a site that needs an account plays nothing until you do), and click It's Playing only once what you chose plays: during an ad, the site's own button may say it's paused.
  2. AutoHush then pauses it itself with the keyboard's Play/Pause key (Let AutoHush pause it), sees which button changed, and plays it again. That's all; it closes by itself.
  3. macOS sends that key to the app it counts as playing, "Now Playing": the last one that started to play. If that's another app (one that started after the web app, say), AutoHush doesn't press the key at all, and goes straight to the step where you pause it yourself (below). If the key doesn't take (the site may ignore it), it presses it again to undo it and marks the step failed, with Try Again and Pause It Yourself. The latter adds a step: pause it yourself and click It's Paused; the button that changed between the two is the one. Paused by hand, you have a minute to pause it and click It's Paused (a line under the step counts down); then it starts over.

If Accessibility isn't allowed yet, its first step asks for it, and the others unlock once it is. A click AutoHush can't take says why under its step: It's Playing while it can't hear the web app, or can't read its page (it isn't open, has no window, or shows its buttons without their names, as a window macOS reopens at login can: open its window, or close it and open it again), or It's Paused while no button has changed.

The steps show only in these windows. If you close the window with Later, the Controls row in the menu's card and in Settings → General says they aren't learned yet, and its Learn Controls… button opens a new window that starts from the first step. Until it knows the button, AutoHush presses nothing on the page.

  • It works with the web app's window visible, minimized, or on another Space (another desktop). With more than one window of the same web app, AutoHush follows the one that plays. Closing the window stops playback, as it does in Safari.
  • It needs the Accessibility permission, and pauses and resumes without fading.
  • When a site won't pause, AutoHush mutes the web app instead: during an ad that can't be paused (the site disables its button, or the button reads "Play" while the ad plays, as on YouTube Music), or when a press doesn't take. As soon as the site can be paused (the ad is over and what you chose plays), AutoHush pauses it and unmutes it, so you don't miss any of it, and plays it when the other app stops. It never mutes a web app that paused. Once its button is learned, its backup controls are used too (unless Use backup controls is off in Settings → Fine-Tuning): a refused pause is then muted by AutoHush, which meanwhile tries the keyboard's Play/Pause key once and the Now Playing panel once (while Use the Now Playing panel while muted is on), and keeps it muted until the other app stops; when it can't be muted, or a play doesn't take, they're tried at once. An ad whose button reads "Play" is still muted by the web app itself. Muting uses macOS's own per-app audio taps, so it needs the audio permission and isn't available in AntiDot mode.
  • If the site changes so much that the button can't be found for a minute while the web app plays, AutoHush asks you to tell it once more when it plays and when it's paused, and remembers both layouts. A page that isn't playing doesn't count: a fresh YouTube Music window shows its player bar only once something plays.
  • If AutoHush pauses or resumes a web app at the wrong times, it may have learned the wrong button, or its words the wrong way round: Learn Again… in the Controls row (in the menu's card and in Settings → General) asks you once more, in a new learning window, to tell it when the web app plays. What it learned keeps working until you click It's Playing there, and is forgotten only then: close the window before that (or click Later) and nothing changes. A learning window still open is closed and starts over.
  • Deleting the chosen web app leaves no player chosen, and the window to choose another opens: adding the site again makes a new web app, which learns its button again.
  • Settings → Diagnostics shows whether the button has been learned.

Other apps: Add an App…

AutoHush can also control an app it doesn't support itself, once it has checked how: choose Add an App… (after Other Apps among the players in the menu, or the Add… tile under Other Apps in Settings → Media Player and the welcome window). A window lists the steps:

  1. Choose the app. Choose an App… opens the list of the apps on your Mac that can play, those in macOS's Now Playing first, with a search; Other App… picks any other app on your disk. A web app made by Chrome, Brave or another Chromium browser shows that browser's icon on its own, and its name under it, so two web apps of one site aren't confused. Apple's apps that aren't media players (Mail, Maps, Notes, Xcode…) and the players AutoHush supports aren't listed. If the app isn't open, AutoHush opens it in the background.
  2. Allow what the check needs, only what that app needs, all at once. Accessibility is needed: the check reads the app's menus and page, moves its window and blocks the mouse and keyboard with it. Audio Recording is optional: without it, or in AntiDot mode, which taps no sound, the check can't mute only the app, so AutoHush mutes your Mac's sound while it runs and puts it back after. Automation is asked for only when the app can be scripted, and is optional too: without it, its AppleScript isn't tried. A warning says what the check does without the ones you leave out, with Continue; with everything allowed it goes on by itself.
  3. Reopen it, only for an app built with Electron (Deezer, Qobuz…) that was opened without the option its page needs to be pressed while its window is covered or on another desktop. AutoHush asks first, since reopening stops whatever it plays; Skip goes on without, and AutoHush can then pause it only while its window can be seen.
  4. Play something in it. AutoHush goes on as soon as the app plays, within 2 minutes. With Audio Recording, outside AntiDot mode, it listens for the app's sound, so an app that keeps its sound output open while paused doesn't count; otherwise an open sound output does.
  5. The check. Continue… first shows what it does: for about 3 minutes, AutoHush pauses and plays the app every way it can find (its AppleScript, its playback menu, its page's Play/Pause, its row in the menu bar's Now Playing panel), with its window in 7 states: in view, covered, on another desktop, covered there, full screen, minimized and hidden (with its windows closed, as a menu bar player playing on, the warning says so: nothing is moved, the mouse and keyboard stay free, and each way that needs no window is tried once, in under a minute). AutoHush shows the other desktop with Mission Control's Move left a Space and Move right a Space shortcuts: when they're off, the warning says so, with Open Keyboard Settings…. The app is muted meanwhile: on its own with Audio Recording and outside AntiDot mode, else with your Mac's whole sound (unless its output has no mute control, as some HDMI and USB ones; an output the sound moves to meanwhile is muted too), put back as it was afterwards, even if AutoHush quit meanwhile. While AutoHush moves windows, it blocks clicks, scrolling and keys (the pointer still moves, except during a drag) and dims the screen, except a small panel at the bottom right with the progress and Stop, on every desktop. Escape or Stop ends the check; whenever it asks you something, the mouse and keyboard are yours again. Windows, desktops and sound are put back as they were, also when you stop it. A player AutoHush paused stays paused until the check ends (the menu says Paused while a check runs).
  6. See what worked, and use it. The ways that worked, everywhere, with the window in some states or with its windows closed, are cards to choose from: the recommended one first, chosen until you pick another (the Now Playing panel comes last, as it opens on screen for a moment); the ways that didn't work are listed under them, with why. Checked with its windows closed, a way that didn't work, or wasn't checked for want of a window, may work with one open: open a window, then Check Again, beside Use, checks the app again (AutoHush waits for the window as well as for it to play). Until that check starts, Back to Result brings this result back. Use adds the app under Other Apps, marked Checked by you, and makes it your media player, paused and played the way you chose, the other ways that worked as its backup controls (Use backup controls, on unless you turn it off here or later in Settings → Fine-Tuning, where you can also choose another main control, with Use the Now Playing panel while muted under it while it's on and the panel is one of the backups): with its window in a state where your way didn't work in the check (minimized, say), one that did is used, then the keyboard's Play/Pause key (only while macOS says the app is Now Playing), the Now Playing panel last. When a pause doesn't take, it's muted instead, as any player (with Audio Recording, outside AntiDot mode), and the other ways are tried while it's muted, one at each retry (the key once, the panel once while its switch is on); when it can't be muted, or a play doesn't take, they're tried at once; if none works, the pause fails and the menu says so. With Use backup controls off, only your way is used. An app added before backups keeps its one way until it's checked again. To remove an app you added, click the × on its tile in Settings → Media Player or the welcome window (it shows under the pointer or with the keyboard's focus), right-click the tile, or hold ⌥ Option in the menu's list of players, where its row becomes Remove …; AutoHush asks first. Removing your current player opens the window to choose another. The app stays on your Mac, and Add an App can check it again. A finished check waits for Use for up to a day, so closing the window or reopening AutoHush doesn't mean checking again; checking another app replaces it.
  • A page's switch: for an app built with Electron, Chromium or Flutter, AutoHush turns on the app's switch for assistive tools (as VoiceOver does) to read its page, and keeps it on while the app is your player (a browser's switch, shared by its web apps, while any of them needs it).
  • If the app was opened without its option while it's your player with its page as one of its controls, its main one or a backup in use (from the Dock, say), the menu bar icon shows "!", the card says it needs reopening, and Reopen (there and in Settings → General) reopens it as it needs. Choosing such an app as your player asks first, in an alert; with Always reopen … this way ticked there, AutoHush reopens it so from then on, without asking, whenever it finds it opened without its option.
  • If no way works (an app with no AppleScript, no playback menu, a page whose button doesn't change, and no working Now Playing row), the last step says so and offers Mute It Instead: AutoHush then mutes the app while other apps play, never pausing it, so it keeps playing, silent, and is heard again when they stop (you miss that part of it). The menu says "Muted — Safari is playing", with Unmute (Settings → General has it too), and the app is marked Muted instead of paused among the players (Muted only on its tile). Pausing it and playing it again yourself while it's muted (stopped for 3 seconds or more, so a gap between songs doesn't count) unmutes it, and AutoHush leaves it alone until the other apps stop, as when you play a paused player yourself. Muting uses macOS's per-app audio taps, so it needs Audio Recording and isn't available in AntiDot mode: there the last step doesn't offer it (it offers Turn Off AntiDot Mode instead), and an app added that way is dimmed among the players, marked Not in AntiDot mode (Not in AntiDot on its tile), and while such an app is your player, the AntiDot mode switch is off and dimmed. Quitting AutoHush always unmutes it. The check's log, the newest … check.log in ~/Library/Logs/AutoHush/Checks, says what was tried, leaving out your Mac account's name and what was playing: you can ask for the app with it.
  • The Now Playing panel needs Now Playing in the menu bar (System Settings → Menu Bar; Control Center on macOS 14 and 15). If you hid it there, AutoHush shows it for the moment of a press and hides it again (in under a second, without touching anything else). It leaves the setting alone if you changed it meanwhile, and should AutoHush or its check quit during a press, your setting is put back afterwards. Only if it can't be shown does the check mark the panel as not tried and a pause through it fail, both saying where to show it, with Open Menu Bar Settings… to go there; once you've shown it, Check Again, beside Use, checks the app again. Whatever covers its icon (a wide app's menus by the notch, another app's window) doesn't matter: AutoHush finds it in the menu bar's own windows. Some apps' rows there never show whether they play (Qobuz's always shows paused): the check then presses the row as a toggle when the app's sound says otherwise, and AutoHush does the same, listening to the app for half a second just before it pauses or plays it. That needs Audio Recording, so in AntiDot mode such a way can't be chosen, and an app added that way is treated as one that can only be muted: dimmed among the players, and while it's your player the AntiDot mode switch is off and dimmed.
  • Apps added this way pause and resume without fading, unless they're controlled by an AppleScript that has a volume.

Settings

Settings, General page: the sidebar with Everyday (What most people change: General, Media Player, Sound Sources, Behavior), Advanced (Fine-tuning and checks: Fine-Tuning, Diagnostics) and About, AutoHush's version and a link to support it; the page with your media player and what works with it, Change…, the Auto-Pause switch, and Startup and Menu Bar

Settings has a page for each of these in its sidebar, and Back and Forward arrows before the page's name, as System Settings does (a row in Behavior opens Fine-Tuning; ‹ brings you back). The pages come in two groups: Everyday, what most people change, and Advanced, for fine-tuning and checks. The sidebar also shows AutoHush's version and a link to support it. Edit → Undo (⌘Z) brings back what a Restore Defaults changed, or the apps you removed from Sound Sources, until Settings closes. You can resize the window; it opens where you left it. It takes the arrow keys as the menu does, ← going to the sidebar and → back to the page; Tab and Shift-Tab go control by control, through the sidebar and the page in turn, and Return, Space, ← and → act on the highlighted control.

General

Your media player, with what it's doing, whether AutoHush may control it and whether it fades, Change…, which shows the Media Player page, and the Auto-Pause switch, with a row to Sound Sources under it.

  • Startup and Menu Bar (with its Restore Defaults): Launch at login, Keep icon next to system icons

Media Player

Every player as a tile, to choose another: the apps under Supported Apps, the apps you added under Other Apps with an Add… tile for Add an App, then the Safari web apps and Add…; above them, as on General, what your player still needs to be controlled, with the button that allows it, then your player's Controls row, with what they're set to ("AppleScript · backups on · panel while muted on"), which shows them in Fine-Tuning; an app that's only muted has none.

Sound Sources

Every app that has played sound, each with a switch for whether it pauses your player, sorted by Last Played (the default), Name or Status; the arrow beside Sort by reverses the order, and the magnifier searches the apps by name. Ignore an App… (Ignore Another App… once one is ignored) adds apps before they ever play, several at once. Click an app, or ⌘-click or ⇧-click several, and Remove takes them off the list, as does Remove from List when you right-click one of them (ignored apps ask first, once, since they would then pause your player again; ⌘Z puts them back), or use Reset List… to start over.

Behavior

The switches, by card, each card with its own Restore Defaults and, at its foot, the row to its settings in Fine-Tuning with what they're set to ("Pause playback after 0.5 s").

  • Pausing:
    • Pause for the microphone (off by default): an app that turns on its microphone pauses your player once it's been on for a second, before it plays any sound (a call that starts muted or in a waiting room); the card says "Paused — zoom.us is using the microphone" until it makes a sound, and your player resumes once no app uses the microphone and nothing else plays. AutoHush only reads whether an app's microphone is on, which needs no permission (AntiDot mode too)
    • Pause on disconnect (off by default): when the headphones or another output your player plays through are unplugged or go out of range (AirPods moving to your iPhone too), your player pauses at once, without a fade, instead of moving to the speakers, and stays paused until you play it; choosing another output yourself doesn't count. Some players already do this themselves. It works with Auto-Pause on
  • Resuming:
    • Resume playback (on by default): your player resumes once the other apps go quiet; turned off, AutoHush only pauses it, and it stays paused until you play it, even if you turn Auto-Pause off meanwhile. What only matters when resuming is greyed out then, saying why: Resume playback after, the fade-in, Level the volume and Stay paused after calls
    • Stay paused after calls (off by default): your player isn't resumed when a call came while it was paused (greyed out with Resume playback off, which keeps every pause)
  • Fades: a switch that turns them on or off; dimmed with a player that can't fade (TIDAL, Apple Podcasts, Safari web apps, and an app added with Add an App… unless it's controlled by an AppleScript with a volume)
  • Volume: Level the volume (off by default): when the apps your player was paused for were quieter than it, it resumes with the Mac's volume lowered to match, and AutoHush leaves it there: it never raises the volume again, so it's yours to set. Calls (an app using the microphone) don't count. It needs an output with a volume control (not HDMI or DisplayPort) and is off in AntiDot mode and with Resume playback off
  • Modes: AntiDot mode

Fine-Tuning

Your player's controls, then what Behavior's switches use, each card with its own Restore Defaults; what doesn't apply is greyed out, saying why.

  • Your player's card: its Main control, the way AutoHush pauses and plays it first, to choose from those that worked (the recommended one first; just its name when there's only one), with where it works under it; Use backup controls (its other ways to pause and play it, tried when its main one fails), Use the Now Playing panel while muted (when the panel is one of its backup controls; dimmed while the first is off), and Details…, which lists its main control and its backup controls with how each works. An app you added before backup controls existed says to Check Again… for them, and a web app gets them once its button is learned (Learn Controls…); while they stand in for a permission your player lacks, the card says so; an app that's only muted has no card
  • Timing: how long an app must play before your player pauses (0.5 s), and how long the apps must be quiet before it resumes (2 s, at least 1 s; greyed out with Resume playback off)
  • Fade Lengths: how long playback fades out before pausing (1 s) and back in when it resumes (2 s; greyed out with Resume playback off), where 0 turns one fade off
  • Volume Limits: Level the volume's: only when the other apps were quieter by 2 dB or more (Only when quieter by, 1 to 10 dB), and by 10 dB at most (Lower by at most, 2 to 20 dB)
  • Detection: AntiDot mode's ways of detecting, what counts as silence (−60 dB; greyed out in AntiDot mode, which doesn't measure sound), and Pause for VoiceOver (on: VoiceOver speaking pauses your player, as any app heard; off, Sound Sources doesn't list it)

Diagnostics

What AutoHush sees right now: how it's doing, every app with its sound on and how it judges it (playing, ignored, silent) and why, then your media player (with its last error; Controlled by: its main control, then the backup controls in use, each marked when it paused or played it last, and their switches; and for TIDAL and Apple Podcasts whether their own words for Play and Pause could be read), Behavior's settings (a timing or a length only while it's used), the detection, each permission and whether it's allowed, AutoHush's own settings, and your Mac. Each part folds away under its heading. It's updated as it happens. Copy Report copies it all, to send with a bug report, and Show Logs… opens what AutoHush logged (this launch or the last 24 hours, every entry or only problems), to copy or save too.

About

AutoHush's version and what it does, its Updates (automatic checks, what happens when an update is found, release candidates, see Updates, Check Now and Restore Defaults), links to the help (the tips below), the release notes and a new issue, and the copyright.

AutoHush uses macOS's own controls, text styles and colors, so it looks like the macOS it runs on; from macOS 26, its menu's panel and card are Liquid Glass.

Language

AutoHush speaks 38 languages, every language macOS itself comes in: English, Spanish (Spain and Latin America), Catalan, German, French (France and Canada), Italian, Portuguese (Brazil and Portugal), Dutch, Swedish, Danish, Norwegian, Finnish, Polish, Czech, Slovak, Hungarian, Romanian, Croatian, Slovenian, Greek, Ukrainian, Russian, Turkish, Arabic, Hebrew, Hindi, Indonesian, Malay, Thai, Vietnamese, Japanese, Korean and Chinese (Simplified, Traditional, and Traditional for Hong Kong). In Arabic and Hebrew it reads right to left. It uses the first of your Mac's preferred languages that it has (System Settings → General → Language & Region), and English otherwise. To give AutoHush a language of its own, add it to the Applications list in that same pane.

Warning

Only English, Spanish (Spain) and Catalan have been checked by a native speaker. The other languages were translated automatically, so they may contain mistakes or odd wording. If you spot one, please report it with the text and a better wording.

Shortcuts and Focus

AutoHush's Auto-Pause switch can also be set from the Shortcuts app and by a Focus:

  • Three actions in the Shortcuts app:
    • Set Auto-Pause turns it On or Off, or switches it with Toggle. Off lasts until it's turned on again, and On also ends a Turn off for.
    • Turn Off Auto-Pause For turns it off for 5 Minutes, 15 Minutes, 30 Minutes, 1 Hour or 24 Hours, as the menu's buttons do, and it comes back on by itself.
    • Get Auto-Pause tells whether it's on now: it isn't while it's off or turned off for a while.
  • Ready-made shortcuts: "Turn off Auto-Pause in AutoHush" and "Turn on Auto-Pause in AutoHush" work in Shortcuts, Spotlight and Siri with nothing to set up.
  • A Focus filter: in System Settings → Focus, choose a Focus, click Add Filter… under Focus Filters, choose AutoHush and set Auto-Pause to On or Off. While that Focus is on, Auto-Pause follows it. When the Focus ends, Auto-Pause goes back to how it was, unless you changed it meanwhile. That works even if AutoHush quit or the Mac restarted during the Focus.

The actions change the running AutoHush, and the menu shows the change at once; if AutoHush isn't running, macOS opens it in the background first. They need no permission. A copy you build from the source code lists them, but runs them only when it's signed with an Apple developer certificate (see DEVELOPMENT.md).

The purple dot and AntiDot mode

To hear whether another app is really playing, AutoHush has to measure its sound level. Whenever an app does that, macOS shows a purple dot in the menu bar. It's a privacy feature that no app can hide, and that's a good thing.

AutoHush keeps the dot to a minimum: it only measures while the answer matters, that is while your player is playing on this Mac (or was paused by AutoHush) and another app has its sound on; then it measures your player too, to know whether it's heard. Apart from that, your player is measured only rarely, for half a second: when an app you added doesn't tell clearly whether it plays (its Now Playing row doesn't show its state, or it reports being paused while its sound is on), just before pausing or playing it, or once per such report. So:

  • Your player paused, or on another device: no dot. Playing on its own, with no other app's sound on: no dot either, opening the menu included.
  • Another app playing over your player: the dot shows while that app has its sound on, plus 2 seconds.
  • An app that keeps its sound on while silent (some players do, paused): the dot shows for its first 10 seconds of silence, then AutoHush stops measuring it until it opens its sound again or tells macOS it plays; while your player plays, it's measured again for half a second every 30 seconds, and once just before AutoHush resumes your player, in case it plays without saying so (a game). An app you've ignored never is. An app that keeps telling macOS it plays (a call) stays measured, so its next sound is heard.

If the dot bothers you, turn on AntiDot mode (Settings → Behavior → Modes; its ways of detecting are in Fine-Tuning). AutoHush then never measures any sound, so the dot never appears. Instead, it goes by what apps tell macOS: most players and browsers say "I'm playing, don't go to sleep" while they play, and stop saying it when you pause. It needs no extra permission, and treats every app the same way.

The catch is that it's a little less precise (measured on macOS 27):

Normal mode AntiDot mode
Purple dot Sometimes, while needed Never
Playback pauses for a video After 0.5 s After 0.5 s (3 s in apps that don't say when they play, like QuickTime)
…for sound without video After 0.5 s After 3 s, so that notification sounds don't pause it
Playback comes back after you pause Firefox ~2 s ~2 s
…Chrome ~2 s ~4.5 s (Chrome keeps saying it plays for 2.5 s)
…a Safari video ~2 s ~2 s once AutoHush has seen Safari play a video in the background, ~9.5 s before that
…QuickTime, or Safari playing sound without video ~2 s ~9.5 s (they don't say when they play, so AutoHush waits for them to switch their sound off)
A notification sound in an app that doesn't say when it plays Ignored Pauses playback for about 10 s
An app that never says it's playing and keeps its sound on while paused Playback comes back Playback stays paused until you close that app
A muted video Playback comes back Playback comes back in Chrome and Firefox, stays paused in other apps

AntiDot mode offers two ways to detect playing apps: What apps tell macOS (recommended), as described above, or Any app with sound on, where an app counts as playing while its sound is switched on, even when paused: simpler, but stricter. Turned off and on again, AntiDot mode keeps the way you chose. There, any app's sound must stay on 2 seconds before your player pauses, so notification sounds don't pause it either.

Tips and troubleshooting

Help → AutoHush Help (⌘?), in the menu bar while one of AutoHush's windows is open, opens this section.

  • Another app paused your player as it started? Some apps pause other players themselves when they play: VLC does with Spotify and Apple Music, unless VLC → Settings → Interface → Control external music players says Do nothing. AutoHush resumes that pause like its own when the app stops, but only if your player stopped as the app's sound began: within a second after (or up to half a second before, as AutoHush hears an app a moment late). It works with the players that report a pause at once, such as Spotify and Apple Music, the ones VLC pauses.
  • Your player plays on through AutoHush's pause, or starts again by itself (an autoplay, the next trailer, an ad)? AutoHush mutes it until the other apps stop, the menu saying Muted and the playing app Mutes your player (with Audio Recording; not in AntiDot mode), and listens to it every second: once it's silent (it paused itself) it counts as paused, kept muted until it plays again (the resume, or you); while it's heard, AutoHush tries its pause again every 2 seconds (with backup controls on, by its controls in turn: the Play/Pause key once in each pause, the Now Playing panel once while its switch is on), and less often while that keeps failing (at most once a minute). A player that refuses to pause is muted too; one whose pause is a mute already (Mute It Instead, a web app during an ad) keeps its own. Unmute on the card lets you hear it until the other apps stop. A player that's heard while it says it's paused or stopped is muted too, and only unmuted once it's silent or the apps stop, never played. If you pause it while it's muted (a key press or click in it, then silence within 3 seconds), it's unmuted and stays paused. If it was paused and you play it again (a key press or click in it once it's in front, or a click in its own menu bar icon or menu, then its sound within 3 seconds), it's yours and AutoHush leaves it playing. Media keys and your headphones' button don't count: while another app plays, macOS sends them to that app. Turning AntiDot mode on, or the Mac going to sleep, pauses it for real (with backup controls on, by each of them in turn if need be), then unmutes it (if it refuses, the menu says Couldn’t pause). In AntiDot mode, where nothing is heard, a player that says it plays again during AutoHush's pause is yours only after a key press or click in it within 3 seconds; otherwise it's paused again. Its sound decides: while nothing of it is heard, the pause stands, whatever it says. Your player starting while another app plays is paused too, unless a key press or click in it came within 3 seconds before.
  • I paused my player myself and it stayed paused. That's on purpose: AutoHush only resumes what it paused, or what another app paused just as it started. A player found stopped stays stopped too.
  • Your player stayed paused after the Mac slept. That's on purpose too, as media players do after a sleep: the other app's sound stops when the Mac falls asleep, which isn't it ending. Play it again when you want it.
  • Switched players? If AutoHush was holding your previous player paused, it keeps watching it and plays it again when the other apps stop, as it would have, even if AutoHush quits and opens again meanwhile. It leaves it alone if you play or quit it yourself first; choosing it again takes the pause back; and the Mac sleeping forgets it, as any pause. Apart from that, the previous player counts like any other app.
  • TIDAL, Apple Podcasts and Safari web apps pause without fading. AutoHush can't read or set their volume, so it pauses and resumes them straight away. It notices when you pause or play them yourself (and VLC and QuickTime Player) within about a second. If an update changes TIDAL's Playback or Podcasts' Controls menu, AutoHush may not be able to control them until AutoHush is updated too.
  • QuickTime Player pauses every movie or recording it's playing, and plays again those it paused, fading each one's own volume.
  • Deezer's app can be added with Add an App…. It can't be scripted and ignores its menu's presses, but its page's Play/Pause works, once it's opened with the option Add an App asks to reopen it with. Its web player works too, as a Safari web app. If you find a way to control an app Add an App can't, please open an issue explaining it, or send a pull request. Either way, it has to keep to AutoHush's principle of being as unintrusive as possible: no virtual audio devices or microphones, and nothing that reroutes your Mac's sound.
  • Only one AutoHush runs at a time. Opening another copy (a newer version, a second install) quits the one that's running, and takes over any pause it was holding. Delete the copies you don't use.
  • Your player keeps playing during a video. Check that the app isn't ignored (menu → Ignored Apps) and that Auto-Pause is on.
  • Your player stays paused after a video ends. Some apps keep their sound switched on after playback. Allow audio recording, or in AntiDot mode close the app or tab.
  • Something looks off? Settings → Diagnostics shows what AutoHush sees (to go straight there, hold ⌥ Option in the menu: Settings becomes Diagnostics), and Copy Report copies it for a bug report. Show Logs…, beside it, shows what AutoHush did and what went wrong.
  • A permission warning, or "isn't responding". A missing permission stops AutoHush only when your player's backup controls can't stand in (none allowed that tells whether it plays); while they do, the menu shows the permission to allow under its card, with "Its backup controls are used until then, or until you choose another main control in Fine-Tuning." Fix the cause and AutoHush starts by itself: a few seconds after you allow access (audio recording: once you reopen AutoHush), or once the player answers again (it keeps trying, up to once a minute). Try Again on the card tries again at once. "Spotify isn't running", in grey, needs nothing: AutoHush starts on once Spotify opens.
  • A permission AutoHush asks for is already switched on in System Settings? That can happen once, after you replace AutoHush 0.12.1 or earlier with 1.0.0 or later by hand: from 1.0.0 AutoHush is signed with another certificate, and the switch belongs to the old copy. In System Settings → Privacy & Security, open that permission's list (Accessibility, say), select AutoHush, remove it with −, then allow AutoHush again.

Privacy

  • AutoHush never records, saves or sends audio, and never uses the microphone.
  • With the audio permission, it reads other apps' sound only to work out how loud it is, in memory, and throws the rest away. It measures your player the same way whenever it measures another app (not during the half-second listens to an app that went quiet), to know whether your player is heard (and, with Level the volume on, how loud it was). It does the same, for half a second, only in a few rare cases: a web app that can be heard while its button says it's paused (an ad), and an app you added that doesn't tell clearly whether it plays (its Now Playing row doesn't show its state, or it reports being paused while its sound is on), just before pausing or playing it, or once per such report. In AntiDot mode it doesn't look at any sound at all.
  • To tell your play from the player's own, it reads when you last pressed a key or clicked (the time only), and which app is in front.
  • It only goes online to check GitHub for a new version once a day, to download that version from GitHub, and to check a website you add as a web app (below). You can turn off the first two (see Updates). None of them leaves a cache or cookies on your Mac, and a downloaded update is kept for at most 7 days.
  • Its only notifications are about updates.
  • It keeps a log of what it does on your Mac only, in ~/Library/Logs/AutoHush/AutoHush.log: the last 24 hours at most, private details left out (when a player answers with an error, only its number, never its message, which can name what was playing). Settings → Diagnostics → Show Logs… shows it; it leaves your Mac only if you copy or save it.
  • While it learns a web app's controls, or before pressing the Play/Pause key as a player's backup, it asks macOS which app is Now Playing, only to know whether the key would reach that app.
  • While Spotify is your player with its backup controls on (or its page chosen as its main control), its switch for assistive tools is on (it shows Spotify's page to AutoHush), so its page's Play/Pause can back up its AppleScript; AutoHush learns that button itself as it pauses Spotify, and keeps it in its preferences, as a web app's.
  • It controls only the media player you chose: Spotify, Apple Music, VLC and QuickTime Player through the standard macOS automation mechanism, TIDAL and Apple Podcasts by pressing Play/Pause in their Playback or Controls menu, a Safari web app by pressing the site's own Play/Pause button, and an app you added with Add an App… the way you chose; each, when that fails, by its backup controls while they're on (Settings → Fine-Tuning). With Now Playing hidden in the menu bar, AutoHush and its check show it for the moment of a press, then put your setting back.
  • Add an App's check reads only the chosen app: its scripting dictionary, its menus, its page's buttons, its sound's level (in memory, as above; not in AntiDot mode) and, on an administrator's account, what it reports to Now Playing in macOS's log. It keeps in AutoHush's preferences how to control the app (the way you chose and the others that worked, how each did in each window state, and its page's Play/Pause words and place, or its Now Playing row's text, below) and a finished check not used yet, for a day at most; what it learned of the app in ~/Library/Caches/com.autohush.AutoHush/PlayerCheck (where its page's Play/Pause is, its own words for Play and Pause, and the text of its row in the Now Playing panel, which is what was playing then), so the next check starts from there; and a log of each check (and Reopen) in ~/Library/Logs/AutoHush/Checks (the last 50 runs), which leaves out your Mac account's name and what was playing.
  • With an app you added as your player, AutoHush also reads what that app reports to Now Playing from macOS's log while AutoHush runs, on an administrator's account, whenever the app's other signs don't tell whether it plays: only the lines macOS's Now Playing service writes about apps' playback, in memory. If it's controlled through the menu bar's Now Playing panel, AutoHush keeps the text of the panel row it last pressed in its preferences, to find that row again: that text is what was playing then (its title, artist and album).
  • When you add a web app from its address, it asks that website once whether it answers, without cookies or a cache, before opening it in Safari.
  • With a Safari web app, it reads the names of the page's buttons, in memory, to find its Play/Pause button. It keeps only that button's two words ("Play", "Pause", in the site's language) and where the button is, never what you listen to or anything else on the page.

Updates

AutoHush checks GitHub for a new version once a day. What happens when it finds one is up to you (Settings → About → Updates → When an update is found):

Choice What happens
Notify me A notification tells you, and the menu offers to install it
Download it and notify me AutoHush downloads it, then a notification tells you it's ready. Installing it takes a second
Install it automatically (the default) AutoHush installs it at a moment when it isn't holding your player paused and none of its windows or menus are open, then a notification says it was updated

Until it's installed, AutoHush's menu bar icon shows a small arrow in its corner, the menu's Updates button shows in the accent color and a row above it offers Install AutoHush with the new version. Both open a window with what's new and a button to Download and Install, or Install and Relaunch once it's downloaded; clicking a notification opens it too. Installing swaps in the new version and restarts in about a second. Your settings and permissions carry over, and if AutoHush has your player paused for another app, the new version takes that pause over.

Notifications: AutoHush asks for them when it first starts. While they're off, every choice still works and the menu bar icon shows when an update is found; Settings says notifications are off, with a button to turn them on. If you reset AutoHush's notifications in System Settings, it asks again.

Downloads wait in ~/Library/Caches/com.autohush.AutoHush/Updates, one at a time. A download is deleted once it's installed or out of date, when you change the choice or turn automatic checks off, or after 7 days (the menu still offers the update). Automatic downloads wait while Low Data Mode is on.

Before installing, AutoHush checks that the download matches the checksum GitHub lists for it, that it's the version GitHub announced, that a kept download hasn't changed since, and that the app inside is signed by the same developer team as your copy (the check macOS itself uses to keep AutoHush's permissions), so nothing but a genuine AutoHush gets installed this way.

Updates in the menu, or Check Now in Settings, checks right away; turn off automatic checks to only check when you ask.

Release candidates are versions published to test the next release before it's out, and they may have bugs. Turn on Get release candidates (Settings → About → Updates) to be offered them too: AutoHush never downloads or installs one by itself, only offers it, whatever When an update is found says, and it moves on to the release that follows. Turned off while you're on one, AutoHush offers the latest release instead, even if it's older; turned off while one is offered, it stops offering it at once.

AutoHush can only update itself from a folder it can write to, such as Applications on an administrator account; Settings tells you when it can't. Then update by hand: brew upgrade --cask autohush, or download the new version and replace the old one. Versions up to 0.2.0 can't update themselves: update those once by hand. Versions up to 0.12.1 can't install 1.0.0 or later, which are signed with another certificate: they say they couldn't install the update, and Open Release Page leads to it. Update those once by hand too; macOS then asks for Open Anyway again (see By hand) and may ask for some permissions again (see Tips and troubleshooting).

Uninstall

  1. In Settings, turn off Launch at login, then quit AutoHush.

  2. Delete /Applications/AutoHush.app, or run brew uninstall --cask autohush.

  3. Optional: delete its settings (the apps you added with Add an App… among them), caches (a downloaded update that may be waiting, and what Add an App's checks learned, in PlayerCheck) and logs (the checks' too, in Checks), and forget the permissions you allowed:

    defaults delete com.autohush.AutoHush
    rm -rf ~/Library/Caches/com.autohush.AutoHush ~/Library/HTTPStorages/com.autohush.AutoHush ~/Library/Logs/AutoHush
    tccutil reset All com.autohush.AutoHush

    With Homebrew, brew uninstall --zap --cask autohush deletes the app, its settings and its caches in one go; the permissions still need the tccutil line. If you also built and ran the Player Check tool from the source code, it keeps its own caches, logs and checks in ~/Library/Caches/PlayerCheck, ~/Library/Logs/PlayerCheck and ~/Library/Application Support/Player Check, and its settings as com.autohush.tools.playercheck.

  4. Optional: to remove AutoHush from System Settings → Notifications, right-click it there and choose Reset Notifications….

Support AutoHush

AutoHush is free. If it saves your ears a few times a day and you'd like to say thanks, you can buy me a coffee. It helps me keep improving it. The link is also at the bottom of Settings' sidebar.

Buy me a coffee


For developers

How AutoHush works, its architecture, building and testing it, translations, contributing and releases are in DEVELOPMENT.md; what it does, step by step, in WORKFLOWS.md. To propose a change, see CONTRIBUTING.md; for how AutoHush looks and reads, STYLE_GUIDE.md.

License

AutoHush is free software: you can redistribute it and modify it under the terms of the GNU General Public License, version 3 or (at your option) any later version (GPL-3.0-or-later). Versions up to 0.12.1 were released under the MIT License, which still applies to them.

About

A macOS menu bar app that pauses what's playing (music, podcasts or videos) while other apps play audio, and resumes it afterwards.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages