ref: b03e0534d7d2ab306b584296bf0af011db85bf55
dir: /INSTALL/
SoX Installation
----------------
This distribution will compile and run on most UNIX systems. It was
originally developed on a UNIX/386 machine running AT&T V3.2 but it's
currently developed under Linux. With a little work it should work
with most POSIX systems.
Compiling
---------
[Only if you're compiling the CVS sources, first make sure you have
the GNU autotools installed (automake 1.9, autoconf >= 2.59) and run
autoreconf -i
]
The preferred method for compiling SoX is to use the "configure"
scripts compatible with most UNIX systems that contain "/bin/sh" or
equivalent (it can also be used on Windows with Cygwin).
To compile and install SoX on these platforms run the following
commands:
./configure
make
make install
There are several optional parameters that you may pass to the
configure script to customize SoX for your applications. Run
./configure --help
for a complete list of options.
Optional Compile Features
-------------------------
SoX can make use of some external libraries to obtain support
for additional file formats and/or effects. Some optional libraries
may require pkg-config to be installed to be properly detected.
SoX can detect and use the following libraries:
Ogg Vorbis - More information available at http://www.vorbis.com
Lame MP3 encoder - http://lame.sourceforge.net/
MAD MP3 decoder - http://www.underbit.com/products/mad/
FLAC - http://flac.sourceforge.net/
Secret Rabbit Code - http://www.mega-nerd.com/SRC/
libsndfile - http://www.mega-nerd.com/libsndfile/
If any libraries are installed in a non-standard locations in your
system then you can use the CPPFLAGS and LDFLAGS variables to allow
configure to find them. For example:
./configure CPPFLAGS="-I/home/sox/include -I/usr/local/multimedia/include" LDFLAGS="-L/home/sox/lib -L/usr/local/multimedia/lib"
If you are compiling under cygwin and would like to create a static
sox.exe using mingw libraries then you can use the following:
./configure CC="gcc -mno-cygwin" --disable-shared
Testing
-------
After successfully compiling SoX, try translating a sound file. If you
can play one of the supported sound file formats, translate
'monkey.wav' to your format (we'll use 'xxx'):
cd src
./sox monkey.wav monkey.xxx
You may have to give the word size and rate for the file. For example,
this command will make a sound file with a data rate of 12,500 samples
per second and the data formatted as signed shorts:
./sox monkey.voc -r 12500 -s -w monkey.xxx
If monkey.xxx plays properly (it's a very short monkey screech),
congratulations! SoX works.
If your adding new features to SoX or want to perform advance tests
on a new platform then you can use the scripts "tests.sh" and
"testall.sh" to stress SoX.