explaingit

kyleneideck/backgroundmusic

Analysis updated 2026-05-18

18,938C++Audience · vibe coderComplexity · 3/5LicenseSetup · 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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

C++Objective-CmacOS

How does it compare?

kyleneideck/backgroundmusiccocos2d/cocos2d-xswoole/swoole-src
Stars18,93819,00718,866
LanguageC++C++C++
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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?

Frequently asked questions

What is backgroundmusic?

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

What language is backgroundmusic written in?

Mainly C++. The stack also includes C++, Objective-C, macOS.

What license does backgroundmusic use?

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

How hard is backgroundmusic to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is backgroundmusic for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub kyleneideck on gitmyhub

Verify against the repo before relying on details.