Error codes
This page lists Audacity error codes and provides some troubleshooting steps on how to fix them.
Last updated
Was this helpful?
This page lists Audacity error codes and provides some troubleshooting steps on how to fix them.
Last updated
Was this helpful?
This error indicates a problem with the hardware used for playback, whether it is permissions, drivers, connections, or if you ask the device to do something it cannot do. You can attempt the following steps to resolve it.
This error indicates a problem with the hardware used for recording, whether it is permissions, drivers, connections, or if you ask the device to do something it cannot do. You can attempt the following steps to resolve it.
These errors can occur when attempting to load a damaged .aup3 project file. Damaged project files can be recovered as described in the following article.
This error indicates that the device that's being attempted to use is not valid, for example:
The device got unplugged
The device has a faulty or loose connection
The device itself is faulty or not a real audio device.
This error can also occur when you are trying to record a number of channels that is not supported in the current configuration
This error can also occur when using Audacity on Windows with Windows WASAPI as the Host if the selected recording device is being used exclusively by another application. Some applications that could make use of the recording device exclusively are ASIO4ALL, Voicemod (when configured to do so) or Voicemeeter (when configured to do so).
You can attempt to fix this issue with the following methods:
Use a different USB port and USB cable. This will resolve the issue if the fault was in the cable.
Use a different audio host. Sometimes WASAPI works when MME doesn't, sometimes it's the other way round.
Use a different number of channels. For example, some Realtek only work when recording in Mono, while some others only work in Stereo when recording a (loopback) stream.
This error can indicate an unsupported sample rate. Double-check that both your OS settings and the Audacity project rate are set to a supported sample rate (usually 44100 Hz or 48000 Hz).
This error can also occur when using Audacity on Windows to record a track while listening another existing track (also known as overdubbing) with Windows WASAPI as the Host if the sample rate of the recording device is different than the sample rate of the playback device. If possible set the same sample rate for your devices or use MME as the Host.
This error can also occur when you are trying to record a number of channels that is not supported in the current configuration To fix this, you can do the following:
Use a different audio host. Sometimes WASAPI works when MME doesn't, sometimes it's the other way round.
Use a different number of channels. For example, some Realtek only work when recording in Mono, while some others only work in Stereo when recording a (loopback) stream.
This error means "something is wrong", most commonly
A lost connection to a USB audio device
Missing microphone permissions from the operating system.
Your device is unable to playback other tracks while recording. Turning off Overdub via Transport -> Transport Options may fix this.
You can try the Common troubleshooting steps, or attempt any of the other workarounds of this page.
This error occurs when the file you're trying to open has no decoder available. You can attempt the following things to fix it:
Install FFMPEG. FFMPEG allows you to open most kinds of media files. Read more: Installing FFmpeg
Check if your file is an actual audio file. Some files which are used to output audio in certain programs don't actually contain sound themselves, but are instructions for for the program to make some sounds. Try to see if the program used to create the file has an export button. If not, you can also try recording desktop audio while playing back the file in another program. Read more: Recording desktop audio
Check if you have accidentally created custom import rules. In Edit -> Preferences -> Extended Import (on macOS: Audacity -> Preferences -> Extended Import), make sure that you have not created any custom rules. If there are any rules, you can safely delete the rules.
Import the audio as RAW. This only works on uncompressed audio. You can do so via File -> Import -> Import raw data...
This is caused by a corrupted audacity.cfg file, such as when upgrading from Audacity 3.1.3 to Audacity 3.2. You can solve this issue by upgrading to Audacity 3.2.1.
This is caused by missing realtime effects. You can replace any missing effects from the effects sidebar.
Audacity currently looks for plugins in absolute paths. This means that if you open a project that was created on a different computer, Audacity will continue to check for the plugins in the exact same locations as they were on the old computer.
If you are on a low-end machine, this may be caused by insufficient resources, specifically memory.
This also can happen if you assign yourself a static IP in the hosts file. If that's the case, simply commenting out the assignment may solve this.
This is caused by an unexpected system state. Rebooting the computer resolves it.
Check if the file you're trying to open actually is what it says on the tin. For example, some lower-quality programs name any audio file *.mp3, regardless of whether it actually is an MP3 file. Read more: