Está en la página 1de 46

8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Referencia de secuencias de comandos


Del manual de desarrollo de Audacity
Saltar a navegación , búsqueda

Esta página enumera los comandos de secuencias de comandos.

Sí, estos son los mismos comandos que en los menús , los mismos que en "Comandos y accesos directos"
también, solo que se presentan de manera diferente.

Presentado en un formato útil para las personas que utilizan:


Macros o
Secuencias de comandos de Python o
AUD-DO .
La mayor parte de esta página se genera automáticamente.

Algunos comandos se omiten intencionalmente del Administrador de macros (como "Cerrar:") porque no son
adecuados para su uso en macros.

Esta tabla muestra los elementos de los menús que se pueden programar.

Es probable que los ID de secuencias de comandos, los parámetros y los valores


predeterminados cambien entre las versiones.
Los valores booleanos se deben dar como 1 (verdadero) o 0 (falso).

Menú Archivo
El menú Archivo proporciona comandos para crear, abrir y guardar proyectos de Audacity e importar y exportar
archivos de audio.
ID de
secuencia de Acción Parámetros Descripción
comandos
Crea una nueva ventana de proyecto vacía,
Nuevo: Nuevo ninguno para comenzar a trabajar en pistas nuevas o
importadas.
Presenta un cuadro de diálogo estándar
donde puede seleccionar archivos de audio,
Abierto: Abierto... ninguno
una lista de archivos (.LOF) o un archivo de
proyecto Audacity para abrir.
Cierra la ventana del proyecto actual y le
Cerrar: Cerrar ninguno solicita que guarde su trabajo si no lo ha
guardado.
Guardar Guardar
ninguno Varias formas de guardar un proyecto.
proyecto: proyecto
Proyecto Proyecto ninguno Compacte su proyecto para ahorrar espacio
compacto: compacto en disco.
https://manual.audacityteam.org/man/scripting_reference.html 1/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Configuración Abre el cuadro de diálogo Configuración de


PageSetup: ninguno
de página ... página estándar antes de imprimir
Imprime todas las formas de onda en la
ventana del proyecto actual (y el contenido
Impresión: Impresión... ninguno de Label Tracks u otras pistas), con la línea
de tiempo arriba. Todo se imprime en una
página.
Cierra todas las ventanas del proyecto y sale
de Audacity. Si hay cambios sin guardar en
Salida: Salida ninguno
su proyecto, Audacity le preguntará si desea
guardarlos.

Archivo: Guardar proyecto

Varias formas de guardar un proyecto.


ID de secuencia
Acción Parámetros Descripción
de comandos
Guardar Guarda el archivo .AUP3 del proyecto
Ahorrar: ninguno
proyecto Audacity actual.
Igual que "Guardar proyecto" anterior,
Guardar
pero le permite guardar una copia de un
Guardar como: proyecto ninguno
como... proyecto abierto con un nombre o
ubicación diferente
Guardar copia
Guarda el archivo .AUP3 del proyecto
SaveCopy: sin pérdidas del ninguno
proyecto ... Audacity actual.
Guardar copia Guarda en el formato de archivo de
SaveCompressed: comprimida del ninguno proyecto audacity .aup3, pero comprimido
proyecto ... (Adecuado para envío por correo)

Archivo: Exportar

Para exportar archivos de audio


ID de
secuencia de Acción Parámetros Descripción
comandos
Exportar como
ExportMp3: ninguno Exporta a un archivo MP3
MP3
Exportar como
ExportWav: ninguno Exporta a un archivo WAV
WAV
Exportar como
ExportOgg: ninguno Exportaciones a un archivo OGG
OGG
Exportar audio
Exportar: ninguno Exporta a un archivo de audio.
...
Exportar audio
ExportSel: ninguno Exporta el audio seleccionado a un archivo.
seleccionado ...
ExportLabels: Exportar ninguno Exporta audio en una o más etiquetas a
https://manual.audacityteam.org/man/scripting_reference.html 2/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

etiquetas ... archivos.


Exporta varios archivos de audio en un
proceso, un archivo para cada pista si hay
Exportación Exportar varios
ninguno varias pistas de audio, o se pueden agregar
Múltiple: ...
etiquetas que luego definen la longitud de
cada archivo exportado.
Exportar MIDI Exporta MIDI (pistas de notas) a un archivo
ExportMIDI: ninguno
... MIDI.

Archivo: Importar

Para importar archivos de audio o archivos de etiquetas en su proyecto


ID de
secuencia de Acción Parámetros Descripción
comandos
Similar a 'Abrir', excepto que el archivo se
ImportAudio: Audio... ninguno agrega como una nueva pista a su proyecto
existente.
Abre una ventana de selección de archivos
donde puede elegir importar un solo archivo
de texto al proyecto que contiene etiquetas
ImportLabels: Etiquetas... ninguno de puntos o regiones . Para obtener más
información sobre la sintaxis de los archivos
de etiquetas, consulte Importación y
exportación de etiquetas .
Importa un archivo MIDI ( extensión MIDI
o MID ) o Allegro (GRO) a una pista de
nota donde se pueden realizar ediciones
simples de cortar y pegar. El resultado se
ImportMIDI: MIDI ... ninguno
puede exportar con el comando Archivo>
Exportar>> Exportar MIDI . Nota:
Actualmente, los archivos MIDI y Allegro
no se pueden reproducir.
Los intentos de importar un archivo de
audio sin comprimir que pueden ser datos
"sin procesar" sin encabezados para definir
su formato, pueden tener encabezados
ImportRaw: Datos brutos ... ninguno
incorrectos o estar parcialmente corruptos, o
pueden estar en un formato que Audacity no
puede reconocer. No se pueden importar
datos sin procesar en formato textual.

Menú de edición
El menú Editar proporciona comandos de edición estándar (Deshacer, Rehacer, Cortar, Copiar, Pegar y Eliminar)
además de muchos otros comandos específicos para editar audio o etiquetas.

https://manual.audacityteam.org/man/scripting_reference.html 3/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

ID de Acción Parámetros Descripción


secuencia de
comandos
Deshacer: Deshacer ninguno Deshace la acción de edición más reciente.
Rehace la última acción de edición
Rehacer: Rehacer ninguno
deshecha.
Elimina los datos y / o etiquetas de audio
seleccionados y los coloca en el
portapapeles de Audacity. De forma
Corte: Corte ninguno
predeterminada, cualquier audio o etiqueta a
la derecha de la selección se desplaza hacia
la izquierda.
Elimina los datos y / o etiquetas de audio
seleccionados sin copiarlos al portapapeles
Borrar: Borrar ninguno de Audacity. De forma predeterminada,
cualquier audio o etiqueta a la derecha de la
selección se desplaza hacia la izquierda.
Copia los datos de audio seleccionados al
Dupdo: Dupdo ninguno portapapeles de Audacity sin eliminarlos del
proyecto.
Inserta lo que esté en el portapapeles de
Audacity en la posición del cursor de
Pegar: Pegar ninguno selección en el proyecto, reemplazando los
datos de audio actualmente seleccionados, si
los hay.
Crea una nueva pista que contiene solo la
Duplicar: Duplicar ninguno
selección actual como un nuevo clip.
El editor de metadatos modifica la
información sobre una pista, como el artista
EditMetaData: Metadatos ... ninguno
y el género. Normalmente se utiliza con
archivos MP3.
Las preferencias le permiten cambiar la
mayoría de los comportamientos y
configuraciones predeterminados de
Preferencias: Preferencias ... ninguno
Audacity. En Mac, las preferencias están en
el menú Audacity y el acceso directo por
defecto es ⌘ +, .

Editar: Eliminar especial


Para una eliminación de audio más "avanzada"
ID de
secuencia de Acción Parámetros Descripción
comandos
SplitCut: Corte dividido ninguno Igual que Cortar, pero ninguno de los datos
de audio o etiquetas a la derecha de la
https://manual.audacityteam.org/man/scripting_reference.html 4/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

selección se desplaza.
Igual que Eliminar, pero no se desplaza
Dividir
SplitDelete: ninguno ninguno de los datos de audio o etiquetas a
Eliminar
la derecha de la selección.
Reemplaza el audio seleccionado
Silencio: Silenciar audio ninguno actualmente con silencio absoluto. No
afecta a las pistas de etiquetas.
Elimina todo el audio excepto la selección.
Si hay otros clips separados en la misma
Podar: Recortar audio ninguno pista, estos no se eliminan ni se desplazan a
menos que se recorten la longitud completa
de un clip o clips. No afecta a las pistas de
etiquetas.

