Installing and updating on Mac OS X

From Audacity Development Manual
Revision as of 14:43, 22 February 2019 by PeterSampson (talk | contribs) (→‎Recommended Installer: ednote archiving the old way (.pkg installer))
Jump to: navigation, search
Other languages
This page provides instructions for installing and updating Audacity on Mac OS X and macOS computer platforms.
  • In addition to basic Audacity you may wish to install the optional LAME encoding software to enable MP3 exports
  • Also the optional FFmpeg library which allows Audacity to import and export a much larger range of audio formats including AC3, AMR (narrow band) and WMA and also to import audio from most video files.
Peter 14Feb19: The following is no longer true - attempting tp do so produces a QuickTime error - see Bug #2068
  • But note that on Mac Audacity can import, without FFmpeg, M4A (AAC), MP4 (including videos) and all other QuickTime-supported files.
Because of software patents, Audacity cannot include LAME or FFmpeg encoding software or distribute such software from its own websites. Instead, use the instructions below to download and install the free and recommended third-party libraries for LAME and FFmpeg.
Advice Note carefully that simply re-installing Audacity will not clear and reset your Audacity settings for preferences and plug-ins. For instructions on how to achieve this please see Reset Audacity Settings.
Alert Also note carefully that 2.3.1 Audacity on Mac is now a 64-bit application.

This means that if you are a user of previous Audacity versions on Mac and had installed the optional LAME and FFmpeg libraries then you must now install the 64-bit versions of those libraries.

Installing the 64-bit libraries will not overwrite or delete your 32-bit libraries.


Contents

  1. Installing Audacity on Mac
  2. Check for Updates
  3. Plug-ins from previous Audacity installations
  4. Installing LAME on Mac
  5. Installing the FFmpeg Import/Export Library on Mac
  6. Reset Audacity Settings


Installing Audacity on Mac

Installation instructions using .dmg files:

  1. On the download page, left-click the "installer" link, the .dmg file, (do not right-click). This takes you to the FossHub site where our downloads are hosted and the download should commence.
  2. Double-click the downloaded DMG to mount it.
  3. Do not double-click the “Audacity” application in the DMG window. Instead drag Audacity rightwards onto the /Applications folder shortcut. You can also drag Audacity out of the DMG to any other location. You need the administrator password to copy Audacity to /Applications.
  4. Eject the DMG at bottom left of Finder, then launch Audacity.app from /Applications or from your chosen location.

If you see any error messages when launching Audacity, please see our FAQ about Mac launch.


System Requirements

Audacity for Mac is for OS X 10.6 and later. Audacity runs best with at least 1 GB RAM and a 1 GHz processor (2 GB RAM/2 GHz on OS X 10.7 and later).

For lengthy multi-track projects, we recommend a minimum of 2 GB RAM and 2 GHz processor (4 GB RAM on OS X 10.7 and later).

Advice The 2.1.1 release was the final release for PPC Macs.

Projects saved by old versions of Audacity

Current Audacity is compatible with project files saved by versions of Audacity 1.3.x and later, including 2.x.x.


Check for Updates

You can check to see if you have the latest version of Audacity by using Help > Check for Updates....

This takes you to the Download page of the Audacity website where you can check what the latest release version of Audacity is.

You can then compare the latest release with the version you have now as shown by using Audacity > About Audacity....


Plug-ins from previous Audacity installations

