Pure-Rust media transcoding and streaming. No C libraries, no FFI wrappers, no *-sys crates — every codec, container, and filter is implemented from the spec in safe Rust.

The two user-facing binaries:

Probe, remux, transcode, run JSON transcode graphs. Drop-in on servers and pipelines; one static binary, no system deps.

cargo install oxideav-cli

…or grab a pre-built binary from the latest oxideav-workspace release.

oxideav list                            # registered codecs + containers
oxideav probe video.mp4                 # demux probe + metadata
oxideav transcode song.flac song.wav    # remux or transcode
oxideav run job.json                    # run a JSON transcode graph

SDL2 + TUI frontend. SDL2 is loaded at runtime via libloading, so the binary builds + ships without an SDL2 build-time dep (install SDL2 on the target machine; oxideplay falls back gracefully if it's missing).

cargo install oxideplay

…or grab it pre-built from the same oxideav-workspace release archive.

oxideplay path/to/file.mkv
oxideplay https://example.com/video.mp4
oxideplay --job job.json            # render a transcode graph live

Pre-built releases bundle both binaries (oxideav + oxideplay) in one per-platform archive — Linux x86_64, macOS universal (Intel + Apple Silicon), Windows x86_64 — published as a single GitHub Release per workspace tag.

graph LR
    CLI[oxideav<br/>CLI]
    PLAYER[oxideplay<br/>Player]

    PIPE[oxideav-pipeline<br/>source → transforms → sink]

    SRC[oxideav-source<br/>URI / file / probe]
    HTTP[oxideav-http]
    GEN[oxideav-generator<br/>synthetic input]

    CORE[oxideav-core<br/>Decoder/Encoder traits<br/>Demuxer/Muxer traits<br/>CodecRegistry]

    AF[oxideav-audio-filter]
    IF[oxideav-image-filter]
    PIX[oxideav-pixfmt]

    SUB[oxideav-subtitle]
    SCENE[oxideav-scene]
    SCRIBE[oxideav-scribe<br/>shaper + rasterizer]
    TTF[oxideav-ttf]
    OTF[oxideav-otf]

    AUDIO[Audio codecs<br/>aac · ac3 · eac3 · opus<br/>flac · mp3 · vorbis<br/>g.711/722/729 · gsm<br/>shorten · tta · wavpack<br/>cook · dts · wma · …]
    VIDEO[Video codecs<br/>h.264 · h.265 · h.266<br/>av1 · vp8 · vp9 · vp6<br/>mpeg-1/2/4 · prores<br/>ffv1 · huffyuv · utvideo<br/>cinepak · indeo · svq · …]
    IMAGE[Image codecs<br/>png · jpeg · webp · gif<br/>jpegxl · jpeg2000 · jpegxs<br/>avif · heif · tiff · bmp · ico]
    CONT[Containers<br/>mp4 · mkv/webm · ogg<br/>avi · flv · iff · mod/s3m]
    LIVE[Live transport<br/>rtmp]

    CLI --> PIPE
    PLAYER --> PIPE
    PIPE --> SRC
    PIPE --> CORE
    PIPE --> AF
    PIPE --> IF
    SRC --> HTTP
    SRC --> GEN
    CORE --> AUDIO
    CORE --> VIDEO
    CORE --> IMAGE
    CORE --> CONT
    CORE --> LIVE
    AF --> CORE
    IF --> PIX
    SUB --> SCRIBE
    SCENE --> SCRIBE
    SCRIBE --> TTF
    SCRIBE --> OTF

oxideav-core carries the trait surface (Decoder, Encoder, Demuxer, Muxer) plus the registry. Each codec/container crate exposes pub fn register(&mut RuntimeContext) and the oxideav-meta aggregator calls every enabled sibling's register from a build-script-generated register_all(ctx). The pipeline executor only sees the registry, never any concrete crate.

OxideAV is a modular framework shipped as ~95 small crates. Each codec is its own repository and its own crates.io release, so you pick only what you need and their cadence stays independent of the framework.

Single-crate standalone use is the expected case:

[dependencies]
oxideav-core = "0.1"       # types + Decoder/Encoder traits + registry
oxideav-g711 = "0.0"       # or any other codec

use oxideav_core::{
    CodecId, CodecParameters, CodecRegistry, Frame, Packet, TimeBase,
};

let mut reg = CodecRegistry::new();
oxideav_g711::register(&mut reg);

let mut params = CodecParameters::audio(CodecId::new("pcm_mulaw"));
params.sample_rate = Some(8_000);
params.channels = Some(1);

let mut dec = reg.make_decoder(&params)?;
dec.send_packet(&Packet::new(0, TimeBase::new(1, 8_000), ulaw_bytes))?;
let Frame::Audio(a) = dec.receive_frame()? else { unreachable!() };

Or pull every codec/container/filter/source via the oxideav-meta aggregator:

[dependencies]
oxideav-core = "0.1"
oxideav-meta = "0.0"             # default-features = ["all"] pulls everything

let mut ctx = oxideav_core::RuntimeContext::new();
oxideav_meta::register_all(&mut ctx);

Slimmer subsets via Cargo features. Preset bundles (audio, video, image, subtitles, hwaccel, source-drivers) plus per-crate flags:

# Just image codecs.
oxideav-meta = { version = "0.0", default-features = false, features = ["image"] }

# MP4 + H.264 + AAC only.
oxideav-meta = { version = "0.0", default-features = false, features = ["mp4", "h264", "aac"] }

register_all is auto-generated by oxideav-meta's build.rs from its Cargo.toml + active feature flags — only the siblings you opted into get linked.

Containers — MP4 · Matroska / WebM · Ogg · AVI · FLV · IFF / 8SVX · MOD · S3M · RTMP (live source)

Audio codecs — PCM · ADPCM · AAC-LC (with ADTS + LATM/LOAS) · MP1 · MP2 · MP3 · FLAC · Vorbis · Opus · CELT · Speex · GSM · G.711 · G.722 · G.723.1 · G.728 · G.729 · iLBC · AC-3 · E-AC-3 · AC-4 · DTS (Core / EXSS / XCH / XXCH / X96 / XLL) · WMA (v1 / v2 / Pro / Lossless) · Cook · Musepack · WavPack · Shorten · TTA · aptX · MIDI (SMF)

Video codecs — H.261 · H.263 · H.264 (decode + CABAC encode, High10) · H.265 (decode + 4:4:4 12-bit IDR encode) · H.266 · MPEG-1 · MPEG-2 · MPEG-4 P2 · MS-MPEG-4 · MJPEG (with progressive + arithmetic SOF9) · Theora · Dirac (with OBMC encode) · ProRes (RDD 36 — all 6 profiles) · FFV1 · AV1 (decode) · VP6 · VP8 · VP9 · AMV · HuffYUV · Lagarith · Ut Video · MagicYUV · Cinepak · Sorenson SVQ1 · Indeo (v2 + v3/v4/v5 module-ready) · EVC

Image codecs — PNG / APNG · GIF · WebP (lossy + lossless + animated) · JPEG (via MJPEG, baseline + progressive + arithmetic) · JPEG XL (decoder) · JPEG 2000 · JPEG XS · AVIF (decoder) · HEIF / HEIC (via H.265 — clap / irot / imir / iovl / grid / auxC) · TIFF · BMP · ICO

Subtitles — SRT · WebVTT · ASS / SSA · TTML · SAMI · MicroDVD · MPL2 · MPsub · VPlayer · PJS · AQTitle · JACOsub · RealText · SubViewer 1/2 · EBU STL · PGS · DVB · VobSub

Each crate ships its own corpus + trace harness against an external reference (ffmpeg / cwebp / libpng / TurboJPEG / etc.) plus a cargo-fuzz harness for the fully-functional encode + decode paths.

Clone oxideav-workspace plus any sibling crate you want to hack on, then run scripts/dev-patch.sh. The generated .cargo/config.toml wires every local sibling into the workspace via [patch.crates-io], so cargo run -p oxideplay picks up your local edits without a re-publish.

Three GitHub Actions reusable workflows live in this repo and are shared by every sibling crate so we don't have to keep ~95 copies of the same YAML in sync:

• crate-ci.yml — cargo build --all-targets + cargo test on the OS matrix (Linux + macOS + Windows by default), cargo fmt --check, cargo clippy --no-deps -- -D warnings, and an optional miri job (rate-limited to once-a-day per repo).
• crate-fuzz.yml — daily nightly cargo-fuzz run for crates that ship harnesses under fuzz/. Auto-discovers targets from fuzz/fuzz_targets/*.rs, splits the per-day budget across them, and persists the corpus across runs.
• crate-release.yml — wraps release-plz: opens/refreshes the release PR on every push to master, then publishes to crates.io + tags the GitHub Release once that PR is merged.

We are still in heavy development, so callers should track @master (no pinned version yet — there's no v1 tag).

Replace the crate's .github/workflows/ci.yml with:

name: CI
on:
  push: { branches: [master] }
  pull_request: { branches: [master] }
jobs:
  ci:
    uses: OxideAV/.github/.github/workflows/crate-ci.yml@master
    with:
      enable_miri: false
    secrets: inherit

…and the crate's .github/workflows/release-plz.yml with:

name: Release-plz
on:
  push: { branches: [master] }

# Caller must grant the permissions the reusable workflow needs —
# workflow_call does NOT elevate the calling token.
permissions:
  contents: write
  pull-requests: write

jobs:
  release:
    uses: OxideAV/.github/.github/workflows/crate-release.yml@master
    secrets: inherit

Optional: add .github/workflows/fuzz.yml for nightly fuzz runs:

name: Fuzz
on:
  schedule:
    - cron: "37 4 * * *"   # daily 04:37 UTC, jittered off the hour
  workflow_dispatch:
jobs:
  fuzz:
    uses: OxideAV/.github/.github/workflows/crate-fuzz.yml@master
    with:
      extra_packages_apt: "libwebp-dev"   # whatever the harness dlopens
      time_budget_seconds: 1800
    secrets: inherit

• CARGO_REGISTRY_TOKEN — crates.io publish token (release workflow).
• RELEASE_PLZ_TOKEN (optional) — PAT used so the tag push triggers downstream workflows; falls back to GITHUB_TOKEN.

OxideAV is an open-source pure-Rust media stack maintained by Karpelès Lab Inc. If it saves you C dependency hell or unblocks a Rust-only build target you couldn't otherwise reach, please consider supporting continued development:

GitHub also surfaces this link automatically via the per-repository Sponsor button (configured in .github/FUNDING.yml on this repo).

Every crate is MIT-licensed. Copyright © 2026 Karpelès Lab Inc.