Script Operations
Script Operations lets you do a number of operations on tracks, clips,
devices, chains and grooves in your Ableton Live project. You can write
5 individual scripts which you can select using the dropdown menu in the
upper right corner of the device window. It will execute them in the
listed order. You can save your scripts by saving the device in a
project or rack and using the mappable execute button to add hotkeys.
Target and Operation
Both targets and operations are written in a declarative style with =
being the separator. Targets can be filtered down by stacking arguments
separated by more = signs. Sometimes an operation needs a list as its
argument, in which case each item in the list is separated by commas.
Example:
Targets
tracks=!muted=midi;
clips=empty="foo"
Operations
color=random;
name=%r,%r,%r,%r, ,bar
This example collects all the unmuted midi tracks and empty clips with
"foo" in their name, then colors them randomly, then renames them to
four random characters followed by a space and "bar".
Target Types
tracks
Represents all tracks in the project.
Available arguments:
"",
midi,
audio,
instrument,
group,
in_group,
muted,
empty,
soloed,
armed,
monitor_in,
monitor_auto,
monitor_off,
folded and
selected.
Available operations:
print,
set,
count,
select,
delete,
latency,
name,
color,
mute,
solo,
arm,
monitor,
fold,
input,
output,
volume,
pan,
width,
polarity,
default and
most_cpu.
Example:
Targets
tracks=!group=in_group
Operations
color=parent
This example sets all non-group tracks that are in groups color to
whatever color their parent group is.
returns
Represents all return tracks in the project.
Available arguments:
"",
muted,
soloed,
folded and
selected.
Available operations:
print,
set,
count,
select,
latency,
name,
color,
mute,
solo,
fold,
volume
pan,
default, and
output.
chains
Represents all chains in the project.
Available arguments:
"",
midi,
audio,
instrument,
drum,
"note_condition",
group,
in_group,
in_rack,
muted,
soloed,
selected and
1selected.
Available operations:
print,
set,
count,
select,
latency,
name,
color,
mute,
solo,
volume,
pan and
default.
Example:
Targets
chains=soloed
Operations
volume=-0.05;
pan=jitter
This example turns down and slightly randomly pans all the soloed chains
in the project.
clips
Represents all the clips in the project.
Available arguments:
"",
midi,
audio,
instrument,
group,
in_group,
muted,
empty*,
warped**,
arrangement,
session,
selected and
1selected.
*Only available for MIDI clips
**Only available for audio clips
Available operations:
print,
set,
count,
select,
delete,
name,
color,
mute,
pitch_coarse,
pitch_fine*,
volume*,
default*,
warp*,
warp_mode*,
ram_mode*,
crop**,
start_time**,
duration**,
decimate**,
velocity**,
v_deviation**,
probability**,
r_velocity** and
groove.
*Only available for audio clips.
**Only available for MIDI clips.
Example:
Targets
clips
Operations
pitch_coarse=3
This example effectively pitches up the entire project by 3 semitones.
devices
Represents all the devices in the project.
Available arguments:
"",
midi,
audio,
instrument,
drum,
group,
in_group,
muted,
folded,
empty,
in_rack
has_sidechain*,
selected and
1selected.
*Only works on stock Compressor devices
*Only works on stock Compressor devices
**Only works on stock EQ Eight devices
Example:
Targets
devices=selected
Operations
default
This example sets all the parameters on all the devices on the selected
tracks back to their default value.
racks
Represents all the rack devices in the project.
You can put a ! before racks to find on all the devices that aren't
racks.
Available arguments:
"",
midi,
audio,
instrument,
drum,
group,
in_group,
muted,
folded,
empty,
in_rack,
selected and
1selected.
Example:
Targets
!racks=in_rack=selected
Operations
mute
This example mutes all the devices on selected tracks that are in racks
and aren't racks.
grooves
Represents all the grooves in the groove pool.
notes
Represents all the notes in all the MIDI clips in the project.
*Selected refers to the selected tracks, not selected notes themselves.
For operations on notes check out
MZ MIDI Edit
Available operations:
count,
delete,
mute,
pitch_coarse,
velocity,
v_deviation,
duration,
decimate,
start_time,
probability,
r_velocity and
quantize
Example:
Targets
notes
Operations
decimate=0.001
This example removes any notes shorter than 1000th of a beat.
drum_pads
Represents all the drum pads on drum rack devices in the project.
Available operations:
print,
set,
mute and
solo.
parameters
Represents all the device parameters in the project.
Available operations:
print,
set,
count,
select,
default and
reenable.
Example:
Targets
parameters=overridden
Operations
reenable
This example reenables any parameters that have their automation
overridden.
project
Represents the Ableton project. No arguments are available for project.
Available operations:
print,
set,
add_tracks and
loop_between
Example:
Targets
project
Operations
loop_between=start,end
This example sets the project loop points to the locators named start
and end
path
Represents any target corresponding to the
Live Object Model
path
Available operations vary depending on the target type.
Example:
path=live_set tracks 0 devices 0 parameters 0
This example represents the first parameter in the first device on the
first track in the project.
id
Represents any target corresponding to its object ID number.
Available operations vary depending on the target type.
Example:
id=1
This example represents the Song according to the
Live Object Model.
Target Arguments
""
Search any target type by name with anything in between quote marks.
The end quote mark is optional. It will match any part of the text and
is not case sensitive.
You can put a ! before the quote marks to find targets not matching the
given name.
midi
Represents MIDI
tracks,
racks,
clips,
devices and
chains
in MIDI effect racks.
audio
Represents audio
tracks,
racks,
clips,
devices and
chains
in audio effect racks.
instrument
Represents instrument
tracks,
racks,
devices and
chains
in instrument racks.
drum
Represents drum
racks/
devices
and
chains
You can put a ! before drum to find all the devices, racks or chains
that are not drum racks or chains.
group
Represents group
tracks. Also represents
racks,
devices and
chains in audio effect racks on group tracks.
You can put a ! before group to find all the targets that are not on a
group track.
in_group or in_groups
Represents
tracks in groups. Also represents
racks,
devices,
clips and
chains in audio
effect racks within groups.
To only match a given group, put in_group followed by a comma, followed
by the name of the group. Note that targets in groups within groups will
only find the target's local parent group, and will not match the group
of groups.
You can put a ! before in_group to find all the targets that are not in
a group or the given group.
Example:
Targets
tracks=!in_group,mix buss
Operations
color=parent
This example colors every track that isn't in the group named "mix buss"
the same color as their group track.
muted
You can put a ! before muted to find all the targets that are not muted.
soloed
Represents soloed
tracks,
returns and
chains.
You can put a ! before soloed to find all the targets that are not
soloed.
armed
You can put a ! before armed to find all the targets that are not armed.
monitor_in
Represents
tracks with their monitoring state set
to In.
monitor_auto
Represents
tracks with their monitoring state set
to Auto.
monitor_off
Represents
tracks with their monitoring state set
to Off.
folded
Represents folded/collapsed
tracks,
returns,
devices and
racks.
You can put a ! before folded to find all the targets that are not
folded.
has_sidechain
Represents stock Compressor
devices that have
sidechain turned on and aren't set to "No Input".
You can put a ! before has_sidechain to find all the compressors that
have sidechain turned off or have no input.
empty
Represents empty
tracks,
racks and MIDI
clips.
You can put a ! before empty to find all the targets that are not empty.
warped
Represents warped audio
clips.
You can put a ! before warped to find all the targets that are not
warped.
in_rack or in_racks
Represents
devices,
racks and
chains in rack
devices.
You can put a ! before in_rack to find all the targets that are not in
rack devices.
arrangement
Represents arrangement
clips and
notes in arrangement clips.
session
Represents session
clips and
notes in session clips
selected or sel
Represents selected
tracks and
returns. For
chains,
clips,
notes,
racks and
devices it
represents the selected track the target is on, not the selected target
itself. Unfortunately Ableton's API doesn't give access to multiple
selected entries other than tracks and notes. For operations on selected
notes, check out
MZ MIDI Edit.
You can put a ! before selected to find all the targets that are not
selected or not on selected tracks.
1selected or 1sel
Represents the one single selected
clips,
devices,
racks,
chains or
parameters
overridden
Represents overridden
parameters.
"note condition" - <[int or MIDI note] or >[int or MIDI note] or
[int or MIDI note]
Represents
notes,
drum
chains and
drum_pads below, above or matching the given
MIDI note number or name*.
The naming scheme is [note letter][sharp][octave] and goes from C-2 to
G8
Example:
Targets
notes=<c#3=>c0
Is the same as
Targets
notes=<61=>24
This example represents all the notes in the project between C#3 and C0
Operations
print
Prints information about the given targets to the display menu.
Available for all target types except
notes.
Arguments
The arguments for print can be separated with commas. They are:
name - Prints the name of the targets
id - Prints the ID number of the targets
path - Prints the live path of the targets
type - Prints the type of the targets
parent - Prints the name of the canonical parent of the object.
[anything] - Prints whatever the result of "get" is on the given targets
with any given text as the argument. See the
Live Object Model documentation
for available get commands.
Example:
Targets
clips=in_group,Bass
Operations
print=id,loop_start
This example prints the ID and loop start value of all the clips in the
group named Bass to the display menu.
cout
Prints information about the given targets to the system console. Useful
for gathering information on lots of targets. Script Operations messages
in the console are marked with the name MZScript. Available for all
target types except
notes.
Arguments
All the arguments for cout are the same as
print.
set
Sets the given targets to whatever value of whatever value you want.
Available for all target types except
notes.
Arguments
The arguments for set are the parameter to set the value of, and the
value to set it to separated by a comma. See the
Live Object Model
for available set operations according to the target type.
Example:
Targets
devices="simpler"
Operations
set=playback_mode,2
This example sets all the Simpler devices playback mode to Slicing.
count
Counts the given targets and displays it as a message. Available for all
target types. No arguments are needed.
Example:
Targets
tracks;clips;devices;grooves
Operations
count
This example counts all the tracks, clips, devices and grooves in the
project and displays it as a message.
select (or sel)
Selects the next given target and displays its name, id and path.
Note that if you do any other operations on the targets before select,
the targets won't update when selecting unless the text input for
targets changes. This avoids any long waiting for targets to update when
selecting through many targets, but may cause unwanted behavior if
changes are made to the given targets in between selecting the next
target.
Arguments
The argument for select is either 0, representing the first target in
the list, or a + or - integer value corresponding to the direction in
which to iterate through the list and amount of indices to skip.
If no argument is given it will default to 1, meaning it will select the
next target in the list.
Example:
Targets
parameters=overridden
Operations
sel
This example selects the next overridden parameter every time you hit
execute.
delete
Deletes the given targets. No arguments are needed.
Available for
tracks,
clips,
devices and
racks.*
*Note that Ableton may hang or crash when deleting many targets at once,
so use with caution. On Windows machines, the likelihood of a crash when
deleting tracks and/or devices is much higher than on Mac devices.
Please get in touch if you know what's causing this bug!
Example:
Targets
clips=empty;
devices=muted
Operations
delete
This example deletes all the empty clips and disabled devices in the
project.
latency
Reports the total latency cause by the given targets in ms and samples.
No arguments are needed.
name
Renames the given targets.
Available for
tracks,
returns,
chains,
clips, stock Ableton
devices and
grooves.
Arguments
Arguments for renaming targets are given in wildcard format. Variables
start with % and are separated with commas. Anything without % preceding
it represents custom text. The following variables are available:
%index - Represents the given index of the target according to the live
path.
%id - Represents the given id number of the target according to the live
object.
%name - Represents the current full name of the target.
%lname - Represents the name of the target without any numbers.
%parent - Represents the name of the target's parent without any
numbers.
%year, %month, %day, %hour, %minute, %second - Represents the current
date and time as numbers.
%r - Represents a random alphanumerical character. A new random
character is generated for each target.
Example:
Targets
tracks=!group
Operations
name=%name, ,not group
This example adds "not group" to the end of every non group track's
name.
color
Colors the given targets.
Available for
tracks,
returns,
clips and
chains.
Arguments
One of the following arguments are needed:
random - Chooses a random color per target.
jitter - Changes the existing color of the targets by a small random
amount.
parent - Changes the color of the targets to the color of the parent
track or group track.
RGB values - Three integers from 0 to 255 separated by commas
representing red, green and blue.
Example:
Targets
clips="foo";
chains="bar"
Operations
color=0,255,0
This example collects clips with foo in their name and chains with bar
in their name then colors them green.
mute
Sets the mute or disabled state the given targets.
Arguments
The argument for mute is a 0 to 1 integer value which represents the
muted or disabled state of the target. 0 turns on the target while 1
turns it off. Calling arm without an argument will default to 1.
Example:
Targets
tracks=instrument=empty
Operations
mute=1
This example mutes all the empty instrument tracks.
solo
Sets the solo state for the given targets.
Available for
tracks,
returns and
chains.
Arguments
The only available arguments for solo are 0 and 1 which represents the
soloed state of the target. 0 un-solos the target while 1 solos it.
Calling solo without an argument will default to 1.
Example:
Targets
chains=!soloed;
tracks=!soloed
Operations
solo=1
This example changes every un-soloed track and chain to soloed.
arm
Sets the armed state for the given targets.
Arguments
The only available arguments for arm are 0 and 1 which represents the
armed state of the target. 0 un-arms the target while 1 arms it. Calling
arm without an argument will default to 1.
Example:
Targets
tracks=!"Kick"
Operations
arm=1
This example arms all the tracks that don't have Kick in their name.
monitor
Sets the monitoring state for the given targets.
Arguments
The arguments for monitor can be one of the following:
in or 0
auto or 1
off or 2
When no arguments are given the default setting is In
Example:
Targets
tracks=empty=monitor_auto
Operations
monitor
This example sets the monitoring state to In on all the empty tracks
with the monitoring state Auto.
fold
Sets the folded/collapsed state for the given targets.
Available for
tracks,
devices and
racks.
Arguments
The only available arguments for fold are 0 and 1 which represents the
folded state of the target. 0 un-folds the target while 1 folds it.
Calling fold without an argument will default to 1.
Example:
Targets
tracks=group
Operations
fold=1
This example folds all the group tracks in the project.
input
Sets the input type and channel of the given targets.
Available for audio and MIDI
tracks and stock
Compressor
devices.
Arguments
The arguments for input are two integer values corresponding to the
index of the respective type and channel, separated by commas. A value
of -1 represents the last output type or channel.
Example:
Targets
tracks=audio
Operations
input=0,0
This example sets the input routing types and channels of all the audio
tracks in the project to the first elements of the types and channels
lists.
output
Sets the output type and channel of the given targets.
Arguments
The arguments for output are two integer values corresponding to the
index of the respective type and channel, separated by commas. A value
of -1 represents the last output type or channel.
Example:
Targets
tracks=audio
Operations
output=0,0
This example sets the output routing types and channels of all the audio
tracks in the project to the first elements of the types and channels
lists.
volume
Sets the volume or gain of the given targets.
Available for
tracks,
returns,
chains and audio
clips.
Arguments
The argument for volume is a 0 to 1 floating point value representing
the way Ableton stores volume and gain values.
Note that this is not a db value, and isn't scaled linearly.
For instance, with tracks and racks, setting the volume to 0.85
corresponds to setting them to 0db. From around -18db to 0db, setting
tracks - or + 0.025 will correspond to subtracting or adding a db.
With audio clips, 0.4 corresponds to setting their gain to 0db and seem
to be scaled logarithmically.
Correct db scaling will be added in a future release.
Example:
Targets
clips
Operations
volume=0.4
This example sets every audio clip's gain to 0db.
pan
Sets the panning of the given targets.
Available for
tracks,
returns and
chains.
Arguments
The arguments for pan are:
-1 to 1 floating point value - where -1 pans the target all the way
left, +1 for all the way right and 0 to center the panning.
random - randomizes the panning.
jitter - randomizes the panning by +- 0.1.
Example:
Targets
tracks=selected;
chains=selected
Operations
pan=0;
pan=jitter
This example centers the panning on all selected tracks and chains on
selected tracks then randomizes their panning slightly.
width
Sets the width parameter on the last Utility device of the given targets
if a Utility is present.
Available for
tracks and
chains.
Arguments
The arguments for width can either be a 0 to 2 floating point value (1
is 100% width, 2 is %400 andd so on) or it can be a floating point value
with a + or - before it to add or subtract the value from the current
width.
Example:
Targets
tracks=selected
Operations
width=-0.1
This example subtracts 0.1 from the width of every Utility device on the
selected tracks.
polarity
Sets or flips the polarity parameters on the last Utility device of the
given targets.
Available for
tracks and
chains.
Arguments
The argument for polarity is either 0 or 1, 1 representing the
parameters being on. If you give no arguments it will flip the polarity
from whatever its previous state was.
Example:
Targets
tracks="overheads"
Operations
polarity
This example flips the polarity of every track with overheads in their
name (if there's a Utility on them).
groove
Sets the groove of the given targets.
Arguments
The arguments for groove can be either an integer value representing the
index of the desired groove, or any text surrounded by "" to find the
groove by name. Text can match any part of the name and is not case
sensitive
Example:
Targets
clips
Operations
groove="highlife"
This example will set every arrangement clip's groove to "Highlife Clave
Accent 16ths", if that groove is in the project's groove pool.
pitch_coarse (or pitch)
Sets the coarse pitch of the given targets.
Available for
clips and
notes
Arguments
One of the following arguments are needed:
An integer representing the amount of semitones to pitch the targets by.
For audio clips setting the value to 0 resets the value to 0.
random - representing a 0 - 127 random MIDI note value.*
jitter - randomizes each note slightly.*
*Only available for MIDI clips and notes.
Example:
Targets
notes=selected=>64
Operations
pitch_coarse=-12
This example takes notes above middle C on the selected tracks and
pitches them down an octave.
pitch_fine
Sets the fine pitch of the given targets.
Available for audio
clips.
Arguments
The argument for pitch fine is any + or - integer value representing the
amount to adjust the fine pitch of the targets by.
Example:
Targets
clips=audio=!warped
Operations
pitch_fine=+10
This example takes un-warped audio clips and changes the fine pitch of
them by +10.
warp
Turns on or off warping for the given targets.
Available for audio
clips.
Arguments
The argument for warp is a 0 or 1 integer value representing the warping
state of the given targets. Calling warp without an argument will
default to 1.
Example:
Targets
clips=!warped=selected
Operations
warp=1
This example turns on warping in un-warped audio clips on the selected
tracks.
warp_mode
Sets the warp mode for the given targets
Available for audio
clips.
Arguments
The argument for warp_mode is a 0 to 6 integer where:
0 = Beats Mode
1 = Tones Mode
2 = Texture Mode
3 = Re-Pitch Mode
4 = Complex Mode
5 = REX Mode*
6 = Complex Pro Mode
*REX Mode is only available for REX files.
Example:
Targets
clips=warped=in_group,percussion
Operations
warp_mode=3
This example sets the warp mode to Re-Pitch on all the warped audio
clips in the group named percussion.
ram_mode
Sets the RAM mode of the given targets
Available for audio
clips.
Arguments
The argument for ram_mode is a 0 or 1 integer value representing the RAM
mode state of the given targets. Calling ram_mode without an argument
will default to 1.
Example:
Targets
clips=selected="breakdown"
Operations
ram_mode=0
This example turns off ram mode in all the audio clips on selected
tracks with breakdown in their name.
crop
Crops the given targets. No arguments are needed.
Available for MIDI
clips.
velocity
Sets the velocity of the given targets
Available for MIDI
clips* and
notes.
*Sets the velocity of the notes in the given clips, not the velocity of
the clips themselves.
Arguments
One of the following arguments is needed:
1 to 127 integer value - representing the MIDI velocity value of the
given targets.
+ or - followed by an integer value adds or subtracts the given number
from the velocity of the given targets.
random - Randomizes the velocity of the given targets.
jitter - Randomizes the velocity of the given targets slightly.
Example:
Targets
clips=!muted
Operations
velocity=127
This example sets the velocity of all the notes in un-muted MIDI clips
to 127.
v_deviation
Sets the velocity deviation of the given targets.
Available for MIDI
clips and
notes.
Arguments
One of the following arguments is needed:
-127 to 127 integer value - representing the MIDI velocity deviation
value of the given targets.
+ or - followed by an integer value adds or subtracts the given number
from the velocity deviation of the given targets.
random - Randomizes the velocity deviation of the given targets.
jitter - Randomizes the velocity deviation of the given targets
slightly.
Example:
Targets
clips=selected
Operations
v_deviation=random
This example randomizes the velocity deviation of all the notes in MIDI
clips on selected tracks.
duration
Sets the duration of the given targets.
Available for MIDI
clips* and
notes.
*Sets the duration of notes in the given clips, not the clips
themselves.
Arguments
One of the following arguments is needed:
Floating point value - representing the duration value* of the given
targets.
+ or - followed by a floating point value adds or subtracts the given
number from the duration of the given targets.
jitter - Randomizes the duration of the given targets slightly.
*Number represents amount of beats. For instance, a 16th note is 0.25, a
dotted 8th note is 0.75, and an 8th note is 0.5 and so on.
Example:
Targets
clips=selected=midi
Operations
duration=jitter
This example randomizes the duration of all the notes in MIDI clips on
selected tracks slightly.
decimate
Removes given notes or notes in the given targets that are shorter than
the given length.
Available for MIDI
clips* and
notes.
Arguments
The argument for decimate is a floating point value corresponding to the
duration threshold in beats. For instance, a 16th note is 0.25, a dotted
8th note is 0.75, and an 8th note is 0.5 and so on.
start_time
Sets the start time of the given targets
Available for MIDI
clips* and
notes
*Sets the start time of notes in the clip, not the start time of the
clips themselves.
Arguments
One of the following arguments is needed:
+ or - followed by a floating point value* adds or subtracts the given
number from the start time of the given targets.
jitter - Randomizes the start time of the given targets slightly.
*Number represents amount of beats. For instance, a 16th note is 0.25, a
dotted 8th note is 0.75, and an 8th note is 0.5 and so on.
Example:
Targets
clips=midi="Bass"
Operations
start_time=-0.05
This example shifts the start time of all the notes in MIDI clips with
Bass in their name back by 1/20th of a beat.
probability
Sets the probability of the given targets.
Available for MIDI
clips* and
notes.
*Sets the probability of notes in the given clips, not the probability
of the clips themselves.
Arguments
One of the following arguments is needed:
0 to 1 floating point value - representing the probability value of the
given targets.
+ or - followed by a floating point value adds or subtracts the given
number from the probability of the given targets.
random - Randomizes the probability of the given targets.
jitter - Randomizes the probability of the given targets slightly.
Example:
Targets
clips=midi="cowbell"
Operations
probability=0.99
This example gives all the notes in clips with cowbell in their name a
probability of 99%.
r_velocity
Sets the release velocity of the given targets
Available for MIDI
clips* and
notes.
*Sets the release velocity of the notes in the given clips, not the
release velocity of the clips themselves.
Arguments
One of the following arguments is needed:
0 to 127 integer value - representing the MIDI release velocity value of
the given targets.
+ or - followed by an integer value adds or subtracts the given number
from the release velocity of the given targets.
random - Randomizes the release velocity of the given targets.
jitter - Randomizes the release velocity of the given targets slightly.
Example:
Targets
clips=midi="harpsichord"
Operations
r_velocity=64;
r_velocity=jitter
This example sets the release velocity of all the notes in MIDI clips
named harpsichord to 64, then randomizes the release velocity slightly.
quantize
Quantizes the start time of the given targets.
Available for MIDI
clips* and
notes.
*Quantizes start time of the notes in the given clips, not the start
time of the clips themselves.
Arguments
The argument for quantize is a floating point value representing the
amount of beats to quantize by. For instance, a 16th note is 0.25, a
dotted 8th note is 0.75, and an 8th note is 0.5 and so on. Calling arm
without an argument will default to 0.25.
Example:
Targets
notes
Operations
quantize=0.333333
This example quantizes all the notes in the project to 8th note
triplets.
base
Sets the base timing of the given targets.
Arguments
The argument for base is a 0 to 5 integer. The following integers
correspond to the following base timings:
0 = 1/4
1 = 1/8
2 = 1/8T
3 = 1/16
4 = 1/16T
5 = 1/32
Example:
Targets
grooves
Operations
base=2
This example sets every groove in the groove pool's base to 8th note
triplets.
q_amount
Sets the quantization amounts for the given targets.
Arguments
The argument for q_amount is a 0 to 100 integer corresponding to the
percentage of quantization.
Example:
Targets
grooves=0
Operations
q_amount=50
This example sets the first groove in the groove pool's quantization
amount to 50%.
r_amount
Sets the random amounts for the given targets.
Arguments
The argument for r_amount is a 0 to 100 integer corresponding to the
percentage of randomization.
Example:
Targets
grooves="triplet"
Operations
r_amount=50
This example finds the first groove in the groove pool named "triplet"
and sets its random amount to 50%.
t_amount
Sets the timing amounts for the given targets.
Arguments
The argument for t_amount is a 0 to 100 integer corresponding to the
percentage of timing.
Example:
Targets
grooves
Operations
t_amount=50
This example sets every groove in the groove pool's timing amount to
50%.
v_amount
Sets the velocity amounts for the given targets.
Arguments
The argument for v_amount is a 0 to 100 integer corresponding to the
percentage of velocity.
Example:
Targets
grooves
Operations
v_amount=50
This example sets every groove in the groove pool's velocity amount to
50%.
add_tracks
Adds new tracks to the
project.
Arguments
The argument for add_tracks is a list of parameters separated by commas
in the following order:
1. audio or midi - The type of track or tracks to add
2. amount (integer value) - Representing the amount of tracks to add.
3. index (integer value) - If given, represents the index at which to
put the new tracks. 0 represents the beginning of the project and -1
represents the end of the project. If no value is given, it puts new
tracks by the end by default.
4. name (string) - If given, represents the name of the new tracks.*
5. red (integer value) - If given, represents a 0 to 255 red RGB value.
6. green (integer value) - If given, represents a 0 to 255 green RGB
value.
7. blue (integer value) - If given, represents a 0 to 255 blue RGB
value.
Wildcard variables like those in the
name operation
are not available for naming new tracks. You can make the names of the
new tracks something unique and temporary then change them with the
name operation.
Example:
Targets
project
Operations
add_tracks=midi,2,0,new midi,0,255,0;
add_tracks=audio,2
This example adds two green MIDI tracks called "new midi" to the
beginning of the project, then adds two audio tracks to the end of the
project.
most_cpu
Selects the track with the most CPU heavy devices. No arguments are
needed.
loop_between
Sets the arrangement loop start and end between two locators.
Arguments
The argument for loop_between is a list of the two names of the locators
you'd like to loop between, separated by commas.
Example:
Targets
project
Operations
loop_between=start,end
This example sets the arrangement loop start and end to the locators
named "start" and "end", if they exist.
song_track
Adds a song track* to the beginning of the project. No arguments are
required.
*A song track is just an empty midi track that you can put clips to mark
sections of your arrangement, or easily loop the whole track after
looping a section of the arrangement.
default
Resets the given targets or parameters of the given targets to their
default value. No arguments are required.
*Resets the volume and panning
**Resets the gain and pitch
reenable
Reenables the given targets. No arguments are required.
oversample
Sets the oversampling on or off for the given targets.
Available for EQ Eight
devices. Even though other devices may have an
oversampling option, currently, Ableton only gives access to the
oversampling parameter of EQ Eight. This may change in future Ableton
releases.
Arguments
The argument for oversample is a 0 or 1 integer value corresponding to
the on or off state of the oversampling parameter of an EQ Eight device.
If no argument is given it defaults to 1
