delete_device
Destructive
Remove a device and its settings from an Ableton Live track chain. Review the reported track, device name, class, and parameter count with confirm=false, then set confirm=true to complete the deletion.
Instructions
Delete one device from a track chain, its settings with it.
Requires confirm=True. With confirm=False it reports the name of the track, and
the device's name, class and parameter count, and changes nothing.
Returns:
Dictionary reporting deletion status or pending loss report.
Note:
The track is named in the report because a device name does not identify
one. A device class like Utility or EQ Eight sits on several tracks in a
normal set, so a loss report naming only the device reads the same whether
the index points at the intended chain or at a neighbour's. Check the track
name against the one you meant before confirming.
Deleting shifts every later device in the chain down one index, so a second
delete aimed at an index read before the first one lands on a different
device. Read the chain again with get_devices between deletes.
Two neighbouring intentions are not this tool. To reorder a chain nothing
needs deleting: call ``song.move_device`` through lom_call. To swap the
instrument on a track, load the replacement with load_device, which replaces
the instrument already there in one step (measured). Deleting first only
loses the settings earlier.
``kind`` reaches the return and main chains, which are addressed the same way
get_devices addresses them. A return track carries its own index and the main
track has none, so ``track`` is not read at all when kind is master.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Which collection the track index counts in: 'track' for song.tracks, 'return' for song.return_tracks, 'master' for the master track, where the track index is ignored. | track |
| track | Yes | Track index in song.tracks, counted from 0. | |
| device | Yes | Device index in that track chain, counted from 0 left to right as Live draws it. get_devices lists the chain with its indices. | |
| confirm | No | True carries the removal out. False changes nothing and returns a report of what the call would remove, which is how to look before committing to it. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||