groove
List the groove pool and update a groove's grid, timing, quantize, random and velocity amounts, plus the Set's global Groove Amount, when Live's API can't create or clear grooves.
Instructions
Read the groove pool and tune its grooves: grid, timing, quantize, random and velocity amounts, and the Set's global groove amount.
Live's API cannot create or remove grooves, and cannot clear a clip's groove; it can only change the grooves already in the pool. Assign a groove to a clip with update_clip. Each field gets its own result line with what Live holds afterwards (Live ignores some invalid writes, so check "now"). One undo step.
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": {
"action": "<action>"
},
"name": "groove"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base | No | For update: grid of the groove: 1/4, 1/8, 1/8T, 1/16, 1/16T, 1/32. | |
| name | No | For update: a new name for the groove. | |
| action | Yes | list the pool, or update a groove or the Set's amount. | |
| groove | No | For update: the groove's number from 0 (see list) or exact name. | |
| groove_amount | No | For update: the Set's global Groove Amount; the answer shows what Live holds. | |
| random_amount | No | For update: Random, 0-100. | |
| timing_amount | No | For update: Timing, 0-100. | |
| velocity_amount | No | For update: Velocity, 0-100. | |
| quantization_amount | No | For update: Quantize, 0-100. |