A low-latency C++ tool to route audio from a WASAPI loopback device (such as "CABLE Input" from VB-Audio) to a target WASAPI playback device (DAC/Sound Card) using the internal capabilities of the miniaudio library.
- Device Routing: Route real-time audio from a Source Audio Device to a Target Audio Device.
- Channel Mapping: Automatically maps source channels matching target channels by position. Excellent for downmixing highly-channelled APOs (like HeSuVi taking 7.1 and converting it directly down to Stereo).
- Format Integrity: Everything runs seamlessly using 32-bit floating point calculations avoiding integer overflow crackles.
- Peak Handling: Hard clamping avoids harsh audio clipping distortion and safeguards output drivers.
- WASAPI Modes: Supports configurable target output logic using either Shared Mode or Exclusive Mode.
- Real-Time Configuration: Prompts the user smoothly for Source Device, Target Device, Latency offsets, and limits.
- Optimized: Compile with native LTO & static linking ensuring blazing-fast execution speeds without overhead.
- GUI + Terminal-Aware: Native Win32 GUI with four tabs (Bridge / Settings / Log / About). Launching from a terminal attaches to the parent console so logs flow back into the shell that started it; launching from Explorer just shows the GUI.
- Per-Monitor DPI Aware: Control geometry and the UI font both scale with the monitor the window is on, so the layout stays correct from 100% to 200% and when the window moves between displays of different scaling.
- Tray Integration: Always-on tray icon with a live-state tooltip and a right-click Open/Exit menu; optionally close to the tray instead of exiting.
- Startup Automation: Optional logon launch, optional start-hidden-in-tray, and optional auto-start of the bridge after a delay.
- Windows 7 or later
- Visual Studio / GCC / LLVM Toolchain
- CMake
This repo uses git submodules to gather miniaudio. Clone the project recursively:
git clone --recurse-submodules https://github.com/DevonTM/wasapi-bridge.git
cd wasapi-bridgeThen generate and build the executable using CMake and Ninja:
mkdir build
cd build
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
ninjaRun wasapi-bridge.exe. The GUI opens with four tabs:
- Bridge — pick the Source loopback device and the Target playback device, choose Shared or Exclusive mode, set latency in ms (defaults: 10 for Shared, 5 for Exclusive), and click Start Bridge. The button toggles to Stop Bridge while running and inputs lock until you stop. Use Rescan after plugging or unplugging audio devices.
- Settings — Close to tray makes the X button hide to the notification area instead of exiting (Alt+F4 and tray → Exit still quit, and Alt+F4 asks first if the bridge is running). Start WASAPI Bridge when I sign in to Windows writes a
HKCU\Software\Microsoft\Windows\CurrentVersion\Runentry — no admin needed, and it is removed again when unticked. Start in tray at logon hides into the tray on that logon launch only, so a manual launch always shows the window. Start the bridge automatically begins routing after a delay in seconds (0–300, default 5) — also logon-only, and it stands down if you already pressed Start or if a selected device is missing. - Log — live log mirroring everything the bridge prints. Toggle auto-scroll, export to a UTF-8 file, or clear.
- About — version, license link, and a button to open the GitHub repo.
The tray icon is always present, with a tooltip showing the current bridge state and Open/Exit on right-click.
When launched from a terminal (.\wasapi-bridge.exe from cmd or PowerShell), the app attaches to the parent console and mirrors log output there. Launched from Explorer it just shows the GUI without opening a console.
This project is licensed under the MIT License.
miniaudio is dual-licensed under the MIT No Attribution (MIT-0) and Public Domain (Unlicense).