Fix device selection: Use CPAL for enumeration AND playback

PREVIOUS WRONG APPROACH (commit 212aae5):
- Used pactl to enumerate devices (PipeWire sink names)
- Tried to open those sink names with CPAL
- CPAL couldn't find PipeWire sink names → fell back to default
- Attempted workaround: change system default with set_pipewire_default_sink
- UNACCEPTABLE: Changed system-wide default, affecting all apps

ROOT CAUSE (identified by ChatGPT research):
- CPAL can open specific devices by name (research was correct)
- BUT: Name mismatch between pactl sinks and CPAL device names
- pactl returns: "alsa_output.usb-Cambridge_Audio..." (PipeWire sink)
- CPAL sees: "DacMagic Plus Analog Stereo" (user-friendly name)

CORRECT SOLUTION:
- Use CPAL for BOTH enumeration AND opening devices
- CPAL device names are consistent: enumerate → save → find → open
- No need to change system default
- Device selection only affects QBZ

CHANGES:
1. Rewrote get_pipewire_sinks() on Linux to use CPAL instead of pactl
2. Removed all calls to set_pipewire_default_sink()
3. Pass CPAL device names directly to reinit_audio_device()
4. CPAL can now find and open devices because names match

BENEFITS:
- ✅ Device selection only affects QBZ (not system-wide)
- ✅ No regresions
- ✅ No features lost
- ✅ Works exactly like librespot (Spotify client in Rust)
- ✅ Consistent with rodio/CPAL architecture

TESTING REQUIRED:
1. Select Cambridge DAC in QBZ → audio plays through Cambridge
2. Open Firefox/other app → uses its own device (unaffected)
3. Toggle devices in QBZ → changes correctly
4. Restart QBZ → restores saved device
5. DAC passthrough bit-perfect → works
This commit is contained in:
vicrodh committed 2026-01-17 11:51:25 -06:00
1 parent 212aae5c9f
commit 1f13370073
3 files changed
+80 -137

No files matched your search

