Files, Tracks and Channels
Load audio, manage tracks, generate tones, noise, clicks, frequency sweeps and keypad signals, and convert between mono and stereo.
On this page20 tools
File and Track Management
loadDecode an audio file (WAV, MP3, FLAC, Ogg Vorbis, Opus or AIFF everywhere, and M4A files with AAC audio on macOS and Windows) and create a new track in the session.
Example prompt: load /path/to/file.wav
Returns: track_id, duration_sec
add_trackAdd a new empty track to the session.
Example prompt: add an empty track called "drums"
Returns: track_id
remove_trackRemove a track. Does not delete the source file on disk.
Example prompt: remove track 2
Returns: node_id
reorder_tracksMove a track to a new position in the track list. The tracks between shift by one, so later calls must use the new indices.
Example prompt: move track 3 to the top
Returns: node_id
duplicate_trackCreate an exact copy of a track (same clips, gain, pan, effects). The duplicate is appended after all existing tracks.
Example prompt: duplicate track 1
Returns: node_id
rename_trackRename a track.
Example prompt: rename track 2 to "guitar"
Returns: node_id
mute_trackMute or unmute a track. Muted tracks produce silence in the mix.
Example prompt: mute track 3
Returns: node_id
mute_all_tracksMute or unmute every track in one call. Solo flags are left as they are.
Example prompt: mute everything
Returns: node_id
solo_trackSolo or un-solo a track. When any track is soloed, only soloed tracks play in the mix.
Example prompt: solo the vocals
Returns: node_id
set_panSet the stereo pan of a track. -1.0 = full left, 0.0 = centre, 1.0 = full right.
Example prompt: pan track 2 hard left
Returns: node_id
time_shiftMove a track's clips forward or backward in time. Positive offset_sec moves later, negative moves earlier (clamped to 0).
Example prompt: move track 2 two seconds later
Returns: node_id
align_end_to_endPlace the given tracks one after another, in the order given: the first stays put, and each next track moves, clips and their spacing together, to start where the previous one ends. An optional gap_sec leaves silence between them. Other tracks do not move, and sync-lock, labels and the transcript are left alone, as with time_shift.
Example prompt: put tracks 1, 2 and 3 one after another
Returns: node_id, moved
mix_to_new_trackOffline-render the selected tracks together and add the result as a new mixed track. track_indices selects which tracks to include. The new track is a copy: it does not follow later edits to the tracks it came from. To put an effect such as a limiter on the whole mix, use add_effect with scope "master" instead of mixing down.
Example prompt: mix tracks 1 and 2 into a new track
Returns: node_id, warnings (only when something was left out)
Generators
generate_click_trackGenerate a sample-aligned click track with an accented downbeat. Give a BPM or a track to measure tempo from, beats per bar, a duration or bar count, and an optional offset before the first beat.
Example prompt: generate 8 bars of clicks at 120 BPM, with an accented downbeat
Returns: node_id, track_index, duration_sec
Works on an empty project. An explicit BPM takes precedence over the track's detected tempo. Duration includes the initial offset; bar count adds the offset before the requested bars.
generate_chirpGenerate a linear or logarithmic frequency sweep at the session sample rate, with start and end frequencies, duration and peak amplitude.
Example prompt: generate a 5-second logarithmic sweep from 100 Hz to 10 kHz
Returns: node_id, track_index, duration_sec
Works on an empty project. Both frequencies must be positive and below half the sample rate.
generate_dtmfGenerate dual-tone keypad signals for digits 0–9, *, # and A–D, with adjustable tone and gap durations and combined peak amplitude.
Example prompt: generate keypad tones for 12#, with 0.1-second tones and 0.05-second gaps
Returns: node_id, track_index, duration_sec
Works on an empty project. Letters are case-insensitive; tones must last at least 40 milliseconds. Gaps occur between tones, with no trailing gap. Short ramps soften tone boundaries.
generate_toneSynthesize a tone (sine, square, sawtooth, or triangle wave) and add it as a new track.
Example prompt: generate a 440 Hz sine for 5 seconds
Returns: track index
generate_noiseGenerate a noise track (white, pink, or brown/Brownian noise) and add it as a new track.
Example prompt: generate 3 seconds of pink noise
Returns: track index
Channel Layout
stereo_to_monoConvert a stereo (or multi-channel) track to mono by averaging all channels.
Example prompt: make track 1 mono
Returns: node_id
mono_to_stereoConvert a mono track to stereo by duplicating the channel to both L and R.
Example prompt: make track 1 stereo
Returns: node_id