Skip to content

Releases

SoundBridge v0.4

Choose a tag to compare

@jerryforgit jerryforgit released this 07 Nov 08:31

SoundBridge v0.4

Universal build: Apple Silicon and Intel, macOS 13.0 or newer.

What's new

  • Universal binary
    • app and HAL plugin are now arm64 + x86_64
    • Apple Silicon runs natively; Intel Macs use the x86_64 slice
  • Minimum macOS lowered to 13.0 (Ventura)
    • SMAppService, the shared-memory transport, EQ, spatial processing and the
      gain stage are all available on Ventura
    • no LaunchAgent fallback is needed at this minimum
  • Existing v0.3 features remain:
    • configurable global shortcuts for volume up/down and mute
      (Carbon, no Accessibility permission)
    • pre-amp gain −15…+15 dB before the EQ, protected by the limiter
    • login item under Open at Login, cleaned up on uninstall
    • 10-band EQ, Spatial/Hall, look-ahead limiter
    • shared-memory transport, no microphone permission
    • dynamic About tab, UID-based wake rebinding

Assets

File Size SHA-256
SoundBridge.pkg 937 KB 134d933793bec8195ddb13c886b8bbb4159e7df05d5d99d8357636e318ee81bb
Uninstall.SoundBridge.pkg 3.6 KB 8decd7a7a1105b374196946f3643d4b4e0ac4a7488f4294e9ef8984203e0942b

The app and HAL plugin are ad-hoc signed; the PKGs are unsigned. This is a
personal/self-use build. If Gatekeeper blocks a double-click, right-click →
Open, or use sudo installer as shown below.

Requirements

  • macOS 13.0 or newer (Ventura+)
  • Apple Silicon (arm64) or Intel (x86_64)
  • A physical HDMI / DisplayPort audio output
  • Tested natively on macOS 14.6 / MacBook Air M3 with LECOO M3221PL
  • x86_64 app slice verified under Rosetta; x86_64 HAL driver needs an Intel
    machine for final verification

Install

  1. Download SoundBridge.pkg.
  2. Double-click it, or:
sudo installer -pkg SoundBridge.pkg -target /

The installer copies:

  • /Applications/SoundBridge.app
  • /Library/Audio/Plug-Ins/HAL/SoundBridge.driver

and restarts coreaudiod — audio is interrupted for 2–3 seconds.

Then open SoundBridge.app. The menu bar shows a speaker icon. Clicking it
switches the system default output to SoundBridge (can be disabled in the menu).
No microphone permission is requested.

Shortcuts

Open Control Panel → Shortcuts (or the status menu → Shortcuts…):

  • click the recorder next to Volume Up, Volume Down or Mute
  • press the desired combination, e.g. ⌃⌥↑, ⌃⌥↓, ⌃⌥M
  • Delete clears a shortcut, Esc cancels
  • if a combination is already taken, the previous setting is kept and a warning
    is shown

Uninstall

Download Uninstall.SoundBridge.pkg, double-click it, or:

sudo installer -pkg "Uninstall.SoundBridge.pkg" -target /

It will:

  • quit the app
  • unregister the app's login item
  • remove the HAL plugin and /Applications/SoundBridge.app
  • remove /tmp/soundbridge_ring_v1, logs and preferences
  • restart coreaudiod and Dock

SpeakerAmp / BlackHole / MAXHUB are not modified.

Known limitations

  • Ad-hoc signed / not notarized; personal use only
  • CPU around 2.5% on an M3 with AUMatrixReverb enabled
  • Spatial processing is calibrated by ear against SpeakerAmp, not bit-identical
  • Custom shortcuts do not trigger the system OSD
  • The shared-memory ring is a local file in /tmp; audio never leaves the Mac
  • No App Store distribution

Notes

  • SpeakerAmp is not required and is not modified by the installer. It can
    remain installed as a fallback.
  • This project is not affiliated with SpeakerAmp.
  • Source, build instructions and design notes:
    https://github.com/jerryforgit/SoundBridge

