kyleneideck /BackgroundMusic
Background Music, a macOS audio utility: automatically pause your music, set individual apps' volumes and record system audio.
★ 19,395⑂ 785👁 154⑃ 68● 727▤ 45
+2
日增长
+26
周增长
+50
月增长
19,395
stars
785
forks
154
watchers
68
prs
727
issues
45
releases
README
!
Background Music
macOS audio utility
Overview
Auto-pause music
Application volume
Recording system audio
Download
Run / Configure
Build and Install
Uninstall
Troubleshooting
Related Projects
License
Overview
+ Automatically pause/unpause your music player when other audio sources are playing/stopped
+ Per-application volume control
+ Record system audio
+ No restart required to install
Note: Background Music is still in alpha.
Auto-pause music
Background Music automatically pauses your music player when a second audio source is playing and unpauses the player when the second source has stopped.
The auto-pause feature currently supports following music players:
+ iTunes
+ Spotify
+ VLC
+ VOX
+ Decibel
+ Hermes
+ Swinsian
+ GPMDP
Adding support for a new music player is usually straightforward.1 If you don't know how to program, or just don't feel
like it, feel free to create an issue. Otherwise, see
BGMMusicPlayer.h.
Application volume
Background Music provides a volume slider for each application running your system. You can boost quiet applications above their maximum volume.
Recording system audio
You can record system audio with Background Music. With Background Music running, launch QuickTime Player and select File New Audio Recording (or New Screen Recording, New Movie Recording). Then click the dropdown menu (⌄) next to the record button and select Background Music as the input device.
You can record system audio and a microphone together by creating an aggregate
device that combines your input device (usually Built-in Input) with
the Background Music device. You can create the aggregate device using the Audio MIDI Setup utility under
/Applications/Utilities.
Download
Requires macOS 10.13+.
You can download the current version of Background Music using the following options. We also have snapshot builds.
Option 1
Download version 0.5.0:
BackgroundMusic-0.5.0.pkg (788 KB)
MD5: 2405d83ac3e2a29fb2c9bf5beb6eaceb
SHA256: c7742b48ac2e9ea955fea66e5c13bb56be5f1487e0b12bad93820984bccb69ef
PGP:
sig,
key (0595DF814E41A6F69334C5E2CAA8D9B8E39EC18C)
Option 2
Install using Homebrew by running the following command in Terminal:
bash
brew install --cask background-music
Run / Configure
Just run Applications Background Music.app! Background Music sets itself as your default output device under
System Settings Sound when it starts up (and sets it back on Quit).
Launch at Startup (Optional)
Add Background Music to System Settings General Login Items.
Installing from Source Code
Background Music usually takes less than a minute to build. You need Xcode version
10 or higher.
Option 1
1. Open Terminal.
2. Copy and paste the following command into Terminal:
shell
(set -eo pipefail; URL='https://github.com/kyleneideck/BackgroundMusic/archive/master.tar.gz'; \
cd $(mktemp -d); echo DownloadingTop issues
#576Problem with installation - macOS Monterey26 comments · 2022-01-13#42Can't change Safari volume21 comments · 2016-04-23#143unable to remove background music device from sound prefrences. 19 comments · 2018-03-23#727Cannot uninstall using brew on macOS 14.417 comments · 2024-03-18#268Doesn't work on Microsoft Teams 17 comments · 2020-03-26#626Distorted audio on all output devices16 comments · 2022-09-28#445Audio distortion making it impossible to hear anything15 comments · 2021-02-27#350Distorted audio when using Zoom and Airpods15 comments · 2020-08-10
Discussions
#842not support for the hompod0 comments · 2026-02-06#829Ability to control what app sources are shown?2 comments · 2025-09-12#822Doesn't work on sequoia 15.150 comments · 2025-07-13#817Put Volumes under a foldable section or move it below Output Device?0 comments · 2025-06-17#811No Audio when recording in Zoom Meeting0 comments · 2025-04-22#809Is Siri also a Per-App with individual Volume Control?0 comments · 2025-04-06#803Crashes in Sequoia 15.3 on Mac Mini M4 while trying to capture a screen recording via Quicktime0 comments · 2025-03-09#798failed install via homebrew0 comments · 2025-02-09
Latest release
Background Music v0.5.0 v0.5.0 2026-06-10If you don't know which file to download, you want BackgroundMusic-0.5.0.pkg and you can ignore the others. Changes since v0.4.3 New Per-app mute button by @TwelfthFace in 843 Configurable auto-pause delays, for better YouTube compatibility, by @jackdrowlands in 818 Improved per-app volume support for Safari, Google Chrome, Microsoft Edge, Brave, Arc Browser, NAVER Whale and Discord. Thanks to @manzick (741), @abdulkadiryugruk (839) and @GloryWord (852). Background Music now stops processing audio when nothing is playing, so macOS won't show the microphone indicator. It still s