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

Convenience macro functions:

asoundconf set−default−card CARD asoundconf reset−default−card


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 the value of defaults.pcm.card from the system sound preferences menu.)



user-specific ALSA library configuration file


file containing asoundconf-managed parameter settings


This program was written by Martin Pitt <martin.pitt [AT]>.