--- title: README pageLayout: default slug: hinterland/audiooutput/README permalink: https://aarnphm.xyz/hinterland/audiooutput/README.md generator: quartz: v4.6.0 hostedProvider: Cloudflare baseUrl: aarnphm.xyz full: https://aarnphm.xyz/llms-full.txt --- # Audio Output macOS menu-bar audio routing. Native apps use Core Audio process taps. Websites use the included Chromium extension. The system default output stays unchanged; BlackHole is only a test fixture. ## Run Requires macOS 14.2+ and Xcode command-line tools. ```sh cd /Users/aarnphm/workspace/garden/content/hinterland/audiooutput just run ``` Choose an output beside an application or site. **Normal output** removes the override. **Pause** releases routes without deleting assignments. Disconnected devices fall back to normal playback and resume when reconnected. Grant System Audio Recording access for native-app routes. Each application and site has a 0–300% volume slider in 5% steps and a 100% reset. Volume is saved independently of the output selection; native applications can follow the system output with a volume override. 0% mutes, 200% doubles sample amplitude, and 300% triples it. Native output clamps peaks to full scale, so boosting loud material can distort. Pause restores normal playback. Website volume requires local blob media or explicitly CORS-enabled media, an unprotected player, and browser support for AudioContext output selection. Click the player if the browser requires a playback gesture. Reload the extension and player tabs after upgrading. Players that already own their media element through Web Audio cannot be boosted by a second graph. When the selected system output has no hardware volume control (including the Yamaha AG03MK2), **Use volume keys** enables a software master from 0–100%. Click **Allow volume keys…** and grant Audio Output Accessibility access. Volume-up/down change the master by 1/16; Shift–Option uses 1/64 steps. Mute toggles without losing the saved level. The master multiplies app gain, so 50% master with 200% app gain yields 100% effective gain. Its percentage appears beside the system output. Per-device levels persist. Pause, disabling the option, or switching to a hardware-volume-capable output releases the master tap and passes keys through. The master covers the selected device’s single stereo stream. Sites routed to another output stay independent. Apps already routed by Audio Output receive the master in their existing renderer; the device tap excludes those processes and its own renderer to prevent duplicate gain or feedback. Device-scoped capture covers other apps and browser media without changing the extension. The gear menu contains the standalone window, login-item switch, extension folder, and capture-permission settings. Keep the app at a stable path before enabling login startup. ## YouTube Music and other websites Chromium web apps share their browser’s audio process. The extension selects the output on the site’s `