Talk:Effects Preferences

=image map entry for Modules parked here= rect 32 288 122 303 Modules Preferences

=Archived from the page= As Gale points out in his ednote: "We probably won't need the plug-in search list here and in Effect Menu when Register Effects supports all plug-in types."

Register Effects dialog for LADSPA, VST and Audio Unit effect plug-ins
When you use Audacity for the first time, Audacity will scan for supported plug-ins of all types. The Register Effects dialog lists all LADSPA, VST and Audio Unit (Mac OS X) plug-ins that are detected, with checkboxes to enable each plug-in or not. On Windows and Mac, this first time dialog will list a minimum of hard_limiter_1413 and sc4_1882. Those two plug-ins are shipped with Audacity and you will usually want to enable them.

After OK'ing this dialog, all detected Nyquist, LV2 and VAMP plug-ins (including the Nyquist plug-ins shipped with Audacity) will also load, along with the plug-ins chosen in the dialog. If Audacity finds a "shell" VST plug-in that hosts multiple effects, a dialog will appear showing the progress of registering the individual effects in the shell.

After first Audacity launch, the Register Effects dialog only appears again at launch time:
 * When Audacity detects new LADSPA, VST or Audio Unit plug-ins (if the check for them is enabled in Plug-in Options)
 * When a rescan of plug-ins is enabled in Plug-in Options, which behaves like the "first time" scan above
 * When you reset Audacity Preferences, which also behaves like first time scan.


 * Installvst.png

The names of the detected plug-ins will be listed alphabetically for each folder in the Path column. All list items have their checkboxes checked by default, the green checkmark indicating that the plug-in will be loaded. To load all the detected plug-ins, just click then Audacity itself will launch. If you deselect some items by mistake, you can quickly re-enable the entire list by choosing the button. The button lets you disable the entire list. This provides a quick method of then enabling only a few plug-ins in a long list.

To disable loading of a specific plug-in, left-click the item's row or checkbox which removes the checkmark. Similarly, click to re-enable a disabled item. Using the keyboard, press arrow,  arrow,  or  to navigate the list then press  to check or uncheck the current item's checkbox. Finally, click to load the enabled plug-ins and launch Audacity. Providing you click and the enabled plug-ins load successfully, then next time you launch Audacity there will be no Register Effects dialog. The plug-ins that you previously enabled in the dialog will appear in the Effect menu, ready to be used when you select them.

If you click in the dialog or if loading a faulty plug-in causes Audacity to crash,  the "Register Effects" dialog will appear again next time you launch Audacity. If Audacity crashed you can therefore use the dialog to experiment by disabling plug-ins that may have crashed. Alternatively, before restarting Audacity you can look in the pluginregistry.cfg file in the Audacity folder for application data. This file will list which plug-ins Audacity had managed to load before it crashed.

Audacity looks in the following locations for plug-ins controlled by the Register Effects dialog

 * VST:
 * Windows, Mac and GNU/Linux:
 * The Audacity plug-ins folder in the location Audacity is run from:
 * On Windows and OS X the "Plug-Ins" folder is in the directory where Audacity resides - usually C:\Program Files or C:\Program Files (x86) on Windows or the "/Applications" folder on OS X
 * 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)
 * The "Plug-Ins" folder in Audacity's folder for application data.
 * Also on Windows:
 * C:\Program Files\Steinberg\VSTPlugins (or C:\Program Files (x86)\Steinberg\VSTPlugins on 64-bit systems).
 * Windows Registry key HKCU\Software\VST\VSTPluginsPath
 * Windows Registry key HKLM\Software\VST\VSTPluginsPath
 * All paths specified by the "VST_PATH" environment variable
 * Also on Mac OS X:
 * ~/Library/Audio/Plug-Ins/VST
 * /Library/Audio/Plug-Ins/VST
 * All paths specified by the "VST_PATH" environment variable
 * Also 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


 * LADSPA:
 * All operating systems:
 * The path specified by the LADSPA_PATH environment variable
 * The Audacity plug-ins folder
 * On Windows and OS X the "plug-ins" folder is in the directory where Audacity resides - usually C:\Program Files on Windows or the "Applications" folder on OS X.
 * On Linux, the "plug-ins" folder is in usr/share/audacity if you installed an Audacity package supplied by your distribution, or usr/local/share/audacity if you compiled Audacity from source code. Optionally a plug-in folder can be created in the home directory ~/.audacity-files/plug-ins.
 * Also on OS X:
 * ~/Library/Audio/Plug-Ins/LADSPA
 * /Library/Audio/Plug-Ins/LADSPA
 * Also on GNU/Linux:
 * ~/.ladspa
 * /usr/local/lib/ladspa
 * /usr/lib/ladspa
 * $LIBDIR/ladspa


 * Audio Units:
 * Mac OS X:
 * ~/Library/Audio/Plug-Ins/Components (user plug-ins)
 * /Library/Audio/Plug-Ins/Components (system-wide plug-ins)