riff-wave-core

Status: early development (0.x). Not recommended for production; public APIs may change without notice. Part of the Mediaway media stack.

Sans-IO RIFF/WAVE mux and demux for PCM audio (integer and IEEE float). Mux buffers pushed samples and writes a complete .wav on finish() (RIFF chunk sizes must be known up front); demux parses a complete buffer back into a format description and raw samples. No I/O in the core.

Quick start

use riff_wave_core::{Muxer, parse, SampleFormat, WaveFormat};

let format = WaveFormat {
    sample_format: SampleFormat::Pcm,
    channels: 2,
    sample_rate: 48_000,
    bits_per_sample: 16,
};

let mut muxer = Muxer::new(format);
muxer.push_samples(&pcm_bytes);
let wav = muxer.finish(); // complete RIFF/WAVE file

// Parse it back: format description + raw sample payload.
let (parsed, samples) = parse(&wav)?;
assert_eq!(parsed.sample_rate, 48_000);

Status

Status marks: ✅ first-class (tests for claimed scope) · ⚡ Zero-Copy path (no payload copy; implies ✅) · 🆗 best-effort / prototype · 🛠️ planned · ❌ attempted and genuinely blocked · 👻 not exercisable yet (no hardware / device / session available)

Docs

• docs/roadmap.md — stages, deferred items, design decisions
• mediaway-container — Mediaway-typed wav surface over this crate
• Root README — container support matrix

Contributing

Contributions are welcome — open an issue or pull request at github.com/nyxways/mediaway.

License

MIT OR Apache-2.0.