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 Downloading