File	Date	Author	Commit
debian	2007-11-03	evilynux	[309cf8] Added libid3tag0-dev to Build-Depends and bumpe...
libgsm	2007-11-04	robs	[f51d9e] warning quashing
lpc10	2007-12-26	robs	[99df22] support out-of-source-build
m4	2007-02-04	rrt	[fd8976] Detect sf_open_virtual and use as a marker for ...
scripts	2007-01-28	cbagwell	[96e3ae] Update scripts help a little.
src	2008-01-03	rrt	[6e4596] Fix unsigned vs signed comparison warnings.
test	2007-11-04	robs	[ca17c9] some fixes I've had lying around for literally ...
watcom	2006-12-25	rrt	[9b643d] Remove soxmix, since it's just sox -m now.
.cvsignore	2007-08-23	rrt	[9c3f46] Add configure.lineno and config.status.lineno
AUTHORS	2007-11-03	robs	[8aa8cb] recent changes
CMakeLists.txt	2007-11-04	robs	[8f5e4c] fix some small build issues
COPYING	2007-02-21	robs	[b6a2c3] st -> sox leftovers
ChangeLog	2007-11-05	robs	[bf805c] dup
INSTALL	2007-11-04	robs	[a5824b] mention libao; group libs
LICENSE.GPL	2004-12-20	cbagwell	[097244] Added in noise reduction effect.
LICENSE.LGPL	2004-12-20	cbagwell	[097244] Added in noise reduction effect.
Makefile.am	2007-10-20	cbagwell	[5d2a07] Removing unused libltdl references.
NEWS	2006-12-06	rrt	[890744] Use automake. This arose out of trying to add L...
README	2007-06-19	robs	[455880] recent change
configure.ac	2008-01-03	rrt	[5df01d] Simplify use of AC_ARG_WITH; no need to set wit...
libsox.3	2007-12-24	rrt	[08cd2f] Change ft_t to sox_format_t, eff_t to sox_effec...
sox.1	2007-05-14	robs	[d0ab05] Allow simpler synth commands; null pointer idio...
soxeffect.7	2008-01-04	robs	[a47fa3] clarify freq. sweep type
soxexam.7	2007-10-24	robs	[1eb825] more changes for reverb
soxformat.7	2007-09-29	robs	[ffa894] non-standard, non-WAVE_FORMAT_EXTENSIBLE (esp. ...
update_debian_version.pl	2007-02-10	evilynux	[74f6ba] Little script to update the versions in the Deb...

Read Me

                         SoX: Sound eXchange
                         -------------------

SoX (Sound eXchange) is the Swiss Army knife of sound processing
tools: it translates sound files between many different file formats,
and can apply many sound effects and transforms, as well as doing
basic analysis and providing input to more capable analysis and
plotting tools.

SoX is distributed under the GNU GPL and GNU LGPL. To be precise: the
sox program is distributed under the GPL, while the library libsox, in
which most of SoX's functionality resides, is dual-licensed. Note that
some optional components of libsox are GPL only: if you use these, you
must use libsox under the GPL.

Send bug fixes, enhancements and feature requests to
sox-devel@lists.sourceforge.net, or post them to the relevant tracker
at http://sourceforge.net/projects/sox/.

This release understands:

  o Raw files in various binary formats
  o Raw textual data
  o Amiga 8svx files
  o Apple/SGI AIFF files
  o SUN .au files
    o PCM, u-law, A-law
    o G7xx ADPCM files (read only)
    o mutant DEC .au files
    o NeXT .snd files
  o AVR files
  o CD-R (music CD format)
  o CVS and VMS files (continuous variable slope)
  o GSM files
  o LPC-10 files
  o Macintosh HCOM files
  o Amiga MAUD files
  o AMR-WB & AMR-NB (with optional libamrwb & libamrnb libraries)
  o MP3 (with optional libmad and libmp3lame libraries)
  o MP4, AAC, AC3, WAVPACK, AMR-NB files (with optional ffmpeg
    library)
  o AVI, WMV, Ogg Theora, MPEG video files (with optional ffmpeg
    library)
  o Ogg Vorbis files (with optional Ogg Vorbis libraries)
  o FLAC files (with optional libflac)
  o IRCAM SoundFile files
  o NIST SPHERE files
  o Turtle beach SampleVision files
  o Soundtool (DOS) files
  o Yamaha TX-16W sampler files
  o Sound Blaster .VOC files
  o Dialogic/OKI ADPCM files (.VOX)
  o Microsoft .WAV files
    o PCM, u-law, A-law
    o MS ADPCM, IMA ADPCM
    o GSM
    o RIFX (big endian)
  o Psion (palmtop) A-law WVE files and Record voice notes
  o Maxis XA Audio files
    o EA ADPCM (read support only, for now)
  o Pseudo-file formats that allow direct playing/recording
    from most audio devices
  o The "null" pseudo-file that reads and writes from/to nowhere

Most sound formats are auto-detected.

The sound effects include:

  o Channel averaging, duplication, and removal (general mixer)
  o Band-pass filters
  o Band-reject filter
  o Bass tone control
  o Compress and Expand (compand) the dynamic range of a sample
  o Chorus effect
  o DCShift audio - useful to get the best volume adjustments
  o De-emphasis filter
  o Move sound stage of CD audio to in front of you (for headphone
    use)
  o Add an echo 
  o Add a sequence of echos
  o Fade in and out
  o Apply a flanger effect
  o Apply a high-pass filter
  o Apply a low-pass filter
  o Apply an equalizer effect
  o Add dithering/masking noise to a signal
  o Multi-band compander
  o Pad with silence
  o Pan sound between channels
  o Apply a phaser effect
  o Change the pitch of a sound file without affecting its speed
  o Repeat audio data
  o Change sampling rates using several different algorithms. A
     'resample' and 'polyphase' effect use high-grade signal rate
     changes using real signal theory!
  o Apply a reverb effect
  o Reverse the sound samples (to search for Satanic messages ;-)
  o Detect periods of silence and start and stop processing based on
    it
  o Change the speed of samples being played (like speeding up the
    motor on a tape recorder)
  o Display general stats on a sound sample
  o Stretch/shorten the duration of a sound file (without affecting
    pitch)
  o Swap stereo channels
  o Create sounds with a simple synthesizer
  o Treble tone control
  o Trim audio data from beginning and end of file
  o Apply a tremolo (a.k.a. vibrato) effect
  o Volume adjustment
  o Noise elimination using frequency profiling
  o Resample using libsamplerate (aka Secret Rabbit code, optional
    external library)
  o Apply LADSPA (Linux Audio Developer's Simple Plugin API) effects
    such as cmt (Computer Music Toolkit)

Unless you're using a pre-compiled binary version, you will need to
compile SoX as described in the INSTALL file.

SoX is distributed with man pages, with plain text versions for those
on systems without man.

The majority of SoX features and source code are contributed by users.
Thank you very much for making SoX a success! There are many new
features wanted for SoX, listed on the feature request tracker at
http://sourceforge.net/projects/sox/. Users are encouraged to
implement them!