Print Version | Search Site

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.4.1 was released on February 1, 2013. Highlights for this maintenance release include:
  • Will check that PulseAudio is present before trying to use it.
  • Use binary mode for pipe inputs ("|sox ...") on Windows.
  • Re-enable file-type detection when reading from a pipe.
  • Fix crash when seeking within a FLAC file.
  • Fix hang in rate and other effects when processing long files.
  • Audio length calculation fixes.
  • Many other bug fixes.

The complete list of changes can be viewed in the changelog.

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

Download

SoX downloads for Source code, Win32 binaries in ZIP archive, Win32 Installer, and Mac OS X binaries can be found on Sourceforge's File Release System.

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; there are some notes on selecting options for resampling. The resampler is also available separately as the SoX Resampler library (libsoxr).

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 Sourceforge. There is a SoX project web site that can be of use when working with git 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 git. It is possible to view the files checked in to git using a git web interface as well as find additional information on SourceForge's git web page.

If you have git installed on your system then you may obtain a snapshot of the latest source by performing the following command.

 git clone git://sox.git.sourceforge.net/gitroot/sox/sox

The anonymous git account does not need a password.

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

 git pull 

If you make any changes to SoX that you would like to be included in future releases then you may use the following commands to commit the changes to your local repo and make a patch for submission.

 git commit -a
 git format-patch -1

It is recommended to read git Documentation for further information and best practices.

Powered by PmWiki Last modified: February 07, 2013, at 09:48 PM