If you had a previous installation of Audacity 2.1.2 or earlier, its shipped plug-ins were in the "plug-ins" folder where Audacity was installed. Versions of Audacity before 2.1.3 were usually installed inside a folder named "Audacity" which was in the "Applications" folder. Because Audacity's shipped plug-ins are now bundled inside the application, any still extant Nyquist plug-ins that came with previous Audacity will appear as a second copy of the plug-in in the Generate, Effect or Analyze Menu. Duplicates of other previously shipped plug-ins might appear even if they no longer exist, in which case they will fail to run.

  • You can remove any duplicates that don't run by using Effect > Add / Remove Plug-ins... then click OK. This does not remove the duplicates from the Plug-in Manager's list, but disables them so they do not appears in the menus.
  • Alternatively you can remove all unwanted duplicates, whether you have deleted the old Audacity installation folder or not, by deleting the file pluginregistry.cfg in ~/Library/Application Support/audacity/.
    • If you delete the Audacity folder from a previous installation, remember to move any optional plug-ins you added to its plug-ins folder to the new Audacity Plug-Ins folder at ~/Library/Application Support/audacity/Plug-Ins.


Installing LAME on Mac

Alert Peter 05Dec18: ToDo-1 for 2.3.1 we will need to update this with 64-bit LAME dylib instructions when we work out where it will be provided.
Audacity does mot include MP3 encoding software or distribute such software from its own websites. Instead, use the following instructions to download and install the free and recommended LAME third-party encoder to export MP3 files with Audacity.
Advice Audacity 2.3.1 on Mac is now a 64-bit application.

This means that if you are a user of previous Audacity versions on Mac and had installed the optional LAME library then you must now install the 64-bit versions of the LAME library, otherwise your MP3 exports will no longer work.

Installing the 64-bit LAME library will not overwrite or delete your 32-bit LAME library if you have one installed.

Recommended Installer

TBP

Peter 22Feb19: the old 2.3.0 and earlier way with a .pkg installer:
  1. Go to the external download page
     Left-click this link, do not right-click.
  2. Directly underneath "For FFmpeg and LAME on Mac OSX click below:", left-click the link "*** TBP ***.dmg".
  3. When you have finished downloading, double-click the DMG to mount it, if it has not been mounted automatically already.
  4. In the DMG window, or using the menu item for the mounted DMG in the Finder sidebar, double-click " TBP Lame Library v3.99.5 for Audacity.pkg" to launch the standard Mac installer. If you receive a warning that the package cannot be opened, right-click or Ctrl-click the package, choose "Open", then click "Open".
  5. Click through the steps in the installer. This will install the libmp3lame64bit.dylib file in the system library at /Library/Application Support/audacity/libs/.
  6. Audacity should detect LAME automatically when you export as MP3. If Audacity cannot find LAME:
    1. Click Audacity > Preferences... then choose "Libraries" on the left.
    2. Click Locate... to right of "MP3 Library:", then in the "Locate Lame" dialog that appears, click Browse....
    3. The "Where is libmp3lame64bit.dylib?" dialog will open at /Library/Application Support/audacity/libs/. Select the "libmp3lame64bit.dylib" file. If the file is grayed out, change the File type: dropdown entry to All Files or Dynamic Libraries.
    4. Click Open then OK and OK.

Alternative zip download

It is not recommended to extract the LAME library to /usr/local/lib because administrative or root permissions may be needed to read the LAME library from there.
  1. Go to the external download page
     Left-click this link, do not right-click.
  2. Directly underneath "For FFmpeg and LAME on Mac OSX click below:", left-click the link "Lame_Library_64bit_MAC_OSX_for_Audacity_2.3.1_and_above.zip"
  3. On most Macs this should extract the contents of the ZIP to your Downloads folder, it will be a single file called: libmp3lame64bit.dylib
    • Otherwise extract the contents of the downloaded ZIP file to obtain the file: libmp3lame64bit.dylib
  4. Then copy the file "libmp3lame64bit.dylib" and paste it anywhere you have full permissions.
    • The preferred default Audacity location is /Library/Application Support/audacity/libs
  5. In Audacity, click Audacity > Preferences... then choose "Libraries" on the left.
  6. Click Locate... to right of "MP3 Library:", then in the "Locate LAME" dialog that appears, click Browse....
    • This will normally open the Audacity default libraries location: /Library/Application Support/audacity/libs
  7. Navigate to and open the folder where "libmp3lame64bit.dylib" is, and select the "libmp3lame64bit.dylib" file
    • If the file is grayed out, change the File type: dropdown entry to All Files or Dynamic Libraries
  8. Click Open to return to the Locate Lame dialog
  9. Click OK in the Locate LAME dialog
  10. Note the LAME library has been located and should show alongside "MP3 Library Version:" as LAME 3.100
  11. Then click OK to exit Preferences.
