# Installing Effect, Generator and Analyzer plug-ins on Linux

### From Audacity Development Manual

You can download and install plug-ins to add extra functionality to Audacity. Plug-ins can give you extra effects, or more audio generation and analysis capabilities.

Audacity on GNU/Linux supports a large number of Nyquist, LADSPA, LV2 and VAMP effects. VST effects are now supported in Audacity on Linux and can be installed as described at VST Effects. However native Linux VST effects are quite rare. Consequently, if a specific VST effect is required on Linux, it may be necessary to employ workarounds such as running Audacity for Windows in a virtual machine.

Audacity supports 64-bit effects in VST, LADSPA and VAMP format on 64-bit Linux systems (conversely, 32-bit plug-ins in those formats will not load into Audacity on 64-bit Linux).

## Contents

1. Installing Nyquist plug-ins
2. Installing VST plug-ins
3. Installing LADSPA plug-ins
4. Installing LV2 plug-ins
5. Installing VAMP plug-ins
6. How can I solve Audacity crashing after I add a plug-in?

## Installing Nyquist plug-ins

Nyquist plug-ins provide most of the optional effects underneath the divider in the Effect menu. They are also used to provide some of Audacity's built-in audio generators and analysis tools. A wide range of additional Nyquist effect, generation and analysis plug-ins can be obtained from Download Nyquist Plug-ins on our Wiki.

To add a new Nyquist plug-in, put it in the Audacity "Plug-Ins" folder:

- /usr/share/audacity/plug-ins if Audacity was installed from a repository package
- /usr/local/share/audacity/plug-ins if you compiled Audacity from source code.
- Optionally a "plug-ins" folder can be created in the home directory thus: ~/.audacity-files/plug-ins (you can also call the folder "plugins").

These locations are usually set as read-only, so the plug-ins will need to be copied as root (for example, by issuing an appropriate root command in the terminal, or by using the terminal to open a file manager application with root permissions).

| Updating the repository package of Audacity may remove plug-ins that are not part of the package. To solve that problem you can: Create a folder called .audacity-files in your home directory, create a sub-folder called Plug-Ins (or Plugins) then add your plug-ins into that Add plug-ins to the Plug-Ins folder in the .audacity-data folder in your home directory. The dot in the folder name .audacity-data and .audacity-files indicates that it is a hidden folder, but the "Plug-Ins" subfolder in either folder is accessible without root permissions and will not be modified by installing a new Audacity package.

To load the new effects into Audacity so they are available in the menu, use the Plug-in Manager: Effects, Generators and Analyzers dialog.

| Some Nyquist plug-ins could crash while processing very long audio selections (typically an hour or more). This is due to the plug-in using a large amount of memory and is a known issue in Audacity's current Nyquist implementation. Try using the plug-in on shorter selections instead.

## Installing VST plug-ins

Audacity supports almost all VST effect plug-ins on Linux including "shell" VST's that host multiple VST effects. On Linux, you must add a "plug-ins" folder to /usr/bin/ (if you installed a packaged version of Audacity) or to /usr/local/bin (if you installed a self-compiled version of Audacity). VST effects will also be found if they are added to (or already exist in) various system or user locations.

Other possible locations on GNU/Linux:

- All paths listed in the "VST_PATH" environment variable
- If no VST_PATH environment variable is found, the following are searched:
  - LIBDIR/vst (where LIBDIR is defined at build time)
  - /usr/lib/vst
  - /usr/local/lib/vst
  - ~/.vst.

All the directories where you can place VST plug-ins are searched recursively, which means that plug-ins that are inside their own folder in that directory should still be found by Audacity.

You can install new VST effects into Audacity by using the Effect > Add / Remove Plug-ins... menu item. This opens the Plug-in Manager: Effects, Generators and Analyzers dialog where you can select and enable the new effects then click OK to load them. Next time you launch Audacity the enabled effect(s) will be cached and you will not need to re-enable them.

| The list of effects in the dialog will include any detected VST instrument (VSTi) plug-ins (such as synths) and any real-time VST effects that are capable of changing audio data while it's being written to disk. Neither of these are yet supported and they will not load even if you enable or re-enable them in the dialog.

### Why do some VST plug-ins not work or display incorrectly?

Audacity will by default display VST effect plug-ins with a full graphical interface where the plug-in supplies this.

