WaveController 0.0.2.3 prealpha

Release Notes: v0.0.2.3-prealpha

Unified Fallback Sink & Zero-Bleed Routing

• Unified PipeWire Adapter Sink: Provisioned WaveController_Fallback_Sink as a permanent 1:1 null-sink adapter node
(playback_FL/FR inputs, monitor_FL/FR outputs).
• Permanent Monitor DAC Link: Permanently linked WaveController_Fallback_Sink to your primary monitoring DAC (Elgato Wave XLR
Analog Stereo:playback_FL/FR).
• Automatic Unassigned Stream Reconciliation: Any application stream not assigned to a channel strip (or unassigned/removed
from a group channel) automatically flows into WaveController_Fallback_Sink with zero audio dropouts and zero direct ALSA
hardware leaks.
• Pruning & Cleanup: Automatically cleans up residual background loopbacks on startup, ensuring a clean 1-node topology in
graph visualizers (qpwgraph).

Word-Boundary Process Token Matching

• Eliminated Substring Collisions: Upgraded port_matches_tokens() to use strict word-boundary matching, resolving false
positives where generic tokens (e.g. 'wave') erroneously matched applications like 'Shortwave'.

Default Hardware Devices Preferences

• Dedicated Preferences Group: Added top-level Default Hardware Devices in Settings with Primary Microphone and Primary Monitor
Output dropdowns.
• Tracked-Only Scope: Dropdowns strictly list added/tracked devices in WaveController.
• Dynamic Hotplug & Rescan: Added a manual Refresh Devices button with dynamic auto-refresh on settings tab selection and
hotplug events.

Dynamic Device Removal & Real-Time Target Failover

• Instant Removal Sync: Removing a device from WaveController immediately prunes it from the Settings dropdowns.
• Instant Target Failover: If the removed device was the active default, WaveController automatically fails over to the next
remaining tracked device (Wave XLR), updates Personal Mix target device, and re-wires Fallback Sink and Personal Mix in real-
time.

First-Time Setup (OOBE) Wizard

• Guided Setup Dialog: Created setup_wizard.py for new installations or initial configurations to select primary microphone and
monitor devices and auto-name the primary mic channel after the connected hardware.

Personal Mix Header Refinement

• Protected Monitoring Route: Omitted the Target Output Device dropdown on the Personal Mix edit popup to prevent accidental
routing breaks and guide users to global preferences.