rob
/
cpal
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Cross-platform audio in Rust
376 Commits 3 Branches 0 Tags 8.7 MiB
Rust 99.6%
C++ 0.4%
Go to file
Chris Morgan 2679ea845f impl Debug for Device (#253) 
The internal alsa, null and emscripten Device implementations already
implemented Debug; but the coreaudio and wasapi ones, and therefore
also the wrapper, did not.

I decided to eschew the `Device(…)` wrapping in the outer layer
(hence a custom implementation rather than `#[derive(Debug)]`),
because `Device(Device)`, `Device(Device { … })` and so forth all
look better without the extra `Device(…)` wrapping.

On the wasapi and coreaudio implementations I put both the pointer and
name. Name because it’s useful, pointer because on Windows at least
I believe duplicated names are possible. (e.g. two monitors that include
monitors, of the same type; I haven’t strictly confirmed this, because I
killed those off harshly on my machine and don’t want to reinstate
them.)

I do not have access to a macOS device to confirm that the coreaudio
implementation is sane, but I think it is.
 		2019-03-22 21:27:17 +01: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 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
src impl Debug for Device (#253) 2019-03-22 21:27:17 +01: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 Fix the PauseStream handler to flip the `playing` bit. (#233) 2018-07-10 16:43:52 +02:00
Cargo.toml Upgrade lazy_static (#232) 2018-07-03 21:07:08 +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.