+47 -73
View File
@@ -554,92 +554,47 @@ pub struct PipewireSink {
pub is_default: bool,
}
/// Get PipeWire/PulseAudio sink information with friendly names (Linux)
/// Get audio output devices using CPAL (works on all platforms including Linux/PipeWire)
/// CRITICAL: Uses CPAL device names so they match what the player can open
#[cfg(target_os = "linux")]
#[tauri::command]
pub fn get_pipewire_sinks() -> Result<Vec<PipewireSink>, String> {
log::info!("Command: get_pipewire_sinks (Linux)");
log::info!("Command: get_pipewire_sinks (Linux, using CPAL)");
use std::process::Command;
use rodio::cpal::traits::{DeviceTrait, HostTrait};
// Get default sink name first
let default_sink = Command::new("pactl")
.args(["get-default-sink"])
.output()
.ok()
.and_then(|o| {
if o.status.success() {
String::from_utf8(o.stdout).ok().map(|s| s.trim().to_string())
} else {
None
}
});
let host = rodio::cpal::default_host();
// Get all sinks
let output = Command::new("pactl")
.args(["list", "sinks"])
.output()
.map_err(|e| format!("Failed to run pactl: {}. Is PulseAudio/PipeWire installed?", e))?;
// Get default device name from CPAL
let default_device_name = host
.default_output_device()
.and_then(|d| d.name().ok());
if !output.status.success() {
return Err("pactl command failed".to_string());
}
log::info!("CPAL default device: {:?}", default_device_name);
let stdout = String::from_utf8_lossy(&output.stdout);
let mut sinks = Vec::new();
// Enumerate all output devices using CPAL
let sinks: Vec<PipewireSink> = host
.output_devices()
.map_err(|e| format!("Failed to enumerate devices: {}", e))?
.filter_map(|device| {
device.name().ok().map(|name| {
let is_default = default_device_name.as_ref().map(|d| d == &name).unwrap_or(false);
// Parse pactl output
let mut current_name: Option<String> = None;
let mut current_description: Option<String> = None;
let mut current_volume: Option<u32> = None;
for line in stdout.lines() {
let line = line.trim();
// New sink starts with "Sink #"
if line.starts_with("Sink #") {
// Save previous sink if complete
if let (Some(name), Some(desc)) = (current_name.take(), current_description.take()) {
let is_default = default_sink.as_ref().map(|d| d == &name).unwrap_or(false);
sinks.push(PipewireSink {
name,
description: desc,
volume: current_volume.take(),
// CRITICAL: Use CPAL device name as both name and description
// This ensures the name we save is the exact name CPAL can find later
PipewireSink {
name: name.clone(),
description: name, // CPAL names are already user-friendly in PipeWire
volume: None, // Volume not available via CPAL
is_default,
});
}
current_volume = None;
} else if line.starts_with("Name:") {
current_name = Some(line.trim_start_matches("Name:").trim().to_string());
} else if line.starts_with("Description:") {
current_description = Some(line.trim_start_matches("Description:").trim().to_string());
} else if line.starts_with("Volume:") {
// Parse volume like "Volume: front-left: 65536 / 100% / 0.00 dB"
if let Some(percent_pos) = line.find('%') {
// Find the number before %
let before_percent = &line[..percent_pos];
if let Some(slash_pos) = before_percent.rfind('/') {
let vol_str = before_percent[slash_pos + 1..].trim();
if let Ok(vol) = vol_str.parse::<u32>() {
current_volume = Some(vol);
}
}
}
}
}
})
})
.collect();
// Don't forget the last sink
if let (Some(name), Some(desc)) = (current_name, current_description) {
let is_default = default_sink.as_ref().map(|d| d == &name).unwrap_or(false);
sinks.push(PipewireSink {
name,
description: desc,
volume: current_volume,
is_default,
});
}
log::info!("Found {} audio output devices via CPAL", sinks.len());
log::info!("Devices: {:?}", sinks.iter().map(|s| &s.name).collect::<Vec<_>>());
log::info!("Found {} PipeWire sinks", sinks.len());
Ok(sinks)
}
@@ -708,3 +663,22 @@ pub fn set_pipewire_default_sink(_sink_name: String) -> Result<(), String> {
log::info!("Command: set_pipewire_default_sink (no-op on non-Linux)");
Ok(())
}
/// DEBUG: Get CPAL device names for comparison with PipeWire sinks
#[tauri::command]
pub fn debug_get_cpal_devices() -> Result<Vec<String>, String> {
use rodio::cpal::traits::{DeviceTrait, HostTrait};
log::info!("Command: debug_get_cpal_devices");
let host = rodio::cpal::default_host();
let devices: Vec<String> = host
.output_devices()
.map_err(|e| format!("Failed to enumerate devices: {}", e))?
.filter_map(|device| device.name().ok())
.collect();
log::info!("CPAL devices: {:?}", devices);
Ok(devices)
}
+1
View File
@@ -333,6 +333,7 @@ pub fn run() {
commands::get_audio_devices,
commands::get_audio_output_status,
commands::get_pipewire_sinks,
commands::debug_get_cpal_devices,
commands::set_pipewire_default_sink,
commands::reinit_audio_device,
commands::get_hardware_audio_status,
+32 -64
View File
@@ -793,20 +793,11 @@
async function loadAudioSettings() {
try {
const settings = await invoke<AudioSettings>('get_audio_settings');
// Convert stored sink name to description for display
// Convert stored device name to description for display
if (settings.output_device) {
// Look up the friendly description from the sink name
// Look up the friendly description from the device name
const description = sinkNameToDescription.get(settings.output_device);
outputDevice = description ?? settings.output_device;
// CRITICAL: Establish the saved device as PipeWire default on app start
// This ensures CPAL uses the correct device when playback begins
try {
await invoke('set_pipewire_default_sink', { sinkName: settings.output_device });
console.log('[Audio] Restored saved device as PipeWire default:', settings.output_device);
} catch (err) {
console.error('[Audio] Failed to set saved device as default:', err);
}
} else {
outputDevice = 'System Default';
}
@@ -832,27 +823,22 @@
async function handleOutputDeviceChange(description: string) {
outputDevice = description;
// Convert description back to sink name for storage
const sinkName = sinkDescriptionToName.get(description);
const deviceToStore = description === 'System Default' ? null : sinkName;
// Convert description back to device name for storage
const deviceName = sinkDescriptionToName.get(description);
const deviceToStore = description === 'System Default' ? null : deviceName;
try {
// Save the preference
await invoke('set_audio_output_device', { device: deviceToStore });
// CRITICAL: CPAL/Rodio cannot open PipeWire sinks by name directly
// We must set the sink as PipeWire default, then QBZ uses "default"
// This is a limitation of CPAL - it only sees ALSA devices, not PipeWire sinks
if (sinkName) {
await invoke('set_pipewire_default_sink', { sinkName });
}
// Reinitialize audio with the selected device
// CRITICAL: Pass the actual CPAL device name, not null
// CPAL can now find this device because we're using CPAL names
await invoke('reinit_audio_device', { device: deviceToStore });
// Reinitialize audio with default device (which now points to selected sink)
await invoke('reinit_audio_device', { device: null });
console.log('Audio output device changed:', description, '(sink:', sinkName ?? 'default', ')');
console.log('[Audio] Output device changed:', description, '(device:', deviceName ?? 'default', ')');
} catch (err) {
console.error('Failed to change audio output device:', err);
console.error('[Audio] Failed to change audio output device:', err);
}
}
@@ -861,17 +847,12 @@
try {
await invoke('set_audio_exclusive_mode', { enabled });
// Restore the currently selected device as PipeWire default
const sinkName = getCurrentDeviceSinkName();
if (sinkName) {
await invoke('set_pipewire_default_sink', { sinkName });
}
// Reinitialize audio (uses PipeWire default)
await invoke('reinit_audio_device', { device: null });
console.log('Exclusive mode changed and audio reinitialized:', enabled);
// Reinitialize audio with currently selected device
const deviceName = getCurrentDeviceSinkName();
await invoke('reinit_audio_device', { device: deviceName });
console.log('[Audio] Exclusive mode changed:', enabled);
} catch (err) {
console.error('Failed to change exclusive mode:', err);
console.error('[Audio] Failed to change exclusive mode:', err);
}
}
@@ -882,23 +863,18 @@
if (enabled) {
gaplessPlayback = false;
crossfade = 0;
console.log('DAC passthrough enabled: disabled gapless playback and crossfade');
console.log('[Audio] DAC passthrough enabled: disabled gapless playback and crossfade');
}
try {
await invoke('set_audio_dac_passthrough', { enabled });
// Restore the currently selected device as PipeWire default
const sinkName = getCurrentDeviceSinkName();
if (sinkName) {
await invoke('set_pipewire_default_sink', { sinkName });
}
// DAC passthrough may also require reinit for proper effect
await invoke('reinit_audio_device', { device: null });
console.log('DAC passthrough changed and audio reinitialized:', enabled);
// Reinitialize audio with currently selected device
const deviceName = getCurrentDeviceSinkName();
await invoke('reinit_audio_device', { device: deviceName });
console.log('[Audio] DAC passthrough changed:', enabled);
} catch (err) {
console.error('Failed to change DAC passthrough:', err);
console.error('[Audio] Failed to change DAC passthrough:', err);
}
}
@@ -908,19 +884,15 @@
// Auto-disable DAC passthrough if incompatible
if (enabled && dacPassthrough) {
dacPassthrough = false;
console.log('Gapless playback enabled: disabled DAC passthrough');
console.log('[Audio] Gapless playback enabled: disabled DAC passthrough');
try {
await invoke('set_audio_dac_passthrough', { enabled: false });
// Restore the currently selected device as PipeWire default
const sinkName = getCurrentDeviceSinkName();
if (sinkName) {
await invoke('set_pipewire_default_sink', { sinkName });
}
await invoke('reinit_audio_device', { device: null });
// Reinitialize audio with currently selected device
const deviceName = getCurrentDeviceSinkName();
await invoke('reinit_audio_device', { device: deviceName });
} catch (err) {
console.error('Failed to disable DAC passthrough:', err);
console.error('[Audio] Failed to disable DAC passthrough:', err);
}
}
}
@@ -931,19 +903,15 @@
// Auto-disable DAC passthrough if crossfade > 0
if (value > 0 && dacPassthrough) {
dacPassthrough = false;
console.log('Crossfade enabled: disabled DAC passthrough');
console.log('[Audio] Crossfade enabled: disabled DAC passthrough');
try {
await invoke('set_audio_dac_passthrough', { enabled: false });
// Restore the currently selected device as PipeWire default
const sinkName = getCurrentDeviceSinkName();
if (sinkName) {
await invoke('set_pipewire_default_sink', { sinkName });
}
await invoke('reinit_audio_device', { device: null });
// Reinitialize audio with currently selected device
const deviceName = getCurrentDeviceSinkName();
await invoke('reinit_audio_device', { device: deviceName });
} catch (err) {
console.error('Failed to disable DAC passthrough:', err);
console.error('[Audio] Failed to disable DAC passthrough:', err);
}
}
}