# FAQ:Installation and Plug-Ins

### From Audacity Manual

## How do I download and install the LAME MP3 encoder?

Because of software patents, we cannot distribute MP3 encoding software ourselves. Follow these instructions to use the free LAME encoder to export MP3 files with Audacity.

Windows:

1. Go to the LAME download page
   Left-click this link, do not right-click
2. Under "For Audacity on Windows", left-click the link "Lame v3.98.2 for Audacity on Windows.exe" and save the file anywhere on your computer
3. Double-click "Lame_v3.98.2_for_Audacity_on_Windows.exe" to launch it (you can safely ignore any warnings that the "publisher could not be verified")
4. Follow the Setup instructions to install LAME for Audacity, and do not change the offered destination location of "C:\Program Files\Lame for Audacity"

You should now be able to export MP3s without any further configuration.

Troubleshooting: If there are any problems, they will likely be due to a conflict with Audacity still trying to detect or read the preferences path to an older lame_enc.dll file. To correct this, ensure there are no older versions of lame_enc.dll in any locations where Audacity detects it, namely:

- C:\Program Files\Lame for Audacity (where the installer puts the new .dll)
- the Audacity installation folder (usually C:\Program Files\Audacity 1.3 Beta (Unicode), or in the Plug-Ins folder inside that

Then exit Audacity and reset your preference settings file located at:

Documents and Settings\<user name>\Application Data\Audacity\audacity.cfg

On Windows Vista, this file is at Users\<user name>\AppData\Roaming\Audacity\audacity.cfg.

If you have never used any versions of Audacity other than Beta 1.3, delete the audacity.cfg file, and Audacity will recreate it. If you have previously used (or still use) Audacity 1.2, open audacity.cfg in a text editor, delete the two lines starting with:

[MP3]
MP3LibPath=

and save the changes.

Mac OS 9 or X:

1. Go to the LAME download page
2. Download either "Lame Library v3.98.2 for Audacity on OSX.dmg" or "LameLib-Carbon.sit", as required

Lame Library v3.98.2 for Audacity on OSX.dmg

1. When you have finished downloading, double-click the .dmg to mount it, then go to the Finder (in Safari, "Lame Library v3.98.2 for Audacity.pkg" will be extracted automatically after downloading).
2. Double-click "Lame Library v3.98.2 for Audacity.pkg". This will install the LAME binary "libmp3lame.dylib" in /usr/local/lib/audacity
3. The first time you use the "Export as MP3" command, Audacity will ask you where libmp3lame.dylib is saved - navigate to /usr/local/lib/audacity, select it and click "Open" then "OK"

LameLib-Carbon.sit

1. When you have finished downloading, extract the files with Stuffit Expander or similar (this may happen automatically)
2. Save the file called "LameLib" anywhere on your computer
3. The first time you use the "Export as MP3" command, Audacity will ask you where LameLib is saved - navigate to that location, select LameLib and click "Open" then "OK"

In case of difficulty, please view our detailed instructions on the Audacity Wiki.

Other Frequently Asked Questions...

## How do I download and install the FFmpeg Import/Export Library?

Windows:

1. Download the FFmpeg installer
   Left-click this link, do not right-click
2. Double-click the .exe file to launch the installer
3. Read the License and click Next, Next and Install to install the required files to C:\Program Files\FFmpeg for Audacity.

The first time you use FFmpeg to import or export, Audacity will ask you to configure Preferences to locate the FFmpeg library. To do this, click Edit > Preferences: Libraries and click the Locate... button, then Browse....

Mac:

1. Download the FFmpeg installer
2. When you have finished downloading, double-click the .dmg to mount it, then go to the Finder (in Safari, "FFmpeg Libraries for Audacity.pkg" will be extracted automatically after downloading)
3. Double-click "FFmpeg Libraries for Audacity.pkg" to launch the installer
4. Follow the instructions to perform a "standard installation"
5. The libraries will be installed in /usr/local/lib/audacity

The first time you use FFmpeg to import or export, Audacity will ask you to configure Preferences to locate the FFmpeg library. To do this, click Edit > Preferences: Libraries and click the Locate... button, then Browse....

If Audacity reports the version of FFmpeg is "incompatible": this will usually be because you have set environment variables for dynamic library search which are picking up another copy of the FFmpeg library. You will need to either set the environment variables to pick up the FFmpeg library you downloaded, or remove them. You can adjust standard environment variables in your .profile or shell environment, or via a property list in ~/.MacOSX/environment.plist - see this Developer Connection article for details.

- Alternatively, you can build Audacity from CVS and link to a system copy of FFmpeg built from source, using these instructions.

Linux/Unix:

- You may download (or build) a suitable FFmpeg library for your own purposes. To build, obtain the source code from the FFmpeg project. If you download a pre-built library, this might be either a "shared" or "static" build. A static build consists of a single libavformat library, whereas a shared build has at least three libraries (libavformat, libavcodec and libavutil). It is recommended to use a shared build, but Audacity will also work with a static build.

If you compile Audacity from source code, it will link to the installed FFmpeg headers, which should always be compatible with an installed FFmpeg binary.

- For Audacity 1.3.8 on Linux, a FFmpeg library or package later than 0.5 is required.
- AAC exports will be incorrect unless you disable the built-in AAC encoder (--disable-encoder=aac).

Installation:

To locate FFmpeg, open Preferences and click on the "Libraries'" tab:

If the "FFmpeg Library Version" says "not found":

1. Click "Find Library"
2. If a "Success" message indicates Audacity has now automatically detected the library and asks if you want to detect them manually, click "No", then OK to close Preferences.
3. If the "Locate FFmpeg" dialogue appears, click "Browse..."
4. Navigate to the avformat library, and select it. It may have different names, such as "avformat-52.dll" on Windows, "libavformat-52.dylib" on Mac or "libavformat.so.52" on Linux
5. Click "Open" then "OK", and "OK" again to close Preferences

"FFmpeg Library Version" should now show a number. If not, you may have installed the wrong libraries. Click the "Download" button to obtain the correct library for your operating system.

Other Frequently Asked Questions...

## Why do I receive an error when I export to an FFmpeg format?

If you receive a "cannot find audio codec" error when exporting to an FFmpeg format, the FFmpeg library you are linking to does not support this codec. To export to this format, you will need a build of the FFmpeg library that supports this codec.

Distributable libraries will not include support for AMR WB (wide band), due to licensing issues. Exporting to AMR WB will return the error "FFmpeg cannot find audio codec 0x 12001". To obtain AMR WB export support, you could build FFmpeg yourself from source and enable the relevant library in the configure step.

Other Frequently Asked Questions...

## How do I install VST plug-ins?

First, download and unzip the VST Enabler.

Place the unzipped VST Enabler, along with your VST plug-ins, into the “Plug-ins” folder in the Audacity installation folder. (On Mac OS X, this is usually in the Applications folder. On Windows, it is usually under Program Files.)

The next time you start Audacity, your VST effects will appear at the bottom of the “Effect” menu.

See also: Why do some VST plug-ins look wrong, or not work?

Other Frequently Asked Questions...

## Why do some VST plug-ins look wrong, or not work?

The VST Enabler. is not yet able to display custom interfaces for plug-ins. Instead, it uses generic controls for all VST plug-ins. Because of this, many plug-ins will look or act differently than they do in other programs.

Other VST plug-ins may not work at all, because of bugs in the VST Enabler. You can contact us to report plug-ins that do not work.

Audacity also does not support VST instrument (VSTi) plug-ins.

Other Frequently Asked Questions...

## What should I do if I have problems downloading or installing Audacity?

If you can't download Audacity, or if the downloaded setup file is corrupt, try downloading it from our alternate servers.

Other Frequently Asked Questions...

##### Views

##### Help Location

- Local manual in use
- Internet manual