edytlab
Audio Tools Reference

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

load

Decode 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_track

Add a new empty track to the session.

Example prompt: add an empty track called "drums"

Returns: track_id

remove_track

Remove a track. Does not delete the source file on disk.

Example prompt: remove track 2

Returns: node_id

reorder_tracks

Move 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_track

Create 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_track

Rename a track.

Example prompt: rename track 2 to "guitar"

Returns: node_id

mute_track

Mute or unmute a track. Muted tracks produce silence in the mix.

Example prompt: mute track 3

Returns: node_id

mute_all_tracks

Mute or unmute every track in one call. Solo flags are left as they are.

Example prompt: mute everything

Returns: node_id

solo_track

Solo 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_pan

Set 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_shift

Move 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_end

Place 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_track

Offline-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_track

Generate 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_chirp

Generate 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_dtmf

Generate 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_tone

Synthesize 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_noise

Generate 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_mono

Convert a stereo (or multi-channel) track to mono by averaging all channels.

Example prompt: make track 1 mono

Returns: node_id

mono_to_stereo

Convert a mono track to stereo by duplicating the channel to both L and R.

Example prompt: make track 1 stereo

Returns: node_id