You should now be able to export MP3s without any further configuration, choosing File > Export > Export as MP3

Installing the FFmpeg Import/Export Library on Mac

Alert Peter 09Jan19: ToDo-1 for 2.3.1 we will need to update this with 64-bit LAME & FFmpeg dylib instructions when we work out where it will be provided and what it will be called.
The optional FFmpeg library allows Audacity to import and export a much larger range of audio formats including M4A (AAC), AC3, AMR (narrow band) and WMA and also to import audio from most video files.
  • Because of software patents, Audacity cannot include the FFmpeg software or distribute it from its own websites. Instead, use the following instructions to download and install the free and recommended FFmpeg third-party library.
  • Advanced usage: If you already have 64-bit Audacity-compatible FFmpeg 2.2.x or 2.3.x shared libraries in the system PATH, Audacity will use those as long as you do not install FFmpeg from the links below and as long as you do not specify the FFmpeg you want Audacity to use in Libraries Preferences.
Advice Audacity 2.3.1 on Mac is now a 64-bit application.

This means that if you are a user of previous Audacity versions on Mac and had installed the optional FFmpeg library then you must now install the 64-bit versions of the FFmpeg library, otherwise your imports and exports that depend upon FFmpeg will no longer work.

Installing the 64-bit FFmpeg library will not overwrite or delete your 32-bit FFmpeg library if you have one installed.

Recommended Installer

  1. Go to the external download page
     Left-click this link, do not right-click.
  2. Directly underneath "For FFmpeg and LAME on Mac click below:", left-click the link "ffmpeg_64bit_osx.dmg"
  3. This should download the file "ffmpeg_64bit_osx.dmg" to your Downloads folder
  4. Double-click on that "ffmpeg_64bit_osx.dmg" file to bring uo the installer dialog
    • You should see three "Lego bricks" with file names on the left hand side - these are the files to be installed
    • On the right you should see a folder called libs - this is the folder where the files are to be installed, in full: /Library/Application Support/audacity/libs' '
  5. Either Select each "Lego brick" one at a time and drag it to the libs folder - or select all three "Lego bricks" using Shift + left-click and drag all three to the libs folder
  6. Exit the installation dialog.
Then follow the instructions below to locate ffmpeg.55.64bit.dylib using the Libraries Preferences.
Peter 22Feb19: the old 2.3.0 and earlier way with a .pkg installer:
  1. Go to the external download page
     Left-click this link, do not right-click.
  2. Directly underneath "For FFmpeg and LAME on Mac click below:", left-click the link "*** TBP 64-bit ***.dmg" and save the file anywhere on your computer.
  3. When you have finished downloading, double-click the DMG file to mount it (if you download with Safari, the FFmpeg virtual disk image will be extracted and mounted automatically after downloading). If the DMG window is not on top, go to Finder, then under "Devices" on the left, click the "TBP 64-bit ffmpeg-mac-2.2.2" DMG.
  4. In the DMG window, double-click the "TBP 64-bit ffmpeg-mac-2.2.2.pkg" to launch the standard OS X package installer. If you receive a warning that the package cannot be opened, right-click or Ctrl-click the package, choose "Open", then click "Open".
  5. Click through the steps in the installer, accepting the defaults in all cases. This will install the FFmpeg libraries in /Library/Application Support/audacity/libs.
  6. Restart Audacity if it was running when you installed FFmpeg then Audacity should detect FFmpeg automatically.
  7. If you have problems with Audacity detecting FFmpeg, follow the steps to manually locate FFmpeg.</ol>

Alternative Zip download