Editar: Límites de clip

Cree o elimine clips separados en la pista de audio. Un clip dentro de una pista de audio es una sección separada
de esa pista que se ha dividido para que pueda manipularse de forma algo independiente de los otros clips de la
pista.
ID de
secuencia de Acción Parámetros Descripción
comandos
Divide el clip actual en dos clips en el punto
Separar: Separar ninguno del cursor o en tres clips en los límites de
selección.
Hace un corte dividido en la selección
actual en la pista actual, luego crea una
SplitNuevo: Split nuevo ninguno
nueva pista y pega la selección en la nueva
pista.
Si selecciona un área que se superpone a
uno o más clips, todos se unirán en un clip
Entrar: Entrar ninguno
grande. Las regiones intermedias entre clips
se vuelven silenciosas.
En una región de selección que incluye
silencios absolutos, crea clips individuales
Separarse en los
Separar: ninguno no silenciosos entre las regiones de silencio.
silencios
El silencio se convierte en un espacio en
blanco entre los clips.

Editar: etiquetas

Estos comandos sirven para agregar y editar etiquetas.


ID de secuencia de
Acción Parámetros Descripción
comandos
EditLabels: Editar etiquetas ninguno Muestra un cuadro de diálogo que
... muestra todas sus etiquetas en una vista

https://manual.audacityteam.org/man/scripting_reference.html 5/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

tabular accesible desde el teclado. Los


prácticos botones del cuadro de diálogo
le permiten insertar o eliminar una
etiqueta, o importar y exportar etiquetas
a un archivo. Consulte Editor de
etiquetas para obtener más detalles.
Agregar
Crea una nueva etiqueta vacía en el
AddLabel: etiqueta en la ninguno
selección cursor o en la región de selección.
Agregar Crea una etiqueta nueva y vacía en la
etiqueta en la
AddLabelPlaying: ninguno posición actual de reproducción o
posición de
reproducción grabación.
Pega el texto en el portapapeles de
Audacity en la posición del cursor en la
pista de etiquetas seleccionada
actualmente. Si no hay ninguna selección
Pegar texto en
en la pista de etiquetas, se crea una
PasteNewLabel: una etiqueta ninguno
nueva etiqueta de punto. Si se selecciona una
región en la pista de etiquetas, se crea
una etiqueta de región. Si no se
selecciona ninguna pista de etiqueta, se
crea una y se crea una nueva etiqueta.
Escriba para Cuando una pista de etiqueta tiene el
crear una borde de enfoque amarillo, si esta opción
TypeToCreateLabel: etiqueta ninguno está activada, simplemente escriba para
(activar / crear una etiqueta. De lo contrario,
desactivar) primero debe crear una etiqueta.

Editar: audio etiquetado

Los comandos de audio etiquetados aplican comandos estándar del menú Editar al audio de una o más regiones
etiquetadas. Las etiquetas en sí mismas no se ven afectadas.
ID de secuencia
Acción Parámetros Descripción
de comandos
Igual que el comando Cortar, pero opera
CutLabels: Corte ninguno
en regiones de audio etiquetadas.
Igual que el comando Eliminar, pero opera
DeleteLabels: Borrar ninguno
en regiones de audio etiquetadas.
Igual que el comando Split Cut, pero
SplitCutLabels: Corte dividido ninguno
funciona en regiones de audio etiquetadas.
Dividir Igual que el comando Split Delete, pero
SplitDeleteLabels: ninguno
Eliminar opera en regiones de audio etiquetadas.
Igual que el comando Silenciar audio, pero
SilenceLabels: Silenciar audio ninguno
funciona en regiones de audio etiquetadas.
Igual que el comando Copiar, pero opera
CopyLabels: Dupdo ninguno
en regiones de audio etiquetadas.
https://manual.audacityteam.org/man/scripting_reference.html 6/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

SplitLabels: Separar ninguno Igual que el comando Dividir, pero opera


en regiones o puntos de audio etiquetados.
Igual que el comando Unir, pero opera en
regiones o puntos de audio etiquetados. Es
JoinLabels: Entrar ninguno posible que deba seleccionar el audio y
usar Editar> Límites de recorte> Unir ,
para unir todas las regiones o puntos.
Igual que el comando Separar en silencio,
Separarse en
DisjoinLabels: ninguno pero funciona en regiones de audio
los silencios
etiquetadas.

Seleccione el menú
El menú Seleccionar tiene comandos que le permiten realizar selecciones de pistas o partes de las pistas en su
proyecto.
ID de secuencia de
Acción Parámetros Descripción
comandos
Seleccionar todo: Todos ninguno Selecciona todo el audio en todas las
pistas.
Seleccione Ninguno: Ninguno ninguno Deselecciona todo el audio en todas las
pistas.
Cursor a la Selecciona desde la posición del cursor
posición
SelCursorStoredCursor: ninguno hasta la posición del cursor
almacenada del
cursor almacenada previamente
Almacenar
Stores the current cursor position for
StoreCursorPosition: posición del ninguno
use in a later selection
cursor
Moves the edges of a selection region
At Zero
ZeroCross: none (or the cursor position) slightly so they
Crossings
are at a rising zero crossing point.

Select: Tracks

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

Select: Region
For modifying, saving and restoring a selection.
Scripting Id Action Parameters Description
SetLeftSelection: Left at none When Audacity is playing, recording
Playback or paused, sets the left boundary of a
https://manual.audacityteam.org/man/scripting_reference.html 7/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Position 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.

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).

Right at Otherwise, opens the "Set Right


SetRightSelection: Playback none Selection Boundary" dialog for
Position 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.

Selects a region in the selected track(s)


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

Select: Spectral

For making a selection of a frequency range.


Scripting Id Action Parameters Description
https://manual.audacityteam.org/man/scripting_reference.html 8/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

ToggleSpectralSelection: Toggle none Changes between selecting a time


Spectral range and selecting the last selected
Selection 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.
When in Spectrogram view, snaps
Next Higher
the center frequency to the next
NextHigherPeakFrequency: Peak none
higher frequency peak, moving the
Frequency
spectral selection upwards.
When in Spectrogram views snaps
Next Lower
the center frequency to the next
NextLowerPeakFrequency: Peak none
lower frequency peak, moving the
Frequency
spectral selection downwards.

Select: Clip Boundaries

For modifying a selection, taking account of clips.


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

View Menu
View Menu has commands that determine the amount of detail you see in all the tracks in the project window. It
also lets you show or hide Toolbars and some additional windows such as Undo History.
Scripting Id Action Parameters Description
Brings up the History window which can
then be left open while using Audacity
UndoHistory: History... none normally. History lists all undoable
actions performed in the current project,
including importing.
Brings up the Karaoke window, which
Karaoke: Karaoke... none displays the labels in a "bouncing ball"
scrolling display
Mixer Board is an alternative view to the
audio tracks in the main tracks window.
MixerBoard: Mixer Board... none Analogous to a hardware mixer board,
each audio track is displayed in a Track
Strip.
https://manual.audacityteam.org/man/scripting_reference.html 9/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

ShowExtraMenus: Extra Menus none Shows extra menus with many extra less-
(on/off) used commands.
Show Clipping Option to show or not show audio that is
ShowClipping: none
(on/off) 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.
Scripting Id Action Parameters Description
Zooms in on the horizontal axis of the
ZoomIn: Zoom In none audio displaying more detail over a shorter
length of time.
Zooms to the default view which displays
ZoomNormal: Zoom Normal none
about one inch per second.
Zooms out displaying less detail over a
ZoomOut: Zoom Out none
greater length of time.
Zoom to Zooms in or out so that the selected audio
ZoomSel: none
Selection fills the width of the window.
Changes the zoom back and forth between
ZoomToggle: Zoom Toggle none
two preset levels.
Advanced
Enable for left-click gestures in the
AdvancedVZoom: Vertical none
vertical scale to control zooming.
Zooming

View: Track Size

Controls the sizes of tracks.


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

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

https://manual.audacityteam.org/man/scripting_reference.html 10/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

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

Transport Menu
Transport Menu commands let you play or stop, loop play, scrub play or record (including timed and sound
activated recordings).
Scripting Id Action Parameters Description
Rescan for audio devices connected to your
Rescan Audio computer, and update the playback and
RescanDevices: none
Devices recording dropdown menus in Device
Toolbar

