Introduction

OpenJOC is an independent Rust implementation of an E-AC-3 JOC decode and rendering pipeline. It accepts supported raw E-AC-3 or seekable ordinary MP4/M4A input, decodes the base programme and JOC reconstruction data, and exposes the resulting scene to several output paths.

The main user-facing surfaces are:

• openjoc render-joc for speaker or binaural rendering;
• openjoc export-adm for a reconstructed ADM BWF representation;
• openjoc inspect and openjoc decode for metadata and reconstruction diagnostics;
• the Rust OpenJocSession API and versioned C ABI for embedding;
• project-provided FFmpeg, GStreamer, mpv, and Windows DirectShow/LAV integrations.

The project has two important semantic boundaries:

1. A ReconstructionBasis row is a decoder-domain, carrier-local output signal. It is not an authored Atmos stem.
2. The reconstructed ADM exporter binds decoded JOC object PCM to decoded OAMD movement only within its admitted profile. It does not recover the source ADM master.

OpenJOC uses a 48 kHz render domain. The ordinary JOC speaker path is experimental and bounded by the documented profiles, layouts, output containers, and validation status. The capability matrix owns the detailed status vocabulary.

The first successful render

Install the CLI, run openjoc --help, then follow Quick start. If your input is a seekable M4A or MP4, keep ffprobe and ffmpeg available as described in Installation.