SoX - Sound eXchange

Welcome

Welcome to the home of SoX, the Swiss Army knife of sound processing programs.

SoX is a cross-platform (Windows, Linux, MacOS X, etc.) command line utility that can convert various formats of computer audio files in to other formats. It can also apply various effects to these sound files, and, as an added bonus, SoX can play and record audio files on most platforms.

The screen-shot to the right shows an example of SoX first being used to process some audio, then being used to play some audio files.

For the list of all file formats, device drivers, and effects supported in the latest release, click here. To see the complete set of SoX documentation, click here.

If you find SoX to be useful, please consider supporting the project with a donation. We can accept PayPal donations through the SourceForge donation system, although currently a SourceForge login ID (or an openID), is required. Creating a SourceForge ID takes only a few seconds—click on the Paypal logo below to make a donation.

An example SoX session

Latest News

SoX 14.3.1 was released on April 11, 2010. Highlights include:

New Grandstream ring-tone (gsrt) format.
CVSD encoding and decoding speed-ups.
Ability to select MP3 compression parameters.
Write support for ID3 and VBR tags in MP3 files.
Support loading MP3, AMRNB, AMRWB, and libsndfile libraries at runtime.
New native Windows audio driver for playing/recording.
New native Windows executable (no cygwin libraries) for smaller size and more consistent window experience.
OSX users no longer need Xcode installed to get missing libltld library.
Turned multi-threaded off by default since it is buggy on some platforms.
Many bugfixes and improvements to existing behavior.
Improvements to documentation and code examples.

The complete list of changes can be viewed here.

Bugs and workarounds associated with recent releases can be found here.

Download

SoX 14.3.1 downloads:

Source code and executables for older versions of SoX are available here.

Some third-party pre-built (usually older) versions of SoX are available via the links page.

Using gnuplot with SoX

Technical Information

SoX is often used to convert an audio file from one sampling rate to another rate (e.g. from DAT to CD rates). SoX's resampling algorithm is highly configurable; some notes on selecting options for resampling are available here.

If you're interested in the format of various audio files then you will be interested in the Audio File Format FAQ which I also maintain.

Support and Development

SorceForge.net Most of the SoX project's resources are provided by Soureforge. There is a SoX project web site that can be of use when working with CVS and its mailing list.

There is a low volume mailing list set up that you can subscribe to or read online located at the SoX-users Mailing List web site.

Development of SoX is done using CVS. It is possible to view the files checked in to CVS using a CVS web interface as well as find additional information on SourceForge's CVS webpage.

If you have CVS installed on your system then you may obtain a snapshot of the latest source by performing the following commands. The commands will log you in and check out a copy of the sox module and place it in the subdirectory it was run from.

 cvs -d :pserver:anonymous@sox.cvs.sourceforge.net:/cvsroot/sox login
 cvs -z3 -d :pserver:anonymous@sox.cvs.sourceforge.net:/cvsroot/sox co -P sox

The anonymous CVS account does not need a password. When prompted for a password by the cvs command, enter nothing and hit Enter.

To merge in future updates you may run the following command (from inside the sox directory that was created from your checkout):

 cvs update -P

If you make any changes to SoX that you would like to be included in future releases then you may use the following command to make an easy to read diff.

 cvs diff -uw