#audio #opus #codec

sys audiopus_sys

FFI-Binding to Opus, dynamically or statically linked for Windows and UNIX

6 releases

✓ Uses Rust 2018 edition

0.1.5 Jun 2, 2019
0.1.4 Jun 2, 2019
0.1.2 May 30, 2019
0.1.1 Mar 29, 2019

#14 in Encoding

Download history 123/week @ 2019-03-25 103/week @ 2019-04-01 92/week @ 2019-04-08 110/week @ 2019-04-15 83/week @ 2019-04-22 168/week @ 2019-04-29 56/week @ 2019-05-06 142/week @ 2019-05-13 164/week @ 2019-05-20 184/week @ 2019-05-27 184/week @ 2019-06-03 246/week @ 2019-06-10 253/week @ 2019-06-17 267/week @ 2019-06-24 130/week @ 2019-07-01

423 downloads per month
Used in 2 crates (1 directly)

ISC license

3.5MB
45K SLoC

C 41K SLoC // 0.2% comments Rust 1.5K SLoC // 0.0% comments Visual Studio Project 1K SLoC Assembly 360 SLoC // 0.3% comments Automake 288 SLoC // 0.1% comments Perl 264 SLoC // 0.2% comments Shell 174 SLoC // 0.5% comments Visual Studio Solution 168 SLoC Python 87 SLoC // 0.1% comments Batch 20 SLoC

ci-badge docs-badge rust 1.33+ badge crates.io version

About

audiopus_sys is an FFI-Rust-binding to Opus version 1.3.

Orginally, this sys-crate was made to empower the serenity-crate to build audio features on Windows, Linux, and Mac.

Everyone is welcome to contribute, check out the CONTRIBUTING.md for further guidance.

Building

Requirements

UNIX/GNU/MSYS2

You will need gcc, libclang, make, automake, autoconf, and libtool. Note that automake uses autoconf as dependency already. If you have pkg-config, audiopus_sys will try finding Opus with pkg-config.

MSVC

Currently audiopus_sys links to a prebuilt Opus hence should just work. It supports x86 and x64 as dynamic or static build.

Linking

audiopus_sys links to Opus 1.3 and supports Windows, Linux, and MacOS By default, we statically link to Windows, MacOS, and if you use the musl-environment. We will link dynamically for Linux except when using mentioned musl.\

This can be altered by compiling with the static or dynamic feature having effects respective to their names. If both features are enabled, we will pick your system's default.

Environment variables named LIBOPUS_STATIC or OPUS_STATIC will take precedence over features thus overriding the behaviour. The value of these environment variables have no influence of the result: If one of them is set, statically linking will be picked.

Pkg-Config

By default, audiopus_sys will use pkg-config on Unix or GNU. Setting the environment variable LIBOPUS_NO_PKG or OPUS_NO_PKG will bypass probing for Opus via pkg-config.

Pre-installed Opus

If you have Opus pre-installed, you can set LIBOPUS_LIB_DIR or OPUS_LIB_DIR to point to the directory in which your Opus lies. Be aware that using an Opus other than version 1.3 may not work.

Installation

Add this to your Cargo.toml:

[dependencies]
audiopus_sys = "0.1"

No runtime deps