ogg-core

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

Sans-IO Ogg page/packet framing (RFC 3533): mux writes spec-valid pages (one packet per page), demux is a general incremental reader that handles multi-packet pages, packets spanning continuation pages, and CRC verification. The transport for Opus, Vorbis, and FLAC logical bitstreams. No I/O in the core.

Quick start

use ogg_core::{Demuxer, Muxer};

let mut muxer = Muxer::new(serial_number);
let mut ogg = Vec::new();
muxer.push_packet(&opus_head, 0, false, &mut ogg)?; // bos set automatically
muxer.push_packet(&opus_packet, 44100, true, &mut ogg)?; // eos on the last page

let mut demuxer = Demuxer::new();
demuxer.push_bytes(&ogg);
while let Some(packet) = demuxer.poll_packet()? {
    // packet.data (continuation pages merged), packet.granule_position, …
}

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