load_device
Search Ableton Live's browser for devices and load a selected device onto the currently selected track. Returns search candidates first, then confirms the load with a chosen URI or path.
Instructions
Search Live's browser and load a device onto the currently selected track.
Two-step process: with confirm=False, searches browser and returns candidate items
along with currently selected track info. With confirm=True and a chosen uri or item_path,
loads the item.
Args:
query: Search string for browser items.
root: Optional browser root category to search within.
uri: Browser item URI returned from search step.
item_path: Direct filesystem or library item path.
limit: Maximum number of search candidates to return (defaults to 12).
confirm: Confirmation flag required to execute loading.
Returns:
Dictionary containing search candidates or device load verification details.
Note:
Browser.load_item targets the current selection rather than an explicit track argument.
Target track is determined by song.view.selected_track.
Inside racks or drum racks, target destination is determined by rack.view.selected_chain
or rack.view.selected_drum_pad.
Instruments replace the track instrument, whereas audio/MIDI effects are appended.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uri | No | ||
| root | No | ||
| limit | No | ||
| query | No | ||
| confirm | No | ||
| item_path | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||