Modules

From Audacity Development Manual
Jump to: navigation, search
Audacity has experimental support for "modules", which are a type of plug-in, usually written in C++, that integrate closely with the main Audacity application. There are currently no modules included in the release binaries, but there are four experimental modules included in the code base (and included in the Linux tarballs). Before any of these modules can be used, they must be built from the source code. Previous experience building C++ projects is recommended.
Bulb icon Modules should be built on the same date as Audacity, otherwise the version string check will prevent the module loading.

Nyquist Workbench

Nyquist Workbench: This module provides a simple graphical editor to create and run arbitrary Nyquist code in Audacity. The Workbench can be compiled along with the Audacity application from our source code. Nyquist Workbench is not essential for writing Nyquist plug-ins for Audacity as most of the functionality is now available in the Nyquist Prompt.

Nyquist Workbench with notch.ny plug-in loaded in Script window.

Current Workbench features include:

  • Full support for Generate, Process and Analyze effects
  • Auto load last file
  • Built-in output/debug screen
  • Parentheses matching.


Mod-script pipe

Mod-script pipe: This is a GUI plug-in that allows Audacity to be driven from an external script, using any scripting language that supports named pipes (Python3 is the recommended language). Please be aware of the security implications of allowing other applications or processes to control Audacity. For more information, see Scripting.


Mod-track-panel

Mod-track-panel: This is the start of an experiment that will ultimately provide a more flexible panel for the audio, label, MIDI and note tracks. It is currently only of value to developers and must be compiled from the latest Audacity source code.


Mod-null

Mod-null: is a bare bones demonstration module.


Installing modules

To install a module, a new folder should be created and named "modules", and the built module placed directly inside it.

  • Windows: the "modules" folder should be in the same location as audacity.exe
  • Mac: the "modules" folder should be in the "Contents" folder.
  • Linux: the "modules" folder can most easily be created in the home folder as ~/.audacity-files/modules

The module may then be enabled in Preferences. Restarting Audacity is required after enabling.