https://manual.audacityteam.org/man/scripting_reference.html 11/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Transport: Playing

These commands control playback in Audacity. You can Start, Stop or Pause playback of the audio in your
project.
Scripting Id Action Parameters Description
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
PlayStop: Play/Stop none
"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.
Starts playback like "Play/Stop", but
stopping playback sets the restart position to
the stop point. When stopped, this command
Play/Stop and
PlayStopSelect: none is the same as "Play/Stop". When playing,
Set Cursor
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.
Temporarily pauses playing or recording
Pause: Pause none
without losing your place.

Transport: Recording

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.
Scripting Id Action Parameters Description
Starts recording at the end of the currently
Record1stChoice: Record none
selected track(s).
Recording begins on a new track at either
Record New
Record2ndChoice: none the current cursor location or at the
Track
beginning of the current selection.
TimerRecord: Timer Record... none Brings up the Timer Record dialog.
Punch and Roll Re-record over audio, with a pre-roll of
PunchAndRoll: none
Record audio that comes before.
Temporarily pauses playing or recording
Pause: Pause none
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.
Scripting Id Action Parameters Description
Scrubbing is the action of moving the
mouse pointer right or left so as to adjust
Scrub: Scrub none the position, speed or direction of
playback, listening to the audio at the
same time.
https://manual.audacityteam.org/man/scripting_reference.html 12/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

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.
Shows (or hides) the scrub ruler, which is
ToggleScrubRuler: Scrub Ruler none
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
Scripting Id Action Parameters Description
Moves the left edge of the current
CursSelStart: Selection Start none selection to the center of the screen,
without changing the zoom level.
Moves the right edge of the current
CursSelEnd: Selection End none selection to the center of the screen,
without changing the zoom level.
Moves the cursor to the start of the
CursTrackStart: Track Start none
selected track.
Moves the cursor to the end of the
CursTrackEnd: Track End none
selected track.
Previous Clip Moves the cursor position back to the
CursPrevClipBoundary: none
Boundary right-hand edge of the previous clip
Next Clip Moves the cursor position forward to
CursNextClipBoundary: none
Boundary the left-hand edge of the next clip
Moves the cursor to the beginning of
CursProjectStart: Project Start none
the project.
Moves the cursor to the end of the
CursProjectEnd: Project End none
project.

Transport: Play Region


These commands enable you to lock a play region and unlock it
Scripting Id Action Parameters Description
Locks standard playback to the current
LockPlayRegion: Lock none 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
Scripting Id Action Parameters Description
Sound
Sets the activation level above which
SoundActivationLevel: Activation none
Sound Activated Recording will record.
Level...
Sound
Activated Toggles on and off the Sound Activated
SoundActivation: none
Recording Recording option.
(on/off)
https://manual.audacityteam.org/man/scripting_reference.html 13/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

PinnedHead: Pinned none You can change Audacity to play and


Play/Record record with a fixed head pinned to the
Head (on/off) Timeline. You can adjust the position of
the fixed head by dragging it
Overdub
Overdub: none Toggles on and off the Overdub option.
(on/off)
Software
Toggles on and off the Software
SWPlaythrough: Playthrough none
Playthrough option.
(on/off)

Tracks Menu
Tracks Menu provides commands for creating and removing tracks, applying operations to selected tracks such
as mixing, resampling or converting from stereo to mono, and lets you add or edit labels.
Scripting Id Action Parameters Description
Allows you to resample the selected track(s)
Resample: Resample... none
to a new sample rate for use in the project
Removes the selected track(s) from the
RemoveTracks: Remove Tracks none project. Even if only part of a track is
selected, the entire track is removed.
Ensures that length changes occurring
Sync-Lock anywhere in a defined group of tracks also
SyncLock: none
Tracks (on/off) take place in all audio or label tracks in that
group.

Tracks: Add New

Adds a new track


Scripting 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
Adds an empty time track to the project.
NewTimeTrack: Time Track none Time tracks are used to speed up and slow
down audio.

Tracks: Mix

Mixes down selected tracks to mono or stereo tracks


Scripting Id Action Parameters Description
Converts the selected stereo track(s)
Mix Stereo into the same number of mono
Stereo to Mono: Down to none tracks, combining left and right
Mono channels equally by averaging the
volume of both channels.
MixAndRender: Mix and none Mixes down all selected tracks to a
Render single mono or stereo track,
rendering to the waveform all real-
time transformations that had been
applied (such as track gain, panning,
https://manual.audacityteam.org/man/scripting_reference.html 14/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

amplitude envelopes or a change in


project rate).
Same as Tracks > Mix and Render
Mix and
except that the original tracks are
MixAndRenderToNewTrack: Render to none
preserved rather than being replaced
New Track
by the resulting "Mix" track.

Tracks: Mute/Unmute

Mutes or unmutes audio tracks in the project


Scripting Id Action Parameters Description
Mutes all the audio tracks in the project as
Mute All
MuteAllTracks: none if you had used the mute buttons from the
Tracks
Track Control Panel on each track.
Unmutes all the audio tracks in the project
Unmute All as if you had released the mute buttons
UnmuteAllTracks: none
Tracks from the Track Control Panel on each
track.
MuteTracks: Mute Tracks none Mutes the selected tracks.
UnmuteTracks: Unmute Tracks none Unmutes the selected tracks.

Tracks: Pan
Pans left right or center audio tracks in the project
Scripting 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.
Scripting Id Action Parameters Description
Aligns the selected tracks one after
Align End to
Align_EndToEnd: none the other, based on their top-to-
End
bottom order in the project window.
Align the selected tracks so that they
Align_Together: Align Together none start at the same (averaged) start
time.
Aligns the start of selected tracks
Align_StartToZero: Start to Zero none
with the start of the project.
Aligns the start of selected tracks
Start to
with the current cursor position or
Align_StartToSelStart: Cursor/Selection none
with the start of the current
Start
selection.
Start to Aligns the start of selected tracks
Align_StartToSelEnd: none
Selection End with the end of the current selection.
Align_EndToSelStart: End to none Aligns the end of selected tracks
Cursor/Selection with the current cursor position or
https://manual.audacityteam.org/man/scripting_reference.html 15/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Start with the start of the current


selection.
End to Selection Aligns the end of selected tracks
Align_EndToSelEnd: none
End with the end of the current selection.
Move Selection Toggles on/off the selection moving
MoveSelectionWithTracks: with Tracks none with the realigned tracks, or staying
(on/off) put.

Tracks: Sort Tracks


Sorts all tracks in the project from top to bottom in the project window, by Start Time or by Name.
Scripting 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 Menu lets you create audio containing tones, noise or silence.
Scripting Id Action Parameters Description
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,
Add / Remove Generators and Analyzers in Audacity.
ManageGenerators: none
Plug-ins... 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.
Shows the list of available Audacity
built-in effects but only if the user has
Built-in: Built-in none
effects "Grouped by Type" in Effects
Preferences.
Shows the list of available Nyquist effects
Nyquist: Nyquist none but only if the user has effects "Grouped
by Type" in Effects Preferences.

Generate: Built-in

Shows the list of available Audacity built-in effects but only if the user has effects "Grouped by Type" in Effects
Preferences.
Scripting Id Action Parameters Description
Chirp: Chirp... double StartFreq, (default:440)
Generates four different types of tone
waveforms like the Tone Generator, but
double EndFreq, (default:1320)
additionally allows setting of the starting
double StartAmp, (default:0.8)
and ending amplitude and frequency.
double EndAmp, (default:0.1)

enum Waveform, (default:Sine)

Sine
Square
https://manual.audacityteam.org/man/scripting_reference.html 16/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Sawtooth
Square, no alias

enum Interpolation,
(default:Linear)

Linear
Logarithmic

string Sequence,
(default:audacity)
Generates dual-tone multi-frequency
DtmfTones: DTMF Tones... (DTMF) tones like those produced by the
double Duty Cycle, (default:55)

keypad on telephones.
double Amplitude, (default:0.8)

enum Type, (default:White)

White
Noise: Noise... Pink Generates 'white', 'pink' or 'brown' noise.
Brownian

double Amplitude, (default:0.8)

double Frequency, (default:440)

double Amplitude, (default:0.8)

enum Waveform, (default:Sine)

