home *** CD-ROM | disk | FTP | other *** search
/ Freelog 54 / Freelog054.iso / Solution / Audio / Audacity / README.txt < prev    next >
Encoding:
Text File  |  2004-02-28  |  21.3 KB  |  624 lines
  1. Audacity: A Free, Cross-Platform Digital Audio Editor
  2.  
  3. Version 1.2.0
  4. For changelog, see the bottom of this document.
  5.  
  6. WWW:   http://audacity.sourceforge.net/
  7.  
  8. Email: audacity-help@lists.sourceforge.net
  9.  
  10. Lead Developers:
  11.  
  12.   Matt Brubeck
  13.   Joshua Haberman
  14.   Dominic Mazzoni (project leader)
  15.  
  16. Active Developers:
  17.   James Crook
  18.   Vaughan Johnson
  19.   Markus Meyer
  20.   Shane Mueller
  21.   Tony Oetzmann
  22.  
  23. Developers
  24.   William Bland
  25.   Vince Busam
  26.   Brian Gunlogson
  27.   Greg Mekkes
  28.   Augustus Saunders  
  29.  
  30. Other Contributors:
  31.   Dave Beydler
  32.   Jason Cohen
  33.   Roger Dannenberg
  34.   Steve Harris
  35.   Daniil Kolpakov
  36.   Robert Leidle
  37.   Logan Lewis
  38.   Abe Milde
  39.   Paul Nasca
  40.   Jason Pepas
  41.   Mark Phillips
  42.   Jonathan Ryshpan
  43.   Patrick Shirkey
  44.   Mark Tomlinson
  45.   David Topper
  46.   Rudy Trubitt
  47.   Tom Woodhams
  48.  
  49.  
  50. The Audacity Logo:
  51.  
  52.   Harvey Lubin
  53.   http://www.agrapha.com/
  54.  
  55. Special Thanks:
  56.  
  57.   The wxWidgets Team
  58.   The Ogg Vorbis Team
  59.   Rob Leslie (libmad)
  60.   Ross Bencina and Phil Burk (PortAudio)
  61.   Erik de Castro Lopo (libsndfile)
  62.   Verilogix, Inc.
  63.  
  64. -------------------------------------------------------------
  65.  
  66. This program is free software; you can redistribute it and/or
  67. modify it under the terms of the GNU General Public
  68. License as published by the Free Software Foundation; either
  69. version 2 of the License, or (at your option) any later version.
  70.  
  71. This program is distributed in the hope that it will be useful,
  72. but WITHOUT ANY WARRANTY; without even the implied warranty of
  73. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  74. General Public License for more details.
  75.  
  76. You should have received a copy of the GNU General Public License
  77. along with this program (in a file called LICENSE.txt); if not, go
  78. to http://www.gnu.org/copyleft/gpl.html or write to 
  79.  
  80.   Free Software Foundation, Inc.
  81.   59 Temple Place - Suite 330
  82.   Boston, MA 02111-1307 USA
  83.  
  84. -------------------------------------------------------------
  85.  
  86. Source code to this program is always available; for more
  87. information visit our website at:
  88.  
  89.   http://audacity.sourceforge.net/
  90.  
  91. Audacity is built upon other free libraries; some of
  92. these libraries may have come with Audacity in the lib-src
  93. directory.  Others you are expected to install first if
  94. you want Audacity to have certain capabilities.  Most
  95. of these libraries are not distributed under the terms
  96. of the GPL, but rather some other free, GPL-compatible
  97. license.  Specifically:
  98.  
  99.   wxWidgets: LGPL
  100.     Cross-platform GUI library - must be downloaded and
  101.     compiled separately.
  102.  
  103.   expat: BSD-like license.
  104.     Provides XML parsing.  Included with Audacity
  105.  
  106.   iAVC: LGPL
  107.     Part of the code to the AVC Compressor effect.
  108.     Included with Audacity.
  109.  
  110.   libid3tag: GPL
  111.     Reads/writes ID3 tags in MP3 files.  Optional
  112.     separate download as part of libmad.
  113.  
  114.   libmad: GPL
  115.     Decodes MP3 files.  Optional separate download.
  116.  
  117.   libnyquist: BSD-like license.
  118.     Functional language for manipulating audio; available
  119.     within Audacity for effects processing.
  120.  
  121.   libogg: BSD-like license.
  122.     Optional separate download, along with libvorbis.
  123.  
  124.   libresample: LGPL
  125.     High-quality audio resampling.
  126.     
  127.   libsndfile: LGPL
  128.     Reads and writes uncompressed PCM audio files.
  129.     Included with Audacity.
  130.  
  131.   libvorbis: BSD-like license.
  132.     Decodes and encodes Ogg Vorbis files.  Optional
  133.     separate download.
  134.  
  135. For more information, see the documentation inside
  136. each library's source code directory.
  137.  
  138. -------------------------------------------------------------------------
  139. Additional copyright information:
  140. -------------------------------------------------------------------------
  141.  
  142. Nyquist
  143.  
  144. Copyright (c) 2000-2002, by Roger B. Dannenberg
  145. All rights reserved.
  146.  
  147. Redistribution and use in source and binary forms, with or without
  148. modification, are permitted provided that the following conditions are met:
  149.  
  150. Redistributions of source code must retain the above copyright notice, this
  151. list of conditions and the following disclaimer.
  152.  
  153. Redistributions of source code must retain the copyright notice, the
  154. list of conditions, and the disclaimer, all three of which appear below under
  155. "COPYRIGHT AND LICENSE INFORMATION FOR XLISP."
  156.  
  157. Redistributions in binary form must reproduce the above copyright notice, this
  158. list of conditions and the following disclaimer in the documentation and/or
  159. other materials provided with the distribution.
  160.  
  161. Redistributions in binary form must reproduce the copyright notice, the
  162. list of conditions, and the disclaimer, all three of which appear below under
  163. "COPYRIGHT AND LICENSE INFORMATION FOR XLISP," in the documentation and/or
  164. other materials provided with the distribution.
  165.  
  166. Neither the name of Roger B. Dannenberg, Carnegie Mellon University, nor the 
  167. names of any contributors may be used to endorse or promote products derived 
  168. from this software without specific prior written permission.
  169.  
  170. COPYRIGHT AND LICENSE INFORMATION FOR XLISP (part of Nyquist):
  171.  
  172. Copyright (c) 1984-2002, by David Michael Betz
  173. All rights reserved.
  174.  
  175. Redistribution and use in source and binary forms, with or without
  176. modification, are permitted provided that the following conditions are met:
  177.  
  178. Redistributions of source code must retain the above copyright notice,
  179. this list of conditions and the following disclaimer. 
  180.  
  181. Redistributions in binary form must reproduce the above copyright notice, this
  182. list of conditions and the following disclaimer in the documentation and/or
  183. other materials provided with the distribution.
  184.  
  185. Neither the name of David Michael Betz nor the names of any contributors may be
  186. used to endorse or promote products derived from this software without specific
  187. prior written permission.
  188.  
  189. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS" AND
  190. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  191. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  192. DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  193. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  194. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  195. SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  196. CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  197. OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  198. USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  199.  
  200. -------------------------------------------------------------
  201.  
  202. Compilation instructions:
  203.  
  204. First you must download wxWidgets from:
  205.  
  206.   http://www.wxWidgets.org/
  207.  
  208. If you install the RPM, make sure you install the devel RPM
  209. as well, otherwise, you won't be able to compile Audacity
  210. from source.
  211.  
  212. To compile on Linux, Mac OS X, and other Unix systems,
  213. simply execute these commands:
  214.  
  215.   ./configure
  216.   make
  217.   make install  # as root
  218.  
  219. To see compile-time options you can set, you can type
  220. "./configure --help".
  221.   
  222. If you want to do any development, you might want to generate
  223. a configure cache and header dependencies:
  224.  
  225.   ./configure -C
  226.   make dep
  227.  
  228. To compile on Windows using MSVC++, please follow the
  229. instructions found in compile.txt in the "win" subdirectory.
  230.  
  231. For more information on compilation (CodeWarrior for Mac is
  232. also supported) please email audacity-help@lists.sourceforge.net
  233.  
  234. -------------------------------------------------------------
  235.  
  236. Known issues/problems:
  237.  
  238.   * Audacity can import and display MIDI files, but they cannot be played
  239.     or edited.
  240.  
  241.   * Recording in full duplex (play existing tracks while recording) on some
  242.     Linux systems causes the recording to sound slowed-down.
  243.  
  244.   * Mac OS X only: Audacity cannot work with files or folders that
  245.     are contained inside folders with international characters
  246.     (accent marks, etc.) in their names.  Note that files with
  247.     accented characters work, and Audacity projects with
  248.     accented characters work.  Only files inside of folders
  249.     with accented characters in their names will cause problems.
  250.  
  251.   * Microsoft Windows(R) only:  Note that the Windows installer 
  252.     will replace 1.0.0 installations, but not the 1.1.x beta 
  253.     installations.
  254.  
  255.   * The About window does not display correctly in locales with
  256.     non-Western character sets.
  257.  
  258.   * The Change Pitch effect crashes when used with tracks that
  259.     have 96 KHz sample rates.
  260.  
  261. -------------------------------------------------------------
  262.  
  263. Changes in 1.2.0:
  264.  
  265.   * New cross-fade effects.
  266.  
  267.   * Fix problem where samples were drawn in the wrong position
  268.     when zoomed all the way in.  This caused the drawing tool
  269.     to move a different sample than the one under the cursor.
  270.  
  271.   * Don't use id3v2.4 tags, which are not yet supported by
  272.     most players.  (This was fixed in 1.2.0-pre2, but appeared
  273.     again by accident in 1.2.0-pre3.)
  274.  
  275.   * Correctly display translated messages in the status bar.
  276.  
  277.   * When the cursor is on-screen, the Zoom In button now zooms
  278.     to the area around the cursor.
  279.  
  280.   * Mac OS X: Fixed audio problems on the Apple PowerMac G5.
  281.  
  282.   * Linux/ALSA: Work around a bug in ALSA's OSS emulation that
  283.     caused Audacity's playback cursor to move too quickly.
  284.  
  285.   * Microsoft Windows: The Audacity source code should now
  286.     compile out of the box on Windows.
  287.  
  288.   * Many new/updated translations.
  289.  
  290. Changes in 1.2.0-pre4:
  291.  
  292.   * Fixed problems that could occur when importing certain
  293.     non-seekable PCM audio files, such as GSM610.
  294.  
  295.   * Fixed bug that was causing the samples to shift off-screen
  296.     horizonally when zoomed in very far and the track had a
  297.     time-shift offset.
  298.  
  299.   * Fixed bugs in the new resampler that added noise to resampled
  300.     audio on some systems. If you experienced noise when exporting
  301.     to a WAV, MP3 or OGG file you may have been bitten by this bug.
  302.   
  303.   * Fixed bug that led to occasional crashes when using the
  304.     time-shift tool in conjunction with high zoom factors.
  305.     
  306.   * Dithering is now only applied on export when it is really
  307.     necessary (e.g. when converting float samples to 16-bit).
  308.     
  309.   * Files that only contain mono tracks are now automatically
  310.     exported to stereo files when they contain tracks which are
  311.     panned to the left or the right.
  312.     
  313.   * The Delete key can now be used to delete the current selection,
  314.     in addition to the Backspace key.
  315.  
  316.   * Fixed bug where Audacity didn't ask whether to save 
  317.     changes if you close the project or exit while recording.
  318.  
  319.   * Mac OS X: Supports Playthrough (listen to what you're recording
  320.     while recording it) if your hardware device supports it.
  321.  
  322.   * Mac OS X: Audacity is now a package (you can right-click on
  323.     Audacity.app and select 'Show Package Contents').  Launch time
  324.     has improved significantly.
  325.  
  326.   * MS Windows: Fixed problem that caused Windows XP to use 
  327.     the short name of a file ("TESTFI~1.AUP"), which led to 
  328.     problems when the file was later opened again using the 
  329.     long file name.
  330.     
  331.   * MS Windows: Fixed bug that caused file exports to fail 
  332.     if the destination directory was the root folder of a 
  333.     Windows drive.
  334.  
  335.   * MS Windows: Audacity's application information which 
  336.     is written to the Windows registry now always contains 
  337.     the full path to the executable. 
  338.  
  339.   * MS Windows: Fixed problems in trying to set the Windows 
  340.     registry as non-admin user, for file-type associations.
  341.  
  342.   * Make sure the "Save" command is enabled after changing
  343.     gain and pan sliders.
  344.  
  345.   * Updated translations.  Added translator credits to the
  346.     "About" window in localized versions.
  347.  
  348. Changes in 1.2.0-pre3:
  349.  
  350.   * Fixed bug where Export is grayed out when nothing is
  351.     selected.
  352.  
  353.   * Fixed crash caused by opening Audacity on a computer with
  354.     a high-end sound card with no mixer support.
  355.  
  356.   * Fixed crash in Import Raw.
  357.  
  358.   * Fixed New Stereo Track.
  359.  
  360.   * Cosmetic fixes for Mac OS X.
  361.  
  362.   * Support for the VST Enabler on Windows added.
  363.  
  364.   * Fixed crash if you close Audacity while the Preferences
  365.     dialog is open.
  366.  
  367.   * Fixed duplicate-character bug in Mac OS X Label Tracks.
  368.  
  369.   * The recording level control on Linux now adjusts the IGAIN,
  370.     rather than the playthrough level of the recording source.
  371.  
  372.   * Fixed bug that caused corruption to 16-bit stereo recordings.
  373.  
  374.   * Fixed bug that caused data loss if you deleted all tracks in
  375.     a saved project and then open a new file into the same window.
  376.  
  377.   * Added support for alternate audio button order (in Interface
  378.     preferences)
  379.  
  380.   * Added preliminary support for wxX11
  381.  
  382.   * Added fully transparent Windows XP icon
  383.  
  384.   * Fixed crash if you try to record (or play) and no audio
  385.     devices exist, or if the audio device doesn't support the
  386.     mode you selected.
  387.  
  388.   * Audacity no longer sets the process priority to high while
  389.     recording on Windows.  Users can still do this manually
  390.     using the Task Manager.
  391.  
  392.   * Fixed bug that caused last ~100 ms of the selection to get
  393.     cut off on Windows.
  394.  
  395.   * Fixed FFT Filter and Equalization effects dialogs.
  396.  
  397.   * Fixed bugs in Unix build system (DESTDIR in locale directory,
  398.     choosing libsamplerate instead of libresample)
  399.  
  400.   * Support for LADSPA plug-ins on Windows added, and 
  401.     three open source LADSPA plug-ins ported to Windows
  402.     (GVerb reverb, SC4 compressor, and Hard Limiter)
  403.  
  404. Changes in 1.2.0-pre2:
  405.  
  406.   * Online help completed.  The full manual is nearly complete
  407.     and will be posted to the website for online browsing shortly.
  408.  
  409.   * Audacity will no longer let you do unsafe editing operations
  410.     while playing or recording.  This eliminates many potential
  411.     crashes.
  412.  
  413.   * Fixed ability to cancel Quit button.
  414.  
  415.   * New resampling library, with no restrictions on the maximum or
  416.     minimum rate of resampling.
  417.  
  418.   * Audacity now supports LADSPA plug-ins on all platforms, and
  419.     supports VST plug-ins through an optional LADSPA plug-in
  420.     called the "VST Enabler", which you can download separately.
  421.     Because of licensing issues, Audacity cannot be distributed
  422.     with VST support built-in.
  423.  
  424.   * Mac OS X keyboard shortcut problems have been fixed.
  425.  
  426.   * Mac OS X audio muting problems have been fixed.
  427.  
  428.   * Mac OS X playback/recording cursor sync problems have been fixed.
  429.  
  430.   * Silence now displays a straight line again, instead of nothing.
  431.  
  432.   * Added a vertical ruler to the Waveform dB display.
  433.  
  434.   * Fixed crash in Change Pitch.
  435.  
  436.   * You can now Paste if nothing is selected.
  437.  
  438.   * Canceling an Import operation doesn't cause an extra error
  439.     dialog to appear.
  440.  
  441.   * Audacity now handles filenames with international characters
  442.     correctly.
  443.  
  444.   * Now outputs ID3v2.3 tags (instead of ID3v2.4), to be
  445.     compatible with more MP3 players.
  446.  
  447.   * Minor improvements to build system on Unix systems.
  448.  
  449. New features in Audacity 1.2:
  450.   * User Interface
  451.     - Vertical zooming of tracks.
  452.     - Improved look and placement of toolbars.
  453.     - New custom mouse cursors.
  454.     - Complete implementation of editable keyboard shortcuts.
  455.     - Find zero-crossings.
  456.     - Mouse wheel can be used to zoom in and out.
  457.     - Multi-Tool mode.
  458.     - Amplify using envelope.
  459.     - Labels can store selections (like Audacity 1.0.0).
  460.  
  461.   * Effects
  462.     - Repeat Last Effect command
  463.     - Improved VST plug-in support
  464.     - Most effects now have a Preview button
  465.     - Compressor (Dynamic Range Compressor)
  466.     - Change Pitch (without changing tempo)
  467.     - Change Tempo (without changing pitch)
  468.     - Change Speed (changing both pitch and tempo)
  469.     - Repeat (useful for creating loops)
  470.     - Normalize (adjust volume and DC bias)
  471.  
  472.   * Audio I/O
  473.     - 1-second preview command.
  474.     - Looped play.
  475.  
  476.   * File I/O
  477.     - Audacity 1.2.0 opens project files from all previous versions
  478.       of Audacity from 0.98 through 1.1.3.
  479.     - Open multiple files from the same dialog.
  480.     - Use a text file to specify a list of audio files to open with offsets.
  481.  
  482.   * Updated user manual
  483.  
  484.   * Bug fixes
  485.     - Project files with special characters are no longer invalid.
  486.     - "Scratchy" noises caused by bad clipping are fixed.
  487.     - Audacity no longer exports invalid Ogg files, and does not cut off the
  488.       last few seconds of exported Ogg files.
  489.     - Mono MP3 files now export at the correct speed.
  490.     - Many incorrect results from the Envelope tool have been fixed.
  491.     - The "Export Labels" command now overwrites existing files correctly.
  492.     - The "Plot Spectrum" window displays the correct octave numbers for
  493.       notes.
  494.     - Several memory leaks are fixed.
  495.  
  496. New features in Audacity 1.1.3:
  497.   * User Interface
  498.     - New Mixer toolbar allows you to control the output
  499.       volume, input volume, and input source directly
  500.       from Audacity.
  501.     - Every track now has its own gain and pan controls.
  502.  
  503.   * File I/O
  504.     - Uses improved project file format.  (Unfortunately reading
  505.       previous formats, including 1.1.1, is not supported.)
  506.     - Block files (stored in Audacity project directories) now
  507.       use the standard AU format.  Though some Audacity
  508.       meta-information is in these files, they can now be
  509.       read by many other popular audio programs as well.
  510.     - Fixed some bugs relating to reading/writing audio
  511.       files with more than 16 bits per sample.
  512.     - Import RAW is functional again, with a simpler GUI
  513.       but support for far more file formats.  The
  514.       autodetection algorithms are much more accurate than
  515.       in 1.0.
  516.  
  517.   * Audio I/O
  518.     - Completely rewritten audio I/O, with lower latency
  519.       and minimal chance of buffer underruns while
  520.       recording.
  521.  
  522.   * Resampling
  523.     - Using high quality resampling algorithms, with the
  524.       option of better quality for mixing than for real-time
  525.       playback
  526.  
  527.     - Preliminary support for Time Tracks, for changing
  528.       playback speed over time.
  529.  
  530.   * Many more bug fixes and new features
  531.  
  532. New features in Audacity 1.1.2:
  533.   * User Interface
  534.     - Fixed bug in Windows version, for track menu commands 
  535.       "Name..." and "Split Stereo Track"/"Make Stereo Track".
  536.   * Effects
  537.     - Nyquist support on Windows (supports plug-ins written 
  538.       in Nyquist, an interpreted functional language based 
  539.       on Lisp).
  540.  
  541. New features in Audacity 1.1.1:
  542.  
  543.   * User Interface
  544.     - Tooltips appear in Statusbar.
  545.     - Vertical cursor follows play/record
  546.     - Pause button
  547.     - Drawing tool (with three different modes)
  548.     - Vertical Resizing of stereo tracks is more fun.
  549.     - Adjust selection by click-dragging selection boundary
  550.     - Toolbar button context-sensitive enabling/disabling
  551.     - Better zooming functionality (centers region)
  552.     - Multiple ways to display the cursor position and selection
  553.     - Snap-to selection mode
  554.     - Drag tracks up and down
  555.     - Align and group align functions
  556.     - Cursor save/restore
  557.     - Working history window
  558.   * Effects
  559.     - Effects broken down into three menus: Generate, Effect, and
  560.       Analyze
  561.     - Generate menu lets you generate silence, noise, or a tone
  562.     - Nyquist support (supports plug-ins written in Nyquist,
  563.       an interpreted functional language based on Lisp)
  564.   * Localization
  565.     - Improved localization support
  566.     - More languages available
  567.     - Language selection dialog on startup
  568.   * Mac OS X
  569.     - Support for more audio hardware
  570.     - Support for full-duplex (play while recording)
  571.     - Support for MP3 exporting using LameLib Carbon
  572.   * Unix
  573.     - Audacity now has a man page (it describes command-line
  574.       options and how to set the search path)
  575.   * File Formats
  576.     - Uses libsndfile 1.0, which fixes some bugs and
  577.       improves performance
  578.   * Searching for Files:
  579.     - On Windows and Mac OS, Audacity now looks for
  580.       translations in the "Languages" folder and all plug-ins
  581.       in the "Plug-ins" folder, relative to the program.
  582.     - On Unix, Audacity looks for translations in
  583.       <prefix>/share/locale and looks for everything else
  584.       in <prefix>/share/audacity and also in any paths in
  585.       the AUDACITY_PATH environment variable
  586.  
  587. New features in Audacity 1.1.0:
  588.  
  589.   * Core audio processing:
  590.     - Support for 24-bit and 32-bit sample formats
  591.     - Automatic real-time resampling (using linear
  592.         interpolation)
  593.   * Effects:
  594.     - Support LADSPA plugins on Linux / Unix
  595.   * File formats:
  596.     - New XML-based Audacity project format
  597.     - Full Ogg Vorbis support now (importing and exporting)
  598.     - Export to any command-line programs on Unix
  599.     - Support for reading and writing many more types of
  600.         uncompressed audio files, including ADPCM WAV files.
  601.   * Toolbars
  602.     - New toolbar drawing code; automatically adopts your
  603.         operating system's colors
  604.     - New toolbar buttons (Skip to Start, Skip to End)
  605.     - New Edit toolbar
  606.     - Toolbar buttons disable when they're not available
  607.   * User Interface
  608.     - Fully customizable keyboard commands
  609.     - Autoscroll while playing or recording
  610.     - New Ruler, used in main view and in
  611.         FFT Filter effect
  612.     - The waveform now displays the average value in a lighter
  613.         color inside the peak values
  614.   * Localization
  615.     - Audacity can now be localized to different foreign
  616.       languages.
  617.  
  618. New libraries in Audacity 1.1:
  619.  
  620.   * libmad for fast MP3 importing
  621.   * libid3tag for editing MP3 file information
  622.   * libsndfile to read and write more audio file formats
  623.   * PortAudio for cross-platform audio playing and recording
  624.