Full Changelog: https://github.com/jerryforgit/SoundBridge/commits/v0.4


中文说明

SoundBridge v0.4:Universal 构建,支持 Apple Silicon 和 Intel,最低 macOS 13.0。

新增 / 变化:

  • Universal 二进制
    • App 和 HAL 插件都是 arm64 + x86_64
    • Apple Silicon 原生运行,Intel Mac 使用 x86_64 切片
  • 最低系统降到 macOS 13.0(Ventura)
    • SMAppService、共享内存、EQ、空间感、增益在 Ventura 上都可用
    • 这个最低版本不需要 LaunchAgent fallback
  • v0.3 功能继续保留:
    • 可录制全局快捷键:音量 +、音量 −、静音(Carbon,不需要辅助功能权限)
    • 前置增益 −15…+15 dB(EQ 前应用,限幅器保护)
    • 登录项显示在「登录时打开」,卸载时清理
    • 10 段 EQ、Hall 空间感、look-ahead 限幅器
    • 共享内存传输,不需要麦克风权限
    • 动态 About 页、UID 唤醒重绑

安装:双击 SoundBridge.pkg,音频会中断 2–3 秒。
卸载:双击 Uninstall.SoundBridge.pkg。
SpeakerAmp 不会被卸载,可随时回退。

SoundBridge v0.3

Choose a tag to compare

@jerryforgit jerryforgit released this 07 Nov 08:14

SoundBridge v0.3

Third release. Adds user-recordable global shortcuts for volume and mute.

What's new

  • Configurable global shortcuts
    • Volume Up / Volume Down: 1/16 (6.25%) per press
    • Mute: toggle
    • click a recorder button and press the key combination
    • Delete clears, Esc cancels
    • shortcuts are off by default; native volume keys and OSD still work
    • registered with Carbon RegisterEventHotKey — no Accessibility
      permission
      required
    • custom shortcuts do not show the system OSD; the menu bar percentage updates
  • Shortcuts tab in the control panel, also reachable from the status menu
  • Existing v0.2 features remain:
    • pre-amp gain −15…+15 dB before the EQ, protected by the limiter
    • login item under Open at Login, cleaned up on uninstall
    • 10-band EQ, Spatial/Hall, look-ahead limiter
    • shared-memory transport, no microphone permission
    • dynamic About tab, UID-based wake rebinding

Assets

File Size SHA-256
SoundBridge.pkg 615 KB 41276ff64e56cbf7bf1dc4458c12fc74b9a9fcee4628cab164be865049a7cbc5
Uninstall.SoundBridge.pkg 3.6 KB 178db4630ef41d6d2e4f15b2c8e6b87050ec72b316b1e74ab9f6daaa5e3b7e89

The app and HAL plugin are ad-hoc signed; the PKGs are unsigned. This is a
personal/self-use build. If Gatekeeper blocks a double-click, right-click →
Open, or use sudo installer as shown below.

Requirements

  • macOS 14.0 or newer
  • Apple Silicon (arm64)
  • A physical HDMI / DisplayPort audio output
  • Tested on macOS 14.6 / MacBook Air M3 with LECOO M3221PL (DisplayPort)

Install

  1. Download SoundBridge.pkg.
  2. Double-click it, or:
sudo installer -pkg SoundBridge.pkg -target /

The installer copies:

  • /Applications/SoundBridge.app
  • /Library/Audio/Plug-Ins/HAL/SoundBridge.driver

and restarts coreaudiod — audio is interrupted for 2–3 seconds.

Then open SoundBridge.app. The menu bar shows a speaker icon. Clicking it
switches the system default output to SoundBridge (can be disabled in the menu).
No microphone permission is requested.

Shortcuts

Open Control Panel → Shortcuts (or the status menu → Shortcuts…):

  • click the recorder next to Volume Up, Volume Down or Mute
  • press the desired combination, e.g. ⌃⌥↑, ⌃⌥↓, ⌃⌥M
  • Delete clears a shortcut, Esc cancels
  • if a combination is already taken, the previous setting is kept and a warning
    is shown

