Skip to main content
Glama

Edit Editor Timeline

edit_editor_timeline
Destructive

Edit the timeline of your Editor project (or one shared with you) the way a person does with the mouse, in one call: place a clip at a time on a track, trim either edge, split, move, delete, ripple delete, duplicate, link or unlink picture and sound, set speed, volume and fades, add or reorder tracks, put words on the picture (text layers), captions on the spoken words, a logo or picture over the frame, a motion block, transitions, keyframes, a clip's scale, position, rotation, opacity, fit, label and enable, and the colour look from the Design pane with its curves, wheels, film stock and mask. Pass operations in order; they run one after another with the Editor's own rules (picture clips never overlap on a track, every video clip keeps a linked sound clip under it, a trim never reaches past the file). The change is saved on the project, lands in its History, shows in the open Editor within seconds and can be undone there. Answers with only the tracks the call changed (readback full for everything, summary for track lengths). Stops at the first operation that cannot be done and saves nothing from that call. Spends no tokens.

Input Schema

NameRequiredDescriptionDefault
labelNoA short name for this change as it will read in the project's History (for example "Place the 25 stops").
readbackNoHow much timeline comes back. full: every track and clip. changes: only the tracks this call changed. summary: each track's clip count and end. Fields left out are empty or at their default (speed 1, volume 0 dB, no fades, enabled). Default changes.
timelineNoWhich timeline tab the steps work on, by name or id (a step's own timeline wins). Default: the open tab, as before.
operationsYesThe edits, in order. Each one is an object with op and the fields that op needs.
project_idYesThe Editor project id (list_editor_projects).
include_mediaNoAlso list the project media (ids and names to place). Default false.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / operations / items / properties / choice
      Added value: +{
      +  "description": "clip_sound: keep, mute, replace or mix (see op).",
      +  "enum": [
      +    "keep",
      +    "mute",
      +    "replace",
      +    "mix"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / db / description
      Previous value: -"volume: -60 to +24 dB, 0 is as recorded."New value: +"volume: -60 to +24 dB, 0 is as recorded. clip_sound mix or replace: the level of the laid sound."
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). ripple_trim: a trim whose change in length moves every later clip on the track (no gap). roll: move the cut between a clip and the clip touching it to to_sec (edge end or start). slip: keep the clip in place and change which part of its file plays (by_sec). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip. sound_role: a sound clip's role (role: voice, music or effect; read_editor_timeline shows each sound clip's role). sound_mix: the project's sound (effects_on, duck_music, dip_db, attack_sec, release_sec). The timeline tabs above the timeline (\"Timeline 01\", \"+\"): timeline_add (name, copy_from: another tab to start as a copy of), timeline_rename (timeline, name), timeline_delete (timeline; never the last one), timeline_select (timeline: the tab the open Editor shows). project_settings: the project's shape (width, height, fps, or ratio; 9:16 vertical = width 1080, height 1920)."New value: +"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). ripple_trim: a trim whose change in length moves every later clip on the track (no gap). roll: move the cut between a clip and the clip touching it to to_sec (edge end or start). slip: keep the clip in place and change which part of its file plays (by_sec). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip. sound_role: a sound clip's role (role: voice, music or effect; read_editor_timeline shows each sound clip's role). sound_mix: the project's sound (effects_on, duck_music, dip_db, attack_sec, release_sec). clip_sound: what a video clip's own sound does (lane, index, choice): keep (its own sound, the default), mute (off but kept on the timeline), replace (off, with a sound from the project laid from the clip's start for as long as both run: media_id or media_name), mix (on, with that sound over the clip at db); the laid sound follows the clip through a move, trim, split, copy or delete, every choice takes the last one back (keep undoes replace), and read_editor_timeline shows each clip's soundChoice, a muted sound as muted and a laid sound as choiceFor. The timeline tabs above the timeline (\"Timeline 01\", \"+\"): timeline_add (name, copy_from: another tab to start as a copy of), timeline_rename (timeline, name), timeline_delete (timeline; never the last one), timeline_select (timeline: the tab the open Editor shows). project_settings: the project's shape (width, height, fps, or ratio; 9:16 vertical = width 1080, height 1920)."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "ripple_trim",
      -  "roll",
      -  "slip",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_delete",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings",
      -  "snapshot",
      -  "snapshot_restore",
      -  "revision_restore",
      -  "comment",
      -  "comment_resolve",
      -  "marker_add",
      -  "marker_edit",
      -  "marker_delete",
      -  "freeze",
      -  "reverse",
      -  "clip_look",
      -  "split_scenes",
      -  "auto_clip",
      -  "sound_role",
      -  "sound_mix",
      -  "timeline_add",
      -  "timeline_rename",
      -  "timeline_delete",
      -  "timeline_select",
      -  "project_settings"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "ripple_trim",
      +  "roll",
      +  "slip",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings",
      +  "snapshot",
      +  "snapshot_restore",
      +  "revision_restore",
      +  "comment",
      +  "comment_resolve",
      +  "marker_add",
      +  "marker_edit",
      +  "marker_delete",
      +  "freeze",
      +  "reverse",
      +  "clip_look",
      +  "split_scenes",
      +  "auto_clip",
      +  "sound_role",
      +  "sound_mix",
      +  "clip_sound",
      +  "timeline_add",
      +  "timeline_rename",
      +  "timeline_delete",
      +  "timeline_select",
      +  "project_settings"
      +]
  2. Changed3 schema fields changed
    • changedInput schema / properties / operations / items / properties / duck_music / description
      Previous value: -"sound_mix: true (the default) dips Music while any Voice plays; effects never dip."New value: +"sound_mix: true (the default) dips Music (by dip_db) and Effects (by effects_dip_db) while any Voice plays."
    • addedInput schema / properties / operations / items / properties / effects_dip_db
      Added value: +{
      +  "description": "sound_mix: how far Effects dip under a voice, -60 to 0 dB (default -6; 0 = effects do not dip).",
      +  "type": "number"
      +}
    • changedInput schema / properties / operations / items / properties / role / description
      Previous value: -"sound_role: Voice (narration, dialogue), Music (beds, songs) or Effect (whooshes, hits, dings). Music dips under voices when the project ducks; effects never dip and go silent when sound effects are off."New value: +"sound_role: Voice (narration, dialogue), Music (beds, songs) or Effect (whooshes, hits, dings). Music and effects dip under voices when the project ducks (each by its own dip); effects go silent when sound effects are off."
  3. Changed15 schema fields changed
    • addedInput schema / properties / include_media
      Added value: +{
      +  "description": "Also list the project media (ids and names to place). Default false.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / operations / items / properties / by_sec
      Added value: +{
      +  "description": "slip: how far the part of its file the clip plays moves (positive = later in the file); its place and length on the timeline stay.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / copy_from
      Added value: +{
      +  "description": "timeline_add: the name or id of a tab whose clips the new tab starts with (default: an empty timeline).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / edge
      Added value: +{
      +  "description": "roll: which cut of the clip moves, the one at its end (default) or its start.",
      +  "enum": [
      +    "start",
      +    "end"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / fps
      Added value: +{
      +  "description": "project_settings: frames per second (default 30).",
      +  "enum": [
      +    24,
      +    25,
      +    30,
      +    50,
      +    60
      +  ],
      +  "type": "integer"
      +}
    • addedInput schema / properties / operations / items / properties / height
      Added value: +{
      +  "description": "project_settings: frame height in pixels (9:16 vertical: 1920).",
      +  "type": "integer"
      +}
    • changedInput schema / properties / operations / items / properties / name / description
      Previous value: -"lane_add / lane_settings: the track's name as it reads on screen."New value: +"lane_add / lane_settings: the track's name as it reads on screen. timeline_add / timeline_rename: the tab's name (\"Best picks\", \"30 s\")."
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip. sound_role: a sound clip's role (role: voice, music or effect; read_editor_timeline shows each sound clip's role). sound_mix: the project's sound (effects_on, duck_music, dip_db, attack_sec, release_sec)."New value: +"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). ripple_trim: a trim whose change in length moves every later clip on the track (no gap). roll: move the cut between a clip and the clip touching it to to_sec (edge end or start). slip: keep the clip in place and change which part of its file plays (by_sec). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip. sound_role: a sound clip's role (role: voice, music or effect; read_editor_timeline shows each sound clip's role). sound_mix: the project's sound (effects_on, duck_music, dip_db, attack_sec, release_sec). The timeline tabs above the timeline (\"Timeline 01\", \"+\"): timeline_add (name, copy_from: another tab to start as a copy of), timeline_rename (timeline, name), timeline_delete (timeline; never the last one), timeline_select (timeline: the tab the open Editor shows). project_settings: the project's shape (width, height, fps, or ratio; 9:16 vertical = width 1080, height 1920)."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_delete",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings",
      -  "snapshot",
      -  "snapshot_restore",
      -  "revision_restore",
      -  "comment",
      -  "comment_resolve",
      -  "marker_add",
      -  "marker_edit",
      -  "marker_delete",
      -  "freeze",
      -  "reverse",
      -  "clip_look",
      -  "split_scenes",
      -  "auto_clip",
      -  "sound_role",
      -  "sound_mix"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "ripple_trim",
      +  "roll",
      +  "slip",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings",
      +  "snapshot",
      +  "snapshot_restore",
      +  "revision_restore",
      +  "comment",
      +  "comment_resolve",
      +  "marker_add",
      +  "marker_edit",
      +  "marker_delete",
      +  "freeze",
      +  "reverse",
      +  "clip_look",
      +  "split_scenes",
      +  "auto_clip",
      +  "sound_role",
      +  "sound_mix",
      +  "timeline_add",
      +  "timeline_rename",
      +  "timeline_delete",
      +  "timeline_select",
      +  "project_settings"
      +]
    • addedInput schema / properties / operations / items / properties / ratio
      Added value: +{
      +  "description": "project_settings: the frame by its shape instead of width and height (9:16 = 1080x1920).",
      +  "enum": [
      +    "16:9",
      +    "9:16",
      +    "1:1",
      +    "4:5",
      +    "4:3",
      +    "3:4",
      +    "21:9",
      +    "2.35:1",
      +    "2:1",
      +    "1.85:1"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / timeline
      Added value: +{
      +  "description": "Which timeline tab this step works on, by name (\"30 s\") or id (read_editor_timeline lists them). Default: the call's timeline, else the open tab.",
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / to_sec / description
      Previous value: -"move: the new start on the timeline."New value: +"move: the new start on the timeline. roll: where the cut between the clip and the one touching it goes."
    • addedInput schema / properties / operations / items / properties / width
      Added value: +{
      +  "description": "project_settings: frame width in pixels (9:16 vertical: 1080).",
      +  "type": "integer"
      +}
    • addedInput schema / properties / readback
      Added value: +{
      +  "description": "How much timeline comes back. full: every track and clip. changes: only the tracks this call changed. summary: each track's clip count and end. Fields left out are empty or at their default (speed 1, volume 0 dB, no fades, enabled). Default changes.",
      +  "enum": [
      +    "full",
      +    "changes",
      +    "summary"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / timeline
      Added value: +{
      +  "description": "Which timeline tab the steps work on, by name or id (a step's own timeline wins). Default: the open tab, as before.",
      +  "type": "string"
      +}
  4. Changed5 schema fields changed
    • addedInput schema / properties / operations / items / properties / fade_in_curve
      Added value: +{
      +  "description": "fades: the fade in's curve; smooth (an S curve, the default) never sounds like a sudden cut.",
      +  "enum": [
      +    "linear",
      +    "smooth",
      +    "exp"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / fade_in_sec / description
      Previous value: -"fades: seconds of fade at the start."New value: +"fades: seconds of fade at the start (a sound clip's fade is at least 0.6 s, or half a shorter clip)."
    • addedInput schema / properties / operations / items / properties / fade_out_curve
      Added value: +{
      +  "description": "fades: the fade out's curve; smooth (an S curve, the default) never sounds like a sudden cut.",
      +  "enum": [
      +    "linear",
      +    "smooth",
      +    "exp"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / fade_out_sec / description
      Previous value: -"fades: seconds of fade at the end."New value: +"fades: seconds of fade at the end (a sound clip's fade is at least 0.6 s, or half a shorter clip)."
    • addedInput schema / properties / operations / items / properties / volume_points
      Added value: +{
      +  "description": "volume: points on the clip's volume line, t = seconds from the clip's start, db = dB above (+) or below (-) the clip's volume; straight lines between points; [] clears them.",
      +  "items": {
      +    "properties": {
      +      "db": {
      +        "type": "number"
      +      },
      +      "t": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "t",
      +      "db"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  5. Changed8 schema fields changed
    • addedInput schema / properties / operations / items / properties / attack_sec
      Added value: +{
      +  "description": "sound_mix: seconds the music takes to go down before a voice starts (default 0.8).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / dip_db
      Added value: +{
      +  "description": "sound_mix: how far Music dips under a voice, -60 to 0 dB (default -10).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / duck_music
      Added value: +{
      +  "description": "sound_mix: true (the default) dips Music while any Voice plays; effects never dip.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / operations / items / properties / effects_on
      Added value: +{
      +  "description": "sound_mix: false silences every Effect clip in the player and the export; true brings them back.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."New value: +"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip. sound_role: a sound clip's role (role: voice, music or effect; read_editor_timeline shows each sound clip's role). sound_mix: the project's sound (effects_on, duck_music, dip_db, attack_sec, release_sec)."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_delete",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings",
      -  "snapshot",
      -  "snapshot_restore",
      -  "revision_restore",
      -  "comment",
      -  "comment_resolve",
      -  "marker_add",
      -  "marker_edit",
      -  "marker_delete",
      -  "freeze",
      -  "reverse",
      -  "clip_look",
      -  "split_scenes",
      -  "auto_clip"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings",
      +  "snapshot",
      +  "snapshot_restore",
      +  "revision_restore",
      +  "comment",
      +  "comment_resolve",
      +  "marker_add",
      +  "marker_edit",
      +  "marker_delete",
      +  "freeze",
      +  "reverse",
      +  "clip_look",
      +  "split_scenes",
      +  "auto_clip",
      +  "sound_role",
      +  "sound_mix"
      +]
    • addedInput schema / properties / operations / items / properties / release_sec
      Added value: +{
      +  "description": "sound_mix: seconds the music takes to come back after a voice ends (default 1.6).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / role
      Added value: +{
      +  "description": "sound_role: Voice (narration, dialogue), Music (beds, songs) or Effect (whooshes, hits, dings). Music dips under voices when the project ducks; effects never dip and go silent when sound effects are off.",
      +  "enum": [
      +    "voice",
      +    "music",
      +    "effect"
      +  ],
      +  "type": "string"
      +}
  6. Changed1 schema field changed
    • removedInput schema / properties / operations / maxItems
      Removed value: -60
  7. Changed1 schema field changed
    • addedInput schema / properties / operations / items / properties / muted
      Added value: +{
      +  "description": "lane_settings on an audio track: true = the track is silent in the player and the export (its M button); false turns it back on.",
      +  "type": "boolean"
      +}
  8. Changed13 schema fields changed
    • changedInput schema / properties / operations / items / properties / enabled / description
      Previous value: -"clip_settings: false disables the clip (it stays on the lane, skipped in play and export)."New value: +"clip_settings: false disables the clip (it stays on the track, skipped in play and export)."
    • changedInput schema / properties / operations / items / properties / hidden / description
      Previous value: -"lane_settings: hide the lane (on an audio lane this mutes it)."New value: +"lane_settings: hide the track (on an audio track this mutes it)."
    • changedInput schema / properties / operations / items / properties / index / description
      Previous value: -"Which clip on that lane, counting from 0 in play order (read_editor_timeline shows the index of every clip)."New value: +"Which clip on that track, counting from 0 in play order (read_editor_timeline shows the index of every clip)."
    • changedInput schema / properties / operations / items / properties / kind / description
      Previous value: -"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane). snapshot: save a restorable snapshot of the whole project (name). snapshot_restore / revision_restore: put the project back as a snapshot or a History revision had it. comment: a note in the Comments pane (text, optionally lane + index or at_sec). comment_resolve: mark it resolved. marker_add: a marker on the ruler (at_sec, text, color teal / purple / rose / peach / orange / white). marker_edit / marker_delete: move, relabel or remove one (marker_id). freeze: hold the clip's first frame for its whole length. reverse: play the clip backwards, picture and sound. fades on a video clip: the picture fades in and out (its sound follows through its linked sound clip). clip_look: colour on ONE clip (lane, index, filters as in look, or reset). lane_settings solo on an audio lane: only solo lanes play and export. split_scenes: cut one clip at many seconds at once (lane, index, at_secs). auto_clip: the AI clipper's step, pieces of a media item (segments) laid in a row on V1 from at_sec or the end."New value: +"lane_add: which kind of track. lane_delete: remove a track and its clips (not V1, not the text track). snapshot: save a restorable snapshot of the whole project (name). snapshot_restore / revision_restore: put the project back as a snapshot or a History revision had it. comment: a note in the Comments pane (text, optionally lane + index or at_sec). comment_resolve: mark it resolved. marker_add: a marker on the ruler (at_sec, text, color teal / purple / rose / peach / orange / white). marker_edit / marker_delete: move, relabel or remove one (marker_id). freeze: hold the clip's first frame for its whole length. reverse: play the clip backwards, picture and sound. fades on a video clip: the picture fades in and out (its sound follows through its linked sound clip). clip_look: colour on ONE clip (lane, index, filters as in look, or reset). lane_settings solo on an audio track: only solo tracks play and export. split_scenes: cut one clip at many seconds at once (lane, index, at_secs). auto_clip: the AI clipper's step, pieces of a media item (segments) laid in a row on V1 from at_sec or the end."
    • changedInput schema / properties / operations / items / properties / lane / description
      Previous value: -"The lane the clip is on, as the Editor names it: V1, X2 (a video lane above V1), A1, A2, T1, M1, G1."New value: +"The track the clip is on, as the Editor names it: V1, X2 (a video track above V1), A1, A2, T1, M1, G1."
    • changedInput schema / properties / operations / items / properties / locked / description
      Previous value: -"lane_settings: lock the lane against edits."New value: +"lane_settings: lock the track against edits."
    • changedInput schema / properties / operations / items / properties / name / description
      Previous value: -"lane_add / lane_settings: the lane's name as it reads on screen."New value: +"lane_add / lane_settings: the track's name as it reads on screen."
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."New value: +"What to do. place: a media item of the project onto a track at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."
    • changedInput schema / properties / operations / items / properties / partner_lane / description
      Previous value: -"link: the other clip's lane."New value: +"link: the other clip's track."
    • changedInput schema / properties / operations / items / properties / scale / description
      Previous value: -"logo: size, 1 to 200 (default 74). clip_settings: 0 to 300 (on a second-lane video, 100 = a third of the frame wide)."New value: +"logo: size, 1 to 200 (default 74). clip_settings: 0 to 300 (on a second-track video, 100 = a third of the frame wide)."
    • changedInput schema / properties / operations / items / properties / solo / description
      Previous value: -"lane_settings on an audio lane: true = only solo lanes play and export; false takes it off."New value: +"lane_settings on an audio track: true = only solo tracks play and export; false takes it off."
    • changedInput schema / properties / operations / items / properties / to_lane / description
      Previous value: -"move: another lane of the same kind."New value: +"move: another track of the same kind."
    • changedInput schema / properties / operations / items / properties / x / description
      Previous value: -"text: centre across the frame, 0 (left) to 100 (right), default 50. logo: offset, default 0. clip_settings on a second-lane video: the player puts its centre at 72 + x/10 percent (x -220, y 220, scale 294 = full frame)."New value: +"text: centre across the frame, 0 (left) to 100 (right), default 50. logo: offset, default 0. clip_settings on a second-track video: the player puts its centre at 72 + x/10 percent (x -220, y 220, scale 294 = full frame)."
  9. Changed2 schema fields changed
    • changedInput schema / properties / operations / items / properties / image_url / description
      Previous value: -"logo: an https link to the picture (or pass media_name of a picture in the project)."New value: +"logo: an https link to a PNG, JPEG, WebP or GIF; Switch keeps its own copy in the project (or pass media_name of a picture in the project)."
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url or media_name, at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."New value: +"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url, an https PNG, JPEG, WebP or GIF that Switch copies into the project, or media_name; at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."
  10. Changed2 schema fields changed
    • changedInput schema / properties / operations / items / properties / scale / description
      Previous value: -"logo: size, 1 to 200 (default 74)."New value: +"logo: size, 1 to 200 (default 74). clip_settings: 0 to 300 (on a second-lane video, 100 = a third of the frame wide)."
    • changedInput schema / properties / operations / items / properties / x / description
      Previous value: -"text: centre across the frame, 0 (left) to 100 (right), default 50. logo: offset, default 0."New value: +"text: centre across the frame, 0 (left) to 100 (right), default 50. logo: offset, default 0. clip_settings on a second-lane video: the player puts its centre at 72 + x/10 percent (x -220, y 220, scale 294 = full frame)."
  11. Changed8 schema fields changed
    • addedInput schema / properties / operations / items / properties / at_secs
      Added value: +{
      +  "description": "split_scenes: timeline seconds to cut the clip at (find_editor_scenes gives seconds in the file; add the clip's start).",
      +  "items": {
      +    "type": "number"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / operations / items / properties / filters / description
      Previous value: -"look: colour controls to set, e.g. { exposure: 10, contrast: 8, temp: -5 }; null resets one. Controls: exposure, contrast, highlight, shadow, whites, blacks, temp, tint, saturate, vibrance, brilliance, sharpen, clarity, blur, fade, vignette, grain, halation."New value: +"look / clip_look: colour controls to set, e.g. { exposure: 10, contrast: 8, temp: -5 }; null resets one. Controls: exposure, contrast, highlight, shadow, whites, blacks, temp, tint, saturate, vibrance, brilliance, sharpen, clarity, blur, fade, vignette, grain, halation."
    • changedInput schema / properties / operations / items / properties / kind / description
      Previous value: -"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane). snapshot: save a restorable snapshot of the whole project (name). snapshot_restore / revision_restore: put the project back as a snapshot or a History revision had it. comment: a note in the Comments pane (text, optionally lane + index or at_sec). comment_resolve: mark it resolved. marker_add: a marker on the ruler (at_sec, text, color teal / purple / rose / peach / orange / white). marker_edit / marker_delete: move, relabel or remove one (marker_id)."New value: +"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane). snapshot: save a restorable snapshot of the whole project (name). snapshot_restore / revision_restore: put the project back as a snapshot or a History revision had it. comment: a note in the Comments pane (text, optionally lane + index or at_sec). comment_resolve: mark it resolved. marker_add: a marker on the ruler (at_sec, text, color teal / purple / rose / peach / orange / white). marker_edit / marker_delete: move, relabel or remove one (marker_id). freeze: hold the clip's first frame for its whole length. reverse: play the clip backwards, picture and sound. fades on a video clip: the picture fades in and out (its sound follows through its linked sound clip). clip_look: colour on ONE clip (lane, index, filters as in look, or reset). lane_settings solo on an audio lane: only solo lanes play and export. split_scenes: cut one clip at many seconds at once (lane, index, at_secs). auto_clip: the AI clipper's step, pieces of a media item (segments) laid in a row on V1 from at_sec or the end."
    • addedInput schema / properties / operations / items / properties / on
      Added value: +{
      +  "description": "freeze / reverse: true (default) turns it on, false turns it off.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_delete",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings",
      -  "snapshot",
      -  "snapshot_restore",
      -  "revision_restore",
      -  "comment",
      -  "comment_resolve",
      -  "marker_add",
      -  "marker_edit",
      -  "marker_delete"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings",
      +  "snapshot",
      +  "snapshot_restore",
      +  "revision_restore",
      +  "comment",
      +  "comment_resolve",
      +  "marker_add",
      +  "marker_edit",
      +  "marker_delete",
      +  "freeze",
      +  "reverse",
      +  "clip_look",
      +  "split_scenes",
      +  "auto_clip"
      +]
    • changedInput schema / properties / operations / items / properties / reset / description
      Previous value: -"look: true clears every colour value and the film stock."New value: +"look: true clears every colour value and the film stock. clip_look: true clears the clip's own colour."
    • addedInput schema / properties / operations / items / properties / segments
      Added value: +{
      +  "description": "auto_clip: pieces of the file (seconds in the file) to lay in a row on V1.",
      +  "items": {
      +    "properties": {
      +      "from_sec": {
      +        "type": "number"
      +      },
      +      "to_sec": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "from_sec",
      +      "to_sec"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / operations / items / properties / solo
      Added value: +{
      +  "description": "lane_settings on an audio lane: true = only solo lanes play and export; false takes it off.",
      +  "type": "boolean"
      +}
  12. Changed9 schema fields changed
    • changedInput schema / properties / operations / items / properties / color / description
      Previous value: -"text: the colour as #rrggbb."New value: +"text: the colour as #rrggbb. marker_add / marker_edit: teal, purple, rose, peach, orange or white."
    • addedInput schema / properties / operations / items / properties / comment_id
      Added value: +{
      +  "description": "comment_resolve: the comment id (history.comments).",
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / kind / description
      Previous value: -"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane)."New value: +"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane). snapshot: save a restorable snapshot of the whole project (name). snapshot_restore / revision_restore: put the project back as a snapshot or a History revision had it. comment: a note in the Comments pane (text, optionally lane + index or at_sec). comment_resolve: mark it resolved. marker_add: a marker on the ruler (at_sec, text, color teal / purple / rose / peach / orange / white). marker_edit / marker_delete: move, relabel or remove one (marker_id)."
    • addedInput schema / properties / operations / items / properties / marker_id
      Added value: +{
      +  "description": "marker_edit / marker_delete: the marker id (read_editor_timeline lists markers).",
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_delete",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings",
      +  "snapshot",
      +  "snapshot_restore",
      +  "revision_restore",
      +  "comment",
      +  "comment_resolve",
      +  "marker_add",
      +  "marker_edit",
      +  "marker_delete"
      +]
    • addedInput schema / properties / operations / items / properties / resolved
      Added value: +{
      +  "description": "comment_resolve: false reopens the comment (default true).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / operations / items / properties / revision_id
      Added value: +{
      +  "description": "revision_restore: the revision id (history.revisions).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / side
      Added value: +{
      +  "description": "revision_restore: restore the project as it was before the revision (default) or after it.",
      +  "enum": [
      +    "before",
      +    "after"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / snapshot_id
      Added value: +{
      +  "description": "snapshot_restore: the snapshot id (read_editor_timeline lists history.snapshots).",
      +  "type": "string"
      +}
  13. Changed2 schema fields changed
    • changedInput schema / properties / operations / items / properties / kind / description
      Previous value: -"lane_add: which kind of lane."New value: +"lane_add: which kind of lane. lane_delete: remove a lane and its clips (not V1, not the text lane)."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look",
      -  "transition",
      -  "keyframe",
      -  "keyframes_clear",
      -  "clip_settings"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_delete",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings"
      +]
  14. Changed9 schema fields changed
    • addedInput schema / properties / operations / items / properties / at_clip_sec
      Added value: +{
      +  "description": "keyframe: the time inside the clip (seconds from its start) to pin scale, x, y, rotation, opacity at.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / enabled
      Added value: +{
      +  "description": "clip_settings: false disables the clip (it stays on the lane, skipped in play and export).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / operations / items / properties / fit
      Added value: +{
      +  "description": "clip_settings: contain = fit to frame, cover = fill frame.",
      +  "enum": [
      +    "contain",
      +    "cover"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / mask
      Added value: +{
      +  "description": "look: the Design pane mask { enabled, shape (split, filmstrip, circle, rectangle), x, y, width, height, rotation, feather }.",
      +  "type": "object"
      +}
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url or media_name, at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters), a film stock (film_stock, intensity) or reset."New value: +"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url or media_name, at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters, including curves curveLuma/curveR/curveG/curveB and the wheels wheelShadHue/Sat, wheelMidHue/Sat, wheelTintHue/Sat, wheelOffHue/Sat, wheelIntensity), a film stock (film_stock, intensity), a mask, or reset. transition: the outgoing transition of a clip (transition, duration_sec). keyframe: pin scale, x, y, rotation, opacity at at_clip_sec; keyframes_clear removes them. clip_settings: scale, x, y, rotation, opacity, fit, enabled, name, tag on a clip."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_reorder",
      -  "lane_settings",
      -  "text",
      -  "text_edit",
      -  "text_delete",
      -  "caption",
      -  "logo",
      -  "motion",
      -  "look"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look",
      +  "transition",
      +  "keyframe",
      +  "keyframes_clear",
      +  "clip_settings"
      +]
    • addedInput schema / properties / operations / items / properties / rotation
      Added value: +{
      +  "description": "keyframe / clip_settings / text: degrees, -180 to 180.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / tag
      Added value: +{
      +  "description": "clip_settings: the label colour from the clip menu: magenta, teal, mustard, blue, orange, violet, green, coral, or none.",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / transition
      Added value: +{
      +  "description": "transition: the outgoing transition as the menu names it: None (hard cut), Cross fade, Dissolve, Wipe left, Wipe right, Wipe up, Wipe down, Slide left, Slide right, Circle open; with duration_sec 0.1 to 2.",
      +  "type": "string"
      +}
  15. Changed27 schema fields changed
    • addedInput schema / properties / operations / items / properties / align
      Added value: +{
      +  "description": "text: alignment.",
      +  "enum": [
      +    "left",
      +    "center",
      +    "right"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / background
      Added value: +{
      +  "description": "text: { on, color, opacity, radius } a box behind the words.",
      +  "type": "object"
      +}
    • addedInput schema / properties / operations / items / properties / block_id
      Added value: +{
      +  "description": "motion: the motion block id (read_editor_timeline lists motionBlocks).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / captions
      Added value: +{
      +  "description": "caption: the spoken words with their times, one entry per caption.",
      +  "items": {
      +    "properties": {
      +      "at_sec": {
      +        "type": "number"
      +      },
      +      "duration_sec": {
      +        "type": "number"
      +      },
      +      "text": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "text",
      +      "at_sec"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / operations / items / properties / color
      Added value: +{
      +  "description": "text: the colour as #rrggbb.",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / film_stock
      Added value: +{
      +  "description": "look: a film stock from the Design pane (K-400, Portra 160, Superia 400, Ektar 100, Cinestill 800T, Tri-X 400, HP5, VHS, Super 8, Polaroid 600, Bleach Bypass, None).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / filters
      Added value: +{
      +  "description": "look: colour controls to set, e.g. { exposure: 10, contrast: 8, temp: -5 }; null resets one. Controls: exposure, contrast, highlight, shadow, whites, blacks, temp, tint, saturate, vibrance, brilliance, sharpen, clarity, blur, fade, vignette, grain, halation.",
      +  "type": "object"
      +}
    • addedInput schema / properties / operations / items / properties / font
      Added value: +{
      +  "description": "text: the font, as the Text pane names it.",
      +  "enum": [
      +    "System",
      +    "Inter",
      +    "Playfair Display",
      +    "JetBrains Mono",
      +    "Bebas Neue"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / image_url
      Added value: +{
      +  "description": "logo: an https link to the picture (or pass media_name of a picture in the project).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / intensity
      Added value: +{
      +  "description": "look: film stock strength 0 to 100 (default 80).",
      +  "type": "number"
      +}
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked)."New value: +"What to do. place: a media item of the project onto a lane at a time. trim: new start_sec and/or end_sec for a clip (the cut moves in the file; it cannot reach past the file). split: cut a clip at at_sec (its sound clip splits too). move: a clip to to_sec (and to_lane of the same kind). delete / ripple_delete: remove a clip (ripple closes the gap). duplicate: a copy right after the clip. link / unlink: a picture clip and a sound clip that move together. speed (rate), volume (db), fades (fade_in_sec, fade_out_sec). lane_add (kind), lane_reorder (lane, to_index), lane_settings (lane, name, hidden, locked). text: words on the picture from at_sec for duration_sec, with font, size, color, x, y, align, preset, background, stroke, shadow (a pink chip on T1). text_edit / text_delete by text_id. caption: captions on the spoken words (captions list, template, position). logo: a picture over the frame on G1 (image_url or media_name, at_sec, duration_sec, x, y, scale, opacity). motion: a motion block on M1 (block_id, at_sec, duration_sec). look: the Design pane colour controls (filters), a film stock (film_stock, intensity) or reset."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "place",
      -  "trim",
      -  "split",
      -  "move",
      -  "delete",
      -  "ripple_delete",
      -  "duplicate",
      -  "link",
      -  "unlink",
      -  "speed",
      -  "volume",
      -  "fades",
      -  "lane_add",
      -  "lane_reorder",
      -  "lane_settings"
      -]New value: +[
      +  "place",
      +  "trim",
      +  "split",
      +  "move",
      +  "delete",
      +  "ripple_delete",
      +  "duplicate",
      +  "link",
      +  "unlink",
      +  "speed",
      +  "volume",
      +  "fades",
      +  "lane_add",
      +  "lane_reorder",
      +  "lane_settings",
      +  "text",
      +  "text_edit",
      +  "text_delete",
      +  "caption",
      +  "logo",
      +  "motion",
      +  "look"
      +]
    • addedInput schema / properties / operations / items / properties / opacity
      Added value: +{
      +  "description": "logo / text: 0 to 100.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / position
      Added value: +{
      +  "description": "caption: where the captions sit.",
      +  "enum": [
      +    "top",
      +    "middle",
      +    "bottom"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / preset
      Added value: +{
      +  "description": "text: a style preset from the Text pane.",
      +  "enum": [
      +    "white",
      +    "outline",
      +    "subtle",
      +    "shadow",
      +    "yellow",
      +    "red"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / reset
      Added value: +{
      +  "description": "look: true clears every colour value and the film stock.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / operations / items / properties / scale
      Added value: +{
      +  "description": "logo: size, 1 to 200 (default 74).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / shadow
      Added value: +{
      +  "description": "text: { on, color } a drop shadow.",
      +  "type": "object"
      +}
    • addedInput schema / properties / operations / items / properties / size
      Added value: +{
      +  "description": "text: font size 12 to 200.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / stroke
      Added value: +{
      +  "description": "text: { on, color, thickness } an outline.",
      +  "type": "object"
      +}
    • addedInput schema / properties / operations / items / properties / template
      Added value: +{
      +  "description": "caption: the caption template as the Captions menu names it.",
      +  "enum": [
      +    "Highlight",
      +    "Pop",
      +    "Bounce",
      +    "Hype",
      +    "Stroke",
      +    "Marker",
      +    "clean"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / text
      Added value: +{
      +  "description": "text / text_edit: the words on screen.",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / text_id
      Added value: +{
      +  "description": "text_edit / text_delete: the text layer id (read_editor_timeline lists textLayers).",
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / weight
      Added value: +{
      +  "description": "text: 100 to 900 (700 bold).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / width_pct
      Added value: +{
      +  "description": "text: the box width as a percent of the frame (default 40).",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / x
      Added value: +{
      +  "description": "text: centre across the frame, 0 (left) to 100 (right), default 50. logo: offset, default 0.",
      +  "type": "number"
      +}
    • addedInput schema / properties / operations / items / properties / y
      Added value: +{
      +  "description": "text: centre down the frame, 0 (top) to 100 (bottom), default 50. logo: offset, default -92 (top).",
      +  "type": "number"
      +}
  16. Added

TDQS

A4.1/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds substantial behavior beyond the annotations: it explains execution order, Editor-enforced constraints, persistence and History behavior, undo support, readback scoping, and atomicity on failure. These details are highly relevant for a destructive, non-idempotent editing tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with purpose and key behavior, but it is an extremely long run-on paragraph. Much of the operation detail duplicates the schema's op enum descriptions, making it dense and harder to scan despite the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex destructive editing tool, the description covers execution rules, failure behavior, output/readback shape, persistence, and undo. With annotations and a fully described schema, an agent has enough context to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already carries the detailed meaning of each parameter and operation field. The description reinforces a few top-level behaviors such as ordered operations and readback output, but does not add much parameter-level meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb and resource: it edits the Editor timeline via ordered operations in one call, and names many supported operation families. It distinguishes the tool enough by emphasizing comprehensive timeline editing, but it does not explicitly contrast with simpler siblings such as place_on_editor_timeline.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The context for use is clear: this is the timeline-editing tool, operations are passed in order, and a failed operation stops the call without saving. There is no explicit when-not-to-use guidance or naming of the read/preview alternatives, so it stops short of the highest bar.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources