lom_get
Read-onlyIdempotent
Read a single property value from an Ableton Live project using a dotted LOM path rooted at song, app, or song.view, returning its value, type, and optional display string.
Instructions
Read one property value by LOM path, with its catalogued meaning.
The single-property read behind every getter here, for the field no getter
exposes. Where the catalog knows the path, the answer carries a ``catalog``
hint, and where it knows that a particular value is a sentinel it carries
``means`` as well: a ``scene.tempo`` of -1.0 reads back as "no tempo set for
this scene" rather than as a tempo below the legal minimum.
Returns:
Dictionary with path, value, type, an optional display string for a device
parameter, and the catalog hint and meaning where those exist.
Note:
A path that is not rooted at song, app or song.view is refused here without
Live being contacted. A path Live rejects comes back as ``ok: false`` with
Live's own ``code``, so a missing property is an error rather than a null.
Reach for a getter first where one exists: get_session for the whole set,
get_track, get_clip and get_devices for one of each, read_clip_notes for
notes, read_automation for envelopes. All of them cost one round trip for
many fields, where this costs one per field. Use lom_batch to read several
paths in a single trip, lom_describe when the property names are not known
yet, and lom_set to write.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Dotted LOM path rooted at song, app or song.view, with integer subscripts for collections: 'song.tempo', 'song.tracks[0].name', 'song.tracks[0].devices[1].parameters[3].value'. Any other root is refused before Live is contacted. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||