6 releases

0.3.1 Dec 10, 2023
0.3.0 Dec 17, 2022
0.2.2 Jul 25, 2021
0.2.1 Feb 14, 2021
0.1.0 Aug 22, 2020

#82 in Multimedia

Download history 17/week @ 2024-06-17 4/week @ 2024-07-08 1/week @ 2024-07-15 3/week @ 2024-07-22 36/week @ 2024-07-29 15/week @ 2024-08-05 279/week @ 2024-08-12 8/week @ 2024-08-19 99/week @ 2024-08-26 4/week @ 2024-09-02 13/week @ 2024-09-16 35/week @ 2024-09-23 183/week @ 2024-09-30

231 downloads per month
Used in flac-bound

BSD-3-Clause

2MB
46K SLoC

C 40K SLoC // 0.1% comments Rust 4K SLoC // 0.0% comments C++ 1.5K SLoC // 0.1% comments Shell 14 SLoC

Contains (obscure autoconf code, 6KB) ogg/configure.ac

Rust FFI bindings to the libFLAC library

This crate provides raw FFI bindings to the libFLAC library for reading and writing losslessly compressed FLAC audio files.

Following the *-sys package conventions, the libflac-sys crate does not define higher-level abstractions over the native libFLAC library functions.

Usage

Add this to your Cargo.toml:

[dependencies]
libflac-sys = "0.3"

Features

  • build-flac (enabled by default): build libFLAC instead of linking to the system library – cmake and a C toolchain is required
  • build-ogg (enabled by default, implies build-flac): build support for FLAC data in OGG containers into libFLAC; if build-flac is not selected, support for OGG containers depends on the configuration of the system libFLAC

Auto-generating the Rust bindings

The Rust bindings have already been auto-generated with bindgen (using the bindgen/run-bindgen.sh script) and are part of this crate (see src/bindings.rs).

Contributing

If you want to report a problem or suggest an improvement, please go to https://github.com/mgeier/libflac-sys. Contributions are always welcome!

Licenses

This crate uses the BSD-3-Clause license, in reference to Xiph.Org's BSD-like license which is used as libFLAC license and libogg license.

Dependencies