Scripting Reference

From Audacity Development Manual
Revision as of 14:39, 12 February 2018 by JamesCrook (talk | contribs) (Updates.)
Jump to: navigation, search
This is an experiemental page, not linked to from anywhere, to list automation commands.
  • Yes these are the same commands as in "Commands and Shortcuts", same as in the menus, just presented differently.
    • Presented in a format useful to people using Scripting or Chains.
    • Most of this page is automatically generated.
For some effects we have two description strings, one created in wiki and one created from a description in Audacity code. This table currently incorrectly gives the one from Audacity code priority. The wiki version is nearly always more comprehensive and up to date and should be used instead
Advice The Align->Tracks submenu has bad Automation IDs which make them unusable. This should be corrected in Audacity.
Advice Nyquist and some other effects do not show their parameters in this table (yet)
Advice Some of the menu items pop up dialogs, making them ill-suited for automation
Advice This table shows the items in the menus in the Automation branch. That branch is not yet merged in to master
Advice The Automation IDs, parameters and defaults are all likely to change between versions.
Advice Stereo tracks count as two tracks as far as selection in automation is concerned.
Advice Boolean values must be given as 0 or 1, NOT true or false.
Alert The very latest versions of commands (possibly more up to date than this table) may be being used in the piped-work scripts


File Menu

This menu has items to open, save, import and export files.
Automation Id Action Parameters Description
New: New none Creates a new empty project window, to start working on new or imported Tracks.
Open: Open... none Presents you with a standard dialog box where you can select either audio files, a list of files (.LOF) or an Audacity Project file to open.
Close: Close none Closes the current project window, prompting you to save your work if you have not saved.
SaveProject: Save Project string Filename, (default:name.aup)

bool AddToHistory, (default:False)
bool Compress, (default:False)

Saves a project.
SaveAs: Save Project As... none Same as "Save Project" above, but allows you to save a copy of an open project to a different name or location
Export: Export string Filename, (default:exported.wav)

int NumChannels, (default:1)

Exports to a file.
Import: Import string Filename, (default:)
Imports from a file.
PageSetup: Page Setup... none Opens the standard Page Setup dialog box prior to printing
Print: Print... none Prints all the waveforms in the current project window (and the contents of Label Tracks or other tracks), with the Timeline above. Everything is printed to one page.
Exit: Exit none Closes all project windows and exits Audacity. If there are any unsaved changes to your project, Audacity will ask if you want to save them.

File: Export

Exports to a file.
Automation Id Action Parameters Description
ExportMp3: Export as MP3 none Exports to an MP3 file
ExportWav: Export as WAV none Exports to a WAV file
ExportOgg: Export as OGG none Exports to an OGG file
Export: Export Audio... none Exports to an audio file.
ExportSel: Export Selected Audio... none Exports selected audio to a file.
ExportLabels: Export Labels... none Exports audio at one or more labels to file(s).
ExportMultiple: Export Multiple... none Exports multiple audio files in one process, one file for each track if there are multiple audio tracks, or labels can be added which then define the length of each exported file.
ExportMIDI: Export MIDI... none Exports MIDI (note tracks) to a MIDI file.
SaveCompressed: Save Compressed Copy of Project... none Saves in the audacity .aup project file format, but compressed (Suitable for mailing)

File: Import

Imports from a file.
Automation Id Action Parameters Description
ImportAudio: Audio... none Similar to 'Open', except that the file is added as a new track to your existing project.
ImportLabels: Labels... none Launches a file selection window where you can choose to import a single text file into the project containing point or region labels. For more information about the syntax for labels files, see Importing and Exporting Labels.
ImportMIDI: MIDI... none Imports a MIDI (MIDI or MID extension) or Allegro (GRO) file to a Note Track where simple cut-and-paste edits can be performed. The result can be exported with the File > Save Other> > Export MIDI command. Note: Currently, MIDI and Allegro files cannot be played.
ImportRaw: Raw Data... none Attempts to import an uncompressed audio file that might be "raw" data without any headers to define its format, might have incorrect headers or be otherwise partially corrupted, or might be in a format that Audacity is unable to recognize. Raw data in textual format cannot be imported.

File: Chains

Chains are Audacity's form of batch processing
Automation Id Action Parameters Description
ApplyChain: Apply Chain... none Creates a new Chain or edits an existing chain.
EditChains: Edit Chains... none Show the existing chains and allows you to select and run one.

Edit Menu

Edit
Automation Id Action Parameters Description
Undo: Undo Recover none no tip string.
Redo: Redo none Redoes the most recently undone editing action.
Cut: Cut none Removes the selected audio data and/or labels and places these on the Audacity clipboard. By default, any audio or labels to right of the selection are shifted to the left.
Delete: Delete none Removes the selected audio data and/or labels without copying these to the Audacity clipboard. By default, any audio or labels to right of the selection are shifted to the left.
Copy: Copy none Copies the selected audio data to the Audacity clipboard without removing it from the project.
Paste: Paste none Inserts whatever is on the Audacity clipboard at the position of the selection cursor in the project, replacing whatever audio data is currently selected, if any.
Duplicate: Duplicate none Creates a new track containing only the current selection as a new clip.
EditMetaData: Metadata... none The Metadata Editor modifies information about a track, such as the artist and genre. Typically used with MP3 files.
Preferences: Preferences... none Preferences let you change most of the default behaviors and settings of Audacity. On Mac, Preferences are in the Audacity Menu and the default shortcut is ⌘ + ,.

Edit: Remove Special

For more "advanced" removal of audio
Automation Id Action Parameters Description
SplitCut: Split Cut none Same as Cut, but none of the audio data or labels to right of the selection are shifted.
SplitDelete: Split Delete none Same as Delete, but none of the audio data or labels to right of the selection are shifted.
Silence: Silence Audio none Replaces the currently selected audio with absolute silence. Does not affect label tracks.
Trim: Trim Audio none Deletes all audio but the selection. If there are other separate clips in the same track these are not removed or shifted unless trimming the entire length of a clip or clips. Does not affect label tracks.

Edit: Clip Boundaries

Create or remove separate clips in the audio track. A clip inside an audio track is a separate section of that track which has been split so that it can be manipulated somewhat independently of the other clips in the track.
Automation Id Action Parameters Description
Split: Split none Splits the current clip into two clips at the cursor point, or into three clips at the selection boundaries.
SplitNew: Split New none Does a Split Cut on the current selection in the current track, then creates a new track and pastes the selection into the new track.
Join: Join none If you select an area that overlaps one or more clips, they are all joined into one large clip. Regions in-between clips become silence.
Disjoin: Detach at Silences none In a selection region that includes absolute silences, creates individual non-silent clips between the regions of silence. The silence becomes blank space between the clips.

Edit: Labels

