Audio

Generated from project.v1.schema.json at the documented engine version. The schema checks shape only; the engine’s validation also checks ranges, limits, references and keyframe order.

AudioEffect

A serializable single-input audio effect applied to a clip or track bus.

Sidechain ducking is not an entry here because it consumes a second input. It is authored per track through Ducking.

One of:

type: "eq"

Cascaded biquad sections.

Field	Type	Description
bandsrequired	EqBand[]	Ordered filter sections, 1 to MAX_EQ_BANDS of them.

type: "compressor"

Lookahead dynamic range compression.

Field	Type	Description
attack_msrequired	number (float)	Attack time in milliseconds, positive and at most MAX_ENVELOPE_MS.
lookahead_ms	number (float)	Lookahead in milliseconds, at most MAX_LOOKAHEAD_MS. Reported as graph latency. Default: 0
ratiorequired	number (float)	Downward ratio, from one (unity) to MAX_COMPRESSOR_RATIO.
release_msrequired	number (float)	Release time in milliseconds, positive and at most MAX_ENVELOPE_MS.
threshold_dbrequired	number (float)	Level above which gain reduction begins, in decibels from MIN_LEVEL_DB to 0.

type: "reverb"

Schroeder reverberation.

Field	Type	Description
dampingrequired	number (float)	High-frequency damping, in 0..=1.
mixrequired	number (float)	Wet mix, in 0..=1.
room_sizerequired	number (float)	Room size, in 0..=1.

AudioProperties

Per-clip audio presentation controls.

Field	Type	Description
effects	AudioEffect[]	Ordered single-input effects applied before the track bus, at most MAX_CHAIN_EFFECTS. Default: []
fade_in	MediaTime	Fade-in duration measured from the clip's timeline start. Non-negative. Default: 0
fade_out	MediaTime	Fade-out duration measured back from the clip's timeline end. Non-negative. Default: 0
fade_shape	FadeShape	Curve used by both fades. Default: "linear"
gain	Animated_float	Animated linear amplitude constrained to 0..=MAX_GAIN. Default: {"mode":"constant","value":1}
muted	boolean	Silences this clip without removing it. Default: false
pan	Animated_float	Animated stereo position from -1 (left) to 1 (right). Default: {"mode":"constant","value":0}

AudioStreamShape

An audio stream's channel count and sample rate.

Field	Type	Description
channelsrequired	integer (uint32)	Channel count.
sample_raterequired	integer (uint32)	Samples per second per channel.

Ducking

Sidechain ducking authored on the track that is attenuated.

Field	Type	Description
attack_msrequired	number (float)	Attack time in milliseconds, positive and at most MAX_ENVELOPE_MS.
depth_dbrequired	number (float)	Maximum attenuation in decibels, from MIN_LEVEL_DB to 0.
release_msrequired	number (float)	Release time in milliseconds, positive and at most MAX_ENVELOPE_MS.
sidechain_trackrequired	TrackId	Track whose mixed output drives the envelope follower.
thresholdrequired	number (float)	Linear level above which attenuation begins. Positive.

EqBand

A single equalizer section stored independently from its DSP implementation.

Field	Type	Description
frequency_hzrequired	number (float)	Center or corner frequency in hertz, within EQ_FREQUENCY_RANGE_HZ.
gain_db	number (float)	Peaking gain in decibels, at most MAX_EQ_GAIN_DB either way. Ignored by the pass filters. Default: 0
kindrequired	EqBandKind	Filter shape.
qrequired	number (float)	Resonance, within EQ_Q_RANGE. Larger values produce narrower bands.

EqBandKind

The filter shape of one equalizer band.

• "peaking" Bell-shaped parametric band.
• "low_pass" Second-order low-pass.
• "high_pass" Second-order high-pass.

FadeShape

Curve applied by a clip's fade in and fade out.

• "linear" Amplitude moves linearly. Two linear fades over one overlap dip by 6 dB.
• "equal_power" Amplitude follows a quarter sine. Two of these crossfade at constant power, which is what overlapping clips normally want.

Limiter

Final peak limiter placed at the end of the master bus.

Field	Type	Description
release_msrequired	number (float)	Release time in milliseconds, positive and at most MAX_ENVELOPE_MS.
thresholdrequired	number (float)	Linear ceiling, positive and at most MAX_GAIN. One is full scale.

MasterAudio

Project-wide master bus settings.

Field	Type	Description
effects	AudioEffect[]	Ordered single-input effects applied to the summed track buses, at most MAX_CHAIN_EFFECTS. Default: []
gain	Animated_float	Animated linear master amplitude constrained to 0..=MAX_GAIN. Default: {"mode":"constant","value":1}
limiter	Limiter | null	Final peak limiter. An omitted field is default; an explicit null leaves the mix unlimited. Default: {"release_ms":50,"threshold":1}

TrackAudio

Per-track audio bus controls.

Field	Type	Description
ducking	Ducking | null	Optional sidechain attenuation driven by another track. Default: null
effects	AudioEffect[]	Ordered single-input effects applied to the summed clip signal, at most MAX_CHAIN_EFFECTS. Default: []
gain	Animated_float	Animated linear bus amplitude constrained to 0..=MAX_GAIN. Default: {"mode":"constant","value":1}
muted	boolean	Silences this bus. Default: false
pan	Animated_float	Animated stereo position applied after the clip mix, from -1 (left) to 1 (right). Default: {"mode":"constant","value":0}
solo	boolean	Restricts the mix to soloed buses when any track sets this. Default: false