This page is an overview of prominent new functionality that has been introduced in Audacity 3.0.2

Version 3.0.2 is primarily a maintenance release.

• Details of all the major changes since 3.0.0 can be found in Audacity 3.0.2.

Overview

Audacity 3.0.2 is about bugfixes for Audacity 3.0.0. Some bugs which didn't show up in our testing of 3.0.0 became apparent once 3.0.0 was being used by more users. We wanted to fix these and also to get more diagnostic information about what goes wrong when SQLite (the database we use) can't read or write a file. So we added more informative diagnostics for when there is an error.

One cluster of bugs we fixed relate to Unicode. Unicode is a system for representing many non-English letters and symbols. We, Microsoft and Apple all have made mistakes with Unicode that affected Audacity 3.0.0. One during 3.0.0 turned out to be a Windows update issue with Unicode input, which was resolved by a later Windows update. Disappearing checkmarks in macOS Big Sur release turned out to be a Unicode issue, believed to be in Apple code, which we in 3.0.2. A with Unicode prevented Audacity working in Korean and Japanese.

Some of our bug-fixes are small changes in areas where the previous Audacity behaviour was not as we wanted. 3.0.2 may only be a 'point' release, but we think it's one most people using 3.0.0 will want.

Bugs we've had trouble with

After 3.0.0 was launched a few users discovered a couple of mysterious bugs which we had not encountered in our extensive QA testing of alpha and Release Candidate builds. These two important bugs that 3.0.0 users saw were hard for us to track down as we could not replicate them. We added extra diagnostic information to help us do that:

Error: Failed to open database file

There was an error which only occurred occasionally for a few users but had us mystified. Usually this seemed to occur when trying to import an audio file, but there may have been other ways it could happen. It did not appear to be causing users to experience data loss or damaged projects. It was this bug:

We added a Show Log to this error message so we could gather more information about this to aid the developers in analyzing the issue. This led to what's probably a solution, as Jack L, with this extra logging, was able to get the problem sufficiently often for us to get a handle on it. This extra information told us that in some circumstances we were trying to access the disk before it was ready again, with back to back requests too quickly. Paul then changed the logic of opening a database so that two important requests were always one after the after. This should address the opening issue. Leland added a retry, so that if SQLite can't yet read the database, it tries again, but fractionally later. The retry timeout should benefit all code in Audacity that reads the database, not just at the time of opening. Jack L then ran his torture tests workload and the problem he experienced was gone.

Even so, because the original error was only occasional, we can't know for sure that it, or similar issues, are gone! We still have the extra logging in Audacity. If you do encounter the dialog indicating a problem, please click on the Show Log chevron to generate the log and send us a copy of the screenshot to the . You may see a variant of the message, "The project's database failed to reopen"

False recovery offered on launch

This is another mysterious issue which only occurred very occasionally and was foxing us.

Sometimes after exiting Audacity without saving the project when offered, on the next relaunch a false recovery can be offered when there is really nothing to be recovered as no crash has occurred to cause this. We think this error had the same underlying cause, but we don't know for sure.

This bug is . If you encounter this and accept this recovery it "recovers" an empty project and no damage is done.

If you do see this error, please let us know what you can of how it happened.

Updating from Audacity 2.x to Audacity 3.x

With the release of Audacity 3.0.0 the project file structure of Audacity was changed significantly with the entire project contained in a single unified database file.

If you have already updated to 3.0.0 you should already be aware of this.

But if you are updating from any earlier 2.x Audacity version please read .

Manage Macros improvements

The Manage Macros dialog has been improved for this release:

1. The Cancel button has been removed

2. It is replaced with a Close button

3. A new Save button has been added to enable you to save the results of editing a Macro.

The Save button is grayed-out until you edit a Macro.

Changes in Macros working on files

We have extended the options in Directories Preferences to include a new entry for Macro output.

If you leave the entry for Macro output blank then Audacity will default to creating a folder called "macro-output" in:

• Windows: C:\Users\<your username>\Documents\Audacity

• Mac: /Users/<your username>/Documents

Bug Fixes

P1 Bugs Fixed

• Nyquist effects fail silently with One hour plus stereo

• Win: Vocal Reduction and Isolation most options fail

• Noise Gate fails silently if "hold" is non-zero

P2 Bugs Fixed

• Progress dialog interferes with scripting

• (Japanese & Korean) "Unable to parse project information"

• Noise Gate fails on a one hour stereo selection

P3 Bugs Fixed

• VST_PATH environment variable fails for non-standard locations

• Nyquist: Audacity crashes when running seq-write-smf

• In Macros, Record New Track and Play with a selection do not wait for completion.

P4 Bugs Fixed

• Noise Gate 'Level Reduction' has a minimum of -60 dB

• Enh: Some preference changes are not written until Audacity exits

• Linux: Internal Error at DBConnection.cpp line 275

Links

- detailed release notes for this release of Audacity

Audacity 3.0.2 was released on 19th Apr 2021.

Checksums

Changes and improvements since previous version

Audacity 3.0.2 replaces all previous versions.

• Over 30 bugs fixed since 3.0.0

Full details of new features in the visual guide to

Supported Platforms

Windows

• Audacity 3.0.2 requires the CPU to support the instruction set which should be available on any Intel hardware produced after 2001 and any AMD hardware produced after 2003.

  • To check what SSE levels your CPU supports, you can install .

  • If your hardware only supports SSE, you may download Audacity 2.0.6 see the page on the Audacity Website.

macOS / Mac OS X

• Audacity 3.0.2 is for Intel Macs running OS X 10.7 and later and macOS.

  • There are legacy versions for older OS X at .

Linux

• Linux support is tested on Ubuntu Linux.

  • Audacity may compile on Gentoo, Debian, Mint.

  • Audacity does not currently compile on SuSE Linux.

Buglists

We probably track more bugs than you are interested in...

We used to have a separate page with a dynamic buglist for each version, but nowadays we recommend instead to visit our for current bug status.

We do use this detail in our own QA work.

Highlighted Issues

Below are listed what we believe are the most common and important issues with 3.0.2 for most users.

macOS Big Sur

Accessibility

• Less of Audacity is properly accessible to visually impaired users than we would like. Currently the best supported platform for accessibility is Windows. We lost a lot of custom accessibility programming when we had to move to a more recent version of the wxWidgets library.

Internationalization

• Audacity is only partially translated in many languages. We also have some issues, for example, with Right-To-Left Languages.

Selected Bugzilla-Tracked Bugs

• Click on the bug numbers to see work done on these bugs.