get_clip
Read a Session clip's properties from a specified track and slot: length, loop, warp, pitch, markers, and flags. Confirms the slot contains a clip before returning data.
Instructions
Read one Session clip's properties: length, loop, warp, pitch, markers, flags.
Checks the slot is filled first, because a clip only exists while its slot
has one and every property read would otherwise fail one by one.
Notes are not properties; use ``read_clip_notes``. Automation is not a property
either; use ``read_automation``.
``warping``, ``warp_mode`` and ``pitch_coarse`` are reachable only through a generic
path, because a per-command bridge has no command for them and a missing command is
easily mistaken for a missing capability (docs/architecture.md, 'the restart tax').
Each was read, written, read back and restored on 2026-08-29 against Live 12.4.5, and
all three rows are ``verified``. ``pitch_fine`` is read-verified only, with no write
attempted on it, and the integer mapping behind ``warp_mode`` is still a hypothesis:
confirm it against ``clip.available_warp_modes``, which is the authoritative per-clip
list.
Writing ``warping`` invalidates every time field this tool just returned. Measured
2026-08-30 against Live 12.4.5 on a 1.14-unit audio clip at 120 BPM: turning warping
on took ``loop_end`` from 0.5704 to 1.1408 and ``end_marker`` from 1.1408 to 2.2816,
both doubled, while ``length`` did not follow. At 60 BPM the same toggle moved
neither. The mechanism is not established and is not claimed; what is established is
that the numbers move and that the factor tracks the tempo. Call this again after any
write to ``warping`` rather than reusing what it said before.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | Yes | ||
| track | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||