Sine
Square Generates one of four different tone
Sawtooth waveforms: Sine, Square, Sawtooth or
Tone: Tone...
Square, no alias Square (no alias), and a frequency between
1 Hz and half the current project rate.
enum Interpolation,
(default:Linear)

Linear
Logarithmic

Generate: Nyquist

Shows the list of available Nyquist effects but only if the user has effects "Grouped by Type" in Effects
Preferences.
Scripting Id Action Parameters Description
int pitch, (default:0)

enum fade, (default:Abrupt)

A synthesized pluck tone with abrupt or


Pluck: Pluck... Abrupt gradual fade-out, and selectable pitch
Gradual corresponding to a MIDI note.

double dur, (default:0)

https://manual.audacityteam.org/man/scripting_reference.html 17/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

RhythmTrack: Rhythm Track... double tempo, (default:0)


Generates a track with regularly spaced
sounds at a specified tempo and number of
int timesig, (default:0)
beats per measure (bar).
double swing, (default:0)

int bars, (default:0)

double click-track-dur,
(default:0)

double offset, (default:0)

enum click-type,
(default:Metronome)

Metronome
Ping (short)
Ping (long)
Cowbell
ResonantNoise
NoiseClick
Drip (short)
Drip (long)

int high, (default:0)

int low, (default:0)

double freq, (default:0)

double decay, (default:0)

double cf, (default:0)

RissetDrum: Risset Drum... Produces a realistic drum sound.


double bw, (default:0)

double noise, (default:0)

double gain, (default:0)

Effect Menu
Audacity includes many built-in effects and also lets you use a wide range of plug-in effects.
Scripting Id Action Parameters Description
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
Add / Remove and Analyzers in Audacity. Even if you do
ManageEffects: none
Plug-ins... 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.
Repeat Last Repeats the last used effect at its last used
RepeatLastEffect: none
Effect settings and without displaying any dialog.
Shows the list of available LADSPA
LADSPA: LADSPA none effects but only if the user has effects
"Grouped by Type" in Effects Preferences.

https://manual.audacityteam.org/man/scripting_reference.html 18/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Effect: Built-in

No special notes for Built-in


Scripting Id Action Parameters Description
float Ratio, (default:0.9)

Increases or decreases the volume of


Amplify: Amplify... bool AllowClipping,
the audio you have selected.
(default:False)

double DuckAmountDb,
(default:-12)

double InnerFadeDownLen,
(default:0)

Reduces (ducks) the volume of one


double InnerFadeUpLen,
or more tracks whenever the volume
(default:0)

of a specified "control" track


double OuterFadeDownLen,
AutoDuck: Auto Duck... reaches a particular level. Typically
(default:0.5)

used to make a music track softer


double OuterFadeUpLen,
whenever speech in a commentary
(default:0.5)

track is heard.
double ThresholdDb,
(default:-30)

double MaximumPause,
(default:1)

double Bass, (default:0)

Increases or decreases the lower


double Treble, (default:0)
frequencies and higher frequencies
Bass and
BassAndTreble: double Gain, (default:0)
of your audio independently;
Treble...
bool Link Sliders, behaves just like the bass and treble
(default:False)
controls on a stereo system.

double Percentage, (default:0)

Change the pitch of a selection


ChangePitch: Change Pitch...
bool SBSMS, (default:False) without changing its tempo.

Change the speed of a selection,


ChangeSpeed: Change Speed... double Percentage, (default:0)

also changing its pitch.


double Percentage, (default:0)
Change the tempo and length
Change
ChangeTempo: (duration) of a selection without
Tempo... bool SBSMS, (default:False)
changing its pitch.
int Threshold, (default:200)
Click Removal is designed to
Click remove clicks on audio tracks and is
ClickRemoval:
Removal... int Width, (default:20)
especially suited to declicking
recordings made from vinyl records.
Compressor: Compressor... double Threshold, Compresses the dynamic range by
(default:-12)
two alternative methods. The
default "RMS" method makes the
double NoiseFloor, louder parts softer, but leaves the
(default:-40)
quieter audio alone. The alternative
double Ratio, (default:2)
"peaks" method makes the entire
double AttackTime, audio louder, but amplifies the

https://manual.audacityteam.org/man/scripting_reference.html 19/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

(default:0.2)
louder parts less than the quieter
double ReleaseTime, parts. Make-up gain can be applied
(default:1)
to either method, making the result
bool Normalize, (default:True)
as loud as possible without clipping,
bool UsePeak, (default:False)
but not changing the dynamic range
further.
enum Type, (default:Hard
Clipping)

Hard Clipping
Soft Clipping
Soft Overdrive
Medium Overdrive
Hard Overdrive Use the Distortion effect to make
Cubic Curve (odd the audio sound distorted. By
harmonics) distorting the waveform the
Even Harmonics frequency content is changed, which
Expand and Compress will often make the sound "crunchy"
Leveller or "abrasive". Technically this effect
Distortion: Distortion... Rectifier Distortion is a waveshaper. The result of
Hard Limiter 1413 waveshaping is equivalent to
applying non-linear amplification to
bool DC Block, (default:False)
the audio waveform. Preset shaping
double Threshold dB, functions are provided, each of
(default:-6)
which produces a different type of
double Noise Floor, distortion.
(default:-70)

double Parameter 1,
(default:50)

double Parameter 2,
(default:50)

int Repeats, (default:1)

Repeats the selected audio again and


again, normally softer each time and
normally not blended into the
float Delay, (default:1)
original sound until some time after
it starts. The delay time between
Echo: Echo...
float Decay, (default:0.5)
each repeat is fixed, with no pause
in between each repeat. For a more
configurable echo effect with a
variable delay time and pitch-
changed echoes, see Delay.
Applies a linear fade-in to the
selected audio - the rapidity of the
fade-in depends entirely on the
FadeIn: Fade In none length of the selection it is applied
to. For a more customizable
logarithmic fade, use the Envelope
Tool on the Tools Toolbar.
FadeOut: 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
https://manual.audacityteam.org/man/scripting_reference.html 20/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

to. For a more customizable


logarithmic fade, use the Envelope
Tool on the Tools Toolbar.

size_t FilterLength,
(default:8191)

bool InterpolateLin,
(default:False)

enum InterpolationMethod,
(default:B-spline)
Adjusts the volume levels of
FilterCurve: Filter Curve...
particular frequencies
B-spline
Cosine
Cubic

double f0, (default:0)

double v0, (default:0)

size_t FilterLength,
(default:8191)

bool InterpolateLin,
(default:False)

enum InterpolationMethod,
(default:B-spline)
Adjusts the volume levels of
GraphicEq: Graphic EQ...
particular frequencies
B-spline
Cosine
Cubic

double f0, (default:0)

double v0, (default:0)

This effect flips the audio samples


upside-down. This normally does
Invert: Invert none not affect the sound of the audio at
all. It is occasionally useful for
vocal removal.
bool StereoIndependent,
(default:False)

double LUFSLevel,
Loudness (default:-23)
Changes the perceived loudness of
LoudnessNormalization:
Normalization... double RMSLevel, the audio.
(default:-20)

bool DualMono, (default:True)

int NormalizeTo, (default:0)

NoiseReduction: Noise none This effect is ideal for reducing


Reduction... 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

https://manual.audacityteam.org/man/scripting_reference.html 21/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

This effect is not currently available


from scripting.
double PeakLevel, (default:-1)

Use the Normalize effect to set the


bool ApplyGain, (default:True)
maximum amplitude of a track,
bool RemoveDcOffset, equalize the amplitudes of the left
Normalize: Normalize...
(default:True)
and right channels of a stereo track
bool StereoIndependent, and optionally remove any DC
(default:False)
offset from the track

Use Paulstretch only for an extreme


time-stretch or "stasis" effect, This
float Stretch Factor, may be useful for synthesizer pad
(default:10)
sounds, identifying performance
Paulstretch: Paulstretch... glitches or just creating interesting
float Time Resolution,
aural textures. Use Change Tempo
(default:0.25)

or Sliding Time Scale rather than


Paulstretch for tasks like slowing
down a song to a "practice" tempo.
int Stages, (default:2)

The name "Phaser" comes from


int DryWet, (default:128)
"Phase Shifter", because it works by
double Freq, (default:0.4)
combining phase-shifted signals
Phaser: Phaser... double Phase, (default:0)
with the original signal. The
int Depth, (default:100)
movement of the phase-shifted
int Feedback, (default:0)
signals is controlled using a Low
double Gain, (default:-6)
Frequency Oscillator (LFO).

