asoundconf(1)

asoundconf1

Utility to read and change the user's alsa library configuration

Usage

asoundconf is-active

asoundconf {get | delete PARAMETER}

asoundconf set PARAMETER VALUE

asoundconf list

Convenience macro functions:

asoundconf set-default-card CARD asoundconf reset-default-card

Overview

asoundconf configures the ALSA library for the user. It does this by reading the values of parameters from and writing the values of parameters to the special file .asoundrc.asoundconf in the user's home directory. The .asoundrc.asoundconf file should not be edited by hand!

The .asoundrc.asoundconf file only has an effect on the ALSA library if it is included by the user's .asoundrc file, also located in the user's home directory. When asoundconf is run and it finds either that the ~/.asoundrc file does not exist or that the file exists and contains the markers of the obsolete set-default-soundcard program then asoundconf adds the required inclusion statement to ~/.asoundrc; otherwise asoundconf does not change ~/.asoundrc. Hence, if you want to disable control of ALSA library configuration parameters by asoundconf then simply comment out this inclusion statement but do not delete the ~/.asoundrc file. (It is OK for ~/.asoundrc to be an empty file.)

Warning

This program is under development. Its features will change without notice and without preservation of backward compatibility, except insofar as they are put to use by other components of the Debian and/or Ubuntu operating systems. (As of this writing the Ubuntu developers have plans to use asoundconf for setting the value of defaults.pcm.card from the system sound preferences menu.)

Files

~/.asoundrc

user-specific ALSA library configuration file

~/.asoundrc.asoundconf

file containing asoundconf-managed parameter settings

Releases

Unchanged in 2 releases since Debian 4.0 (Etch).

  1. 4.0–5.0

Author

This program was written by Martin Pitt <[email protected]>.

From alsa-utils 1.0.16-2 in Debian 5.0 (Lenny). Parsed by carta from the page's man source.