Arch manual pages

asoundconf(1) General Commands Manual asoundconf(1)

asoundconf - utility to read and change the user's ALSA library configuration

asoundconf is-active

asoundconf get|delete PARAMETER

asoundconf set PARAMETER VALUE

asoundconf list

asoundconf list-all

Convenience macro functions:

asoundconf set-default-card PARAMETER

asoundconf reset-default-card

asoundconf set-pulseaudio

asoundconf unset-pulseaudio

asoundconf set-oss PARAMETER

asoundconf unset-oss

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.)

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 parameters listed in /usr/share/alsa/alsa.conf under the defaults section. Separate graphical frontend tools are under development to ease the configuration of multichannel .asoundrc files.)

user-specific ALSA library configuration file
file containing asoundconf-managed parameter settings

This program was written by Martin Pitt <>.
06 May 2008