Fix one particular short click, pop or


Repair: Repair none other glitch no more than 128
samples long.
Repeats the selection the specified
Repeat: Repeat... int Count, (default:1)

number of times.
double RoomSize, (default:75)

double Delay, (default:10)

double Reverberance,
(default:50)
A configurable stereo reverberation
double HfDamping, effect with built-in and user-added
(default:50)
presets. It can be used to add
double ToneLow, (default:100)
ambience (an impression of the
Reverb: Reverb...
double ToneHigh, space in which a sound occurs) to a
(default:100)
mono sound. Also use it to increase
double WetGain, (default:-1)
reverberation in stereo audio that
double DryGain, (default:-1)
sounds too "dry" or "close".
double StereoWidth,
(default:100)

bool WetOnly, (default:False)

Reverses the selected audio; after


Reverse: Reverse none the effect the end of the audio will
be heard first and the beginning last.
SlidingStretch: Sliding double This effect allows you to make a

https://manual.audacityteam.org/man/scripting_reference.html 22/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Stretch... RatePercentChangeStart, continuous change to the tempo


(default:0)
and/or pitch of a selection by
choosing initial and/or final change
double values.
RatePercentChangeEnd,
(default:0)

double PitchHalfStepsStart,
(default:0)

double PitchHalfStepsEnd,
(default:0)

double
PitchPercentChangeStart,
(default:0)

double
PitchPercentChangeEnd,
(default:0)

double Threshold,
(default:-20)

enum Action, (default:Truncate


Detected Silence)

Truncate Detected
Silence Automatically try to find and
Truncate
TruncateSilence: Compress Excess eliminate audible silences. Do not
Silence...
Silence use this with faded audio.

double Minimum, (default:0.5)

double Truncate, (default:0.5)

double Compress, (default:50)

bool Independent,
(default:False)

double Freq, (default:1.5)

double Phase, (default:0)

int Depth, (default:70)


Rapid tone quality variations, like
Wahwah: Wahwah... double Resonance, that guitar sound so popular in the
(default:2.5)
1970's.
int Offset, (default:30)
double Gain, (default:-6)

Effect: Nyquist

No special notes for Nyquist


Scripting Id Action Parameters Description
AdjustableFade: Adjustable enum type, (default:Up)
enables you to control the shape
Fade... of the fade (non-linear fading) to
Up be applied by adjusting various
Down parameters; allows partial (that
SCurveUp is not from or to zero) fades up
SCurveDown or down.
https://manual.audacityteam.org/man/scripting_reference.html 23/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

double curve, (default:0)

enum units, (default:Percent)

Percent
dB

double gain0, (default:0)

double gain1, (default:0)

enum preset, (default:None)

None
LinearIn
LinearOut
ExponentialIn
ExponentialOut
LogarithmicIn
LogarithmicOut
RoundedIn
RoundedOut
CosineIn
CosineOut
SCurveIn
SCurveOut

double threshold, (default:0)


Clip Fix attempts to reconstruct
ClipFix: Clip Fix... clipped regions by interpolating
double gain, (default:0)

the lost signal.


Use Crossfade Clips to apply a
Crossfade simple crossfade to a selected
CrossfadeClips:
Clips pair of clips in a single audio
track.
enum type,
(default:ConstantGain)

ConstantGain
ConstantPower1 Use Crossfade Tracks to make a
ConstantPower2 smooth transition between two
CustomCurve overlapping tracks one above the
Crossfade other. Place the track to be faded
CrossfadeTracks:
Tracks... double curve, (default:0)
out above the track to be faded
enum direction, in then select the overlapping
(default:Automatic)
region in both tracks and apply
the effect.
Automatic
OutIn
InOut

Delay: Delay... enum delay-type, A configurable delay effect with


(default:Regular)
variable delay time and pitch
shifting of the delays.
Regular
BouncingBall
ReverseBouncingBall

https://manual.audacityteam.org/man/scripting_reference.html 24/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

double dgain, (default:0)

double delay, (default:0)

enum pitch-type,
(default:PitchTempo)

PitchTempo
LQPitchShift

double shift, (default:0)

int number, (default:0)

enum constrain, (default:Yes)

Yes
No

double frequency, (default:0)

enum rolloff, (default:dB6)

Passes frequencies above its


High-Pass dB6 cutoff frequency and attenuates
High-passFilter:
Filter... dB12 frequencies below its cutoff
dB24 frequency.
dB36
dB48

enum type, (default:SoftLimit)

SoftLimit Limiter passes signals below a


HardLimit specified input level unaffected
SoftClip or gently reduced, while
HardClip preventing the peaks of stronger
signals from exceeding this
double gain-L, (default:0)
threshold. Mastering engineers
Limiter: Limiter...
double gain-R, (default:0)
often use this type of dynamic
double thresh, (default:0)
range compression combined
double hold, (default:0)
with make-up gain to increase
enum makeup, (default:No)
the perceived loudness of an
audio recording during the audio
No mastering process.
Yes

double frequency, (default:0)

enum rolloff, (default:dB6)

Passes frequencies below its


Low-Pass dB6 cutoff frequency and attenuates
Low-passFilter:
Filter... dB12 frequencies above its cutoff
dB24 frequency.
dB36
dB48

NotchFilter: Notch Filter... double frequency, (default:0)


Greatly attenuate ("notch out"),
a narrow frequency band. This is
double q, (default:0)
a good way to remove mains
hum or a whistle confined to a
https://manual.audacityteam.org/man/scripting_reference.html 25/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

specific frequency with minimal


damage to the remainder of the
audio.
When the selected track is in
spectrogram or spectrogram
log(f) view, applies a notch
filter, high pass filter or low
Spectral edit
SpectralEditMultiTool: pass filter according to the
multi tool
spectral selection made. This
effect can also be used to change
the audio quality as an
alternative to using Equalization.
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
Spectral edit boundary, performs the specified
SpectralEditParametricEq: parametric double control-gain, (default:0)
band cut or band boost. This
EQ... 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.
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 edit spectral selection made. This can
SpectralEditShelves: double control-gain, (default:0)

shelves... 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.
Applies a more musical fade out
Studio Fade
StudioFadeOut: to the selected audio, giving a
Out
more pleasing sounding result.
enum wave, (default:Sine)

Sine
Triangle
Modulates the volume of the
Sawtooth
selection at the depth and rate
Tremolo: Tremolo... InverseSawtooth selected in the dialog. The same
Square as the tremolo effect familiar to
guitar and keyboard players.
int phase, (default:0)

int wet, (default:0)

double lfo, (default:0)

VocalReductionAndIsolation: Vocal enum action, Attempts to remove or isolate

https://manual.audacityteam.org/man/scripting_reference.html 26/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Reduction (default:RemoveToMono)
center-panned audio from a
and stereo track. Most "Remove"
Isolation... RemoveToMono options in this effect preserve
Remove the stereo image.
Isolate
IsolateInvert
RemoveCenterToMono
RemoveCenter
IsolateCenter
IsolateCenterInvert
Analyze

double strength, (default:0)

double low-transition,
(default:0)

double high-transition,
(default:0)

double dst, (default:0)

enum mst, Synthesizes audio (usually a


(default:BothChannels)
voice) in the left channel of a
stereo track with a carrier wave
BothChannels (typically white noise) in the
RightOnly right channel to produce a
Vocoder: Vocoder...
modified version of the left
int bands, (default:0)
channel. Vocoding a normal
double track-vl, (default:0)
voice with white noise will
double noise-vl, (default:0)
produce a robot-like voice for
double radar-vl, (default:0)
special effects.
double radar-f, (default:0)

Analyze Menu
The Analyze Menu contains tools for finding out about the characteristics of your audio, or labeling key feature.
Scripting Id Action Parameters Description
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,
Add / Remove Generators and Analyzers in Audacity.
ManageAnalyzers: none
Plug-ins... 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

https://manual.audacityteam.org/man/scripting_reference.html 27/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

to determine if the speech will be


intelligible to the hard of hearing.
Takes the selected audio (which is a set of
Plot sound pressure values at points in time)
PlotSpectrum: none
Spectrum... and converts it to a graph of frequencies
against amplitudes.
Displays runs of clipped samples in a
int Duty Cycle Start, (default:3)
Label Track, as a screen-reader accessible
alternative to View > Show Clipping. A
FindClipping: Find Clipping...
int Duty Cycle End, (default:3)
run must include at least one clipped
sample, but may include unclipped
samples too.