Uninstall

Download Uninstall.SoundBridge.pkg, double-click it, or:

sudo installer -pkg "Uninstall.SoundBridge.pkg" -target /

It will:

  • quit the app
  • unregister the app's login item
  • remove the HAL plugin and /Applications/SoundBridge.app
  • remove /tmp/soundbridge_ring_v1, logs and preferences
  • restart coreaudiod and Dock

SpeakerAmp / BlackHole / MAXHUB are not modified.

Known limitations

  • Ad-hoc signed / not notarized; personal use only
  • No Intel build
  • CPU around 2.5% on an M3 with AUMatrixReverb enabled
  • Spatial processing is calibrated by ear against SpeakerAmp, not bit-identical
  • Custom shortcuts do not trigger the system OSD
  • The shared-memory ring is a local file in /tmp; audio never leaves the Mac
  • No App Store distribution

Notes

  • SpeakerAmp is not required and is not modified by the installer. It can
    remain installed as a fallback.
  • This project is not affiliated with SpeakerAmp.
  • Source, build instructions and design notes:
    https://github.com/jerryforgit/SoundBridge

Full Changelog: https://github.com/jerryforgit/SoundBridge/commits/v0.3


中文说明

SoundBridge v0.3 第三个版本。

新增:

  • 可录制的全局快捷键
    • 音量 + / 音量 −:每次 1/16(6.25%)
    • 静音:切换
    • 点击录制按钮后按下组合键,Delete 清除,Esc 取消
    • 默认不设置;系统音量键、OSD、静音键仍然照常工作
    • 使用 Carbon 注册,不需要辅助功能权限
    • 自定义快捷键不会触发系统 OSD,菜单栏百分比会更新
  • 快捷键标签页,也可以从状态栏菜单进入

v0.2 的功能继续保留:

  • 前置增益 −15…+15 dB(EQ 前应用,限幅器保护)
  • 登录项显示在「登录时打开」,卸载时清理
  • 10 段 EQ、Hall 空间感、look-ahead 限幅器
  • 共享内存传输,不需要麦克风权限
  • 动态 About 页、UID 唤醒重绑

安装:双击 SoundBridge.pkg,音频会中断 2–3 秒。
卸载:双击 Uninstall.SoundBridge.pkg。
SpeakerAmp 不会被卸载,可随时回退。

SoundBridge v0.2

Choose a tag to compare

@jerryforgit jerryforgit released this 07 Nov 08:00

SoundBridge v0.2

Second release. Adds a pre-amp gain control and fixes the login item so it
appears under Open at Login.

What's new

  • Pre-amp gain −15…+15 dB
    • new slider in the Spatial tab
    • applied before the 10-band EQ
    • positive gain is protected by the look-ahead limiter
    • persisted in output.gainDB
    • matches the idea of SpeakerAmp's per-device pre-amp attenuator
      (0…−15 dB) and also allows boost
  • Login item now uses SMAppService
    • appears under System Settings → General → Login Items → Open at Login
    • the installer unregisters the old build's item before replacing the app
    • the new build re-registers on launch when launch-at-login is enabled
    • avoids stale records caused by ad-hoc signing / changing cdhash
  • Uninstaller
    • unregisters the login item
    • removes app, HAL plugin, shared memory, preferences and logs
    • restores the previous output
  • About tab now reads the version, app path and current output dynamically
  • PKG install no longer relocates SoundBridge.app into the build folder

Assets

File Size SHA-256
SoundBridge.pkg 586 KB 59942db70df5312849ce22750379f0e6f5ff442b67c57ac5a3de015c98624a41
Uninstall.SoundBridge.pkg 3.6 KB 501444c14328d972a6774b3ecf12076aa90d075c2006706ff253fda61d14f5ff

The app and HAL plugin are ad-hoc signed; the PKGs are unsigned. This is a
personal/self-use build. If Gatekeeper blocks a double-click, right-click →
Open, or use sudo installer as shown below.

