# alsactl crate

Rust API bindings and wrappers for [alsactl library](https://github.com/alsa-project/alsa-gobject) to
operate ALSA Control character device.

The alsactl library version 0.3.0 is the minimum supported version for underlying library.

The alsactl crate is automatically generated by [gir tool](https://gtk-rs.org/gir/book/) provided
by [gtk-rs project](https://gtk-rs.org/). ALSACtl-0.0 file from alsactl library is used for the
generation. But some functions are implemented manually.

## Usage

Add the following line to your Cargo.toml file:

```toml
[dependencies]
alsactl = "0.7"
```

The API documentation is available in <https://docs.rs/alsactl/>.

## License

The alsactl crate is released under [MIT license](https://spdx.org/licenses/MIT.html).

## Dependency

The alsactl crate depends on API crates provided by [gtk-rs project](https://gtk-rs.org/) for
type/object system, event loop, and dispacher.

## Repository

The alsactl crate is the part of ALSA project and maintained by
[ALSA gobject-introspection team](https://alsa-project.github.io/gobject-introspection-docs/).
The remote repository is located in <https://github.com/alsa-project/alsa-gobject-rs>.

## Support

If finding issue, please file it in <https://github.com/alsa-project/alsa-gobject-rs>.

## Sample programs
Some programs are available under `examples` directory.

* `dump-elem-data.rs`

    * demonstration to dump information and current values of elements available in a sound card.