These commands are to add and edit labels.
Automation Id Action Parameters Description
EditLabels: Edit Labels... none Brings up a dialog box showing all of your labels in a keyboard-accessible tabular view. Handy buttons in the dialog let you insert or delete a label, or import and export labels to a file. See Labels Editor for more details.
AddLabel: Add Label At Selection none Creates a new, empty label at the cursor or at the selection region.
AddLabelPlaying: Add Label At Playback Position none Creates a new, empty label at the current playback or recording position.
PasteNewLabel: Paste Text to New Label none Pastes the text on the Audacity clipboard at the cursor position in the currently selected label track. If there is no selection in the label track a point label is created. If a range is selected in the label track a range label is created. If no label track is selected one is created, and a new label is created.
TypeToCreateLabel: Type to Create a Label (on/off) none When a label track has the yellow focus border, if this option is on, just type to create a label. Otherwise you must create a label first.

Edit: Labeled Audio

Labeled Audio commands apply standard Edit Menu commands to the audio of one or more regions that are labeled. The labels themselves are not affected.
Automation Id Action Parameters Description
CutLabels: Cut none Same as the Cut command, but operates on labeled audio regions.
DeleteLabels: Delete none Same as the Delete command, but operates on labeled audio regions.
SplitCutLabels: Split Cut none Same as the Split Cut command, but operates on labeled audio regions.
SplitDeleteLabels: Split Delete none Same as the Split Delete command, but operates on labeled audio regions.
SilenceLabels: Silence Audio none Same as the Silence Audio command, but operates on labeled audio regions.
CopyLabels: Copy none Same as the Copy command, but operates on labeled audio regions.
SplitLabels: Split none Same as the Split command, but operates on labeled audio regions or points.
JoinLabels: Join none Same as the Join command, but operates on labeled audio regions or points. You may need to select the audio and use Edit > Clip Boundaries > Join, to join all regions or points.
DisjoinLabels: Detach at Silences none Same as the Detach at Silences command, but operates on labeled audio regions.

Select Menu

Selects Audio.
Automation Id Action Parameters Description
SelectAll: All none Selects all of the audio in all of the tracks.
SelectNone: None none Deselects all of the audio in all of the tracks.
SelCursorStoredCursor: Cursor to Stored Cursor Position none Selects from the position of the cursor to the previously stored cursor position
StoreCursorPosition: Store Cursor Position none Stores the current cursor position for use in a later selection
ZeroCross: At Zero Crossings none Moves the edges of a selection region (or the cursor position) slightly so they are at a rising zero crossing point.

Select: Tracks

Tracks
Automation Id Action Parameters Description
SelAllTracks: In All Tracks none Extends the current selection up and/or down into all tracks in the project.
SelSyncLockTracks: In All Sync-Locked Tracks none Extends the current selection up and/or down into all sync-locked tracks in the currently selected track group.

Select: Region

For modifying, saving and restoring a selection.
Automation Id Action Parameters Description
SetLeftSelection: Left at Playback Position none When Audacity is playing, recording or paused, sets the left boundary of a potential selection by moving the cursor to the current position of the green playback cursor (or red recording cursor).

Otherwise, opens the "Set Left Selection Boundary" dialog for adjusting the time position of the left-hand selection boundary. If there is no selection, moving the time digits backwards creates a selection ending at the former cursor position, and moving the time digits forwards provides a way to move the cursor forwards to an exact point.

SetRightSelection: Right at Playback Position none When Audacity is playing, recording or paused, sets the right boundary of the selection, thus drawing the selection from the cursor position to the current position of the green playback cursor (or red recording cursor).

Otherwise, opens the "Set Right Selection Boundary" dialog for adjusting the time position of the right-hand selection boundary. If there is no selection, moving the time digits forwards creates a selection starting at the former cursor position, and moving the time digits backwards provides a way to move the cursor backwards to an exact point.

SelStartCursor: Track Start to Cursor none Selects a region in the selected track(s) from the start of the track to the cursor position.
SelCursorEnd: Cursor to Track End none Selects a region in the selected track(s) from the cursor position to the end of the track.
SelSave: Store Selection none Stores the end points of a selection for later reuse.
SelRestore: Retrieve Selection none Retrieves the end points of a previously stored selection.

Select: Spectral

For making a selection of a frequency range.
Automation Id Action Parameters Description
ToggleSpectralSelection: Toggle spectral selection none Changes between selecting a time range and selecting the last selected spectral selection in that time range. This command toggles the spectral selection even if not in Spectrogram view, but you must be in Spectrogram view to use the spectral selection in one of the Spectral edit effects.
NextHigherPeakFrequency: Next Higher Peak Frequency none When in Spectrogram view, snaps the center frequency to the next higher frequency peak, moving the spectral selection upwards.
NextLowerPeakFrequency: Next Lower Peak Frequency none When in Spectrogram views snaps the center frequency to the next lower frequency peak, moving the spectral selection downwards.

Select: Clip Boundaries

For modifying a selection, taking account of clips.
Automation Id Action Parameters Description
SelPrevClipBoundaryToCursor: Previous Clip Boundary to Cursor none Selects from the current cursor position back to the right-hand edge of the previous clip.
SelCursorToNextClipBoundary: Cursor to Next Clip Boundary none Selects from the current cursor position forward to the left-hand edge of the next clip.
SelPrevClip: Previous Clip none Moves the selection to the previous clip.
SelNextClip: Next Clip none Moves the selection to the next clip.

View Menu

View
Automation Id Action Parameters Description
UndoHistory: History... none Brings up the History window which can then be left open while using Audacity normally. History lists all undoable actions performed in the current project, including importing.
Karaoke: Karaoke... none Brings up the Karaoke window, which displays the labels in a "bouncing ball" scrolling display
MixerBoard: Mixer Board... none Mixer Board is an alternative view to the audio tracks in the main tracks window. Analogous to a hardware mixer board, each audio track is displayed in a Track Strip.
ShowExtraMenus: Extra Menus (on/off) none Shows extra menus with many extra less-used commands.
ShowClipping: Show Clipping (on/off) none Option to show or not show audio that is too loud (in red) on the wave form.

View: Zoom

Zoom in/out on the horizontal axis. Show more detail or show a longer length of time.
Automation Id Action Parameters Description
ZoomIn: Zoom In none Zooms in on the horizontal axis of the audio displaying more detail over a shorter length of time.
ZoomNormal: Zoom Normal none Zooms to the default view which displays about one inch per second.
ZoomOut: Zoom Out none Zooms out displaying less detail over a greater length of time.
ZoomSel: Zoom to Selection none Zooms in or out so that the selected audio fills the width of the window.
ZoomToggle: Zoom Toggle none Changes the zoom back and forth between two preset levels.

