FAQ:Installation and Plug-Ins - Audacity Manual

# FAQ:Installation and Plug-Ins

### From Audacity Manual

> Forward To: FAQ:Recording

< Back to: FAQ:About Audacity

|< Index of Frequently Asked Questions

## 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 the path to an older lame_enc.dll file. To correct this:

1. 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

2. Exit Audacity and navigate to the 1.3 preferences .cfg file at:

- Windows 2000/XP: Documents and Settings\<user name>\Application Data\Audacity\audacity.cfg
- Windows Vista/7: Users\<user name>\AppData\Roaming\Audacity\audacity.cfg.

3. Open audacity.cfg in a text editor such as Notepad, and delete the two lines starting with:
   - [MP3]
     MP3LibPath=
4. Save the changes to audacity.cfg and restart Audacity

In order to see audacity.cfg, you may need to set the operating system to show hidden files and folders. See instructions for Windows 7 and Windows versions before 7.

Note that the above four steps will remove old paths to lame_enc.dll for Audacity version 1.3 and later only. If you still use (or have ever used) Audacity 1.2, that version will continue to look for the .dll in the location stored in its own Preferences setting.

Merely exiting Audacity and deleting audacity.cfg will not remove old paths to lame_enc.dll for 1.3 if you have ever previously used a 1.2 version. In that case Audacity 1.3 and later would still look up the path from the 1.2 Preferences setting.

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.

back to top

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

Please follow both the 1. Download and 2. Installation steps below.

### 1. Download

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.

  *Alternative zip download - extract the contents to a folder called "FFmpeg_2009_07_20_for_Audacity_on_Windows" anywhere on your computer.

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.

- Alternatively, you can build Audacity from SVN 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 or later 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).

### 2. Installation

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 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" dialog 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.

Note for Mac users: 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. 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.

back to top

## 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.

back to top

## 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?

back to top

## 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.

back to top

## 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.

back to top

> Forward To: FAQ:Recording

< Back to: FAQ:About Audacity

|< Index of Frequently Asked Questions

##### Views

##### Help Location

- Local manual in use
- Internet manual