sox_ng is another Swiss Army Knife of sound processing utilities. It can convert audio files to other popular audio file types and also apply sound effects and filters during the conversion. This is the hot mirror of https://codeberg.org/sox_ng/sox_ng
Find a file
2026-08-29 15:01:37 +02:00
issues Portability fixes to issues.sh for FreeBSD 2025-10-13 11:41:27 +02:00
libgsm Fix another case or portable fallthrough without compiler warnings 2024-11-19 09:51:46 +01:00
lpc10 Remove unused parameters 2025-02-19 07:36:33 +01:00
m4 Make ogg output with -t sndfile work 2025-08-26 22:13:23 +02:00
msvc9 Rationalize .gitignores 2025-02-18 10:44:24 +01:00
msvc10 Rationalize .gitignores 2025-02-18 10:44:24 +01:00
scripts Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
src waveaudio: Only pause for a second on wave output, not input 2026-08-29 14:09:46 +02:00
test Disallow piped commands in playlists to prevent command injection 2026-08-26 14:24:13 +02:00
.gitignore Rationalize .gitignores 2025-02-18 10:44:24 +01:00
AUTHORS Update Doug Cook's email address 2025-02-18 10:44:18 +01:00
ChangeLog Release 14.5.4 2026-08-29 15:01:37 +02:00
CMakeLists.txt Rip out the mpg123 decoding 2024-11-22 22:07:26 +01:00
configure.ac Release 14.5.4 2026-08-29 15:01:37 +02:00
COPYING Replace blanket GPL/LPGL licences with GPLv2 2024-08-04 03:33:56 +02:00
cygbuild Update to latest versions of deps and drop MP3 patent words 2025-02-18 10:44:16 +01:00
Doxyfile Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
FEATURES.in Rip out the mpg123 decoding 2024-11-22 22:07:26 +01:00
INSTALL Update ChangeLog and INSTALL 2025-02-18 10:44:20 +01:00
libsox_ng.3 Run manuals through spelling check 2025-08-26 22:13:22 +02:00
Makefile.am Add rules to make win32.exe and win64.exe 2026-02-25 17:32:37 +01:00
mingwbuild Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
osxbuild Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
README.md Release 14.5.2 2025-10-13 12:26:06 +02:00
README.osx Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
README.sh Drop the pmwiki-format Docs.Features file generation 2025-02-18 10:44:20 +01:00
README.win32 Make waveaudio the default audio driver on Windows 2025-08-26 22:13:24 +02:00
release.sh Correct the mailing list's address 2024-09-12 14:39:55 +02:00
RULES-issues.md Update RULES-issues.md and RULES-wiki.md 2025-08-29 07:35:22 +02:00
RULES-wiki.md Update RULES-issues.md and RULES-wiki.md 2025-08-29 07:35:22 +02:00
RULES.md Replace martinwguy's read-only access token with sox_ng's one 2024-11-01 12:30:38 +01:00
screenshot1 Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
sox_ng.1 Recommend using flanger for chorus and phaser 2025-08-26 22:13:23 +02:00
sox_ng.pc.in Rename sox, soxi, play, rec, sox.h and libsox to *_ng 2024-07-14 17:44:09 +02:00
soxformat_ng.7 Remove (also with -tsndfile) from .vox [issue #576] 2025-08-26 22:13:23 +02:00
soxi_ng.1 Run manuals through spelling check 2025-08-26 22:13:22 +02:00

README.md

The SoX_ng project imports, compares and refines bug fixes and new work from the 50-odd software distributions that package SoX and from the plethora of forks on github and elsewhere and makes regular releases with a six-monthly cadence for each of the micro (bug fixes) and minor (new features) releases. A major release (non-backwards-compatible changes) is not planned.

The next micro release is scheduled for the 18th February 2026.
The next minor release is scheduled for the 18th November 2025.

Terminology

sox means sox.sf.net
SoX means the Swiss Army Knife of command-line audio processing in any of its incarnations
sox_ng means the hard fork of sox-14.4.2 aiming to sanitize SoX
SoX_ng means the project to maintain sox_ng

How to get it

sox_ng lives at codeberg.org/sox_ng/sox_ng and is composed of a SoX code base, a wiki and an issue tracker.

Releases

Download one of the release tarballs.

Extract it:

gzip -d < sox_ng-*.tar.gz | tar xf -

Build it:

cd sox_ng*
./configure
make

Install it:

make install

It installs as sox_ng, sox_ng.h, libsox_ng.so and so on so that sox and sox_ng can coexist on the same system. To make it work the same as the original sox, use ./configure --enable-replace instead, and if ffmpeg is installed add --with-ffmpeg to decode 48 more audio and video formats.

Development branches

main

To fetch the latest version:

git clone https://codeberg.org/sox_ng/sox_ng
cd sox_ng

and to make local copies of the wiki and the issues:

git clone https://codeberg.org/sox_ng/sox_ng.wiki wiki
issues/getissues.sh

To compile it:

autoreconf -i
./configure
make

and to install it:

sudo make install

This installs it as sox_ng, sox_ng.h, libsox_ng and so on, so that it can coexist with traditional sox. If you want it to work the same as the original sox, use ./configure --enable-replace and if ffmpeg is installed add --with-ffmpeg to decode 48 more audio and video formats.

Build dependencies

To compile a release tarball you will need make, libtool and gcc or clang (./configure CC=clang)

To build the git repository you will also need autoconf and automake.

To enable all of SoX's optional modules you can install ladspa-sdk lame, libao, libfftw3, libflac, libid3tag, libmad libogg, libopus, libopusfile, libpng, libsndfile, libspeex, libspeexdsp, libvorbis, opencore-amr, twolame, wavpack.

Debian, Ubuntu, Mint etc.

apt install gcc make libtool ladspa-sdk libao-dev libasound2-dev libfftw3-dev \
	libgsm1-dev libid3tag0-dev libltdl-dev libmad0-dev libmagic-dev \
	libmp3lame-dev libopencore-amrnb-dev libopencore-amrwb-dev \
	libopusfile-dev libpng-dev libpulse-dev libsamplerate0-dev \
	libsndfile1-dev libspeex-dev libspeexdsp-dev libtwolame-dev \
	libvorbis-dev libwavpack-dev

and to run issues/getissues.sh and the makehtml.sh scripts you will need

apt-get install jq libtext-multimarkdown-perl

Fedora, Red Hat, CentOS etc.

yum install gcc make libtool \
	alsa-lib-devel fftw-devel file-devel flac-devel gsm-devel \
	ladspa-devel lame-devel libao-devel libcaca-devel libid3tag-devel \
	libmad-devel libpng-devel libsamplerate-devel libsndfile-devel \
	libtool-ltdl-devel libvorbis-devel opencore-amr-devel \
	opusfile-devel pulseaudio-libs-devel speex-devel speexdsp-devel \
	twolame-devel wavpack-devel

and to run issues/getissues.sh and the makehtml.sh scripts you will need

yum install jq multimarkdown

Accessibility

You can edit and commit to the code and the wiki using Codeberg's web interface or from the command-line. The command-line is the only way to add images and attachments to the wiki.

The issues can be downloaded as well as uploaded replacing all remote content but this risks overwriting changes made via the web interface so for now it is recommended to edit them on the Codeberg web site.

Community

Mailing list

Private email

Finances

README and PDFs

To generate SoX's original README, run ./README.sh or make README

To generate the PDF version of the documentation, make pdf