View: Track Size

Controls the sizes of tracks.
Automation Id Action Parameters Description
FitInWindow: Fit to Width none Zooms out until the entire project just fits in the window.
FitV: Fit to Height none Adjusts the height of all the tracks until they fit in the project window.
CollapseAllTracks: Collapse All Tracks none Collapses all tracks to take up the minimum amount of space.
ExpandAllTracks: Expand Collapsed Tracks none Expands all collapsed tracks to their original size before the last collapse.

View: Skip to

Move forward/backwards through the audio
Automation Id Action Parameters Description
SkipSelStart: Selection Start none When there is a selection, moves the cursor to the start of the selection and removes the selection.
SkipSelEnd: Selection End none When there is a selection, moves the cursor to the end of the selection and removes the selection.

View: Toolbars

Toolbars can be used to determine which of the Audacity toolbars are displayed. By default all toolbars are shown except Spectral Selection and Scrub
Automation Id Action Parameters Description
ResetToolbars: Reset Toolbars none Using this command positions all toolbars in default location and size as they were when Audacity was first installed
ShowTransportTB: Transport Toolbar none Controls playback and recording and skips to start or end of project when neither playing or recording
ShowToolsTB: Tools Toolbar none Chooses various tools for selection, volume adjustment, zooming and time-shifting of audio
ShowRecordMeterTB: Recording Meter Toolbar none Displays recording levels and toggles input monitoring when not recording
ShowPlayMeterTB: Playback Meter Toolbar none Displays playback levels
ShowMixerTB: Mixer Toolbar none Adjusts the recording and playback volumes of the devices currently selected in Device Toolbar
ShowEditTB: Edit Toolbar none Cut, copy, paste, trim audio, silence audio, undo, redo, zoom tools
ShowTranscriptionTB: Transcription Toolbar none Plays audio at a slower or faster speed than normal, affecting pitch
ShowScrubbingTB: Scrub Toolbar none Controls playback and recording and skips to start or end of project when neither playing or recording
ShowDeviceTB: Device Toolbar none Selects audio host, recording device, number of recording channels and playback device
ShowSelectionTB: Selection Toolbar none Controls the sample rate of the project, snapping to the selection format and adjusts cursor and region position by keyboard input
ShowSpectralSelectionTB: Spectral Selection Toolbar none Displays and lets you adjust the current spectral (frequency) selection without having to be in Spectrogram view

Transport Menu

Transport
Automation Id Action Parameters Description
RescanDevices: Rescan Audio Devices none Rescan for audio devices connected to your computer, and update the playback and recording dropdown menus in Device Toolbar

Transport: Play

These commands control playback in Audacity. You can Start, Stop or Pause playback of the audio in your project.
Automation Id Action Parameters Description
Play: Play/Stop none Starts and stops playback or stops a recording (stopping does not change the restart position). Therefore using any play or record command after stopping with "Play/Stop" will start playback or recording from the same Timeline position it last started from. You can also assign separate shortcuts for Play and Stop.
PlayStopSelect: Play/Stop and Set Cursor none Starts playback like "Play/Stop", but stopping playback sets the restart position to the stop point. When stopped, this command is the same as "Play/Stop". When playing, this command stops playback and moves the cursor (or the start of the selection) to the position where playback stopped.
PlayLooped: Loop Play none Plays the selection over and over again.
Pause: Pause none Temporarily pauses playing or recording without losing your place.

Transport: Record

These commands control recording in Audacity. You can Start, Stop or Pause recording in your project. You can either start a recording on your existing track or an a new track.
Automation Id Action Parameters Description
Record1stChoice: Record none Starts recording at the end of the currently selected track(s).
Record2ndChoice: Record New Track none Recording begins on a new track at either the current cursor location or at the beginning of the current selection.
TimerRecord: Timer Record... none Brings up the Timer Record dialog.
Pause: Pause none Temporarily pauses playing or recording without losing your place.

Transport: Scrubbing

Scrubbing is the action of moving the mouse pointer right or left so as to adjust the position, speed or direction of playback, listening to the audio at the same time - a convenient way to quickly navigate the waveform to find a particular event of interest. Speed changes are made by rotating the mouse wheel while scrubbing.
Automation Id Action Parameters Description
Scrub: Scrub none Scrubbing is the action of moving the mouse pointer right or left so as to adjust the position, speed or direction of playback, listening to the audio at the same time.
Seek: Seek none Seeking is similar to Scrubbing except that it is playback with skips, similar to using the seek button on a CD player.
ToggleScrubRuler: Scrub Ruler none Shows (or hides) the scrub ruler, which is just below the timeline.

Transport: Cursor to

These commands let you move the cursor to the start or end of the selection, track or any adjacent Clip that you may have
Automation Id Action Parameters Description
CursSelStart: Selection Start none Moves the left edge of the current selection to the center of the screen, without changing the zoom level.
CursSelEnd: Selection End none Moves the right edge of the current selection to the center of the screen, without changing the zoom level.
CursTrackStart: Track Start none Moves the cursor to the start of the selected track.
CursTrackEnd: Track End none Moves the cursor to the end of the selected track.
CursPrevClipBoundary: Previous Clip Boundary none Moves the cursor position back to the right-hand edge of the previous clip
CursNextClipBoundary: Next Clip Boundary none Moves the cursor position forward to the left-hand edge of the next clip
CursProjectStart: Project Start none Moves the cursor to the beginning of the project.
CursProjectEnd: Project End none Moves the cursor to the end of the project.

Transport: Play Region

These commands enable you to lock a play region and unlock it
Automation Id Action Parameters Description
LockPlayRegion: Lock none Locks standard playback to the current position of the playback region, or to the current position of the Quick-Play region).
UnlockPlayRegion: Unlock none Removes the Play Region Lock.

Transport: Transport Options

This submenu lets you manage and set various options for transport (playing and recording) in Audacity
Automation Id Action Parameters Description
SoundActivationLevel: Sound Activation Level... none Sets the activation level above which Sound Activated Recording will record.
SoundActivation: Sound Activated Recording (on/off) none Toggles on and off the Sound Activated Recording option.
PinnedHead: Pinned Play/Record Head (on/off) none You can change Audacity to play and record with a fixed head pinned to the center of the Timeline.
Duplex: Overdub (on/off) none Toggles on and off the Overdub option.
SWPlaythrough: Software Playthrough (on/off) none Toggles on and off the Software Playthrough option.

Tracks Menu

For extending a selection to more tracks.
Automation Id Action Parameters Description
Resample: Resample... none Allows you to resample the selected track(s) to a new sample rate for use in the project
RemoveTracks: Remove Tracks none Removes the selected track(s) from the project. Even if only part of a track is selected, the entire track is removed.
SyncLock: Sync-Lock Tracks (on/off) none Ensures that length changes occurring anywhere in a defined group of tracks also take place in all audio or label tracks in that group.

