Example CLI for flacenc-rs

A CLI tool for encoding wav files into flac format, which compresses the input waveform by ~60% without any degradation. This is an example application of flacenc library.

Usage

To install (with using nightly rust; recommended):

cargo +nightly install flacenc-bin --features "simd-nightly"

Or, if you want to use stable channel:

cargo install flacenc-bin

Then, you can run encoding as follows:

flacenc --output output.flac input.wav

If you want to customize the encoder behavior, you can specify an additional config file. To do so, first, you may generate the default config file by:

flacenc --output output.flac --dump-config config.toml input.wav

Then, edit config.toml and encode with the customized config, as:

flacenc --output output.flac --config config.toml input.wav

Feature Flags

This binary crate has a few feature flags to enable additional features:

• pprof: If activated, the binary accept an additional command line argument --pprof-output [FILE]. If this flag is set, profiling data that can be processed by pprof are collected during the encoding process.
• simd-nightly: If activated, the dependency library is built with simd-nightly feature. This is a recommended setting; however, it is only available in a nightly toolchain.

Contributing

See CONTRIBUTING.md for details.

License

Apache 2.0; see LICENSE for details.

Disclaimer

This project is not an official Google project. It is not supported by Google and Google specifically disclaims all warranties as to its quality, merchantability, or fitness for a particular purpose.

This encoder is still unstable and sometimes the encoded file may contain distortion, i.e. the encoder very rarely outputs broken signals. You can check whether you encountered an encoder bug by running, e.g., the reference decoder. The FLAC format contains MD5 digest of the input signal, and the reference decoder checks if the digest of the decoded signal matches with the stored one.