It is not recommended to extract the files to /usr/local/lib because administrative or root permissions may be needed to read the FFmpeg library from there.
  1. Go to the external download page
     Left-click this link, do not right-click
  2. Directly underneath "For FFmpeg and LAME on Mac OSX click below:", left-click the link "FFmpeg64bit_MAC_OSX_for_Audacity_2.3.1_and_above.zip"
  3. Some Mac computers may extract the files from the zip automatically to a new folder in the Downloads directory called: FFmpeg64bit MAC OSX for Audacity
    • Otherwise extract the contents of the downloaded ZIP file to obtain the folder to anywhere you have full permissions
  4. This folder will contain three files: ffmpeg_codecs.55.64bit.dyli, ffmpeg_utils.52.64bit.dylib and ffmpeg.55.64bit.dylib
  5. Copy all three files and paste them anywhere you have full permissions (such as your Documents folder)
    • The preferred default Audacity location is /Library/Application Support/audacity/libs
Then follow the instructions below to locate ffmpeg.55.64bit.dylib using the Libraries Preferences.
Tip Compiling Audacity against another build of FFmpeg:

Locating the FFmpeg library manually

If you installed FFmpeg while Audacity was running, or if you installed FFmpeg to a non-default location, Audacity will ask you to configure Preferences to locate the FFmpeg library.

To do this, access Preferences then the "Libraries" tab on the left:

Preferences Libraries FFmpeg NOT Found Mac.png

As in the image above, the "FFmpeg Library Version" will say "FFmpeg library not found". To correct this:

  1. Click the Locate... button to right of FFmpeg Library:
  2. If a "Success" message indicates Audacity has now automatically detected valid FFmpeg libraries 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 folder that contains FFmpeg and select the file "ffmpeg.55,64bit.dylib"
  5. Click Open then OK
  6. Note that the FFmpeg library has been located
  7. Then click OK to close Preferences.
FFmpeg Library Version should now show a set of three version numbers for the sub-libraries of FFmpeg ("F" for libavformat version, "C" for libavcodec version and "U" for libavutil version).

If you still see "not found", you may have installed the wrong libraries. Click the Download... button to obtain the correct library for your operating system. You can also choose Help > Diagnostics > Show Log... to see diagnostic information about FFmpeg detection.


Reset Audacity Settings on Mac

As stated in the introduction on this page, simply re-installing Audacity will not clear and reset your Audacity settings for preferences and plug-ins.

The data for these are stored in a folder called audacity in the Library>Application Support in your user directory.

On macOS the full pathname is: your username > Library > Application Support > audacity

To open the audacity settings folder:

  1. Open Finder and click on Go > Go to Folder...
  2. In the dialog box type ~/Library/Application Support/audacity
  3. click the Go button
Alternatively: on macOS the Library folder is usually hidden by default. To reveal it for future use:
  • In the sidebar of a Finder window, click on your username (it will have a house icon beside it)
  • Click on the View menu and select Show View Options
  • check "on" "Show Library Folder"
  • The Library folder will then show in your username folder

First you will need to quit Audacity.

To completely reset your Audacity settings

Navigate to that audacity folder with Finder and delete the entire contents. Then restart Audacity.

Advice If you have added additional plug-ins to the Plug-Ins folder and wish to keep them, do not delete that folder.

To reset just your Audacity preferences

Navigate to that audacity folder with Finder and delete the audacity.cfg file. Then restart Audacity.

To reset just your plug-ins

Navigate to that audacity folder with Finder and delete the:

  • pluginregistry.cfg file
  • pluginsettings.cfg file
  • Plug-Ins folder

Then restart Audacity

Advice If you want to reset your plug-in settings but do not want to lose any additional plug-ins you have added to the Plug-Ins folder, do not delete that folder.
Retrieved from "http://alphamanual.audacityteam.org/m/index.php?title=Installing_and_updating_Audacity_on_Mac_OS_X&oldid=63335"