Requirements

  • macOS 14.0 or newer
  • Apple Silicon (arm64)
  • A physical HDMI / DisplayPort audio output
  • Tested on macOS 14.6 / MacBook Air M3 with LECOO M3221PL (DisplayPort)

Install

  1. Download SoundBridge.pkg.
  2. Double-click it, or:
sudo installer -pkg SoundBridge.pkg -target /

The installer copies:

  • /Applications/SoundBridge.app
  • /Library/Audio/Plug-Ins/HAL/SoundBridge.driver

and restarts coreaudiod — audio is interrupted for 2–3 seconds.

Then open SoundBridge.app. The menu bar shows a speaker icon. Clicking it
switches the system default output to SoundBridge (can be disabled in the menu).
No microphone permission is requested.

Uninstall

Download Uninstall.SoundBridge.pkg, double-click it, or:

sudo installer -pkg "Uninstall.SoundBridge.pkg" -target /

It will:

  • quit the app
  • unregister the app's login item
  • remove the HAL plugin and /Applications/SoundBridge.app
  • remove /tmp/soundbridge_ring_v1, logs and preferences
  • restart coreaudiod and Dock

SpeakerAmp / BlackHole / MAXHUB are not modified.

Known limitations

  • Ad-hoc signed / not notarized; personal use only
  • No Intel build
  • CPU around 2.5% on an M3 with AUMatrixReverb enabled
  • Spatial processing is calibrated by ear against SpeakerAmp, not bit-identical
  • The shared-memory ring is a local file in /tmp; audio never leaves the Mac
  • No App Store distribution

Notes

  • SpeakerAmp is not required and is not modified by the installer. It can
    remain installed as a fallback.
  • This project is not affiliated with SpeakerAmp.
  • Source, build instructions and design notes:
    https://github.com/jerryforgit/SoundBridge

Full Changelog: https://github.com/jerryforgit/SoundBridge/commits/v0.2


中文说明

SoundBridge v0.2 第二个版本。

新增:

  • 前置增益 −15…+15 dB
    • 在「空间感」页
    • EQ 之前应用,正增益由限幅器保护
    • 设置保存在 output.gainDB
    • 对应 SpeakerAmp 的 Pre-amp attenuator(0…−15 dB),同时支持提升
  • 登录项改为 SMAppService
    • 显示在 系统设置 → 通用 → 登录项 → 登录时打开
    • 安装时先注销旧 build 的登录项,新 build 启动后按偏好重新注册
  • 卸载包
    • 注销登录项,删除 App、HAL 插件、共享内存、设置和日志
    • 恢复之前的输出设备
  • 关于页改为动态版本、App 路径和当前输出
  • PKG 安装不再把 App 重定位到构建目录

安装:双击 SoundBridge.pkg,音频会中断 2–3 秒。
卸载:双击 Uninstall.SoundBridge.pkg。
SpeakerAmp 不会被卸载,可随时回退。

SoundBridge v0.1

Choose a tag to compare

@jerryforgit jerryforgit released this 06 Nov 14:49

SoundBridge v0.1

First public release of SoundBridge — a macOS menu bar audio bridge for HDMI /
DisplayPort displays.

SoundBridge creates a virtual output device with native macOS volume/mute,
applies a 10-band EQ and spatial processing, and forwards audio to the physical
display output by UID. It is designed to survive clamshell sleep/wake, including
the “device rebuilt twice” case that breaks ID-based routing.

Highlights

  • HAL virtual output device with native VolumeScalar / Mute
    • system volume keys, native OSD, Control Center and mute key just work
    • no Accessibility permission, no media-key interception
  • UID-based wake rebinding
    • no cached AudioObjectID
    • debounce, backoff and silent standby while the display endpoint is gone
    • 10/10 clamshell sleep/wake recoveries during testing
  • Shared-memory audio transport
    • plugin → engine via /tmp/soundbridge_ring_v1
    • no microphone permission, no orange microphone indicator
  • 10-band EQ + look-ahead limiter
    • 50 / 150 / 300 / 600 / 1k / 3k / 6k / 9k / 12k / 15k Hz
    • ±12 dB, default Flat
  • Spatial effect
    • M/S widening, crossfeed, early reflections
    • Apple AUMatrixReverb Large Hall, wet 50, calibrated against SpeakerAmp
      Hall 50%
  • Menu bar app
    • speaker icon whose sound waves follow volume
    • control panel with Spatial / Equalizer / About tabs
    • output-device picker, language switch (system / 中文 / English)
    • launch at login, engine log
  • Conventional PKG install / uninstall
    • install app + HAL plugin, restart coreaudiod
    • separate uninstall PKG removes app, plugin, login item, shared memory,
      preferences and logs