Tracks: Add New

Adds a new track
Automation Id Action Parameters Description
NewMonoTrack: Mono Track none Creates a new empty mono audio track.
NewStereoTrack: Stereo Track none Adds an empty stero track to the project
NewLabelTrack: Label Track none Adds an empty label track to the project
NewTimeTrack: Time Track none Adds an empty time track to the project. Time tracks are used to speed up and slow down audio.

Tracks: Mix

Mixes down selected tracks to mono or stereo tracks
Automation Id Action Parameters Description
Stereo to Mono: Mix Stereo down to Mono none Converts the selected stereo track(s) into the same number of mono tracks, combining left and right channels equally by averaging the volume of both channels.
MixAndRender: Mix and Render none Mixes down all selected tracks to a single mono or stereo track, rendering to the waveform all real-time transformations that had been applied (such as track gain, panning, amplitude envelopes or a change in project rate).
MixAndRenderToNewTrack: Mix and Render to New Track none Same as Tracks > Mix and Render except that the original tracks are preserved rather than being replaced by the resulting "Mix" track.

Tracks: Mute/Unmute

Mutes or unmutes audio tracks in the project
Automation Id Action Parameters Description
MuteAllTracks: Mute All Tracks none Mutes all the audio tracks in the project as if you had used the mute buttons from the Track Control Panel on each track.
UnMuteAllTracks: Unmute All Tracks none Unmutes all the audio tracks in the project as if you had released the mute buttons from the Track Control Panel on each track.

Tracks: Pan

Pans left right or center audio tracks in the project
Automation Id Action Parameters Description
PanLeft: Left none Pan selected audio to left speaker
PanRight: Right none Pan selected audio centrally.
PanCenter: Center none Pan selected audio to right speaker.

Tracks: Align Tracks

Commands that provide an automatic way of aligning selected tracks with the cursor, the selection, or with the start of the project.
Automation Id Action Parameters Description
Align:&Align End to End: Align End to End none Aligns the selected tracks one after the other, based on their top-to-bottom order in the project window.
Align:Align &Together: Align Together none Align the selected tracks so that they start at the same (averaged) start time.
Align:Start to &Zero: Start to Zero none Aligns the start of selected tracks with the start of the project.
Align:Start to &Cursor/Selection Start: Start to Cursor/Selection Start none Aligns the start of selected tracks with the current cursor position or with the start of the current selection.
Align:Start to Selection &End: Start to Selection End none Aligns the start of selected tracks with the end of the current selection.
Align:End to Cu&rsor/Selection Start: End to Cursor/Selection Start none Aligns the end of selected tracks with the current cursor position or with the start of the current selection.
Align:End to Selection En&d: End to Selection End none Aligns the end of selected tracks with the end of the current selection.
MoveSelectionWithTracks: Move Selection with Tracks (on/off) none Toggles on/off the selection moving with the realigned tracks, or staying put.

Tracks: Sort Tracks

Sorts all tracks in the project from top to bottom in the project window, by Start Time or by Name.
Automation Id Action Parameters Description
SortByTime: by Start time none Sort tracks in order of start time.
SortByName: by Name none Sort tracks in order by name.

Generate Menu

Generate
Automation Id Action Parameters Description
ManageGenerators: Add / Remove Plug-ins... none Selecting this option from the Effect Menu (or the Generate Menu or Analyze Menu) takes you to a dialog where you can enable or disable particular Effects, Generators and Analyzers in Audacity. Even if you do not add any third-party plug-ins, you can use this to make the Effect menu shorter or longer as required. For details see Add / Remove Effects, Generators and Analyzers.
Chirp: Chirp... double StartFreq, (default:440)

double EndFreq, (default:1320)
double StartAmp, (default:0.8)
double EndAmp, (default:0.1)
enum Waveform, (default:0)

  • Sine
  • Square
  • Sawtooth
  • Square, no alias

enum Interpolation, (default:0)

  • Linear
  • Logarithmic
Generates an ascending or descending tone of one of four types
DtmfTones: DTMF Tones... string Sequence, (default:audacity)

double Duty Cycle, (default:55)
double Amplitude, (default:0.8)

Generates dual-tone multi-frequency (DTMF) tones like those produced by the keypad on telephones
Noise: Noise... enum Type, (default:0)
  • White
  • Pink
  • Brownian

double Amplitude, (default:0.8)

Generates one of three different types of noise
Silence...: Silence... none Creates audio of zero amplitude, the only configurable setting being duration.
Tone: Tone... double Frequency, (default:440)

double Amplitude, (default:0.8)
enum Waveform, (default:0)

  • Sine
  • Square
  • Sawtooth
  • Square, no alias

enum Interpolation, (default:0)

  • Linear
  • Logarithmic
Generates a constant frequency tone of one of four types
Pluck...: Pluck... none A synthesized pluck tone with abrupt or gradual fade-out, and selectable pitch corresponding to a MIDI note.
Rhythm Track...: Rhythm Track... none Generates a track with regularly spaced sounds at a specified tempo and number of beats per measure (bar).
Risset Drum...: Risset Drum... none Produces a realistic drum sound.
Sample Data Import...: Sample Data Import... none Create audio from imported numeric data.

Effect Menu

Effect
Automation Id Action Parameters Description
ManageEffects: Add / Remove Plug-ins... none Selecting this option from the Effect Menu (or the Generate Menu or Analyze Menu) takes you to a dialog where you can enable or disable particular Effects, Generators and Analyzers in Audacity. Even if you do not add any third-party plug-ins, you can use this to make the Effect menu shorter or longer as required. For details see Add / Remove Effects, Generators and Analyzers.
RepeatLastEffect: Repeat Last Effect none Repeats the last used effect at its last used settings and without displaying any dialog.
Amplify: Amplify... float Ratio, (default:0.9)
Increases or decreases the volume of the audio you have selected
AutoDuck: Auto Duck... double DuckAmountDb, (default:-12)

double InnerFadeDownLen, (default:0)
double InnerFadeUpLen, (default:0)
double OuterFadeDownLen, (default:0.5)
double OuterFadeUpLen, (default:0.5)
double ThresholdDb, (default:-30)
double MaximumPause, (default:1)

Reduces (ducks) the volume of one or more tracks whenever the volume of a specified "control" track reaches a particular level
BassAndTreble: Bass and Treble... double Bass, (default:0)

double Treble, (default:0)
double Gain, (default:0)
bool Link Sliders, (default:False)

Simple tone control effect
ChangePitch: Change Pitch... double Percentage, (default:0)

bool SBSMS, (default:False)

