update_clip
Modify Session or timeline audio/MIDI clip settings and optionally run an action; omitted fields stay unchanged.
Instructions
Change a clip's settings and optionally run an action; every field you leave empty stays as it is. Works on Session and timeline clips, MIDI and audio.
Settings: name, color, mute, loop and marker positions, time signature, launch mode and quantization, legato, clip scale, groove; for audio also warping, warp mode, gain, pitch and RAM mode. Actions: fire, stop, crop to the loop, duplicate_loop, quantize (grid, amount), clear_envelopes, move_playing_position, and warp markers (add, move, remove). Each field gets a result line with what Live holds afterwards; Live keeps the old value for something it refuses and the line says so. Loop markers that Live refuses in one order are tried again after the others. One undo step.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip | No | The clip: t0/s2 (Session slot 2 of t0) or t0/a1 (the second timeline clip of t0, see arrangement list). Or give track and slot instead. | |
| gain | No | Audio: gain 0-1 (Live's raw scale; the answer shows dB). | |
| grid | No | For quantize: None, 1/4, 1/8, 1/8T, 1/8 + 1/8T, 1/16, 1/16T, 1/16 + 1/16T or 1/32. | |
| name | No | New clip name. | |
| slot | No | Session slot (scene row) from 0, with track. | |
| muted | No | Clip deactivated: true / false. | |
| track | No | Track of a Session clip, e.g. t0 (with slot). | |
| action | No | Optional action to run after the settings. | |
| amount | No | For quantize: strength 0-1 (default 1). | |
| groove | No | A groove from the pool by number or exact name (see groove). | |
| legato | No | Legato launch: true / false. | |
| looping | No | Loop on or off: true / false. | |
| warping | No | Audio: warp on or off: true / false. | |
| loop_end | No | Loop end in beats. | |
| ram_mode | No | Audio: load the sample into RAM: true / false. | |
| root_note | No | Clip scale root as a number 0 (C) to 11 (B). | |
| warp_mode | No | Audio: Beats, Tones, Texture, Re-Pitch, Complex or Complex Pro. | |
| end_marker | No | End marker in beats. | |
| loop_start | No | Loop start in beats. | |
| pitch_fine | No | Audio: detune in cents, -50 to 50. | |
| scale_mode | No | Clip scale highlighting on or off: true / false. | |
| scale_name | No | Clip scale name as Live shows it: Major, Minor... | |
| time_beats | No | For move_playing_position and the warp marker actions: a position in beats. | |
| color_index | No | Live's color number, 0-69. | |
| launch_mode | No | Trigger, Gate, Toggle or Repeat. | |
| sample_time | No | For add_warp_marker: the sample position in seconds. | |
| stop_button | No | Session slot: show or hide its stop button (works on an empty slot). | |
| pitch_coarse | No | Audio: transpose in semitones, -48 to 48. | |
| start_marker | No | Start marker in beats. | |
| distance_beats | No | For move_warp_marker: how far to move it, in beats. | |
| time_signature | No | Clip time signature such as 3/4. | |
| velocity_amount | No | How much launch velocity scales the clip, -1 to 1. | |
| launch_quantization | No | Global, None, 8 Bars, 4 Bars, 2 Bars, 1 Bar, 1/2, 1/2T, 1/4, 1/4T, 1/8, 1/8T, 1/16, 1/16T or 1/32. |