search

alsa-project / alsa-ucm-conf

ALSA Use Case Manager configuration
BSD 3-Clause "New" or "Revised" License
76 stars 222 forks source link

readme

alsa-ucm-conf

ALSA Use Case Manager configuration

Installation

Copy the ucm and ucm2 trees to the alsa-lib configuration directory (usually located in /usr/share/alsa) including symlinks. The files in the package root directory (README.md, LICENSE and VERSION) files are extra (only informational).

Example:

tar xvjf alsa-ucm-conf-1.2.6.2.tar.bz2 -C /usr/share/alsa --strip-components=1 --wildcards "*/ucm" "*/ucm2"

The latest configuration can be obtained with those commands:

curl -L -o alsa-ucm-conf.tar.gz https://github.com/alsa-project/alsa-ucm-conf/archive/refs/heads/master.tar.gz
tar xvzf alsa-ucm-conf.tar.gz -C /usr/share/alsa --strip-components=1 --wildcards "*/ucm" "*/ucm2"

State file

Some values may be set only one time by UCM and then they are saved to the global ALSA sound state file. Please, make sure that this state is cleared, if you have an issue.

Commands for standard systemd setup (relogin is required):

systemctl stop alsa-state
rm /var/lib/alsa/asound.state
systemctl start alsa-state

Validation

Validate UCM configuration

The UCM configurations are automatically validated using the UCM validator available at https://github.com/alsa-project/alsa-tests/tree/master/python/ucm-validator .

If you create a pull request for new hardware, please, add also the alsa-info.sh output to emulate this hardware in the UCM validator.