Change the pitch of a track without changing its tempo
ChangeSpeed: Change Speed... double Percentage, (default:0)
Change the speed of a track, also changing its pitch
ChangeTempo: Change Tempo... double Percentage, (default:0)

bool SBSMS, (default:False)

Change the tempo of a selection without changing its pitch
ClickRemoval: Click Removal... int Threshold, (default:200)

int Width, (default:20)

Click Removal is designed to remove clicks on audio tracks
Compressor: Compressor... double Threshold, (default:-12)

double NoiseFloor, (default:-40)
double Ratio, (default:2)
double AttackTime, (default:0.2)
double ReleaseTime, (default:1)
bool Normalize, (default:True)
bool UsePeak, (default:False)

Compresses the dynamic range of audio
Distortion: Distortion... enum Type, (default:0)
  • Hard Clipping
  • Soft Clipping
  • Soft Overdrive
  • Medium Overdrive
  • Hard Overdrive
  • Cubic Curve (odd harmonics)
  • Even Harmonics
  • Expand and Compress
  • Leveller
  • Rectifier Distortion
  • Hard Limiter 1413

bool DC Block, (default:False)
double Threshold dB, (default:-6)
double Noise Floor, (default:-70)
double Parameter 1, (default:50)
double Parameter 2, (default:50)
int Repeats, (default:1)

Waveshaping distortion effect
Echo: Echo... float Delay, (default:1)

float Decay, (default:0.5)

Repeats the selected audio again and again
Equalization: Equalization... size_t FilterLength, (default:4001)

string CurveName, (default:unnamed)
bool InterpolateLin, (default:False)
enum InterpolationMethod, (default:0)

  • B-spline
  • Cosine
  • Cubic
Adjusts the volume levels of particular frequencies
Fade In: Fade In none Applies a linear fade-in to the selected audio - the rapidity of the fade-in depends entirely on the length of the selection it is applied to. For a more customizable logarithmic fade, use the Envelope Tool on the Tools Toolbar.
Fade Out: Fade Out none Applies a linear fade-out to the selected audio - the rapidity of the fade-out depends entirely on the length of the selection it is applied to. For a more customizable logarithmic fade, use the Envelope Tool on the Tools Toolbar.
Invert: Invert none This effect flips the audio samples upside-down. This normally does not affect the sound of the audio at all. It is occasionally useful for vocal removal.
Noise Reduction...: Noise Reduction... none This effect is ideal for reducing constant background noise such as fans, tape noise, or hums. It will not work very well for removing talking or music in the background. More details here.
Normalize: Normalize... double Level, (default:-1)

bool ApplyGain, (default:True)
bool RemoveDcOffset, (default:True)
bool StereoIndependent, (default:False)

Sets the peak amplitude of one or more tracks
Nyquist Prompt...: Nyquist Prompt... none Brings up a dialog where you can enter Nyquist commands. Nyquist is a programming language for generating, processing and analyzing audio. For more information see Nyquist Plug-ins Reference.
Paulstretch: Paulstretch... float Stretch Factor, (default:10)

float Time Resolution, (default:0.25)

Use Paulstretch only for an extreme time-stretch or "stasis" effect
Phaser: Phaser... int Stages, (default:2)

int DryWet, (default:128)
double Freq, (default:0.4)
double Phase, (default:0)
int Depth, (default:100)
int Feedback, (default:0)
double Gain, (default:-6)

Combines phase-shifted signals with the original signal
Repair: Repair none Fix one particular short click, pop or other glitch no more than 128 samples long.
Repeat: Repeat... int Count, (default:1)
Repeats the selection the specified number of times
Reverb: Reverb... double RoomSize, (default:75)

double Delay, (default:10)
double Reverberance, (default:50)
double HfDamping, (default:50)
double ToneLow, (default:100)
double ToneHigh, (default:100)
double WetGain, (default:-1)
double DryGain, (default:-1)
double StereoWidth, (default:100)
bool WetOnly, (default:False)

Adds ambience or a "hall effect"
Reverse: Reverse none Reverses the selected audio; after the effect the end of the audio will be heard first and the beginning last.
TimeScale: Sliding Time Scale/Pitch Shift... double RatePercentChangeStart, (default:0)

double RatePercentChangeEnd, (default:0)
double PitchHalfStepsStart, (default:0)
double PitchHalfStepsEnd, (default:0)
double PitchPercentChangeStart, (default:0)
double PitchPercentChangeEnd, (default:0)

Allows continuous changes to the tempo and/or pitch
TruncateSilence: Truncate Silence... enum Db, (default:0)
  • -20 dB
  • -25 dB
  • -30 dB
  • -35 dB
  • -40 dB
  • -45 dB
  • -50 dB
  • -55 dB
  • -60 dB
  • -65 dB
  • -70 dB
  • -75 dB
  • -80 dB

enum Action, (default:0)

  • Truncate Detected Silence
  • Compress Excess Silence

double Minimum, (default:0.5)
double Truncate, (default:0.5)
double Compress, (default:50)
bool Independent, (default:False)

Automatically reduces the length of passages where the volume is below a specified level
Wahwah: Wahwah... double Freq, (default:1.5)

double Phase, (default:0)
int Depth, (default:70)
double Resonance, (default:2.5)
int Offset, (default:30)
double Gain, (default:-6)