Analyze: Nyquist
No special notes for Nyquist
Scripting Id Action Parameters Description
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
BeatFinder: Beat Finder... int thresval, (default:0)

pop music track with compressed dynamic


range. If you do not get enough beats
detected, try reducing the "Threshold
Percentage" setting.
double threshold, (default:0)

enum measurement,
(default:peak)

peak
avg
rms

double sil-dur, (default:0)

double snd-dur, (default:0)


Divides up a track by placing labels for
LabelSounds: Label Sounds...
enum type, (default:before) areas of sound that are separated by silence.

before
after
around
between

double pre-offset, (default:0)

double post-offset, (default:0)

string text, (default:"")

Tools Menu
The Tools Menu contains customisable tools.
Scripting Id Action Parameters Description

https://manual.audacityteam.org/man/scripting_reference.html 28/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

ManageTools: Add / Remove none Selecting this option from the Effect
Plug-ins... 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.
Creates a new macro or edits an
ManageMacros: Macros... none
existing macro.
Displays a menu with list of all your
Macros. Selecting any of these
Apply Macro: Apply Macro none Macros by clicking on it will cause
that Macro to be applied to the current
project.
Screenshot: Screenshot... string Path, (default:)
A tool, mainly used in documentation,
to capture screenshots of Audacity.
enum CaptureWhat,
(default:Window)

Window
FullWindow
WindowPlus
Fullscreen
Toolbars
Effects
Scriptables
Preferences
Selectionbar
SpectralSelection
Timer
Tools
Transport
Mixer
Meter
PlayMeter
RecordMeter
Edit
Device
Scrub
Play-at-Speed
Trackpanel
Ruler
Tracks
FirstTrack
FirstTwoTracks
FirstThreeTracks
FirstFourTracks
SecondTrack
TracksPlus
FirstTrackPlus
https://manual.audacityteam.org/man/scripting_reference.html 29/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

AllTracks
AllTracksPlus

enum Background,
(default:None)

Blue
White
None

bool ToTop, (default:True)

Run A tool for measuring the performance


Benchmark: none
Benchmark... of one part of Audacity.
Brings up a dialog where you can
string Command, (default:)
enter Nyquist commands. Nyquist is a
Nyquist programming language for generating,
NyquistPrompt:
Prompt... int Version, (default:3)
processing and analyzing audio. For
more information see Nyquist Plug-
ins Reference.
string files, (default:)

enum overwrite,
NyquistPlug- Nyquist Plug- (default:Disallow)
A Nyquist plug-in that simplifies the
inInstaller: in Installer... installation of other Nyquist plug-ins.
Disallow
Allow

RegularIntervalLabels: Regular enum mode, (default:Both)


Places labels in a long track so as to
Interval divide it into smaller, equally sized
Labels... Both segments.
Number
Interval

int totalnum, (default:0)

double interval, (default:0)

double region, (default:0)

enum adjust, (default:No)

No
Yes

string labeltext, (default:)

enum zeros, (default:TextOnly)

TextOnly
OneBefore
TwoBefore
ThreeBefore
OneAfter
TwoAfter
ThreeAfter

int firstnum, (default:0)

enum verbose,
https://manual.audacityteam.org/man/scripting_reference.html 30/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

(default:Details)

Details
Warnings
None

int number, (default:0)

enum units, (default:dB)

dB
Linear

string filename, (default:)

enum fileformat,
(default:None)

None
Count
Time

enum header, (default:None)

Reads the values of successive


Sample Data None samples from the selected audio and
SampleDataExport:
Export... Minimal prints this data to a plain text, CSV or
Standard HTML file.
All

string optext, (default:)

enum channel-layout,
(default:SameLine)

SameLine
Alternate
LFirst

enum messages, (default:Yes)

Yes
Errors
None

string filename, (default:)

enum bad-data, Reads numeric values from a plain


Sample Data (default:ThrowError)

SampleDataImport: ASCII text file and creates a PCM


Import...
ThrowError sample for each numeric value read.
ReadAsZero

Tools: Apply Macro

Displays a menu with list of all your Macros. Selecting any of these Macros by clicking on it will cause that
Macro to be applied to the current project.
https://manual.audacityteam.org/man/scripting_reference.html 31/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Scripting Id Action Parameters Description


Displays a menu with list of all your
ApplyMacrosPalette: Palette... none Macros which can be applied to the
current project or to audio files..
Fades in the first second and fades out
Macro_FadeEnds: Fade Ends none
the last second of a track.
MP3
Macro_MP3Conversion: none Converts MP3.
Conversion

Extra Menu
The Extra menu provides access to additional Commands that are not available in the normal default Audacity
menus.
Scripting Id Action Parameters Description
PlayAtSpeed: Play-at-Speed none Extra commands related to play at speed
Full Screen
FullScreenOnOff: none Toggle full screen mode with no title bar
(on/off)

Extra: Transport

Extra commands related to play and record


Scripting Id Action Parameters Description
Play: Play none Play (or stop) audio
Stop: Stop none Stop audio
Plays for one second centered on
the current mouse pointer
Play One
PlayOneSec: none position (not from the current
Second
cursor position). See this page
for an example.
Plays to or from the current
mouse pointer position to or
Play to from the start or end of the
PlayToSelection: none
Selection selection, depending on the
pointer position. See this page
for more details.
Plays a short period before the
Play Before
start of the selected audio, the
PlayBeforeSelectionStart: Selection none
period before shares the setting
Start
of the cut preview.
Plays a short period after the
Play After
start of the selected audio, the
PlayAfterSelectionStart: Selection none
period after shares the setting of
Start
the cut preview.
Plays a short period before the
Play Before
end of the selected audio, the
PlayBeforeSelectionEnd: Selection none
period before shares the setting
End
of the cut preview.
PlayAfterSelectionEnd: Play After none Plays a short period after the end
Selection of the selected audio, the period
End
https://manual.audacityteam.org/man/scripting_reference.html 32/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

after shares the setting of the cut


preview.
Plays a short period before and
Play Before
after the start of the selected
and After
PlayBeforeAndAfterSelectionStart: none audio, the periods before and
Selection
after share the setting of the cut
Start
preview.
Plays a short period before and
Play Before
after the end of the selected
and After
PlayBeforeAndAfterSelectionEnd: none audio, the periods before and
Selection
after share the setting of the cut
End
preview.
Play Cut Plays audio excluding the
PlayCutPreview: none
Preview selection

Extra: Tools
Extra commands to select the tool, for example time-shift, envelopes, multi-tool.
Scripting 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.
MultiTool: Multi Tool none Chooses the Multi-Tool
Cycles backwards through the tools, starting
from the currently selected tool: starting
PrevTool: Previous Tool none from Selection, it would navigate to Multi-
tool to Time Shift to Zoom to Draw to
Envelope to Selection.
Cycles forwards through the tools, starting
from the currently selected tool: starting
NextTool: Next Tool none 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


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

https://manual.audacityteam.org/man/scripting_reference.html 33/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

InputGain: Adjust none Displays the Recording Volume dialog. You


Recording can type a new value for the recording
Volume... volume (between 0 and 1), or press Tab,
then use the left and right arrow keys to
adjust the slider.
Increase
Each key press will increase the recording
InputGainInc: Recording none
volume by 0.1.
Volume
Decrease
Each key press will decrease the recording
InputGainDec: Recording none
volume by 0.1.
Volume

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

Extra: Play-at-Speed

Extra commands related to play at speed


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

Extra: Seek
https://manual.audacityteam.org/man/scripting_reference.html 34/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Extra commands related to seeking


Scripting Id Action Parameters Description
Short Seek Left
Skips the playback cursor back one second
SeekLeftShort: During none
by default.
Playback
Short Seek
Skips the playback cursor forward one
SeekRightShort: Right During none
second by default.
Playback
Long Seek Left
Skips the playback cursor back 15 seconds
SeekLeftLong: During none
by default.
Playback
Long Seek
Skips the playback cursor forward 15
SeekRightLong: Right During none
seconds by default.
Playback

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

Extra: Selection

Extra commands related to selecting.


