get_clip
Read-onlyIdempotent
Read a Session clip's properties—length, loop, warp, pitch, markers, flags—from a track slot. Returns has_clip: false for empty slots instead of failing.
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.
Returns:
Dictionary with ``has_clip``, and where that is true the clip path, whether
it is MIDI, and the property fields. An empty slot answers ``has_clip:
false`` and says so rather than failing.
Note:
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. 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 | Clip slot index in track.clip_slots, counted from 0. A slot index is the scene the clip sits in, so slot 2 is the third scene down. | |
| track | Yes | Track index in song.tracks, counted from 0. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||