whatisgithub

What is sound_pref?

kbshal/sound_pref — explained in plain English

Analysis updated 2026-07-26

12SwiftAudience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

A free macOS menu bar app for per-app audio control: adjust individual app volumes, mute specific apps, and route audio to different output devices like speakers or headphones.

Mindmap

mindmap
  root((repo))
    What it does
      Per app volume
      Mute specific apps
      Route audio output
    Use cases
      Music to speakers
      Calls to headphones
      Quick device switch
    Tech stack
      Swift 6
      macOS 14.4 API
      Core Audio
    Audience
      Mac users
      Power users
      Budget conscious
    Privacy
      Local processing
      No telemetry
      No network calls

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

Send music to speakers while keeping video call audio in your headphones.

USE CASE 2

Mute a noisy app without lowering the volume of other apps.

USE CASE 3

Quickly switch system audio output devices from the menu bar.

USE CASE 4

Pin favorite apps so they always appear in the audio control panel.

What is it built with?

Swift 6Core AudiomacOS 14.4Xcode 15

How does it compare?

kbshal/sound_prefamethystsoft/keyringaccesskageroumado/refrax-browser
Stars121212
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyhard
Complexity3/52/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Xcode 15 and macOS 14.4 Sonoma or later, running with Swift commands fails due to sandbox permissions, so the included build script is needed.

Free to use and modify, but if you distribute modified versions you must also release them under the same GPL-3.0 license.

So what is it?

SoundPref is a free, open-source macOS application that gives you detailed control over how your Mac handles audio. It lives in your menu bar and lets you adjust the volume of individual apps, mute specific apps without affecting others, and send each app's sound to a different output device. For example, you could route music to your speakers while keeping a video call's audio in your headphones. It is described as a free alternative to a paid app called SoundSource. The app requires macOS 14.4 (Sonoma) or later and runs on both Apple Silicon and Intel Macs. It is written in Swift 6 and released under the GPL-3.0 license. The project is labeled as an MVP (minimum viable product), meaning it covers core functionality but is still in an early stage. Beyond per-app volume and routing, it lets you quickly switch system audio devices from the menu bar, pin favorite apps so they always appear in the panel, and save your settings so they persist across restarts. SoundPref works by using a Core Audio API introduced in macOS 14.4 that lets one app capture and control audio from other apps without needing a kernel extension. When you change an app's volume or output, SoundPref taps into that app's audio stream, applies a gain adjustment for volume, sends the audio to your chosen device, and mutes the original default device to prevent the sound from playing twice. Building the app from source requires Xcode 15 or later. The README notes that running it directly with Swift commands often fails due to macOS sandbox permissions, so the project includes a build script that compiles, signs, and launches the app. There is also a separate script for creating a disk image for distribution. On privacy, the README states that all audio processing happens locally, with no recording, telemetry, analytics, or network calls. A purple dot appears in the menu bar, which is Apple's standard indicator that an app is accessing system audio.

Copy-paste prompts

Prompt 1
How do I build SoundPref from source using the included build script, and why does running it directly with Swift commands fail?
Prompt 2
Help me understand how SoundPref uses the macOS 14.4 Core Audio API to control per-app volume and route audio to different output devices without a kernel extension.
Prompt 3
What does the purple dot in the menu bar mean when SoundPref is running, and should I be concerned about privacy?
Prompt 4
Explain how SoundPref applies a gain adjustment to an app's audio stream and mutes the original default device to prevent double audio playback.

Frequently asked questions

What is sound_pref?

A free macOS menu bar app for per-app audio control: adjust individual app volumes, mute specific apps, and route audio to different output devices like speakers or headphones.

What language is sound_pref written in?

Mainly Swift. The stack also includes Swift 6, Core Audio, macOS 14.4.

What license does sound_pref use?

Free to use and modify, but if you distribute modified versions you must also release them under the same GPL-3.0 license.

How hard is sound_pref to set up?

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

Who is sound_pref for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.