Rapid tone quality variations, like that guitar sound so popular in the 1970's
Adjustable Fade...: Adjustable Fade... none enables you to control the shape of the fade (non-linear fading) to be applied by adjusting various parameters; allows partial (that is not from or to zero) fades up or down.
Clip Fix...: Clip Fix... none Clip Fix attempts to reconstruct clipped regions by interpolating the lost signal.
Crossfade Clips: Crossfade Clips none Use Crossfade Clips to apply a simple crossfade to a selected pair of clips in a single audio track.
Crossfade Tracks...: Crossfade Tracks... none Use Crossfade Tracks to make a smooth transition between two overlapping tracks one above the other. Place the track to be faded out above the track to be faded in then select the overlapping region in both tracks and apply the effect.
Delay...: Delay... none A configurable delay effect with variable delay time and pitch shifting of the delays.
High Pass Filter...: High Pass Filter... none Passes frequencies above its cutoff frequency and attenuates frequencies below its cutoff frequency.
Limiter...: Limiter... none Limiter passes signals below a specified input level unaffected or gently reduced, while preventing the peaks of stronger signals from exceeding this threshold. Mastering engineers often use this type of dynamic range compression combined with make-up gain to increase the perceived loudness of an audio recording during the audio mastering process.
Low Pass Filter...: Low Pass Filter... none Passes frequencies below its cutoff frequency and attenuates frequencies above its cutoff frequency.
Notch Filter...: Notch Filter... none Greatly attenuate ("notch out"), a narrow frequency band. This is a good way to remove mains hum or a whistle confined to a specific frequency with minimal damage to the remainder of the audio.
SC4...: SC4... none This effect is a stereo compressor with a variable envelope follower for RMS (average) / peak behavior.
Spectral edit multi tool: Spectral edit multi tool none When the selected track is in spectrogram or spectrogram log(f) view, applies a notch filter, high pass filter or low pass filter according to the spectral selection made. This effect can also be used to change the audio quality as an alternative to using Equalization.
Spectral edit parametric EQ...: Spectral edit parametric EQ... none When the selected track is in spectrogram or spectrogram log(f) view and the spectral selection has a center frequency and an upper and lower boundary, performs the specified band cut or band boost. This can be used as an alternative to Equalization or may also be useful to repair damaged audio by reducing frequency spikes or boosting other frequencies to mask spikes.
Spectral edit shelves...: Spectral edit shelves... none When the selected track is in spectrogram or spectrogram log(f) view, applies either a low- or high-frequency shelving filter or both filters, according to the spectral selection made. This can be used as an alternative to Equalization or may also be useful to repair damaged audio by reducing frequency spikes or boosting other frequencies to mask spikes.
Studio Fade Out: Studio Fade Out none Applies a more musical fade out to the selected audio, giving a more pleasing sounding result.
Tremolo...: Tremolo... none Modulates the volume of the selection at the depth and rate selected in the dialog. The same as the tremolo effect familiar to guitar and keyboard players.
Vocal Reduction and Isolation...: Vocal Reduction and Isolation... none Attempts to remove or isolate center-panned audio from a stereo track. Most "Remove" options in this effect preserve the stereo image.
Vocal Remover...: Vocal Remover... none (Legacy effect) Attempts to remove center-panned vocals from a stereo track. The output from this effect will always be mono. Help text is available from within the dialog.
Vocoder...: Vocoder... none Synthesizes audio (usually a voice) in the left channel of a stereo track with a carrier wave (typically white noise) in the right channel to produce a modified version of the left channel. Vocoding a normal voice with white noise will produce a robot-like voice for special effects.

Analyze Menu

Analyze
Automation Id Action Parameters Description
ManageAnalyzers: Add / Remove Plug-ins... none Selecting this option from the Effect Menu (or the Generate Menu or Analyze Menu) takes you to a dialog where you can enable or disable particular Effects, Generators and Analyzers in Audacity. Even if you do not add any third-party plug-ins, you can use this to make the Effect menu shorter or longer as required. For details see Add / Remove Effects, Generators and Analyzers.
ContrastAnalyser: Contrast... none Analyzes a single mono or stereo speech track to determine the average RMS difference in volume (contrast) between foreground speech and background music, audience noise or similar. The purpose is to determine if the speech will be intelligible to the hard of hearing.
PlotSpectrum: Plot Spectrum... none Takes the selected audio (which is a set of sound pressure values at points in time) and converts it to a graph of frequencies against amplitudes.
FindClipping: Find Clipping... int Duty Cycle Start, (default:3)

int Duty Cycle End, (default:3)

Creates labels where clipping is detected
Beat Finder...: Beat Finder... none Attempts to place labels at beats which are much louder than the surrounding audio. It's a fairly rough and ready tool, and will not necessarily work well on a typical modern pop music track with compressed dynamic range. If you do not get enough beats detected, try reducing the "Threshold Percentage" setting.
Regular Interval Labels...: Regular Interval Labels... none Places labels in a long track so as to divide it into smaller, equally sized segments.
Sample Data Export...: Sample Data Export... none Reads the values of successive samples from the selected audio and prints this data to a plain text, CSV or HTML file. Further information may be added as a "header" at the top of the file.
Silence Finder...: Silence Finder... none Divides up a track by placing point labels inside areas of silence.
Sound Finder...: Sound Finder... none Divides up a track by placing region labels for areas of sound that are separated by silence.

Help Menu

Gives help on a command.
Automation Id Action Parameters Description
QuickHelp: Quick Help none A brief version of help with some of the most essential information.
Manual: Manual none Opens the manual in the default browser.
Updates: Check for Updates... none Checks online to see if this is the latest version of Audacity.
About: About Audacity... none Brings a dialog with information about Audacity, such as who wrote it, what features are enabled and the GNU GPL v2 license.

Help: Tools

Takes you to Screenshot tools and Benchmarking
Automation Id Action Parameters Description
FancyScreenshot: Screenshot Tools... none A tool, mainly used in documentation, to capture screenshots of Audacity.
Benchmark: Run Benchmark... none A tool for measuring the performance of one part of Audacity.

Help: Diagnostics

A set of diagnostic tools
Automation Id Action Parameters Description
DeviceInfo: Audio Device Info... none Shows technical information about your detected audio device(s).
MidiDeviceInfo: MIDI Device Info... none Shows technical information about your detected MIDI device(s).
Log: Show Log... none Launches the "Audacity Log" window, the log is largely a debugging aid, having timestamps for each entry
CrashReport: Generate Support Data... none Selecting this will generate a Debug report which could be useful in aiding the developers to identify bugs in Audacity or in third-party plug-ins
CheckDeps: Check Dependencies... none Lists any WAV or AIFF audio files that your project depends on, and allows you to copy these files into the project

Extra Menu

Extra optional commands.
Automation Id Action Parameters Description
FullScreenOnOff: Full screen (on/off) none Toggle full screen mode with no title bar

Extra: Transport

Extra commands related to play and record
Automation Id Action Parameters Description
Play: Play none Play (or stop) audio
Stop: Stop none Stop audio
PlayOneSec: Play One Second none Plays for one second centered on the current mouse pointer position (not from the current cursor position). See this page for an example.
PlayToSelection: Play To Selection none Plays to or from the current mouse pointer position to or from the start or end of the selection, depending on the pointer position. See this page for more details.
PlayBeforeSelectionStart: Play Before Selection Start none Plays a short period before the start of the selected audio, the period before shares the setting of the cut preview.
PlayAfterSelectionStart: Play After Selection Start none Plays a short period after the start of the selected audio, the period after shares the setting of the cut preview.
PlayBeforeSelectionEnd: Play Before Selection End none Plays a short period before the end of the selected audio, the period before shares the setting of the cut preview.
PlayAfterSelectionEnd: Play After Selection End none Plays a short period after the end of the selected audio, the period after shares the setting of the cut preview.
PlayBeforeAndAfterSelectionStart: Play Before and After Selection Start none Plays a short period before and after the start of the selected audio, the periods before and after share the setting of the cut preview.
PlayBeforeAndAfterSelectionEnd: Play Before and After Selection End none Plays a short period before and after the end of the selected audio, the periods before and after share the setting of the cut preview.
PlayCutPreview: Play Cut Preview none Plays audio excluding the selection

