Skip to content

Quick start

This guide takes a supported JOC programme from input to a first file render.

Render a speaker layout

openjoc render-joc input.m4a \\
  --layout 7.1.4 \\
  --output output.wav

The output extension selects the container. Standard layouts can use WAV when their channel identities are representable by WAVEFORMATEXTENSIBLE; use CAF when semantic channel descriptions are required.

Try stereo or binaural output

openjoc render-joc input.m4a --layout 2.0 --output stereo.wav
openjoc render-joc input.m4a --binaural --output headphones.wav

The default binaural virtual field is 7.1.4 and the default LFE policy is exclude. A custom SOFA file and a different virtual layout are available through the options documented in the CLI reference.

Inspect before rendering

openjoc inspect input.ec3
openjoc --help

Use inspect to see whether the input is admitted as a JOC carrier and which profile or rejection boundary applies. Use decode when you need metadata manifests or diagnostic ReconstructionBasis row WAVs rather than a final speaker render.

Inspect E-AC-3 JOC object metadata

openjoc inspect input.ec3 --aus --objects --emdf

--objects adds per-OAMD-slot statistics and --emdf expands the parsed EMDF configuration for the traversed carrier. These are inspection metadata, not decoded object PCM or an object-audio export. See Decode and inspect for report fields and limits. The E-AC-3 JOC overview explains how supported OAMD metadata and JOC reconstruction data are decoded from the same carrier.

Export a reconstructed ADM file

openjoc export-adm input.m4a --output reconstructed.wav
openjoc validate-adm reconstructed.wav

The exporter also writes an adjacent .adm-report.json. Read Reconstructed ADM export before using the file in a DAW or interchange workflow.

Pick the right next page