Optionalmarkers?: { id: string; label?: string; time: number }[]Markers, in time order (file version 4+).
OptionalexportRange?: { end: number; start: number }The part of the timeline to export (in / out points, flicks; end exclusive). Optional
(file version 3+); missing = the whole video. May lie past the end after edits: exports
clamp it to the video's length.
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.
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).
Optionalblend?: Lanes only: how the picture mixes with what's under it (file version 3+).
Fractions of the source cut from each edge.
Optionalcutout?: { assetId: string }Background removed (file version 4+).
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 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.
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).
Optionalblend?: Lanes only: how the picture mixes with what's under it (file version 3+).
Fractions of the source cut from each edge.
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 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.
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.
Optionalanimation?: {Entrance / exit / loop animations.
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).
Optionalblend?: How the text mixes with what's under it (file version 3+). Missing = normal.
How long it lasts on the timeline.
A colour look, as on pictures (file version 2+).
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+).
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+).
OptionalmaxWidth?: numberWrap width as a fraction of the canvas width at scale 1 (file version 3+): lines break at spaces to fit, balanced so they're about the same length. It grows with the text's scale, so a bigger title keeps its lines; on the caption track it stays this fraction of the canvas. Missing = lines break only where the text does.
Optionalname?: stringWhere the item starts on the timeline.
Font size as a fraction of canvas height.
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.
Optionalunsure?: booleanAuto captions (file version 6+): the speech was hard to hear here, so the words may be wrong — the captions list asks to check it. Cleared when its text is edited or marked right.
Optionalwords?: { end: number; start: number; text: string }[]Captions: each spoken word and its time from the caption's start (file version 3+). Drives word highlighting; captions typed or imported without it share their time evenly.
Optionalanimation?: {Entrance / exit / loop animations.
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).
An image/GIF asset, or an emoji character. Exactly one is set. At transform.scale 1 the sticker contain-fits the canvas (an emoji is a square of side min(width, height)).
Optionalblend?: How the sticker mixes with what's under it (file version 3+). Missing = normal.
Optionalcutout?: { assetId: string }Image stickers: background removed (file version 4+).
How long it lasts on the timeline.
A colour look, as on pictures (file version 2+).
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+).
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+).
Optionalname?: stringWhere 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.
Strength 0…1: how soft the blur is / how big the mosaic's cells are.
How long it lasts on the timeline.
Blur, or a mosaic of big pixels.
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+).
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+).
Optionalname?: stringWhere 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.
Optionalindex: number
Adds a video / photo / freeze item to the main track at
index(default: the end).