waverly

Waverly is a Rust library that allows for easy parsing and writing of WAV files with the primary goal of providing access to all metadata within a WAV file, not just the format and data chunks. It's secondary goal is to support no_std. If you only care about the data chunk already formatted as samples, there are plenty of good alternatives.

use std::fs::File;
use std::io::Cursor;
use waverly::Wave;

fn main() -> Result<(), waverly::WaverlyError> {
    let file = File::open("./meta/16bit-2ch-float-peak.wav")?;
    let wave: Wave = Wave::from_reader(file)?;

    let mut virt_file = Cursor::new(Vec::new());
    wave.write(&mut virt_file)?;
    Ok(())
}

TODO

• Parse/read and write WAV files

• FORMAT chunk

• DATA chunk

• PEAK chunk

• FACT chunk

• no_std support

• Single pass generation of samples in any bit depth

• Most metadata in WAV can be generated without user input, do so where possible on write.

• Feature to skip or target chunks

• CUE POINT chunk

• PLAYLIST chunk

• Support PEAK chunk when channels are not equal to 2

• Better support for extensible modes

• Better error messages when binary doesn't align with chunks

• ATests for additional chunks, extensible modes, no_std

Further reading

Multimedia Programming Interface and Data Specifications, starting on page 56