VST instruments (VSTi) (such as synths) and real-time VST effects (that change the audio data while it's being written) are not yet supported. These will not load even if you enable or re-enable them in the Plug-in Manager: Effects, Generators and Analyzers dialog. VST 3 plug-ins are not supported.

If any plug-in displays incorrectly, you can use the Manage button in the effect's dialog then choose Options... to open the VST Effect Options for that effect. Then remove the checkmark from the "Enable graphical interface" checkbox Enable graphical interface and click OK. When you reopen the effect it will display a simpler tabular interface.

| On GNU/Linux, 32-bit systems will have 32-bit versions of Audacity which will not see 64-bit VST plug-ins. 64-bit systems will have 64-bit versions of Audacity which will see 64-bit VST plug-ins but will not see 32-bit plug-ins.

If you experience a problem with a specific VST effect plug-in in Audacity, please contact us.

## Installing LADSPA plug-ins

The LADSPA plug-in architecture which was originally developed on Linux. Audacity supports both LV2 and LADSPA effects on GNU/Linux. You can download and install a set of over 90 LADSPA plug-ins for all operating systems. You can then choose which LADSPA plug-ins to enable in the Plug-in Manager: Effects, Generators and Analyzers dialog.

LADSPA plug-ins can be installed by putting the plug-ins into the Audacity "Plug-Ins" folder:

- /usr/share/audacity/plug-ins if Audacity was installed from a repository package
- /usr/local/share/audacity/plug-ins if you compiled Audacity from source code.

These locations are usually set as read-only, so the plug-ins will need to be copied as root (for example, by issuing an appropriate root command in the terminal, or by using the terminal to open a file manager application with root permissions).

To load the new effects into Audacity so they are available in the menu, use the Plug-in Manager: Effects, Generators and Analyzers dialog.

Audacity will also load LADSPA plug-ins from the following system locations:

- The path specified by the LADSPA_PATH environment variable
- ~/.ladspa
- /usr/local/lib/ladspa
- /usr/lib/ladspa
- $LIBDIR/ladspa

| Updating the repository package of Audacity may remove plug-ins that are not part of the package. To solve that problem you can: Create a folder called .audacity-files in your home directory, create a sub-folder called Plug-Ins (or Plugins) then add your plug-ins into that Add plug-ins to the Plug-Ins folder in the .audacity-data folder in your home directory. The dot in the folder name .audacity-data and .audacity-files indicates that it is a hidden folder, but the "Plug-Ins" subfolder in either folder is accessible without root permissions and will not be modified by installing a new Audacity package.

Audacity installed from a repository package or compiled from source should automatically find LADSPA plug-ins installed in /usr/lib/ladspa. This may not be the case if you are compiling older source code. If necessary you can set an environment variable to indicate to Audacity where LADSPA plug-ins are installed. For Debian-based distributions this can be done by entering the following code at the command prompt (change <user> to your account username):

export LADSPA_PATH=$LADSPA_PATH:/home/<user>/.ladspa:/usr/local/lib/ladspa:/usr/lib/ladspa

If you wish this path to be set each time you boot, the LADSPA_PATH environment variable may be added to ~/.profile or this file may be created if it does not exist. An example of how to add the LADSPA_PATH environment variable:

LADSPA_PATH=$LADSPA_PATH:/home/<user>/.ladspa:/usr/local/lib/ladspa:/usr/lib/ladspa export LADSPA_PATH

For OpenSuse 64, LADSPA plug-ins may be found in /usr/lib64/ladspa. This path can be set by adding the following line to your /etc/environment file:

LADSPA_PATH=/usr/lib64/ladspa

LV2 and VAMP plug-ins cannot be placed in the Audacity "Plug-Ins" folder or your .audacity-files folder. LV2 plug-ins should be installed by placing the complete .lv2 folder (not the individual files in that folder) in the root of ~/.lv2, /usr/local/lib/lv2, /usr/local/lib64/lv2, /usr/lib/lv2 or /usr/lib64/lv2. Alternatively the environment variable may be set as in this example:

export LV2_PATH=$HOME/.lv2:/usr/local/lib/lv2:/usr/lib/lv2

## Installing LV2 plug-ins

LV2 is a more advanced evolution of the LADSPA plug-in architecture which was originally developed on Linux.

To add a new LV2 effect, place its complete ".lv2" folder (not the files alone) at the top level of any of the following searched for locations:

- ~/.lv2
- /usr/local/lib/lv2 or /usr/local/lib64/lv2
- /usr/lib/lv2 or /usr/lib64/lv2

Search paths where Audacity looks for LV2 plug-ins may also be specified by setting the LV2_PATH environment variable. The path listed below is legitimate.

- $HOME/.lv2:/usr/local/lib/lv2:/usr/lib/lv2 (assuming $PREFIX is /usr/local as it should be by default)

Then use Effect > Add / Remove Plug-ins... to enable the LV2 effects and load them into Audacity, For details see Plug-in Manager: Effects, Generators and Analyzers.

## Installing VAMP plug-ins

VAMP plug-ins are usually for analyzing audio so will appear under Audacity's Analyze Menu. You can do interesting things like attempt to track beats, note pitches, chords or frequencies. Any VAMP plug-ins whose output is suitable for a label track should work in Audacity on GNU/Linux. To add a new VAMP analysis tool, add the plug-in's DLL, DYLIB or SO file and any supplied category or RDF files to any of the VAMP search locations then enable the tool in the Plug-in Manager: Effects, Generators and Analyzers dialog.

VAMP plug-ins may be installed in

- $HOME/vamp
- $HOME/.vamp
- /usr/local/lib/vamp
- /usr/lib/vamp.

Alternatively the VAMP_PATH environment variable may be set to any of those specified VAMP installation directories. VAMP plug-ins will normally be placed in the Analyze Menu of Audacity.

## How can I solve Audacity crashing after I add a plug-in?

Please see this FAQ

If you discover a specific plug-in that misbehaves in Audacity, please email our feedback address. Please include any available Debug report that Audacity generates.

##### Views

##### Useful External Links

- Forum
- Wiki
- Latest Release