explaingit

kyleneideck/backgroundmusic

18,960C++Audience · vibe coderComplexity · 3/5MaintainedLicenseSetup · moderate

TLDR

Free macOS audio utility that auto-pauses music when other sounds play and gives you per-app volume control.

Mindmap

mindmap
  root((Background Music))
    What it does
      Auto-pause music
      Per-app volume control
      System audio recording
    Supported players
      iTunes
      Spotify
      VLC
      VOX
    Use cases
      Gaming without music
      Screen recording
      Video watching
    Tech stack
      C++
      Objective-C
      macOS

Things people build with this

USE CASE 1

Automatically pause Spotify when you start watching a YouTube video or receive a notification.

USE CASE 2

Lower the volume of a loud game while keeping your music at normal level.

USE CASE 3

Record all system audio from your Mac for screen recordings or podcast editing.

Tech stack

C++Objective-CmacOS

Getting it running

Difficulty · moderate Time to first run · 30min

Requires macOS development environment (Xcode) and understanding of native macOS audio APIs to build from source.

Use it freely, but any project you distribute that includes this code must also be GPL-licensed and open source.

In plain English

Background Music is a free macOS audio utility that gives you per-application volume control and automatic music pausing, features that macOS doesn't provide natively. The main feature most people use it for is auto-pause: when you're listening to music and a video or notification sound starts playing, Background Music automatically pauses your music player. When that other audio stops, your music resumes. This means you don't have to manually pause Spotify every time a YouTube video starts. It supports iTunes, Spotify, VLC, VOX, and several other players. The second major feature is per-application volume control. macOS normally has a single master volume. Background Music adds individual volume sliders for each running app, so you can turn down a loud game without affecting your music, or boost a quiet app beyond its normal maximum. Third, it enables system audio recording. By selecting Background Music as the input device in QuickTime Player, you can record all the audio coming from your Mac, useful for screen recordings or capturing audio from any application. You would use this as a Mac power user who wants more fine-grained audio control without buying third-party software. It requires macOS 10.13 or higher, installs without restarting, and can be installed via Homebrew. It's written in C++ and Objective-C and is currently in alpha.

Copy-paste prompts

Prompt 1
How do I install Background Music on my Mac using Homebrew?
Prompt 2
Show me how to set up auto-pause for Spotify in Background Music.
Prompt 3
How can I use Background Music to record system audio in QuickTime Player?
Prompt 4
What's the difference between Background Music's per-app volume control and macOS's built-in volume?
Prompt 5
Can I use Background Music to boost the volume of a quiet application above its maximum?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.