Difference between revisions of "Mac OS X"

From Audacity Wiki
Jump to: navigation, search
(Audio Units issues: AU MatrixReverb & AU GraphicEQ issues resolved - removed)
 
(112 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Audacity is fully supported under Mac OS X.  However, there are a number of quirks, and because of subtle differences between Mac OS X and other platforms, you may discover bugs or issues that are specific to Mac OS X. This page is solely for recording such OS X-specific problems, in other words those that are '''specific to the Apple Mac OS X operating system''' and thus '''do not occur with Audacity on Microsoft Windows or Unix/Linux systems'''.  
+
{{DISPLAYTITLE:macOS / Mac OS X}}
 +
{{intro|Audacity is fully supported under macOS and Mac OS X.  However, there are a number of quirks, and because of subtle differences between Mac and other platforms, you may discover bugs or issues that are specific to Mac. This page is solely for documenting Mac-specific behavior that does not occur on Windows or Unix/Linux systems.|}}
  
This page is intended as a reference point only. It is not constantly monitored by the Audacity team and is thus '''not''' meant as a direct method for obtaining technical support. 
 
  
<span style="color:#BA55D3;font-weight:bold">Before adding a report here, please check the existing reports below thoroughly, plus our extensive online help resources as listed on our </span>[[Reporting Bugs]] <span style="color:#BA55D3;font-weight:bold"> page, to see if your issue is already known. Only add an issue on this page if you're sure it is something specific to Macs only, you're sure of your facts, and that there is not some other explanation for the problem. In all other cases, please follow the instructions on </span> [[Reporting Bugs]] <span style="color:#BA55D3;font-weight:bold">to get help and/or give us a useful bug report that we can follow up. </span>
+
__TOC__
  
<span style="color:#CC9900;font-weight:bold">If you are looking to request a new feature for Audacity, please go to our </span>[[Feature Requests]] <span style="color:#CC9900;font-weight:bold"> page.</span>
+
<div id="dmg"></div>
 +
==Audacity should not be run inside the DMG image==
 +
You should not run Audacity from within the DMG image it's distributed in and must not separate the Audacity application from the folder it came in. Otherwise:
 +
* You won't be able to save or export files without changing the directory you are saving or exporting to
 +
* You will be warned that "Critical Nyquist files cannot be found" and will not be able to use Audacity's optional plug-ins.
  
= Active issues =
+
'''Always install Audacity like this:'''
 +
<ol>
 +
<li>Double-click the downloaded DMG to mount it.
 +
<li>Drag the "Audacity" folder from the newly mounted DMG to the "Applications" icon underneath "Places" on the left of Finder. Alternatively you can instead copy the "Audacity" folder to any other location of your choosing.
 +
<div style="margin-top:-20px;margin-bottom:-20px">{{advice|Do not double-click the "Audacity" folder to open it and drag only the Audacity icon to /Applications. The Audacity application must be kept inside the Audacity folder at all times.}}</div>
 +
<li> Eject the DMG in the "Devices" section on the left of Finder, or from the desktop by right-clicking on it, then launch the Audacity application from the "Audacity" folder that you copied.
 +
<li> You can, if you wish, drag a copy of the Audacity icon from the Applications folder to the application dock at the bottom of the Mac screen, where it will remain docked.  You can then simply launch Audacity by clicking there
 +
</ol>
  
Many differences between the OS X and other platforms relate to the audio platform API - in the case of Mac OS X, this API is called [[CoreAudio]]. 
 
  
== Input sources not selectable in Audacity == 
+
<div id="no_sound"></div>
 
 
[[Core Audio]] does not offer individual applications any straightforward options for setting the input source (for example, the microphone) of a recording device. Select your input source in Audio-MIDI Setup.
 
 
 
== No Unicode or long filename support ==
 
 
 
There are bugs in the Mac version of wxWidgets, called wxMac, that can affect Audacity. One bug involves Unicode support: because of this bug, Audacity stable 1.2.x versions cannot work with files or folders located inside a directory named with non-ASCII characters (usually international or accented characters). There is an additional artificial restriction of file name length, limiting your filenames to 32 characters despite support in OS X for much longer names. Upgrade to 1.3.3 for Unicode and long filename support.
 
  
 
== Loss of sound after running Audacity ==  
 
== Loss of sound after running Audacity ==  
 +
If you have lost sound on your system after connecting headphones for an Audacity session then removing them, try connecting your headphones again then '''gently''' manipulate the headphones plug up/down and left/right so as to bend back the internal component to its correct position. Do this several times if necessary so that the internal switch for the headphones is fully released.
 +
  
An issue whereby certain other applications lose sound after Audacity has run (see {{external|1=[http://docs.info.apple.com/article.html?artnum=300832 this Apple article]}}) has now been largely resolved with the release of the current Audacity 1.2.5 for Intel and 1.2.6 for Power PC releases and 1.3.2 and later Beta releases.   
+
<div id="streaming"></div>
 
 
 
== No built-in streaming audio recording ==  
 
== No built-in streaming audio recording ==  
 +
Macs have no ability to record streaming as it plays on the built-in sound device as can be done on Windows and Linux (if the sound device has that capability). It is possible to record streaming audio from the built-in microphone, but this a very lossy method that also picks up all ambient noise. Alternatives:
 +
* Join the line-out to line-in, then recording from the built-in input set to line-in
 +
* Capture the stream digitally with applications other than Audacity, before it reaches the soundcard.
 +
* Download the stream, if its web address is known
  
Macs almost always have no ability to record streaming audio internally off the built-in audio device. Use {{external|[http://www.rogueamoeba.com/audiohijack/ Audio Hijack]}} or {{external|[http://www.ambrosiasw.com/utilities/wiretap/ Wiretap]}}. Turn off compression in Wiretap Preferences if you want to import the recorded AIFF files into Audacity.
+
For more details, see [[Recording Computer Playback on Mac]].
 
 
== Limited support for external audio devices ==
 
 
 
Many (mostly higher-end) external Firewire Input/Output devices and some USB Input/Output devices won't work in 1.2.5/6. Use Audacity 1.3.3 Beta instead which uses our later PortAudio v19 interface. 
 
 
 
Additionally, it's necessary to set up external sound devices such as USB and Firewire interfaces in Apple Audio-MIDI Setup, in addition to doing so in Audacity. This also applies in the Beta version of Audacity. 
 
 
 
== Unresponsive Play and Record buttons == 
 
 
 
The Record and occasionally Play buttons can fail to respond. Click them repeatedly or upgrade to Audacity 1.3.3. 
 
 
 
== 1.2.6 PPC only launches in English ==
 
 
 
Unfortunately the official release of 1.2.6 on our website will only launch in English. To run 1.2.6 in other languages, drag the entire contents of the folder where you have Audacity installed to Trash, and download {{external|[http://www.gaclrecords.org.uk/audacity-macosx-ppc-1.2.6-test.dmg this version of 1.2.6]}} instead.
 
 
 
== Audio Units Matrix Reverb  ==
 
 
 
AUMatrixReverb will only output in stereo and needs a stereo track to work on, so cannot be used on a mono track. It seems to be the only one of the built-in AudioUnits plugins that has this limitation. To work round it, select the track by clicking in its Track Panel above the Mute/Solo buttons, then {{menu|Edit > Duplicate}}. Click on the dropdown arrow in the Track Panel of the upper track > {{menu|Make Stereo Track}}. After processing with AUMatrixReverb, click the arrow again > {{menu|Split Stereo Track}}, click the arrow once more in the upper track and make it Mono, then delete the lower track by clicking on the [X] in the Track Panel. This only applies to 1.3.1 and later.
 
 
 
 
 
= Cleared issues =
 
 
 
== Crash when recording in 24 bit quality ==
 
 
 
Resolved in 1.2.5 Intel/1.2.6 Power PC
 
 
 
== Griffin iMic mono 8 bit recording problem ==
 
 
 
Griffin iMic re-sets recording to mono 8bit only. Resolved in 1.2.4
 
 
 
== Audacity won't launch on case-sensitive file systems ==
 
 
 
Resolved in 1.2.5 Intel/1.2.6 Power PC
 
 
 
==Previous Intel Mac naming issue with libmp3lame.dylib==
 
 
 
An earlier version of {{external|http://spaghetticode.org/lame/libmp3lame-osx-universal-3.97.zip}} mistakenly named the included MP3 encoding binary as libmp3lame.so instead of the libmp3lame.dylib which Audacity asks for. If you have this earlier version, please download the latest version from the link above.
 
 
 
 
 
 
 
= User Reports =
 
 
 
==Echo/looping hardware fault==
 
 
There is an audio looping/echo is a known fault on the newest (2005) [[PowerBooks]]  (17 &15 inch) There are threads on Apple's support/discussions pages. Also occurs on PPC iBooks. It seems to be a core audio problem. Possibly a data stream corruption
 
through to the sound processors. [[PowerBook]] users are awaiting a fix. Some people think it may be a logic board fault.Killing core audio in Activity viewer seems to be a temporary cure.
 
 
 
== Network Home Weirdness ==
 
 
 
Audacity 1.3.3 was installed by a local admin.  Users with network homes receive a 'You cannot open the application "Audacity.app" because it is not supported on this system'.
 
 
 
If a network user downloads and installs it, that network user can run it, but not others.  There was some other weirdness with local accounts that was fixed with loosening the permissions.
 
 
 
It can be run from the command line.  It seems to work, but starts wth the error 'The path "Languages" contains too many ".."!'.
 
 
 
''This symptom can be reproduced by creating a non-admin user and attempting to launch Audacity from the non-admin user.''
 
 
 
<span style="color:green">Try changing the permissions of the Audacity executable within the Audacity.app bundle.</span>
 
 
 
# <span style="color:green">Open the Terminal.app from an Administrator account</span>
 
# <span style="color:green">Update the permissions of the Audacity executable:</span><br>
 
{{code|chmod 755 "<path to Audacity.app folder>/Contents/MacOS/Audacity"}}
 
 
 
<span style="color:green">The <path to Audacity.app folder> should be replaced with the full or relative path to where you placed the Audacity.app folder.  For instance, if you created an "Audacity1.3.3Beta" folder inside your Applications folder and placed the entire contents of the downloaded .dmg file inside there, you would use:</span>
 
 
 
{{code|chmod 755<br>
 
"/Applications/Audacity1.3.3Beta/Audacity.app/Contents/MacOS/Audacity"}}
 
 
 
 
 
A side note, the owner in the package is 777, this should be changed to 501.'''-->Please explain this for the non-commandline folks.
 
'''
 
 
 
I've chown -R 501 the folder and chmod -R 777 the folder.  Neither works. '''-->Please explain this for the non-commandline folks.'''
 
 
 
501 is the uid of the first local user created user (the local admin in this case).  It almost always exists and is a safe bet for ownership. chown -R 501 changes the ownership of all of the files to the user with uid 501
 
  
777 translates to -rwxrwxrwx, everyone has full permissions.
 
  
So, I changed the ownership to a real user and gave everyone full permission to everything.
+
<div id="external"></div>
I don't _think_ that there are any preference files written to /Library, but I didn't check.  This wouldn't affect those.
+
== Support and setup for external audio devices ==
 +
Some external audio devices (for example, some USB microphones or headets and most USB or Firewire input/output interfaces) won't work correctly in Audacity unless the device is set up in '''/Applications/Audio MIDI Setup''', as well as doing so in Audacity.
 +
<ol>
 +
<li> If you connected your external device while Audacity was open, click {{Menu|Audacity > Quit Audacity}} and restart it, so that Audacity can see the device 
 +
<li> In Audacity, select the device at {{menu|Audacity > Preferences: Devices}} in the "Recording Device" box (and in the "Playback Device" box if appropriate) ''(these preferences are under "Audio I/O" in earlier Betas)'' 
 +
<li>On the same tab, choose the number of "Recording Channels" required
 +
<li> Open the {{menu|Finder > Applications > Utilities > Audio MIDI Setup}}:<br>[[Image:MacAudioMidiSetupUSB.png|535px|Apple Audio-MIDI Setup on OS X 10.5]]
 +
<li> Click the Audio Devices tab and make sure on the left-hand (input) side that your device is selected in the "Default Input" and "Properties For" boxes - in the image above our device is called "USB Audio Codec"
 +
<li> Match the input sample rate and channel mode in Audio MIDI Setup in all places - with your Audacity settings, and with any settings on the device or in its control software: for example, if the Audacity Project Rate at bottom left is 44100 Hz and you're recording in stereo, set the Audio MIDI input "Format" boxes to "44100.0 Hz" and "2 ch-16 bit"
 +
<li> If you are playing back to the device, go to the right-hand (output) side of Audio MIDI Setup, set the device as Default Output and System Output, and similarly match the settings in the "Format" boxes to your settings in Audacity and in the device </ol><br>
 +
{{Hint|1=In more advanced interface devices with 24-bit capability, it may also be necessary to explicitly match the Audacity "Default Sample Format" at {{Menu|Audacity > Preferences: Quality tab}} with both the Audio MIDI format settings and with the bit depth setting in the device.}}
  
---
 
  
Based on what I'm seeing here, and have tried myself, I'm not convinced the other authors got this to work.  I have a non-admin local account that still refuses to run Audacity 1.3.3, generating the error listed above.
+
<div id="usb"></div>
 +
==Using USB audio devices on Mac==
 +
For help configuring USB audio devices on Mac, see [[Mac and USB input devices]].
  
---
 
  
== Vanishing Envelopes  ==  
+
<div id="midi"></div>
 +
==Playing Note tracks - MIDI and Allegro playback ==
 +
Note tracks containing MIDI data (or Allegro data) can now be played in Audacity.  '''Loop Play''' and '''Play Cut Preview''' also work with Note tracks.  But note that there will no use of the '''Playback meter''' while Note tracks are played.
  
'''Problem with 1.3.3:'''
+
In order to achieve MIDI playback on Mac you will need to install, and run, additional software, a [https://en.wikipedia.org/wiki/Software_synthesizer software synthesizer] 
  
Files created in Audacity 1.3.2 or 1.3.3 vanish (or are squashed to occupy a single point at the beginning of the track) when file is opened with Audacity 1.3.3.  
+
Please see this page in the Audacity Wiki for details: [[Enabling Note Track playback on Mac]].
  
In earlier versions, you could make them reappear by performing any kind of action and then undoing it - the envelopes would magically reappear. With the release of 1.33, this no longer works - after saving, closing, and reopening the file, the envelopes are gone for good. Others have {{external|[http://www.nabble.com/Envelope-Points-Aren't-Saving-t3875057.html  reported the same problem]}}.
 
  
I have read that this was a known bug which was repaired in 1.3.3, but that is clearly not the case.
+
<div id="audiounits"></div>
 +
== Audio Units issues  ==
 +
* Some older third-party AU plug-ins can be very slow to load on launch or unload on exit, or may completely hang Audacity on launch. See the [[Audio Units#slow|Audio Units]] page for a workaround.
  
''Mac OSX 10.4.10 on a PowerBook G4'',  July 15, 2007
 
  
  
[[Category:Troubleshooting]]
+
{{CategoryTroubleshooting}}
 +
[[Category:Mac Platform]]

Latest revision as of 14:38, 1 November 2017

Audacity is fully supported under macOS and Mac OS X. However, there are a number of quirks, and because of subtle differences between Mac and other platforms, you may discover bugs or issues that are specific to Mac. This page is solely for documenting Mac-specific behavior that does not occur on Windows or Unix/Linux systems.


Audacity should not be run inside the DMG image

You should not run Audacity from within the DMG image it's distributed in and must not separate the Audacity application from the folder it came in. Otherwise:

  • You won't be able to save or export files without changing the directory you are saving or exporting to
  • You will be warned that "Critical Nyquist files cannot be found" and will not be able to use Audacity's optional plug-ins.

Always install Audacity like this:

  1. Double-click the downloaded DMG to mount it.
  2. Drag the "Audacity" folder from the newly mounted DMG to the "Applications" icon underneath "Places" on the left of Finder. Alternatively you can instead copy the "Audacity" folder to any other location of your choosing.
    Warning icon Do not double-click the "Audacity" folder to open it and drag only the Audacity icon to /Applications. The Audacity application must be kept inside the Audacity folder at all times.
  3. Eject the DMG in the "Devices" section on the left of Finder, or from the desktop by right-clicking on it, then launch the Audacity application from the "Audacity" folder that you copied.
  4. You can, if you wish, drag a copy of the Audacity icon from the Applications folder to the application dock at the bottom of the Mac screen, where it will remain docked. You can then simply launch Audacity by clicking there


Loss of sound after running Audacity

If you have lost sound on your system after connecting headphones for an Audacity session then removing them, try connecting your headphones again then gently manipulate the headphones plug up/down and left/right so as to bend back the internal component to its correct position. Do this several times if necessary so that the internal switch for the headphones is fully released.


No built-in streaming audio recording

Macs have no ability to record streaming as it plays on the built-in sound device as can be done on Windows and Linux (if the sound device has that capability). It is possible to record streaming audio from the built-in microphone, but this a very lossy method that also picks up all ambient noise. Alternatives:

  • Join the line-out to line-in, then recording from the built-in input set to line-in
  • Capture the stream digitally with applications other than Audacity, before it reaches the soundcard.
  • Download the stream, if its web address is known

For more details, see Recording Computer Playback on Mac.


Support and setup for external audio devices

Some external audio devices (for example, some USB microphones or headets and most USB or Firewire input/output interfaces) won't work correctly in Audacity unless the device is set up in /Applications/Audio MIDI Setup, as well as doing so in Audacity.

  1. If you connected your external device while Audacity was open, click Audacity > Quit Audacity and restart it, so that Audacity can see the device
  2. In Audacity, select the device at Audacity > Preferences: Devices in the "Recording Device" box (and in the "Playback Device" box if appropriate) (these preferences are under "Audio I/O" in earlier Betas)
  3. On the same tab, choose the number of "Recording Channels" required
  4. Open the Finder > Applications > Utilities > Audio MIDI Setup:
    Apple Audio-MIDI Setup on OS X 10.5
  5. Click the Audio Devices tab and make sure on the left-hand (input) side that your device is selected in the "Default Input" and "Properties For" boxes - in the image above our device is called "USB Audio Codec"
  6. Match the input sample rate and channel mode in Audio MIDI Setup in all places - with your Audacity settings, and with any settings on the device or in its control software: for example, if the Audacity Project Rate at bottom left is 44100 Hz and you're recording in stereo, set the Audio MIDI input "Format" boxes to "44100.0 Hz" and "2 ch-16 bit"
  7. If you are playing back to the device, go to the right-hand (output) side of Audio MIDI Setup, set the device as Default Output and System Output, and similarly match the settings in the "Format" boxes to your settings in Audacity and in the device

In more advanced interface devices with 24-bit capability, it may also be necessary to explicitly match the Audacity "Default Sample Format" at Audacity > Preferences: Quality tab with both the Audio MIDI format settings and with the bit depth setting in the device.


Using USB audio devices on Mac

For help configuring USB audio devices on Mac, see Mac and USB input devices.


Playing Note tracks - MIDI and Allegro playback

Note tracks containing MIDI data (or Allegro data) can now be played in Audacity. Loop Play and Play Cut Preview also work with Note tracks. But note that there will no use of the Playback meter while Note tracks are played.

In order to achieve MIDI playback on Mac you will need to install, and run, additional software, a software synthesizer

Please see this page in the Audacity Wiki for details: Enabling Note Track playback on Mac.


Audio Units issues

  • Some older third-party AU plug-ins can be very slow to load on launch or unload on exit, or may completely hang Audacity on launch. See the Audio Units page for a workaround.