Assets

File Size SHA-256
SoundBridge.pkg 584 KB 06365cba48334d7a59cc2788cfcd9b574030114caacda9ed64fecb92e08e5fa3
Uninstall.SoundBridge.pkg 3.6 KB c3c657698f1c854edc85078dacd4136c158166669899337d8a0e90e7014dc9ef

The app and HAL plugin are ad-hoc signed; the PKGs are unsigned. This is a
personal/self-use build. If Gatekeeper blocks a double-click, right-click →
Open, or use sudo installer as shown below.

Requirements

  • macOS 14.0 or newer
  • Apple Silicon (arm64)
  • A physical HDMI / DisplayPort audio output
  • Tested on macOS 14.6 / MacBook Air M3 with LECOO M3221PL (DisplayPort)

Install

  1. Download SoundBridge.pkg.
  2. Double-click it, or:
sudo installer -pkg SoundBridge.pkg -target /

The installer copies:

  • /Applications/SoundBridge.app
  • /Library/Audio/Plug-Ins/HAL/SoundBridge.driver

and restarts coreaudiod — audio is interrupted for 2–3 seconds.

Then open SoundBridge.app. The menu bar shows a speaker icon. Clicking it
switches the system default output to SoundBridge (can be disabled in the menu).
No microphone permission is requested.

If an older build left a stale grant:

tccutil reset Microphone com.jerry.soundbridge

Uninstall

Download Uninstall.SoundBridge.pkg, double-click it, or:

sudo installer -pkg "Uninstall.SoundBridge.pkg" -target /

It will:

  • quit the app
  • unregister the app's login item
  • remove the HAL plugin and /Applications/SoundBridge.app
  • remove /tmp/soundbridge_ring_v1, logs and preferences
  • restart coreaudiod and Dock

SpeakerAmp / BlackHole / MAXHUB are not modified.

Known limitations

  • Ad-hoc signed / not notarized; personal use only
  • No Intel build
  • CPU around 2.5% on an M3 with AUMatrixReverb enabled (slightly above the
    original 2% target; the reverb is the dominant cost)
  • Spatial processing is calibrated by ear against SpeakerAmp, not bit-identical
  • The shared-memory ring is a local file in /tmp; audio never leaves the Mac
  • No App Store distribution

Notes

  • SpeakerAmp is not required and is not modified by the installer. It can
    remain installed as a fallback.
  • This project is not affiliated with SpeakerAmp.
  • Source, build instructions and design notes:
    https://github.com/jerryforgit/SoundBridge

Full Changelog: https://github.com/jerryforgit/SoundBridge/commits/v0.1


中文说明

SoundBridge v0.1 首个公开版本。

  • 虚拟输出设备 + 原生音量键 / OSD / 静音
  • 按 UID 重绑,合盖睡眠唤醒不丢声音
  • 插件 → 引擎走共享内存,不需要麦克风权限
  • 10 段 EQ + look-ahead 限幅器
  • 空间感使用 Apple AUMatrixReverb Large Hall,已和 SpeakerAmp Hall 50% 校准
  • 菜单栏图标声波跟随音量;控制面板含空间感 / 均衡器 / 关于
  • 中文 / English 可手动切换

安装:双击 SoundBridge.pkg,音频会中断 2–3 秒。
卸载:双击 Uninstall.SoundBridge.pkg,会删除 App、插件、共享内存、设置和日志。
SpeakerAmp 不会被卸载,可随时回退。