Scripting Id Action Parameters Description
Equivalent to setting the Snap To control in
SnapToOff: Snap-To Off none
Selection Toolbar to "Off".
Snap-To Equivalent to setting the Snap To control in
SnapToNearest: none
Nearest Selection Toolbar to "Nearest".
Equivalent to setting the Snap To control in
SnapToPrior: Snap-To Prior none
Selection Toolbar to "Prior".
SelStart: Selection to none Select from cursor to start of track
https://manual.audacityteam.org/man/scripting_reference.html 35/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Start
Selection to
SelEnd: none Select from cursor to end of track
End
Increases the size of the selection by
extending it to the left. The amount of
Selection
SelExtLeft: none increase is dependent on the zoom level. If
Extend Left
there is no selection one is created starting
at the cursor position.
Increases the size of the selection by
extending it to the right. The amount of
Selection
SelExtRight: none increase is dependent on the zoom level. If
Extend Right
there is no selection one is created starting
at the cursor position.
Set (or Extend) Extend selection left a little (is this a
SelSetExtLeft: none
Left Selection duplicate?)
Set (or Extend) Extend selection right a litlle (is this a
SelSetExtRight: none
Right Selection duplicate?)
Decreases the size of the selection by
Selection contracting it from the right. The amount of
SelCntrLeft: none
Contract Left decrease is dependent on the zoom level. If
there is no selection no action is taken.
Decreases the size of the selection by
Selection contracting it from the left. The amount of
SelCntrRight: none
Contract Right 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
Scripting Id Action Parameters Description
Move backward through currently focused
Move
toolbar in Upper Toolbar dock area, Track
Backward from
PrevFrame: none View and currently focused toolbar in
Toolbars to
Lower Toolbar dock area. Each use moves
Tracks
the keyboard focus as indicated.
Move forward through currently focused
Move Forward toolbar in Upper Toolbar dock area, Track
NextFrame: from Toolbars none View and currently focused toolbar in
to Tracks Lower Toolbar dock area. Each use moves
the keyboard focus as indicated.
Move Focus to
PrevTrack: none Focus one track up
Previous Track
Move Focus to
NextTrack: none Focus one track down
Next Track
Move Focus to
FirstTrack: none Focus on first track
First Track
Move Focus to
LastTrack: none Focus on last track
Last Track
Move Focus to
ShiftUp: Previous and none Focus one track up and select it
Select
https://manual.audacityteam.org/man/scripting_reference.html 36/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

ShiftDown: Move Focus to none Focus one track down and select it
Next and Select
Toggle Focused
Toggle: none Toggle focus on current track
Track
Toggle Focused
ToggleAlt: none Toggle focus on current track
Track

Extra: Cursor

Extra commands to move the cursor


Scripting Id Action Parameters Description
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
CursorLeft: Cursor Left none
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"
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
CursorRight: Cursor Right none 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"
When not playing audio, moves the
editing cursor one second left by
default. When playing audio, moves
Cursor Short the playback cursor one second left by
CursorShortJumpLeft: none
Jump Left default. The default value can be
changed by adjusting the "Short
Period" under "Seek Time when
playing" in Playback Preferences.
When not playing audio, moves the
editing cursor one second right by
default. When playing audio, moves
Cursor Short the playback cursor one second right
CursorShortJumpRight: none
Jump 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 none When not playing audio, moves the
Jump Left editing cursor 15 seconds left by
default. When playing audio, moves
the playback cursor 15 seconds left by
https://manual.audacityteam.org/man/scripting_reference.html 37/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

default. The default value can be


