Professional Documents
Culture Documents
README
README
WWW: http://audacity.sourceforge.net/
1. Licensing
2. Changes in version 1.3.5
3. Known Issues
4. Source Code, Libraries and Additional Copyright Information
5. Compilation Instructions
6. Previous Changes going back to version 1.1.0
--------------------------------------------------------------------------------
1. Licensing
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.
You should have received a copy of the GNU General Public License
along with this program (in a file called LICENSE.txt); if not, go
to http://www.gnu.org/copyleft/gpl.html or write to
--------------------------------------------------------------------------------
Recording / Playback:
* Several bugs fixed so that latency correction should be better, and more
devices work correctly. Problems with invalid sample rates under Linux
should be much rarer.
* Newer version of Portaudio library.
* New feature to record onto the end of an existing track
(hold Shift while clicking Record).
Import / Export:
* Updated versions of Libogg, Libvorbis, Libflac, Libsndfile and Twolame
libraries.
* Handling of unsupported file formats more informative.
* Handling of file names with slashes on OS X improved. New dialog
allows replacement of illegal file name characters on all platforms.
Interface:
* Improved scaling and layout for rulers and VU meters.
* Envelope fixes/improvements including full control of undo/redo.
* New keyboard shortcuts and improved menu navigation.
* Preferences: More intuitive tab arrangement. New options for
mute/solo and Metadata Editor behavior. Language can now be
changed without restart.
* Expanded Build Information tab.
Effects:
* New Vocal Remover plug-in, improvements for Generate effects.
Compilation:
* Fixes when building Audacity with libraries disabled.
* Improvements to make Mac and Solaris builds easier.
Security:
* Full fix for issue CVE-2007-6061 on systems where temporary directories
can be changed by other users (thanks to Michael Schwendt).
Miscellaneous:
* Updated translations for many locales.
* Several stability improvements.
--------------------------------------------------------------------------------
3. Known Issues
for details of any issues that have been identified after release of
this version.
* If Audacity is built from CVS with wxWidgets 2.6.4 or later, the Escape
key does not cancel most dialogs. This is due to a wxWidgets bug.
* Pressing Play (but not spacebar) in a second project when another is already
playing stops playback of the first project.
* Metadata such as ID3 tags is not fully imported and exported for all supported
file formats. MP3 tags *are* correctly imported and exported to the current ID3
specification, but some players don't fully support this specification, so may
not
see all the tags.
* No warning is given if File > Save or File > Save Project As... is carried out
with
no tracks open.
* Not all menu items are correctly enabled when the preference: "Select all audio
in
project, if none selected" is checked.
* Audacity can import and display MIDI files, but they cannot be played
or edited.
* Windows (reported on): There have been reports of clicks during recording on
some Windows XP systems using Audacity 1.3.4, where 1.2.6 had no problem.
It is not clear if 1.3.5 will have this issue or if it will occur on other
operating
systems. Users can help us by sending any reports of this problem to:
audacity-devel@lists.sourceforge.net
* Mac OS X only: Some users find that after running Audacity other media
players don't produce any sound or crash. Audacity tries to select the best
quality settings your system is capable of, to give the best recordings
possible. Some sound drivers also retain these settings as defaults for
other applications, which can cause these symptoms
To get round this, enable the option "Do not modify audio device settings"
on the Audio I/O tab of the preferences, and make sure that your sound
device is set up (in the Apple Sound and Midi Setup utility) to work in
stereo, 16bits, with a sample rate of 44100Hz or 48000Hz. More help at:
http://audacityteam.org/wiki/index.php?
title=Mac_Bugs#Loss_of_sound_after_running_Audacity
* Mac OS X only: Portable settings aren't picked up, and the default
settings (in the default location) are always used. See this page for
a workround:
http://audacityteam.org/wiki/index.php?title=Portable_Audacity
* Linux only: Audacity now supports interfacing with Jack, however this has
not been tested, and is known to have a number of issues with both
reliability and useability. Patches to improve both will be welcomed.
* Linux (reported on): The first file imported into a project no longer
changes the project rate to the file's rate, if that rate is absent from the
project rate list.
Also note that the Windows installer will not replace 1.2.x installations, but will
install alongside them.
--------------------------------------------------------------------------------
Source code to this program is always available; for more information visit
our website at:
http://audacity.sourceforge.net/download/
Audacity is built upon other free libraries; some of these libraries may have
come with Audacity in the lib-src directory. Others you are expected to install
first if you want Audacity to have certain capabilities. Most of these libraries
are not distributed under the terms of the GPL, but rather some other free,
GPL-compatible license. Specifically:
iAVC: LGPL
Part of the code to the AVC Compressor effect.
Included with Audacity.
libid3tag: GPL
Reads/writes ID3 tags in MP3 files. Optional
separate download as part of libmad.
libmad: GPL
Decodes MP3 files. Optional separate download.
SoundTouch: LGPL
Changes tempo without changing pitch and vice versa.
Included in audacity
Twolame: LGPL
Encodes MPEG I layer 2 audio (used in DVDs and Radio). Optional separate
download.
--------------------------------------------------------------------------------
Additional copyright information:
--------------------------------------------------------------------------------
Nyquist
Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or
other materials provided with the distribution.
Neither the name of Roger B. Dannenberg, Carnegie Mellon University, nor the
names of any contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or
other materials provided with the distribution.
Neither the name of David Michael Betz nor the names of any contributors may be
used to endorse or promote products derived from this software without specific
prior written permission.
--------------------------------------------------------------------------------
5. Compilation instructions
http://www.wxWidgets.org/
If you install the RPM, make sure you install the devel RPM as well, otherwise you
won't be able to compile Audacity from source.
To compile on Linux, Mac OS X, and other Unix systems, simply execute these
commands:
./configure
make
make install # as root
If you want to do any development, you might want to generate a configure cache
and header dependencies:
./configure -C
make dep
or email us at:
audacity-devel@lists.sourceforge.net
--------------------------------------------------------------------------------
Changes in 1.3.4:
New Features
* New Welcome Screen with introduction to Audacity
* Enhanced Windows Shell integration, so Audacity shows up in lots of
Windows places such as "Open With".
* New keyboard command: 'Mix and Render to New Track'
(bound to Ctrl+Shift+M).
* New keyboard shortcut: "Shift-A" starts playback when stopped,
or performs "Stop and Select" when playing.
* Added support for VAMP audio analysis plug-ins.
* Solo button solos only one track at a time, and a track cannot be both
mute and solo.
Interface:
* Keyboard shortcuts for making short/long jumps along the timeline.
* Added 'Snap To' in the Selection Bar.
* Made keyboard navigation easier when multiple menu items with the
same first letter exist.
* Enhanced interface for label editing.
* Layout of OK/Cancel buttons consistency improved.
* Preferences:
* "Select all audio in project, if none selected" (on by default)
* "Beep on completion of longer activities" (system bell, not
main output).
* Other preferences cleaned up and explanations improved.
* Envelopes: Many fixes when copying / pasting / repeating.
* Many translation updates.
* Track height fixed in several cases.
* CleanSpeech mode switching without closing and re-opening fixed.
Opening/saving formats:
* Metadata editor added for OGG, FLAC and WAV/AIFF exports, and
general improvements in this area.
* Import of metadata improved.
* Muted tracks are no longer audible in the exported mix.
Effects:
* Truncate Silence: support for multiple and stereo tracks.
* Dtmf Generator:
* added support for keypad letters
* added an amplitude control.
* Compressor: variable decay time added.
* Equalization:
* Clicks at start / end prevented
* Improvements to saved curves being found
* Preview works correctly
* 'Merge' command appears in Undo history.
* Clipping detected more reliably.
* Nyquist plug-ins reviewed and enhanced.
* Better (and more) progress bars.
* Cancelling effect always restores previous audio.
* Several improvement to effects in batch mode.
Recording / Playback:
* Improvements to latency correction.
* Updated version of portaudio-v19 library.
Note that Help is no longer built in, but accessible on the Web via links
in Audacity.
Changes in 1.3.3:
Opening/saving formats:
* Import
* Import of audio from QuickTime (mov, aac, m4a) files is now
supported on OS X.
* Broadcast Wave Format (BWF) wave files can now be imported.
* Export
* Metadata can be added to OGG files
* Improved export option selection
* Additional export options added to MP3 and FLAC file formats
* Command line exporter now supported on Windows and OS X
Effects:
* EQ effect
* Responsiveness improved.
* Several enhancements added.
* Batch support added.
* New Auto Duck effect
* Added previewing to AudioUnit effects
* Much improved Noise Removal effect
* Effects previewing can now be canceled
* New DTMF Tone Generator effect
* Additional options available in Noise effect
* Improved the Tone Generation effects
Other features:
* Major speed improvement in Spectrogram rendering
* Increased support for drag and drop on OS X
* Support added for building against wxWidgets 2.8
* Support opening multiple Audacity Projects at once from Explorer on
Windows
* Improved main window sliders
* New support for snapping while selecting and sliding
* Improved track focus handling and visual feedback
* Speed improvements and handling of resizing/zooming in tracks
* Spectrum view can now be zoomed.
* New internal file cache to improve handling of project files over
networks
Also:
* Many improvements to language specific translations
* Numerous stability improvements
Changes in 1.3.1 and 1.3.2:
Changes in 1.3.0:
New features
The new features in Audacity 1.3 have been grouped into the
following six major categories.
1. Collapse/Expand Tracks
In Audacity 1.3, every track has an upward-pointing triangle at
the bottom of the label area on the left side of the track.
3. Selection Bar
In Audacity 1.2, the current selection is contained in a
status bar at the bottom of the window. In Audacity 1.3,
this is replaced by a fully functional Selection Bar, which
displays and controls the current selection (your choice of
Start and End, or Start and Length), and the current audio
position. The selection bar is fully editable - just click
in any field and type to change the current selection precisely.
In addition, many formatting options allow you to view times in
different units, such as samples, CD frames, or NTSC video frames.
6. Other features
Better performance with large projects
Transcription toolbar
Upload
Batch
Cut lines
CleanSpeech
Changes in 1.2.4:
* Audacity is now built with Vorbis 1.1, which features better encoding
quality and file compression.
* Dragging sound files into the Audacity window now works on Mac OS X
and Linux, as well as Windows. (Before, it worked only on Windows.)
* The "View History" window can now discard old undo levels to save disk
space on Windows. (This previously worked only on Linux and Mac.)
* The Change Pitch and Change Tempo effects have been upgraded to
use a new version of the SoundTouch library by Olli Parviainen,
with better speed and higher quality.
* Fixed a bug that caused the program to run slowly when using the
Envelope tool.
* VU Meters will now always reset when audio I/O has stopped.
* Fixed a major Mac-only bug that was causing Audacity to crash at seemingly
random times, but especially during audio playback and recording.
Changes in 1.2.2:
* Fixed a serious bug that could cause data loss when you save and
then reload and re-edit an Audacity project containing repeated
or duplicate data.
* MP3 tags dialog will only pop up the first time you export as
MP3; after that it will not pop up again as long as you have
filled in at least one tag.
* You can now change the font of a label track by choosing "Font..."
from the label track's pop-up menu.
* Zoom In / Zoom Out now properly disable when they're not available.
Changes in 1.2.1:
* Fix a bug that could cause data to be lost when pasting audio
from one project into another, after the first project has been
saved and closed.
* Fix a bug that prevented Nyquist effects from running when certain
regional settings were activated.
* Fix a bug in the Quick Mix command that could cause old temporary
files to not be deleted.
* Two new Nyquist plug-ins: "Cross Fade In" and "Cross Fade Out."
Changes in 1.2.0:
* The Delete key can now be used to delete the current selection,
in addition to the Backspace key.
* Fixed bug that caused data loss if you deleted all tracks in
a saved project and then open a new file into the same window.
Changes in 1.2.0-pre2:
* Online help completed. The full manual is nearly complete
and will be posted to the website for online browsing shortly.
* Effects
- Repeat Last Effect command
- Improved VST plug-in support
- Most effects now have a Preview button
- Compressor (Dynamic Range Compressor)
- Change Pitch (without changing tempo)
- Change Tempo (without changing pitch)
- Change Speed (changing both pitch and tempo)
- Repeat (useful for creating loops)
- Normalize (adjust volume and DC bias)
* Audio I/O
- 1-second preview command.
- Looped play.
* File I/O
- Audacity 1.2.0 opens project files from all previous versions
of Audacity from 0.98 through 1.1.3.
- Open multiple files from the same dialog.
- Use a text file to specify a list of audio files to open with offsets.
* Bug fixes
- Project files with special characters are no longer invalid.
- "Scratchy" noises caused by bad clipping are fixed.
- Audacity no longer exports invalid Ogg files, and does not cut off the
last few seconds of exported Ogg files.
- Mono MP3 files now export at the correct speed.
- Many incorrect results from the Envelope tool have been fixed.
- The "Export Labels" command now overwrites existing files correctly.
- The "Plot Spectrum" window displays the correct octave numbers for
notes.
- Several memory leaks are fixed.
* File I/O
- Uses improved project file format. (Unfortunately reading
previous formats, including 1.1.1, is not supported.)
- Block files (stored in Audacity project directories) now
use the standard AU format. Though some Audacity
meta-information is in these files, they can now be
read by many other popular audio programs as well.
- Fixed some bugs relating to reading/writing audio
files with more than 16 bits per sample.
- Import RAW is functional again, with a simpler GUI
but support for far more file formats. The
autodetection algorithms are much more accurate than
in 1.0.
* Audio I/O
- Completely rewritten audio I/O, with lower latency
and minimal chance of buffer underruns while
recording.
* Resampling
- Using high quality resampling algorithms, with the
option of better quality for mixing than for real-time
playback
* User Interface
- Tooltips appear in Statusbar.
- Vertical cursor follows play/record
- Pause button
- Drawing tool (with three different modes)
- Vertical Resizing of stereo tracks is more fun.
- Adjust selection by click-dragging selection boundary
- Toolbar button context-sensitive enabling/disabling
- Better zooming functionality (centers region)
- Multiple ways to display the cursor position and selection
- Snap-to selection mode
- Drag tracks up and down
- Align and group align functions
- Cursor save/restore
- Working history window
* Effects
- Effects broken down into three menus: Generate, Effect, and
Analyze
- Generate menu lets you generate silence, noise, or a tone
- Nyquist support (supports plug-ins written in Nyquist,
an interpreted functional language based on Lisp)
* Localization
- Improved localization support
- More languages available
- Language selection dialog on startup
* Mac OS X
- Support for more audio hardware
- Support for full-duplex (play while recording)
- Support for MP3 exporting using LameLib Carbon
* Unix
- Audacity now has a man page (it describes command-line
options and how to set the search path)
* File Formats
- Uses libsndfile 1.0, which fixes some bugs and
improves performance
* Searching for Files:
- On Windows and Mac OS, Audacity now looks for
translations in the "Languages" folder and all plug-ins
in the "Plug-ins" folder, relative to the program.
- On Unix, Audacity looks for translations in
<prefix>/share/locale and looks for everything else
in <prefix>/share/audacity and also in any paths in
the AUDACITY_PATH environment variable