add_shaped_automation
Draw repeating waveform automation (sine, triangle, saw, square, random) onto any device parameter in a clip, phase-locked to the loop.
Instructions
Draw a repeating waveform onto any device parameter as clip automation.
This is NOT a free-running LFO. The curve is baked into the clip and repeats every loop, phase-locked to the bar. For a genuinely free-running LFO on an arbitrary parameter you still need a Max for Live LFO, whose Map button the API cannot set (ask the user to click it). Use this when a loop-locked, editable curve is acceptable, and use a long or coprime clip length if you want the repetition to be hard to notice.
Parameters:
track_index, clip_index: the clip to draw the automation into
parameter_name: the parameter to modulate
device_index: which device on the track owns that parameter
shape: sine, triangle, saw, square, or random
cycles: how many full waveform cycles across the clip (can be fractional)
min_value, max_value: the range the parameter sweeps between
points: resolution of the drawn curve (more = smoother)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"track_index": "<track_index>",
"clip_index": "<clip_index>",
"parameter_name": "<parameter_name>",
"device_index": "<device_index>"
},
"name": "add_shaped_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shape | No | sine | |
| cycles | No | ||
| points | No | ||
| max_value | No | ||
| min_value | No | ||
| clip_index | Yes | ||
| track_index | Yes | ||
| device_index | Yes | ||
| parameter_name | Yes |