changed by adjusting the "Long
Period" under "Seek Time when
playing" in Playback Preferences.
When not playing audio, moves the
editing cursor 15 seconds right by
default. When playing audio, moves
Cursor Long the playback cursor 15 seconds right
CursorLongJumpRight: none
Jump Right by default. The default value can be
changed by adjusting the "Long
Period" under "Seek Time when
playing" in Playback Preferences.
Moves the currently focused audio
track (or a separate clip in that track
ClipLeft: Clip Left none which contains the editing cursor or
selection region) one screen pixel to
left.
Moves the currently focused audio
track (or a separate clip in that track
ClipRight: Clip Right none 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


Scripting Id Action Parameters Description
Brings up the Pan dialog for the focused
Change Pan on track where you can enter a pan value, or
TrackPan: Focused none use the slider for finer control of panning
Track... than is available when using the track pan
slider.
Controls the pan slider on the focused
Pan Left on
TrackPanLeft: none track. Each keypress changes the pan
Focused Track
value by 10% left.
Controls the pan slider on the focused
Pan Right on
TrackPanRight: none track. Each keypress changes the pan
Focused Track
value by 10% right.
Brings up the Gain dialog for the focused
Change Gain on track where you can enter a gain value, or
TrackGain: Focused none use the slider for finer control of gain
Track... than is available when using the track pan
slider.
Increase Gain Controls the gain slider on the focused
TrackGainInc: on Focused none track. Each keypress increases the gain
Track value by 1 dB.
Decrease Gain Controls the gain slider on the focused
TrackGainDec: on Focused none track. Each keypress decreases the gain
Track value by 1 dB.
TrackMenu: Open Menu on none Opens the Audio Track Dropdown Menu
Focused on the focused audio track or other track
Track... type. In the audio track dropdown, use
https://manual.audacityteam.org/man/scripting_reference.html 38/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

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.
Mute/Unmute Toggles the Mute button on the focused
TrackMute: none
Focused Track track.
Solo/Unsolo Toggles the Solo button on the focused
TrackSolo: none
Focused Track track.
Close Focused
TrackClose: none Close (remove) the focused track only.
Track
Move Focused Moves the focused track up by one track
TrackMoveUp: none
Track Up and moves the focus there.
Move Focused Moves the focused track down by one
TrackMoveDown: none
Track Down track and moves the focus there.
Move Focused Moves the focused track up to the top of
TrackMoveTop: none
Track to Top the track table and moves the focus there.
Move Focused Moves the focused track down to the
TrackMoveBottom: Track to none bottom of the track table and moves the
Bottom focus there.

Extra: Scriptables I

These commands were originally written for scripting Audacity, e.g via a Python script that uses mod-script-
pipe. The commands though are also present in the menu, available from macros, and available from within
Nyquist using (AUD-DO "command")
Scripting Id Action Parameters Description
double Start,
(default:unchanged)

double End,
(default:unchanged)

enum RelativeTo, Modifies the temporal selection. Start and


(default:unchanged)
End are time. FromEnd allows selection
SelectTime: Select Time...
from the end, which is handy to fade in
ProjectStart
Project and fade out a track.
ProjectEnd
SelectionStart
Selection
SelectionEnd

double High,
(default:unchanged)

Select Modifies what frequencies are selected.


SelectFrequencies:
Frequencies... double Low, High and Low are for spectral selection.
(default:unchanged)

SelectTracks: Select Tracks... double Track, Modifies which tracks are selected. First
(default:unchanged)
and Last are track numbers. High and
Low are for spectral selection. The Mode
parameter allows complex selections, e.g
https://manual.audacityteam.org/man/scripting_reference.html 39/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

double TrackCount, adding or removing tracks from the


(default:unchanged)
current selection.
enum Mode,
(default:unchanged)

Set
Add
Remove

string Name,
(default:unchanged)

Sets properties for a track or channel (or


Set Track bool Selected,
SetTrackStatus: both).Name is used to set the name. It is
Status... (default:unchanged)

not used in choosing the track.


bool Focused,
(default:unchanged)

bool Mute, (default:unchanged)

bool Solo, (default:unchanged)

Set Track double Gain, Sets properties for a track or channel (or
SetTrackAudio:
Audio... (default:unchanged)
both). Can set pan, gain, mute and solo.
double Pan,
(default:unchanged)

SetTrackVisuals: Set Track int Height, (default:unchanged)


Sets visual properties for a track or
Visuals... channel (or both). SpectralPrefs=1 sets
enum Display, the track to use general preferences,
(default:unchanged)
SpectralPrefs=1 per track prefs. When
using general preferences, SetPreferences
Waveform can be used to change a preference and so
Spectrogram affect display of the track.
enum Scale,
(default:unchanged)

Linear
dB

enum Color,
(default:unchanged)

Color0
Color1
Color2
Color3

enum VZoom,
(default:unchanged)

Reset
Times2
HalfWave

https://manual.audacityteam.org/man/scripting_reference.html 40/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

double VZoomHigh,
(default:unchanged)

double VZoomLow,
(default:unchanged)

bool SpecPrefs,
(default:unchanged)

bool SpectralSel,
(default:unchanged)

enum Scheme,
(default:unchanged)

Color (default)
Color (classic)
Grayscale
Inverse Grayscale

Get
GetPreference: string Name, (default:)
Gets a single preference setting.
Preference...
string Name, (default:)
Sets a single preference setting. Some
Set settings such as them changes require a
SetPreference: string Value, (default:)

Preference... reload (use Reload=1), but this takes time


bool Reload, (default:False)

and slows down a script.


double At, (default:unchanged)

enum Color,
(default:unchanged)

Modify a clip by stating the track or


Color0 channel a time within it. Color and start
SetClip: Set Clip... Color1 position can be set. Try to avoid
Color2 overlapping clips, as Audacity will allow
Color3 it, but does not like them.

double Start,
(default:unchanged)

double Time,
(default:unchanged)
Modify an envelope by specifying a track
or channel and a time within it. You
double Value,
SetEnvelope: Set Envelope... cannot yet delete individual envelope
(default:unchanged)

points, but can delete the whole envelope


bool Delete,
using Delete=1.
(default:unchanged)

int Label, (default:0)

string Text, (default:unchanged)

double Start,
(default:unchanged)
Modifies an existing label. You must give
SetLabel: Set Label...
double End, it the label number.
(default:unchanged)

bool Selected,
(default:unchanged)

https://manual.audacityteam.org/man/scripting_reference.html 41/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

SetProject: Set Project... string Name, Sets the project window to a particular
(default:unchanged)
location and size. Can also change the
caption - but that is cosmetic and may be
double Rate, overwritten again later by Audacity.
(default:unchanged)

int X, (default:unchanged)

int Y, (default:unchanged)

int Width, (default:unchanged)

int Height, (default:unchanged)

Extra: Scriptables II

Like Scriptables I, but these ones are less commonly used from the menu.
Scripting Id Action Parameters Description
double Start,
(default:unchanged)

double End,
(default:unchanged)

enum RelativeTo,
(default:unchanged)

ProjectStart
Project
ProjectEnd
SelectionStart Selects audio. Start and End are time. First
Selection and Last are track numbers. High and Low
SelectionEnd are for spectral selection. FromEnd allows
selection from the end, which is handy to
Select: Select...
double High, fade in and fade out a track. The Mode
(default:unchanged)
parameter allows complex selections, e.g
double Low, adding or removing tracks from the current
(default:unchanged)
selection.
double Track,
(default:unchanged)

double TrackCount,
(default:unchanged)

enum Mode,
(default:unchanged)

Set
Add
Remove

SetTrack: Set Track... string Name, Sets properties for a track or channel (or
(default:unchanged)
both). Setting one channel of a stereo track
can lead to interesting results. That's most
bool Selected, used when setting relative sizing of the two
(default:unchanged)
channels. SpectralPrefs=1 sets the track to
bool Focused, use general preferences, SpectralPrefs=1
(default:unchanged)
per track prefs. When using general
bool Mute, (default:unchanged)
preferences, SetPreferences can be used to
bool Solo, (default:unchanged)
change a preference and so affect display of
https://manual.audacityteam.org/man/scripting_reference.html 42/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

double Gain, the track. Name is used to set the name. It is


(default:unchanged)
not used in choosing the track.
double Pan, (default:unchanged)

int Height, (default:unchanged)

enum Display,
(default:unchanged)

Waveform
Spectrogram

enum Scale, (default:unchanged)

Linear
dB

enum Color,
(default:unchanged)

Color0
Color1
Color2
Color3

enum VZoom,
(default:unchanged)

Reset
Times2
HalfWave

double VZoomHigh,
(default:unchanged)

double VZoomLow,
(default:unchanged)

bool SpecPrefs,
(default:unchanged)

bool SpectralSel,
(default:unchanged)

bool GrayScale,
(default:unchanged)

GetInfo: Get Info... enum Type, (default:Commands)


Gets information in a list in one of three
formats.
Commands
Menus
Preferences
Tracks
Clips
Envelopes
Labels
Boxes

enum Format, (default:JSON)

JSON
https://manual.audacityteam.org/man/scripting_reference.html 43/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

LISP
Brief

string Text, (default:Some Used in testing. Sends the Text string back
Message: Message...
message)
to you.
string Command, (default:Help)

enum Format, (default:JSON)

This is an extract from GetInfo Commands,


Help: Help...
JSON with just one command.
LISP
Brief

Imports from a file. The automation


Import2: Import... string Filename, (default:)
command uses a text box to get the file
name rather than a normal file-open dialog.
Exports to a named file. This version of
export has the full set of export options.
However, a current limitation is that the
string Filename, detailed option settings are always stored to
(default:exported.wav)
and taken from saved preferences. The net
Export2: Export...
effect is that for a given format, the most
int NumChannels, (default:1)

recently used options for that format will be


used. In the current implementation,
NumChannels should be 1 (mono) or 2
(stereo).
string Filename,
(default:test.aup3)

OpenProject2: Open Project... Opens a project.


bool AddToHistory,
(default:false)

string Filename,
(default:name.aup3)

SaveProject2: Save Project... bool AddToHistory, Saves a project.


(default:False)

bool Compress, (default:False)

Drag: Move Mouse... int Id, (default:unchanged)


Experimental command (called Drag in
scripting) that moves the mouse. An Id can
string Window, be used to move the mouse into a button to
(default:unchanged)
get the hover effect. Window names can be
double FromX, used instead. If To is specified, the
(default:unchanged)
command does a drag, otherwise just a
double FromY, hover.
(default:unchanged)

double ToX,
(default:unchanged)

double ToY, (default:unchanged)

enum RelativeTo,
(default:unchanged)

Panel
https://manual.audacityteam.org/man/scripting_reference.html 44/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

App
Track0
Track1

Compare Compares selected range on two tracks.


CompareAudio: float Threshold, (default:0)

Audio... Reports on the differences and similarities.


A version of Tools -> Screenshot with a
Screenshot more minimal GUI. One of the most useful
Screenshot: none
(short format)... options is All_Tracks. The _Plus suffix
includes the timeline.

Help Menu
The Help Menu lets you find out more about the Audacity application and how to use it. It also includes some
diagnostic tools.
Scripting Id Action Parameters Description
A brief version of help with some of the
QuickHelp: Quick Help... none
most essential information.
Manual: Manual... none Opens the manual in the default browser.
Check for Checks online to see if this is the latest
Updates: none
Updates... version of Audacity.
Brings a dialog with information about
About Audacity, such as who wrote it, what
About: none
Audacity... features are enabled and the GNU GPL v2
license.

Help: Diagnostics
A set of diagnostic tools
Scripting Id Action Parameters Description
Audio Device Shows technical information about your
DeviceInfo: none
Info... detected audio device(s).
MIDI Device Shows technical information about your
MidiDeviceInfo: none
Info... detected MIDI device(s).
Launches the "Audacity Log" window, the
Log: Show Log... none log is largely a debugging aid, having
timestamps for each entry
Selecting this will generate a Debug report
Generate which could be useful in aiding the
CrashReport: none
Support Data... developers to identify bugs in Audacity or
in third-party plug-ins
Enumera todos los archivos de audio WAV
Comprobar o AIFF de los que depende su proyecto y le
CheckDeps: ninguno
dependencias ... permite copiar estos archivos en el
proyecto.

Sin Menú
https://manual.audacityteam.org/man/scripting_reference.html 45/46
8/11/21 14:42 Referencia de secuencias de comandos - Manual de Audacity

Estos son comandos adicionales que no aparecen en ningún menú


ID de
secuencia de Acción Parámetros Descripción
comandos
Ventana
anterior: Ventana anterior ninguno Navega a la ventana anterior.

NextWindow: Siguiente ninguno Navega a la siguiente ventana.


ventana

Navegación
Página de inicio del manual
Usando Audacity
Guía turístico
Nuevas características
Empezando
Tutoriales
Consejos
GUI de Audacity
Barra de menús
Barras de herramientas
Pistas
Efectos
Personalización
Preferencias
Teclas de atajo
Complementos
Temas
Barras de herramientas

Referencia

Referencia
Buscar en el manual
Audio digital
Glosario
Todos los comandos
Errores
Índice
Preguntas más frecuentes

Enlaces útiles
Foro
Wiki
Último lanzamiento

Esta versión creada el 2021-10-26 - Verifique la versión actual de esta página (Manual de desarrollo)

https://manual.audacityteam.org/man/scripting_reference.html 46/46

También podría gustarte