---
name: "asoundconf"
section: "1"
platform: "linux"
package: "alsa-utils"
version: "1.0.16-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/asoundconf"
---

# asoundconf(1)

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

## NAME

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

## SYNOPSIS

**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**

## DESCRIPTION

**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

## AUTHOR

This program was written by Martin Pitt \<martin.pitt@ubuntu.com\>.