Extra: Tools

Extra commands to select the tool, e.g. time-shift, envelopes, multi-tool.
Automation Id Action Parameters Description
SelectTool: Selection Tool none Chooses Selection tool.
EnvelopeTool: Envelope Tool none Chooses Envelope tool.
DrawTool: Draw Tool none Chooses Draw tool.
ZoomTool: Zoom Tool none Chooses Zoom tool.
TimeShiftTool: Time Shift Tool none Chooses Time Shift tool.
MultiTool: Multi Tool none Chooses the Mulit-Tool
PrevTool: Previous Tool none Cycles backwards through the tools, starting from the currently selected tool: starting from Selection, it would navigate to Multi-tool to Time Shift to Zoom to Draw to Envelope to Selection.
NextTool: Next Tool none Cycles forwards through the tools, starting from the currently selected tool: starting from Selection, it would navigate to Envelope to Draw to Zoom to Time Shift to Multi-tool to Selection.

Extra: Mixer

Extra commands related to volume
Automation Id Action Parameters Description
OutputGain: Adjust playback volume none Displays the Playback Volume dialog. You can type a new value for the playback volume (between 0 and 1), or press Tab, then use the left and right arrow keys to adjust the slider.
OutputGainInc: Increase playback volume none Each key press will increase the playback volume by 0.1.
OutputGainDec: Decrease playback volume none Each key press will decrease the playback volume by 0.1.
InputGain: Adjust recording volume none Displays the Recording Volume dialog. You can type a new value for the recording volume (between 0 and 1), or press Tab, then use the left and right arrow keys to adjust the slider.
InputGainInc: Increase recording volume none Each key press will increase the recording volume by 0.1.
InputGainDec: Decrease recording volume none Each key press will decrease the recording volume by 0.1.

Extra: Edit

Extra commands related to editing
Automation Id Action Parameters Description
DeleteKey: DeleteKey none Deletes the selection. When focus is in Selection Toolbar, BACKSPACE is not a shortcut but navigates back to the previous digit and sets it to zero.
DeleteKey2: DeleteKey2 none Deletes the selection.

Extra: Transcription

Extra commands related to play at speed
Automation Id Action Parameters Description
PlayAtSpeed: Play-at-Speed none Play audio at a faster or slower speed
PlayAtSpeedLooped: Loop Play-at-Speed none Combines looped play and play at speed
PlayAtSpeedCutPreview: Play Cut Preview-at-Speed none Combines cut preview and play at speed
SetPlaySpeed: Adjust playback speed none Displays the Playback Speed dialog. You can type a new value for the playback volume (between 0 and 1), or press Tab, then use the left and right arrow keys to adjust the slider.
PlaySpeedInc: Increase playback speed none Each key press will increase the playback speed by 0.1.
PlaySpeedDec: Decrease playback speed none Each key press will decrease the playback speed by 0.1.
MoveToPrevLabel: Move to Previous Label none Moves selection to the previous label
MoveToNextLabel: Move to Next Label none Moves selection to the next label

Extra: Seek

Extra commands related to seeking
Automation Id Action Parameters Description
SeekLeftShort: Short seek left during playback none Skips the playback cursor back one second by default.
SeekRightShort: Short seek right during playback none Skips the playback cursor forward one second by default.
SeekLeftLong: Long seek left during playback none Skips the playback cursor back 15 seconds by default.
SeekRightLong: Long Seek right during playback none Skips the playback cursor forward 15 seconds by default.

Extra: Device

Extra commands related to selecting a device
Automation Id Action Parameters Description
InputDevice: Change recording device none Displays the Select recording Device dialog for choosing the recording device, but only if the "Recording Device" dropdown menu in Device Toolbar has entries for devices. Otherwise, an recording error message will be displayed.
OutputDevice: Change playback device none Displays the Select Playback Device dialog for choosing the playback device, but only if the "Playback Device" dropdown menu in Device Toolbar has entries for devices. Otherwise, an error message will be displayed.
AudioHost: Change audio host none Displays the Select Audio Host dialog for choosing the particular interface with which Audacity communicates with your chosen playback and recording devices.
InputChannels: Change recording channels none Displays the Select Recording Channels dialog for choosing the number of channels to be recorded by the chosen recording device.

Extra: Selection

Extra commands related to selecting.
Automation Id Action Parameters Description
SnapToOff: Snap To Off none Equivalent to setting the Snap To control in Selection Toolbar to "Off".
SnapToNearest: Snap To Nearest none Equivalent to setting the Snap To control in Selection Toolbar to "Nearest".
SnapToPrior: Snap To Prior none Equivalent to setting the Snap To control in Selection Toolbar to "Prior".
SelStart: Selection to Start none Select from cursor to start of track
SelEnd: Selection to End none Select from cursor to end of track
SelExtLeft: Selection Extend Left none Increases the size of the selection by extending it to the left. The amount of increase is dependent on the zoom level. If there is no selection one is created starting at the cursor position.
SelExtRight: Selection Extend Right none Increases the size of the selection by extending it to the right. The amount of increase is dependent on the zoom level. If there is no selection one is created starting at the cursor position.
SelSetExtLeft: Set (or Extend) Left Selection none Extend selection left a little (is this a duplicate?)
SelSetExtRight: Set (or Extend) Right Selection none Extend selection right a litlle (is this a duplicate?)
SelCntrLeft: Selection Contract Left none Decreases the size of the selection by contracting it from the right. The amount of decrease is dependent on the zoom level. If there is no selection no action is taken.
SelCntrRight: Selection Contract Right none Decreases the size of the selection by contracting it from the left. The amount of decrease is dependent on the zoom level. If there is no selection no action is taken.

Extra: Focus

Extra commands to set focus, usually focus on one track
Automation Id Action Parameters Description
PrevFrame: Move backward from toolbars to tracks none Move backward through currently focused toolbar in Upper Toolbar dock area, Track View and currently focused toolbar in Lower Toolbar dock area. Each use moves the keyboard focus as indicated.
NextFrame: Move forward from toolbars to tracks none Move forward through currently focused toolbar in Upper Toolbar dock area, Track View and currently focused toolbar in Lower Toolbar dock area. Each use moves the keyboard focus as indicated.
PrevTrack: Move Focus to Previous Track none Focus one track up
NextTrack: Move Focus to Next Track none Focus one track down
FirstTrack: Move Focus to First Track none Focus on first track
LastTrack: Move Focus to Last Track none Focus on last track
ShiftUp: Move Focus to Previous and Select none Focus one track up and select it
ShiftDown: Move Focus to Next and Select none Focus one track down and select it
Toggle: Toggle Focused Track none Toggle focus on current track
ToggleAlt: Toggle Focused Track none Toggle focus on current track

Extra: Cursor

