Home

Awesome

cubeb-rs ISC License

A cross-platform audio library in Rust.

Features

Provides access to the following:

Goals

Currently, cubeb-rs is based on a set of bindings to the original cubeb C++ library most notable for its use as the audio backend within Gecko, Mozilla's browser engine. The long-term goal for cubeb-rs is to become independent of the C++ library and provide a pure-Rust implementation down to the level of the platform API eventually replacing the original within Gecko where possible.

In order to achieve this goal cubeb-rs is structured in a manner that supports backend implementations in both pure-Rust and via bindings to the C++ implementation, allowing for progressive replacement. So far, pure-Rust implementations exist for:

The plan is to consolidate all cubeb-related projects (including backend implementations) under a single repository here in the near future.

While cubeb is primarily renown for its use within Gecko, contributions and use from projects outside of Gecko is very welcome.

Crates

The following crates are included within this repository:

CrateLinksDescription
cubebcrates.io docs.rsThe top-level user API for cubeb-rs. See the cubeb-api subdirectory. Depends on cubeb-core.
cubeb-corecrates.io docs.rsCommon types and definitions for cubeb rust and C bindings. Not intended for direct use. Depends on cubeb-sys.
cubeb-syscrates.io docs.rsNative bindings to the cubeb C++ library. Requires pkg-config and cmake
cubeb-backendcrates.io docs.rsBindings to libcubeb internals to facilitate implementing cubeb backends in Rust. Depends on cubeb-core.