volumecontrol-linux

Linux (PulseAudio) volume control backend for the volumecontrol crate family.

This crate provides an AudioDevice implementation backed by PulseAudio.

Note: This crate exists primarily as an implementation detail of the volumecontrol crate, which selects the correct backend automatically. If cross-platform support is not a concern, you may depend on this crate directly.

Feature flags

Without the pulseaudio feature every method returns AudioError::Unsupported, which allows the crate to compile on any platform without the PulseAudio development headers.

System requirements

On Linux, install the PulseAudio development headers before building:

# Debian / Ubuntu
sudo apt-get install libpulse-dev

# Fedora / RHEL
sudo dnf install pulseaudio-libs-devel

# Arch Linux
sudo pacman -S libpulse

Usage

[dependencies]
volumecontrol-linux = { version = "0.1", features = ["pulseaudio"] }
volumecontrol-core  = "0.1"

Example

use volumecontrol_linux::AudioDevice;
use volumecontrol_core::AudioDevice as _;

fn main() -> Result<(), volumecontrol_core::AudioError> {
    let device = AudioDevice::from_default()?;
    println!("{device}");  // e.g. "Built-in Audio (alsa_output.pci-…)"
    println!("Current volume: {}%", device.get_vol()?);
    Ok(())
}

Built with AI

This crate is part of the volumecontrol workspace, which was built 100% with GitHub Copilot (Claude Opus & Claude Sonnet) as an experiment in AI-driven development of a production-ready Rust crate.

License

MIT — see the LICENSE file in the repository for details.