Difference between revisions of "Ladspa Plug-ins"

From Audacity Wiki
Jump to: navigation, search
m
(Tidy up paths on Linux (Audacity does not see plug-ins in $HOME/.ladspa/) ; add Intro and LV2 link)
Line 1: Line 1:
'''Related pages:'''
+
{{Introrel|1=[http://en.wikipedia.org/wiki/LADSPA LADSPA] ('''L'''inux '''A'''udio '''D'''evelopers '''S'''imple '''P'''lugin '''A'''PI) is an audio plug-in standard originally developed on Linux, but which can be ported to Windows and Mac too. Audacity has built-in support for LADSPA plug-ins.|2=|3=[[Nyquist Plug-ins]]
 +
*[[VST Plug-ins]]
 +
*Other pages in our [[:Category:Plug-ins|Plug-ins category]]}}
  
'''[[Nyquist Plug-ins]]'''
 
  
'''[[VST Plug-ins]]'''
+
__TOC__
  
'''Other pages in our [[:Category:Plug-ins|Plug-ins category]]'''
+
==Writing LADPSA plug-ins==
 +
Audacity behaves as an excellent LADSPA host. Just read up about LADSPA, and make your plug-ins correctly. As a starting point, look at the [http://gdam.ffem.org/ladspa-doc/ladspa.html LADSPA developers' documentation] and the LADSPA site's [http://www.ladspa.org example plug-ins]. Keep in mind that Audacity "runs" the plug-in multiple times with some specific number of samples. So, don't assume that your plug-in will get the entire selection the first time. Here is an [http://www.it.iitb.ac.in/~chetanv/personal/acads/musicology/project/ example LADSPA plug-in] made by a user for plotting frequency variation. 
  
  
Audacity behaves as an excellent LADSPA ('''L'''inux '''A'''udio '''D'''eveloper's '''S'''imple '''P'''lugin '''A'''PI) host. Just read up about LADSPA, and make your plug-ins correctly. As a starting point, look at the {{external|[http://gdam.ffem.org/ladspa-doc/ladspa.html LADSPA developers' documentation]}} and the LADSPA site's {{external|[http://www.ladspa.org example plug-ins]}}.  
+
==Using LADSPA plug-ins==
 +
===Linux===
 +
Nothing special is needed for using LADSPA plug-ins for Audacity on Linux. It's usually most convenient to place your LADSPA plugsin in:
 +
* any colon-delimited path specified by the {{path|LADSPA_PATH environment variable}}
 +
* {{path|$INSTALL_PREFIX/ladspa}}
 +
* {{path|/usr/local/lib/ladspa}}
 +
* {{path|$LIBDIR/ladspa}} 
 +
 
 +
Then restart Audacity and the plug-ins should be in the {{menu|Effect}} menu, underneath the divider.  
  
Nothing special is needed for writing LADSPA plug-ins for Audacity on '''Linux'''. Just place your plug-in in $HOME/.ladspa/ and it should appear in the {{menu|Effect}} menu. Also, keep in mind that Audacity "runs" the plug-in multiple times with some specific number of samples. So, don't assume that your plug-in will get the entire selection the first time. Here is an {{external|[http://www.it.iitb.ac.in/~chetanv/personal/acads/musicology/project/ example LADSPA plug-in]}} made by a user for plotting frequency variation.
+
If you have the ladspa-sdk installed, you can run '''listplugins''' from a terminal to list all plug-ins in your LADSPA_PATH.  
  
Audacity also supports LADSPA plug-ins on '''Windows''' and '''Mac OS X'''.  In fact the current {{external|[http://audacityteam.org/vst/ VST enabler]}} for these platforms works by putting VST plug-ins inside a LADPSA wrapper. So if you can compile your LADSPA plug-in source code to be a windows .dll or Mac shared Lib, it will work there as well. Simply place your plug-in in the '''Plug-Ins''' folder inside your Audacity installation folder and restart Audacity. Your installation folder is usually under {{path|C:\Program Files}} on Windows, or under {{path|Mac Hard Disk > Applications}} on OS X.
+
{{Hint|Advanced users on Linux can compile the latest Audacity Beta [http://audacity.sourceforge.net/community/developers#svn development code] and enable [[LV2_Support/Project_Docs|experimental support]] for [http://lv2plug.in/ LV2]. This is an extensible, "second-generation" version of LADSPA that has a wider range of effects, can use LV2 synthesizer plug-ins as powerful tone generators, and supports effect categorisation.}} <br>
 +
 
 +
===Windows and Mac OS===
 +
Audacity also supports LADSPA plug-ins on Windows and Mac OS. Any LADSPA plug-in compiled as a Windows .dll or Mac .dylib shared library will work on these platforms. An extensive set of LADSPA plug-ins is available for [http://audacity.sourceforge.net/beta/ladspa/ladspa-0.4.15.exe Windows] and [http://ardour.org/files/releases/swh-plugins-0.4.15.dmg Mac OS X].
 +
 
 +
To add LADSPA plug-ins to Audacity, place them in the '''Plug-Ins''' folder inside the Audacity installation folder. Restart Audacity and the plug-ins should be in the {{menu|Effect}} menu, underneath the divider. The Audacity installation folder is usually under {{path|C:\Program Files}} on Windows, or under {{path|Mac Hard Disk > Applications}} on OS X.  
 +
 
 +
As on Linux, Audacity will also detect LADSPA plug-ins if you put them in a folder specified in the {{path|LADSPA_PATH environment variable}}. 
  
 
[[Category:Plug-ins]]
 
[[Category:Plug-ins]]

Revision as of 23:58, 26 November 2010

LADSPA (Linux Audio Developers Simple Plugin API) is an audio plug-in standard originally developed on Linux, but which can be ported to Windows and Mac too. Audacity has built-in support for LADSPA plug-ins.
 
Related article(s):


Writing LADPSA plug-ins

Audacity behaves as an excellent LADSPA host. Just read up about LADSPA, and make your plug-ins correctly. As a starting point, look at the LADSPA developers' documentation and the LADSPA site's example plug-ins. Keep in mind that Audacity "runs" the plug-in multiple times with some specific number of samples. So, don't assume that your plug-in will get the entire selection the first time. Here is an example LADSPA plug-in made by a user for plotting frequency variation.


Using LADSPA plug-ins

Linux

Nothing special is needed for using LADSPA plug-ins for Audacity on Linux. It's usually most convenient to place your LADSPA plugsin in:

  • any colon-delimited path specified by the LADSPA_PATH environment variable
  • $INSTALL_PREFIX/ladspa
  • /usr/local/lib/ladspa
  • $LIBDIR/ladspa

Then restart Audacity and the plug-ins should be in the Effect menu, underneath the divider.

If you have the ladspa-sdk installed, you can run listplugins from a terminal to list all plug-ins in your LADSPA_PATH.


Advanced users on Linux can compile the latest Audacity Beta development code and enable experimental support for LV2. This is an extensible, "second-generation" version of LADSPA that has a wider range of effects, can use LV2 synthesizer plug-ins as powerful tone generators, and supports effect categorisation.

Windows and Mac OS

Audacity also supports LADSPA plug-ins on Windows and Mac OS. Any LADSPA plug-in compiled as a Windows .dll or Mac .dylib shared library will work on these platforms. An extensive set of LADSPA plug-ins is available for Windows and Mac OS X.

To add LADSPA plug-ins to Audacity, place them in the Plug-Ins folder inside the Audacity installation folder. Restart Audacity and the plug-ins should be in the Effect menu, underneath the divider. The Audacity installation folder is usually under C:\Program Files on Windows, or under Mac Hard Disk > Applications on OS X.

As on Linux, Audacity will also detect LADSPA plug-ins if you put them in a folder specified in the LADSPA_PATH environment variable.