Adding `alsa` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add alsa

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

alsa = "0.11.0"

The alsa library will be automatically available globally. Read the alsa library documentation.

Readme

Thin but safe wrappers for ALSA, the most common API for accessing audio devices on Linux.

The ALSA API is rather big, so everything is not covered yet, but expect the following to work:

The following is not yet implemented (mostly because nobody asked for them) :

Quickstart guide / API design:

Most functions map 1-to-1 to alsa-lib functions, e g, ctl::CardInfo::get_id() is a wrapper around snd_ctl_card_info_get_id and the alsa-lib documentation can be consulted for additional information.
Structs are RAII and closed/freed on drop, e g, when a PCM struct is dropped, snd_pcm_close is called.
To read and write buffers, call the io_* methods. It will return a separate struct from which you can read or write, and which can also be used for mmap (if supported by the driver).
Error handling - most alsa-lib functions can return errors, so the return value from these is a Result.
Enumeration of cards, devices etc is done through structs implementing Iterator.
Many structs implement poll::Descriptors, to combine with your favorite async framework. Or just use wait if you don't need non-blocking functionality.

Notes:

To run the tests successfully, there must be a "default" sound card configured. This is usually not a problem when running on normal hardware, but some CI systems, docker images etc, might not have that configured by default.