Sonixx

A high-performance virtual audio router for Windows
Capture per-app audio & microphones → mix → route to a single virtual mic

• Overview
• Why Sonixx?
• Features
• Architecture
• Prerequisites
• Quick Start
• Building a Standalone Executable
• Usage Guide
• Keyboard Shortcuts
• Configuration
• Project Structure
• Dependencies
• Troubleshooting
• Author

Sonixx is a lightweight, native Windows desktop application that acts as a virtual audio mixer and router. It lets you selectively capture audio from individual applications (games, browsers, music players, VoIP clients) and physical microphones, then blends them into a single virtual microphone output powered by VB-Cable.

Use-case example: You're in a Discord or VALORANT voice call and want to play background music from Spotify and your mic simultaneously — Sonixx makes that seamless with per-source volume controls, muting, and real-time peak metering.

The entire stack runs locally with zero cloud dependencies — no accounts, no telemetry, no latency overhead.

There is not a single soundboard on the market that routes live audio between applications.

Every existing "soundboard" — Voicemod, Soundpad, EXP Soundboard, Resanance, you name it — works the same way: you load pre-downloaded MP3/WAV files and trigger them with hotkeys. They are glorified audio-file players wired to a virtual mic.

Sonixx is fundamentally different:

If you've ever wanted to share a YouTube video's audio in a call, play your Spotify playlist through your mic in VALORANT, or route a DAW's output into OBS — without manually recording and re-uploading files — Sonixx is the tool that finally makes it possible.

graph TD
    APP1["App Source (Chrome)\nNamed Pipe + PAC DLL"]
    APP2["App Source (Spotify)\nNamed Pipe + PAC DLL"]
    MIC["Mic Source (Realtek)\nWASAPI Input Callback"]

    APP1 --> MIX
    APP2 --> MIX
    MIC --> MIX

    MIX["AudioRouter._out_cb()\nHardware-synced WASAPI callback\nMix → master vol/mute → clip to ±1.0"]

    MIX --> VBC["VB-Cable Output\n(Virtual Mic)"]
    MIX --> MON["Monitor (Loopback)\nHeadphones"]

┌──────────────────────────────────────────────────────┐
│                   Sonixx Application                 │
│                                                      │
│  ┌────────────┐   ┌────────────┐   ┌──────────────┐  │
│  │ App Source  │   │ App Source  │   │  Mic Source│  │
│  │ (Chrome)   │   │ (Spotify)  │   │  (Realtek)   │  │
│  │            │   │            │   │              │  │
│  │ Named Pipe │   │ Named Pipe │   │ WASAPI Input │  │
│  │ + PAC DLL  │   │ + PAC DLL  │   │ (Callback)   │  │
│  └─────┬──────┘   └─────┬──────┘   └──────┬───────┘  │
│        │                │                  │         │
│        └────────┬───────┘                  │         │
│                 │                          │         │
│           ┌─────▼──────────────────────────▼───┐     │
│           │       AudioRouter._out_cb()        │     │
│           │   (Hardware-synced WASAPI callback)│     │
│           │                                    │     │
│           │  Mix all sources → master vol/mute │     │
│           │  → clip to [-1.0, 1.0]             │     │
│           └────────┬───────────────┬───────────┘     │
│                    │               │                 │
│            ┌───────▼───┐   ┌───────▼──────┐          │
│            │ VB-Cable  │   │   Monitor    │          │
│            │  Output   │   │  (Loopback)  │          │
│            │ (Virtual  │   │  Headphones  │          │
│            │   Mic)    │   │              │          │
│            └───────────┘   └──────────────┘          │
└──────────────────────────────────────────────────────┘

Simply double-click the included batch file:

run.bat

This will:

1. Verify Python is installed.
2. Run uv sync to install all dependencies.
3. Launch Sonixx with uv run main.py.

Note: The application will automatically request Administrator privileges on startup.

# 1. Clone the repository
git clone https://github.com/Felix-au/Sonixx.git
cd Sonixx

# 2. Install dependencies
uv sync

# 3. Launch
uv run main.py

Create a single-file .exe with all assets bundled:

uv run pyinstaller SonixxAudioRouter.spec --noconfirm

The compiled executable will be at:

dist/SonixxAudioRouter.exe

The spec file automatically bundles:

• assets/ — Logo, icons, and SVGs
• VBCABLE_Driver_Pack45.zip — VB-Cable installer
• customtkinter and process_audio_capture — Collected hidden imports

If VB-Cable is not detected, Sonixx displays a setup screen:

• Click ⚡ Install VB-Cable Driver for a silent, automated install.
• Or install manually and click ⟳ Already installed — Refresh.

1. Play audio in the applications you want to capture (e.g., open Spotify, a YouTube tab, a game).
2. Click ⟳ Scan in the Applications panel.
3. Detected processes appear as source rows with individual controls.
4. Toggle the switch on each source to include it in the mix.

Tip: Scanning briefly pauses the audio router to ensure a clean process enumeration.

1. Select your microphone from the dropdown in the 🎤 Microphones section.
2. Click + Add to create a mic source row.
3. Toggle it on and adjust volume.

• Loopback Source: Select which output device to capture system-wide audio from (usually your speakers/headphones).
• Monitor Mix: Enable to hear the mixed output in your headphones.
• Master Volume: 0–200% with real-time peak metering.
• Master Mute: Click 🔊 or press Ctrl+Alt+M.

1. Click ▶ Start — the status indicator turns green: ● Routing.
2. In your target application (Discord, VALORANT, etc.), select "Sonixx" or "CABLE Output" as the microphone input.
3. Click ■ Stop to halt routing.

Click Rename to "Sonixx" (Admin) to change the VB-Cable device name in the Windows audio registry. Applications will then display the device as "Sonixx" instead of "CABLE Output".

Settings are persisted at:

%APPDATA%\Sonixx\settings.json

Sonixx/
├── main.py                     # Entry point (admin elevation + app launch)
├── run.bat                     # One-click launcher script
├── pyproject.toml              # Project metadata & dependencies (uv/pip)
├── requirements.txt            # Fallback pip requirements
├── settings.json               # Default settings template
├── SonixxAudioRouter.spec      # PyInstaller build specification
├── VBCABLE_Driver_Pack45.zip   # Bundled VB-Cable driver installer
│
├── app/
│   ├── __init__.py             # Package init
│   ├── ui.py                   # CustomTkinter GUI (538 lines)
│   ├── audio_router.py         # Audio engine & mixer (481 lines)
│   └── driver.py               # VB-Cable driver management (173 lines)
│
├── assets/
│   ├── sonixx_logo.png         # Application logo (high-res)
│   ├── sonixx_logo.ico         # Windows icon
│   ├── github.png / .svg       # Footer profile icon
│   └── email.png / .svg        # Footer profile icon
│
├── build/                      # PyInstaller build artifacts
├── dist/                       # Compiled executable output
└── .venv/                      # Python virtual environment

Felix-au (Harshit Soni)

• 🔗 GitHub: github.com/Felix-au
• 📧 Email: harshit.soni.23cse@bmu.edu.in

_{Built with ❤️ and too many late nights debugging WASAPI callbacks.}