Optionalanimation?: {Lanes only (picture-in-picture): entrance / exit / loop animations. Ignored on the main track.
Optionalin?: { duration: number; type: string }Flicks. Clamped to the item's length when played (in + out never overlap).
Animation preset id (ANIMATION_PRESETS, slot in or out).
Optionalloop?: { speed?: number; type: string }Optionalspeed?: numberSpeed multiplier 0.25–4 (missing = 1).
Animation preset id (ANIMATION_PRESETS, slot loop).
Optionalout?: { duration: number; type: string }Flicks. Clamped to the item's length when played (in + out never overlap).
Animation preset id (ANIMATION_PRESETS, slot in or out).
OptionalaudioFx?: {Sound effects (file version 4+). Missing = none.
Optionalcompress?: numberCompressor ("even out"): 0 = off … 1 = strong; quiet parts come up, loud ones go down.
Optionaldenoise?: numberClean up noise: 0 = off … 1 = strong; steady background noise (hiss, hum, fans) goes down.
Optionaleq?: { high: number; low: number; mid: number }Three-band equaliser, dB each (−12…12): bass (shelf, 120 Hz), middle (1 kHz), treble (shelf, 8 kHz).
OptionalkeepPitch?: booleanKeep the original pitch when the clip is sped up or slowed down (speeds 0.5×…2×).
Optionalpitch?: numberPitch shift in semitones (−12…12), the speed unchanged.
Optionalblend?: Lanes only: how the picture mixes with what's under it (file version 3+).
Fractions of the source cut from each edge.
Optionalduck?: numberLower under voice (ducking, file version 3+): while the project's other sound — video clips'
own sound, voiceovers, anything not itself ducked — has a voice in it, this item plays at
1 − duck of its volume (eased in and out). 0…1; missing = off.
How long it lasts on the timeline.
How the media fills the canvas at scale 1: inside it (fit) or covering it (fill).
OptionalgroupId?: stringLane items sharing a group id select, move (on the stage and in time) and scale together (file version 3+). Main-track clips are never grouped.
Optionalhidden?: booleanNot drawn in the preview or the export; a video's sound still plays (file version 3+).
Optionalkey?: { color: string; softness: number; spill: number; tolerance: number }Green screen (file version 3+). Missing = off.
The colour to remove, #rrggbb.
Optionalkeyframes?: {Transform keyframes (file version 4+).
Optionalopacity?: {Optionalrotation?: {Optionalscale?: {Optionalshift?: numberFlicks added to the item's time before sampling: a part of a split (or a clip trimmed at its start) keeps the whole motion and plays its own share of it, exactly. Missing = 0.
Optionalx?: {Optionaly?: {Optionallocked?: booleanCan be selected but not moved, trimmed or edited until unlocked (file version 3+).
Optionallut?: { assetId: string; intensity: number }A 3D LUT look on top of the filter (file version 3+). Missing = none.
Optionalmask?: { feather: number; invert?: boolean; shape: string }Shape mask (file version 4+). Missing = the whole picture.
Soft edge, 0 (sharp) … 1 (very soft).
Optionalinvert?: booleanShow the outside of the shape instead.
Shape preset id (SHAPE_PRESETS), e.g. 'circle', 'star-5', 'heart'.
Optionalname?: stringWhere in the source media the item starts.
Playback speed; source span = duration × speed.
Where the item starts on the timeline.
Degrees, clockwise.
1 = fits inside the canvas (contain).
Centre, as a fraction of canvas width (0.5 = centred).
Centre, as a fraction of canvas height.
Main track only: transition from the previous item into this one.
Gain: 1 = original, 0…2.
OptionalaudioFx?: {Sound effects (file version 4+). Missing = none.
Optionalcompress?: numberCompressor ("even out"): 0 = off … 1 = strong; quiet parts come up, loud ones go down.
Optionaldenoise?: numberClean up noise: 0 = off … 1 = strong; steady background noise (hiss, hum, fans) goes down.
Optionaleq?: { high: number; low: number; mid: number }Three-band equaliser, dB each (−12…12): bass (shelf, 120 Hz), middle (1 kHz), treble (shelf, 8 kHz).
OptionalkeepPitch?: booleanKeep the original pitch when the clip is sped up or slowed down (speeds 0.5×…2×).
Optionalpitch?: numberPitch shift in semitones (−12…12), the speed unchanged.
Optionalduck?: numberLower under voice (ducking, file version 3+): while the project's other sound — video clips'
own sound, voiceovers, anything not itself ducked — has a voice in it, this item plays at
1 − duck of its volume (eased in and out). 0…1; missing = off.
How long it lasts on the timeline.
OptionalgroupId?: stringLane items sharing a group id select, move (on the stage and in time) and scale together (file version 3+). Main-track clips are never grouped.
Optionalhidden?: booleanNot drawn in the preview or the export; a video's sound still plays (file version 3+).
Optionallocked?: booleanCan be selected but not moved, trimmed or edited until unlocked (file version 3+).
Optionalname?: stringWhere the item starts on the timeline.
Gain: 1 = original, 0…2.
Media items read a span of their source:
[sourceIn, sourceIn + duration × speed).