> For the complete documentation index, see [llms.txt](https://support.audacityteam.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.audacityteam.org/au3/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0.md). # Audacity 2.2.0 **Audacity 2.2.0 was released on 02 November 2017.** ## Changes since previous version See the [New features in Audacity 2.2.0](/au3/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0/new-features-in-audacity-2.2.0.md) page in the Manual for more information about improvements and other changes. ### Improvements * Four Selectable themes provided, with new 'Light' theme as default, plus option to customize * Many menu changes: * Menus Reorganized * Extended menu bar provided * New keyboard commands for working with clips * Help buttons ? in Preferences, Effects, Generators and Analyzers - and other places * Non-Greying out of effects when no selection (and explanatory dialog with help button) * Playback of MIDI (and Allegro) files imported into Note Tracks is now available. * 'Center' option in Selection Toolbar * Stem plots * Major overhaul to documentation/manual including many new images and streamlined text on landing pages for in-program help. ### Other Changes * Append-record is now the default *(use Shift + Record for old behavior, to record on a new track)* * The *Esc* key now cancels all click-and-drag actions. It also chooses among overlapping mouse click targets, which is especially useful in the Multi-Tool. * Sync-Lock button removed (use menu item or keyboard shortcut instead) * New preferences and preference pages * Overhaul of much code: * Overhaul of envelope handling code to deal with some anomalies * Overhaul of exception handling for greater safety * New Logo ### Bug Fixes * Major work on bug fixing. 198 bugs that were in 2.1.3 fixed for 2.2.0. * The most serious bug fixed this time round was [bug 437](http://bugzilla.audacityteam.org/show_bug.cgi?id=437) which was about what happens when Audacity is recording and runs out of storage. * The problems of incomplete support for macOs Sierra have been resolved (including [bug 290](http://bugzilla.audacityteam.org/show_bug.cgi?id=290), [bug 1567](http://bugzilla.audacityteam.org/show_bug.cgi?id=1567), [bug 1702](http://bugzilla.audacityteam.org/show_bug.cgi?id=1702), and [bug 1703](http://bugzilla.audacityteam.org/show_bug.cgi?id=1703)). * Most of the bugs fixed were more minor, such as [bug 463](http://bugzilla.audacityteam.org/show_bug.cgi?id=463) which was about a case in which the numbering on the timeline could display incorrect times. For those who **really have to know**, the list of bugs fixed in 2.2.0 is [here](https://github.com/audacity/audacity-support/blob/main/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0/broken-reference/README.md). ## Supported Platforms ### Windows * Audacity 2.2.0 requires the CPU to support the [SSE2 ](http://en.wikipedia.org/wiki/SSE2)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 [CPU-Z](http://www.cpuid.com/softwares/cpu-z.html). If your hardware only supports SSE, you may download Audacity 2.0.6 see the [Legacy Windows](https://www.audacityteam.org/download/legacy-windows/) page on the Audacity Website. * 2.2.0 does not officially support Windows XP. ### macOS / Mac OS X * Audacity 2.2.0 is for Intel Macs running OS X 10.6 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. ## Issues See our [list of issues](https://github.com/audacity/audacity-support/blob/main/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0/broken-reference/README.md) for much more detail of issues with Audacity 2.2.0. {% hint style="info" %} Below are listed what we believe are the most common and important issues with 2.2.0 for most users. {% endhint %} ### File > Open * If you use **File > Open** to "open" an audio file (WAV file or MP3 file say) the file will import properly but only the first few seconds of it will be shown (the default zoom level), but more importantly the horizontal scroll slider will be missing from the scroll bar, meaning you can't access the remaining audio. * All you need to do do is press the Play button or any of the Zoom buttons in the Edit toolbar and the horizontal scroll slider will be restored. * The best way to avoid this happening is to use the **File > Export** command to import the file into an Audacity project. All that the **File > Open** does with an audio file is to **Import** the audio into an open empty project, or if you already have an active project it will open a new project and import the file into that project. ### Timer Record * Timer Record may not reliably stop the recording on some machines. The Elapsed and Remaining Time counters may stop counting. In this case it will be necessary to force quit Audacity. * On a few affected machines, the problem can be avoided if you leave focus on Audacity or ensure it has focus when recording is due to end. ### (Linux) PULSE Audio * PulseAudio is not reliable when used with Audacity on Linux. Playback or recording may freeze, recording dropouts or fast playback may occur when using PulseAudio. * Freezes may be caused by repeatedly starting and stopping playback or recording in quick succession (or by holding down the Play or Record button). * Workarounds: Try launching Audacity from the terminal with the pulse latency set to 30 ms in an environment variable: env PULSE\_LATENCY\_MSEC=30 audacity * If you get underruns noted in the terminal, try a higher number in the PULSE\_LATENCY\_MSEC command. If the problem is unchanged, try a lower number. * Alternatively, bypass pulseaudio by setting the playback and recording device to an ALSA (hw) choice in Device Toolbar. More help with this can be found here. ### (Linux) MIDI * The timing of notes during MIDI playback may sound erratic on some machines. Optimizing the system for low latency MIDI playback can help to reduce the inaccuracies. ### (Mac) Launch from Finder or AUP file * With Sierra 10.12 and High Sierra 10.13 opening a second project from Mac's Finder produces a second inaccessible instance of Audacity. If you already have an Audacity project open, and attempt to open a second .AUP from within the Finder window (whether by double clicking, right-clicking for Open on the pop-up menu, or typing Cmd-O) or by right-clicking on the .AUP file and using **Open With**, the second project attempts to open in a new instance of Audacity, visible in Apple’s Dock bar at the bottom of the screen. This second instance of Audacity will not be accessible and you will need to Force Quit it. * Workaround: Use Audacity's **File > Open** command to open the second and successive projects. ### Accessibility * Far 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. A lot more detail about accessibility limitations can be found [here](https://github.com/audacity/audacity-support/blob/main/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0/broken-reference/README.md) ## Bugzilla We track these and many other bugs in our 'bugzilla' database. {% hint style="info" %} Click on the bug numbers to see work done on these bugs. {% endhint %}
IDSummary (5 tasks) ⇒ID
42Timer Record occasionally carries on recording past the scheduled end, requiring force quit42
1726Linux: MIDI playback timing / synchronisation problems1726
1767Opening a second project from Mac's Finder produces a second inaccessible instance of Audacity1767
276Linux: PULSE-AUDIO issues. Freeze repeatedly starting/stopping streams276
1765Using File > Open to import audio gives wrong zoom level and no scroll bar slider1765
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://support.audacityteam.org/au3/additional-resources/changelog/older-versions/audacity-2.x/audacity-2.2.0.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.