Files, Tracks and Channels
Load audio, manage tracks, generate tones and noise, and convert between mono and stereo.
On this page14 tools
File and Track Management
loadDecode an audio file (WAV, MP3, FLAC or Ogg Vorbis) 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
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
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
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_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