Difference between revisions of "New features in Audacity 3.0.2"

From Audacity Wiki
Jump to: navigation, search
m (James moved page New features in Audacity 3.0.1 to New features in Audacity 3.0.2 without leaving a redirect: Updated version number.)
(Updating from Audacity 2.x to Audacity 3.x: fix link)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
<center>[[File:Audacity_Logo_signika_512_transparent.png‎|Click to visit the Audacity main website for  the latest news and Audacity downloads|link=http://audacityteam.org/|size=50%]]</center>
 
<center>[[File:Audacity_Logo_signika_512_transparent.png‎|Click to visit the Audacity main website for  the latest news and Audacity downloads|link=http://audacityteam.org/|size=50%]]</center>
{{intro|1=<span style="font-size:120%">'''This page is an overview of prominent new functionality that has been introduced in Audacity 3.0.1 '''
+
{{intro|1=<span style="font-size:120%">'''This page is an overview of prominent new functionality that has been introduced in Audacity 3.0.2 '''
  
'''Version 3.0.1 is primarily a maintenance release for bugfixes. '''</span>
+
'''Version 3.0.2 is primarily a maintenance release. '''</span>
* <span style="font-size:110%">Details of all the major changes since 3.0.0 can be found in [https://wiki.audacityteam.org/wiki/Release_Notes_3.0.1 Audacity Release Notes 3.0.1].</span>
+
* <span style="font-size:110%">Details of all the major changes since 3.0.0 can be found in [https://wiki.audacityteam.org/wiki/Release_Notes_3.0.2 Audacity Release Notes 3.0.2].</span>
 
}}
 
}}
  
 
==Contents==
 
==Contents==
 
#[[#overview|'''Overview''']]
 
#[[#overview|'''Overview''']]
 +
#[[#aup|'''Updating from Audacity 2.x''']]
 
#[[#macros|'''Manage Macros improvements''']]
 
#[[#macros|'''Manage Macros improvements''']]
#[[#bugs|'''34 Bug Fixes''']]
+
#[[#output|'''Changes in Macros working on files''']]
 +
#[[#bugs|'''36 Bug Fixes''']]
  
  
Line 16: Line 18:
  
 
== Overview ==
 
== Overview ==
Audacity 3.0.1 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) cannot read or write a file.  So we added more informative diagnostics for when there is an error.
+
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 relates 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 [https://bugzilla.audacityteam.org/show_bug.cgi?id=2715 problem we tracked] 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 [https://bugzilla.audacityteam.org/show_bug.cgi?id=2709 now work around] in 3.0.1.  A [https://bugzilla.audacityteam.org/show_bug.cgi?id=2714 mistake we made] with Unicode prevented Audacity working in Korean and Japanese.
+
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 [https://bugzilla.audacityteam.org/show_bug.cgi?id=2715 problem we tracked] 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 [https://bugzilla.audacityteam.org/show_bug.cgi?id=2709 now work around] in 3.0.2.  A [https://bugzilla.audacityteam.org/show_bug.cgi?id=2714 mistake we made] 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.1 may only be a 'point' release, but we think it's one most people using 3.0.0 will want.
+
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.
  
===Error: Failed to open the project database===
+
===Bugs we've had trouble with===
There is a mysterious error which only occurs occasionally ''(and we cannot reproduce it on demand)'' but is currently leaving us mystified. Usually this seems to occur when you are trying to import an audio file but there may be other use cases. It does not appear to be causing users to experience data loss or damaged projectsIt is this bug: [https://bugzilla.audacityteam.org/show_bug.cgi?id=2700 '''Bug 2700 - "Failed to open the project database"''']
+
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 themWe added extra diagnostic information to help us do that:
  
For 3.0.1 we have added a {{button|Show Log}} button to this error message so we can hopefully gather more information about this to aid the developers in analyzing the issue.  If you do encounter this issue please press the log button to generate the log and send us a copy of the screenshot to the [https://forum.audacityteam.org/index.php Audacity Forum].  The message has been changed to "'''The project's database failed to reopen'''"
+
<div style="margin-left:30px">
 +
====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:  [https://bugzilla.audacityteam.org/show_bug.cgi?id=2700 '''Bug 2700 - "Failed to open the project database"''']
 +
 
 +
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 <s>torture tests</s> 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 [https://forum.audacityteam.org/index.php Audacity Forum].  You may see a variant of the message, "'''The project's database failed to reopen'''"
 +
:<span title="Error dialog Failed to open database file">[[Image:Failed to open database file.png|link=]]</span>
 +
:Clicking on the '''Show Log''' chevron will expand the message to show log data.
 
{{tip|This can normally be resolved by simply exiting Audacity, relaunching and then making the required import of an audio file. }}
 
{{tip|This can normally be resolved by simply exiting Audacity, relaunching and then making the required import of an audio file. }}
  
===False recovery offered on launch===
+
====False recovery offered on launch====
This is another mysterious issue which only occurs very occasionally and is foxing us.
+
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 [https://bugzilla.audacityteam.org/show_bug.cgi?id=2732 '''Bug 2732 Faux recovery offered on launch (very moonphase)'''].  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.
 +
 
 +
</div>
 +
 
  
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.
+
<div id="aup"></div>
  
This is [https://bugzilla.audacityteam.org/show_bug.cgi?id=2732 '''Bug 2732 Faux recovery offered on launch (very moonphase)''']. If you encounter this and accept this recovery it "recovers" an empty project and no damage is done.
+
== Updating from Audacity 2.x to Audacity 3.x ==
{{note|Our current thinking is that these two errors may be linked so that if you get this false recovery and then try to import audio you may well get the "'''The project's database failed to reopen'''" warning too. }}
+
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 '''[https://manual.audacityteam.org/man/updating_from_audacity_2.x_to_audacity_3.html Updating from Audacity 2.x to Audacity 3.x]'''.
  
 
<div id="macros"></div>
 
<div id="macros"></div>
Line 49: Line 70:
  
  
 +
<div id="output"></div>
 +
 +
== Changes in Macros working on files ==
 +
We have extended the options in '''Directories Preferences''' to include a new entry for '''Macro output'''.
 +
:<span title="Directories preferences 3.0.2 version with added Macros output setting">[[Image:Preferences Directories what new in 3-0-2.png|link=]]</span>
 +
If you leave the entry for '''Macro output''' blank then Audacity will default to creating a folder called "'''macro-output'''" in:
 +
* '''Windows:'''  {{path|C:\Users\<your username>\Documents\Audacity }}
 +
* '''Mac:''' {{path|/Users/<your username>/Documents }}
 +
{{note|Note carefully that this diverges from previous behavior with 3.0.0 and earlier where a "macro-output" directory was created/used in the same directory as the files to be processed by the Macro.
 +
<p>We believe that a single rationalized folder for all Macro output from processing files with Macros is a more sensible approach.</p> }}
  
  
Line 54: Line 85:
  
 
== Bug Fixes ==
 
== Bug Fixes ==
{{ednote|1='''James:''' I'm thinking of discussing the unicode issues, Japanese Crash (Microsoft) Missing check marks (Apple) label emoji and 'Linux: differently configured wxWidgets'.  And maybe not list those bugs a second time}}
 
 
 
===P1 Bugs Fixed===
 
===P1 Bugs Fixed===
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2708 2708] Nyquist effects fail silently with One hour plus stereo
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2708 2708] Nyquist effects fail silently with One hour plus stereo
Line 79: Line 108:
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2694 2694] Coloring of tracks in Mixer Board are awry
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2694 2694] Coloring of tracks in Mixer Board are awry
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2692 2692] Mac: VI users get trapped in radio buttons of Keyboard Preferences
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2692 2692] Mac: VI users get trapped in radio buttons of Keyboard Preferences
 +
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2734 2734] Apply macro may not create the macro-output folder in the source directory
  
 
===P3 Bugs Fixed===
 
===P3 Bugs Fixed===
Line 97: Line 127:
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2124 2124] Import>Audio failure error message is misleading
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2124 2124] Import>Audio failure error message is misleading
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2511 2511] Enh: Remove the "Variable Speed: Fast / Standard" option from MP3 dialog
 
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2511 2511] Enh: Remove the "Variable Speed: Fast / Standard" option from MP3 dialog
 
+
* [https://bugzilla.audacityteam.org/show_bug.cgi?id=2736 2736] Recent files list can be replaced by ExportCL commands
 
 
 
 
<div id="appendix"></div>
 
 
 
{{ednote|1=
 
==[[New features in 3.0.1 - appendix|Additional new features]]==
 
This page '''[[New features in 3.0.1 - appendix]]''' gives an overview of further new functionality that has been introduced in this release of Audacity.
 
}}
 
  
 
==Links==
 
==Links==
  
[https://wiki.audacityteam.org/wiki/Release_Notes_3.0.1 '''>''' Audacity Release Notes 3.0.1] ''- detailed release notes for this release of Audacity''
+
[https://wiki.audacityteam.org/wiki/Release_Notes_3.0.2 '''>''' Audacity Release Notes 3.0.2] ''- detailed release notes for this release of Audacity''

Latest revision as of 13:23, 19 April 2021

size=50%
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.

Contents

  1. Overview
  2. Updating from Audacity 2.x
  3. Manage Macros improvements
  4. Changes in Macros working on files
  5. 36 Bug Fixes


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 problem we tracked 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 now work around in 3.0.2. A mistake we made 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: Bug 2700 - "Failed to open the project database"

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 Audacity Forum. You may see a variant of the message, "The project's database failed to reopen"

Failed to open database file.png
Clicking on the Show Log chevron will expand the message to show log data.
Bulb icon This can normally be resolved by simply exiting Audacity, relaunching and then making the required import of an audio file.

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 Bug 2732 Faux recovery offered on launch (very moonphase). 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 Updating from Audacity 2.x to Audacity 3.x.

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.
Manage Macros 3-0-1 What's new.png


Changes in Macros working on files

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

Preferences Directories what new in 3-0-2.png

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
Note carefully that this diverges from previous behavior with 3.0.0 and earlier where a "macro-output" directory was created/used in the same directory as the files to be processed by the Macro.

We believe that a single rationalized folder for all Macro output from processing files with Macros is a more sensible approach.


Bug Fixes

P1 Bugs Fixed

  • 2708 Nyquist effects fail silently with One hour plus stereo
  • 2706 Win: Vocal Reduction and Isolation most options fail
  • 2698 Noise Gate fails silently if "hold" is non-zero
  • 2720 Cannot open project that's in a read only folder - error message vague
  • 2710 Compressor with audio before T=0 crashes Audacity
  • 2703 Mac: EGAT preview dialog is hidden behind the EGAT dialog
  • 2707 Opened projects not being removed from "audacity.cfg"
  • 2697 Linux: AUP3 projects use incorrect char size on "differently" configured wxWidgets
  • 2718 Failed to execute a project file command (on server)

P2 Bugs Fixed

  • 2701 Progress dialog interferes with scripting
  • 2714 (Japanese & Korean) "Unable to parse project information"
  • 2722 Noise Gate fails on a one hour stereo selection
  • 2716 Cleared "Recent Files" are restored on next launch
  • 2709 Mac: Missing sub-menu check marks in French
  • 2696 Metadata Editor: changed size is not remembered/restored on next use
  • 2699 Windows: Cannot edit labels with emoji in them correctly
  • 2704 Mac: Stop button in EGATs with Preview does nor stop the preview
  • 2676 Export: Incorrect handling over 0 dB
  • 2694 Coloring of tracks in Mixer Board are awry
  • 2692 Mac: VI users get trapped in radio buttons of Keyboard Preferences
  • 2734 Apply macro may not create the macro-output folder in the source directory

P3 Bugs Fixed

  • 2723 VST_PATH environment variable fails for non-standard locations
  • 2209 Nyquist: Audacity crashes when running seq-write-smf
  • 2522 In Macros, Record New Track and Play with a selection do not wait for completion.
  • 2672 Plug-ins listed in reverse alphabetic order in Plug-ins Manager
  • 2211 Mac: keyboard navigation problem in Libraries preferences dialog
  • 2523 Audacity may suggest installing FFmpeg even when FFmpeg is installed

P4 Bugs Fixed

  • 2733 Noise Gate 'Level Reduction' has a minimum of -60 dB
  • 2726 Enh: Some preference changes are not written until Audacity exits
  • 2717 Linux: Internal Error at DBConnection.cpp line 275
  • 2721 Allegro (.gro files) cause crash with undo/redo
  • 2684 Bitrot for Docimage script
  • 2690 Move the actual build information to the top of the build information tab
  • 2124 Import>Audio failure error message is misleading
  • 2511 Enh: Remove the "Variable Speed: Fast / Standard" option from MP3 dialog
  • 2736 Recent files list can be replaced by ExportCL commands

Links

> Audacity Release Notes 3.0.2 - detailed release notes for this release of Audacity