Cross-platform audio in Rust
Go to file
mitchmindtree eae0e18714 Add `PlayStreamError` and `PauseStreamError`.
This allows for properly handling potential failure on macOS. We should
also consider propagating the mutex/channel poison errors through these
new types, especially considering the potential removal of the event
loop in favour of switching over to high-priority audio threads on
windows and linux.
2019-06-21 03:04:15 +02:00
.circleci Add testing on circle-ci (#171) 2017-10-21 15:08:34 +02:00
alsa-sys Bump alsa-sys version number 2017-03-06 15:57:18 +00:00
examples Add `PlayStreamError` and `PauseStreamError`. 2019-06-21 03:04:15 +02:00
src Add `PlayStreamError` and `PauseStreamError`. 2019-06-21 03:04:15 +02:00
.gitignore Update to a more general Device and Stream API. Add support for input streams (E.g. microphone). Add default format methods. (#201) 2018-02-12 14:10:24 +01:00
.rustfmt.toml Run rustfmt on the code (#162) 2017-10-11 13:24:49 +02:00
.travis.yml Stop publishing on gh-pages 2017-02-10 09:45:41 +01:00
CHANGELOG.md add changelog entries for #248 #254 & #269; update version to 0.9.0 2019-06-06 10:29:52 -05:00
Cargo.toml Remove std `Error` implementations in favour of using `failure` 2019-06-20 21:12:17 +02:00
README.md readme: mention system dependencies (#240) 2018-09-17 15:57:51 +02:00
appveyor.yml Fix the appveyor build 2014-12-23 15:28:38 +01:00

README.md

CPAL - Cross-Platform Audio Library

Build Status Crates.io docs.rs

Low-level library for audio input and output in pure Rust.

This library currently supports the following:

  • Enumerate all available audio devices.
  • Get the current default input and output devices.
  • Enumerate known supported input and output stream formats for a device.
  • Get the current default input and output stream formats for a device.
  • Build and run input and output PCM streams on a chosen device with a given stream format.

Currently supported backends include:

  • Linux (via ALSA)
  • Windows
  • macOS (via CoreAudio)
  • iOS (via CoreAudio)
  • Emscripten

Note that on Linux, the ALSA development files are required. These are provided as part of the libasound2-dev package on Debian and Ubuntu distributions and alsa-lib-devel on Fedora.