Extra commands to move the cursor
Automation Id Action Parameters Description
CursorLeft: Cursor Left none When not playing audio, moves the editing cursor one screen pixel to left. When a Snap To option is chosen, moves the cursor to the preceding unit of time as determined by the current selection format. If the key is held down, the cursor speed depends on the length of the tracks. When playing audio, moves the playback cursor as described at "Cursor Short Jump Left"
CursorRight: Cursor Right none When not playing audio, moves the editing cursor one screen pixel to right. When a Snap To option is chosen, moves the cursor to the following unit of time as determined by the current selection format. If the key is held down, the cursor speed depends on the length of the tracks. When playing audio, moves the playback cursor as described at "Cursor Short Jump Right"
CursorShortJumpLeft: Cursor Short Jump Left none When not playing audio, moves the editing cursor one second left by default. When playing audio, moves the playback cursor one second left by default. The default value can be changed by adjusting the "Short Period" under "Seek Time when playing" in Playback Preferences.
CursorShortJumpRight: Cursor Short Jump Right none When not playing audio, moves the editing cursor one second right by default. When playing audio, moves the playback cursor one second right by default. The default value can be changed by adjusting the "Short Period" under "Seek Time when playing" in Playback Preferences.
CursorLongJumpLeft: Cursor Long Jump Left none When not playing audio, moves the editing cursor 15 seconds left by default. When playing audio, moves the playback cursor 15 seconds left by default. The default value can be changed by adjusting the "Long Period" under "Seek Time when playing" in Playback Preferences.
CursorLongJumpRight: Cursor Long Jump Right none When not playing audio, moves the editing cursor 15 seconds right by default. When playing audio, moves the playback cursor 15 seconds right by default. The default value can be changed by adjusting the "Long Period" under "Seek Time when playing" in Playback Preferences.
ClipLeft: Clip Left none Moves the currently focused audio track (or a separate clip in that track which contains the editing cursor or selection region) one screen pixel to left.
ClipRight: Clip Right none Moves the currently focused audio track (or a separate clip in that track which contains the editing cursor or selection region) one screen pixel to right.

Extra: Track

Extra commands to operate on a track that has focus
Automation Id Action Parameters Description
TrackPan: Change pan on focused track none Brings up the Pan dialog for the focused track where you can enter a pan value, or use the slider for finer control of panning than is available when using the track pan slider.
TrackPanLeft: Pan left on focused track none Controls the pan slider on the focused track. Each keypress changes the pan value by 10% left.
TrackPanRight: Pan right on focused track none Controls the pan slider on the focused track. Each keypress changes the pan value by 10% right.
TrackGain: Change gain on focused track none Brings up the Gain dialog for the focused track where you can enter a gain value, or use the slider for finer control of gain than is available when using the track pan slider.
TrackGainInc: Increase gain on focused track none Controls the gain slider on the focused track. Each keypress increases the gain value by 1 dB.
TrackGainDec: Decrease gain on focused track none Controls the gain slider on the focused track. Each keypress decreases the gain value by 1 dB.
TrackMenu: Open menu on focused track none Opens the Audio Track Dropdown Menu on the focused audio track or other track type. In the audio track dropdown, use Up, and Down, arrow keys to navigate the menu and Enter, to select a menu item. Use Right, arrow to open the "Set Sample Format" and "Set Rate" choices or Left, arrow to leave those choices.
TrackMute: Mute/Unmute focused track none Toggles the Mute button on the focused track.
TrackSolo: Solo/Unsolo focused track none Toggles the Solo button on the focused track.
TrackClose: Close focused track none Close (remove) the focused track only.
TrackMoveUp: Move focused track up none Moves the focused track up by one track and moves the focus there.
TrackMoveDown: Move focused track down none Moves the focused track down by one track and moves the focus there.
TrackMoveTop: Move focused track to top none Moves the focused track up to the top of the track table and moves the focus there.
TrackMoveBottom: Move focused track to bottom none Moves the focused track down to the bottom of the track table and moves the focus there.

Extra: Automation

No special notes for Automation
Automation Id Action Parameters Description
Screenshot: Screenshot (Vanilla)... string Path, (default:)

enum CaptureWhat, (default:Window)

  • Window
  • Full_Window
  • Window_Plus
  • Fullscreen
  • Toolbars
  • Menus
  • Effects
  • Preferences
  • Selectionbar
  • Spectral_Selection
  • Tools
  • Transport
  • Mixer
  • Meter
  • Play_Meter
  • Record_Meter
  • Edit
  • Device
  • Scrub
  • Transcription
  • Trackpanel
  • Ruler
  • Tracks
  • First_Track
  • Second_Track
  • Tracks_Plus
  • First_Track_Plus
  • First_Two_Tracks
  • First_Three_Tracks
  • First_Four_Tracks

enum Background, (default:None)

  • Blue
  • White
  • None
Takes screenshots.
CompareAudio: Compare Audio... float Threshold, (default:0)
Compares a range on two tracks.
GetPreference: Get Preference... string Name, (default:)
Gets the value of a single preference.
GetInfo: Get Info... enum Type, (default:0)
  • Commands
  • Commands+
  • Menus
  • Tracks
  • Clips
  • Labels
  • Boxes

enum Format, (default:0)

  • JSON
  • LISP
  • Brief
Gets information in JSON format.
Select: Select... double Start, (default:0)

double End, (default:0)
bool FromEnd, (default:False)
int First, (default:0)
int Last, (default:0)
enum Mode, (default:0)

  • Set
  • Add
  • Remove
Selects Audio.
SetPreference: Set Preference... string Name, (default:)

string Value, (default:)
bool Reload, (default:False)

Sets the value of a single preference.
SetClip: Set Clip... int Clip, (default:0)

enum Color, (default:unchanged)

  • Color0
  • Color1
  • Color2
  • Color3

double Start, (default:unchanged)

Sets various values for a clip.
SetLabel: Set Label... int Label, (default:0)

string Text, (default:unchanged)
double Start, (default:unchanged)
double End, (default:unchanged)
bool Selected, (default:unchanged)

Sets various values for a label.
SetProject: Set Project... string Name, (default:unchanged)

int X, (default:unchanged)
int Y, (default:unchanged)
int Width, (default:unchanged)
int Height, (default:unchanged)

Sets various values for a project.
SetTrack: Set Track... int Track, (default:0)

string Name, (default:unchanged)
double Pan, (default:unchanged)
double Gain, (default:unchanged)
int Height, (default:unchanged)
enum Color, (default:unchanged)

  • Color0
  • Color1
  • Color2
  • Color3

bool Selected, (default:unchanged)
bool Focused, (default:unchanged)
bool Solo, (default:unchanged)
bool Mute, (default:unchanged)

Sets various values for a track.