ebml-webm

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

Sans-IO EBML / WebM mux and demux. Demux handles the common Matroska/WebM profile — SimpleBlock and BlockGroup frames, Xiph/fixed/EBML lacing, Cues/SeekHead (index) — and mux writes spec-valid WebM with known-size clusters. Pure state machine: push bytes in, poll frames out; no I/O in the core.

Quick start

use ebml_webm::mux::{Live, Muxer};
use ebml_webm::types::{Bytes, TrackInfo};

let mut muxer = Muxer::new();
muxer.add_track(TrackInfo {
    track_number: 1,
    track_type: 1, // video
    codec_id: "V_VP9".to_owned(),
    codec_private: None,
    width: 1920,
    height: 1080,
    sample_rate: 0.0,
    channels: 0,
})?;

let mut muxer: Muxer<Live> = muxer.begin();
muxer.push_frame(1, 0, true, &vp9_keyframe)?; // track, timecode, keyframe, payload
muxer.flush();

let mut webm = Vec::new();
muxer.poll_bytes(&mut webm);

// Demux: feed bytes, poll frames — the index is exposed informationally.
let mut demuxer = ebml_webm::Demuxer::new();
demuxer.push_bytes(&webm);
while let Some(frame) = demuxer.poll_frame() { /* … */ }
let _index = demuxer.cues();

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 webm 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.