|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| libgsm/ | H | 03-May-2022 | - | 4,815 | 3,267 |
| lpc10/ | H | 03-May-2022 | - | 8,487 | 3,407 |
| m4/ | H | 22-Feb-2015 | - | 8,843 | 7,966 |
| msvc10/ | H | 03-May-2022 | - | 4,499 | 4,042 |
| msvc9/ | H | 03-May-2022 | - | 7,371 | 6,907 |
| scripts/ | H | 22-Feb-2015 | - | 15 | 13 |
| src/ | H | 03-May-2022 | - | 57,151 | 41,327 |
| AUTHORS | H A D | 02-Mar-2011 | 308 | 9 | 6 |
| COPYING | H A D | 27-Dec-2011 | 548 | 12 | 9 |
| ChangeLog | H A D | 22-Feb-2015 | 80.1 KiB | 1,760 | 1,545 |
| FEATURES.in | H A D | 06-Oct-2014 | 5.3 KiB | 146 | 130 |
| INSTALL | H A D | 17-Dec-2014 | 12.5 KiB | 351 | 249 |
| LICENSE.GPL | H A D | 02-Mar-2011 | 17.6 KiB | 340 | 281 |
| LICENSE.LGPL | H A D | 02-Mar-2011 | 25.8 KiB | 505 | 418 |
| Makefile.am | H A D | 06-Oct-2014 | 3.9 KiB | 131 | 96 |
| Makefile.in | H A D | 22-Feb-2015 | 37.4 KiB | 1,157 | 1,038 |
| NEWS | H A D | 23-Dec-2014 | 434 | 12 | 9 |
| README | H A D | 17-Dec-2014 | 7.7 KiB | 197 | 163 |
| README.osx | H A D | 06-Oct-2014 | 3.9 KiB | 130 | 88 |
| README.sh | H A D | 02-Mar-2011 | 2.3 KiB | 66 | 48 |
| README.win32 | H A D | 02-Mar-2011 | 5.7 KiB | 168 | 120 |
| aclocal.m4 | H A D | 22-Feb-2015 | 48.8 KiB | 1,373 | 1,241 |
| compile | H A D | 17-Dec-2014 | 7.2 KiB | 348 | 258 |
| config.guess | H A D | 17-Dec-2014 | 41.9 KiB | 1,421 | 1,229 |
| config.sub | H A D | 17-Dec-2014 | 35 KiB | 1,799 | 1,661 |
| configure | H A D | 22-Feb-2015 | 552 KiB | 19,355 | 16,373 |
| configure.ac | H A D | 22-Feb-2015 | 25 KiB | 767 | 646 |
| cygbuild | H A D | 23-Dec-2014 | 3.9 KiB | 124 | 43 |
| depcomp | H A D | 17-Dec-2014 | 23 KiB | 792 | 502 |
| install-sh | H A D | 17-Dec-2014 | 13.7 KiB | 528 | 351 |
| libsox.3 | H A D | 02-Mar-2011 | 14.9 KiB | 388 | 373 |
| ltmain.sh | H A D | 17-Dec-2014 | 276.8 KiB | 9,656 | 7,304 |
| missing | H A D | 17-Dec-2014 | 6.7 KiB | 216 | 143 |
| sox.1 | H A D | 22-Dec-2014 | 146 KiB | 4,256 | 4,227 |
| sox.pc.in | H A D | 02-Mar-2011 | 264 | 13 | 11 |
| soxformat.7 | H A D | 22-Dec-2014 | 26.8 KiB | 818 | 802 |
| soxi.1 | H A D | 06-Oct-2014 | 3.2 KiB | 124 | 111 |
README
1 SoX: Sound eXchange
2 ===================
3
4SoX (Sound eXchange) is the Swiss Army knife of sound processing tools: it
5can convert sound files between many different file formats & audio devices,
6and can apply many sound effects & transformations, as well as doing basic
7analysis and providing input to more capable analysis and plotting tools.
8
9SoX is licensed under the GNU GPL and GNU LGPL. To be precise, the 'sox'
10and 'soxi' programs are distributed under the GPL, while the library
11'libsox' (in which most of SoX's functionality resides) is dual-licensed.
12Note that some optional components of libsox are GPL only: if you use these,
13you must use libsox under the GPL. See INSTALL for the list of optional
14components and their licences.
15
16If this distribution is of source code (as opposed to pre-built binaries),
17then you will need to compile and install SoX as described in the 'INSTALL'
18file.
19
20Changes between this release and previous releases of SoX can be found in
21the 'ChangeLog' file; a summary of the file formats and effects supported in
22this release can be found below. Detailed documentation for using SoX can
23be found in the distributed 'man' pages:
24
25 o sox(1)
26 o soxi(1)
27 o soxformat(7)
28 o libsox(3)
29
30or in plain text or PDF files for those systems without man.
31
32The majority of SoX features and fixes are contributed by SoX users - thank
33you very much for making SoX a success! There are several new features
34wanted for SoX, listed on the feature request tracker at the SoX project
35home-page:
36
37 http://sourceforge.net/projects/sox
38
39users are encouraged to implement them!
40
41Please submit bug reports, new feature requests, and patches to the relevant
42tracker at the above address, or by email:
43
44 mailto:sox-devel@lists.sourceforge.net
45
46Also accessible via the project home-page is the SoX users' discussion
47mailing list which you can join to discuss all matters SoX with other SoX
48users; the mail address for this list is:
49
50 mailto:sox-users@lists.sourceforge.net
51
52The current release handles the following audio file formats:
53
54
55 o Raw files in various binary formats
56 o Raw textual data
57 o Amiga 8svx files
58 o Apple/SGI AIFF files
59 o SUN .au files
60 o PCM, u-law, A-law
61 o G7xx ADPCM files (read only)
62 o mutant DEC .au files
63 o NeXT .snd files
64 o AVR files
65 o CDDA (Compact Disc Digital Audio format)
66 o CVS and VMS files (continuous variable slope)
67 o Grandstream ring-tone files
68 o GSM files
69 o HTK files
70 o LPC-10 files
71 o Macintosh HCOM files
72 o Amiga MAUD files
73 o AMR-WB & AMR-NB (with optional libamrwb & libamrnb libraries)
74 o MP2/MP3 (with optional libmad, libtwolame and libmp3lame libraries)
75 o Opus files (read only; with optional Opus libraries)
76
77 o Ogg Vorbis files (with optional Ogg Vorbis libraries)
78 o FLAC files (with optional libFLAC)
79 o IRCAM SoundFile files
80 o NIST SPHERE files
81 o Turtle beach SampleVision files
82 o Sounder & Soundtool (DOS) files
83 o Yamaha TX-16W sampler files
84 o SoundBlaster .VOC files
85 o Dialogic/OKI ADPCM files (.VOX)
86 o Microsoft .WAV files
87 o PCM, floating point
88 o u-law, A-law, MS ADPCM, IMA (DMI) ADPCM
89 o GSM
90 o RIFX (big endian)
91 o WavPack files (with optional libwavpack library)
92 o Psion (palmtop) A-law WVE files and Record voice notes
93 o Maxis XA Audio files
94 o EA ADPCM (read support only, for now)
95 o Pseudo formats that allow direct playing/recording from most audio devices
96 o The "null" pseudo-file that reads and writes from/to nowhere
97
98
99The audio effects/tools included in this release are as follows:
100
101 o Tone/filter effects
102 o allpass: RBJ all-pass biquad IIR filter
103 o bandpass: RBJ band-pass biquad IIR filter
104 o bandreject: RBJ band-reject biquad IIR filter
105 o band: SPKit resonator band-pass IIR filter
106 o bass: Tone control: RBJ shelving biquad IIR filter
107 o equalizer: RBJ peaking equalisation biquad IIR filter
108 o firfit+: FFT convolution FIR filter using given freq. response (W.I.P.)
109 o highpass: High-pass filter: Single pole or RBJ biquad IIR
110 o hilbert: Hilbert transform filter (90 degrees phase shift)
111 o lowpass: Low-pass filter: single pole or RBJ biquad IIR
112 o sinc: Sinc-windowed low/high-pass/band-pass/reject FIR
113 o treble: Tone control: RBJ shelving biquad IIR filter
114
115 o Production effects
116 o chorus: Make a single instrument sound like many
117 o delay: Delay one or more channels
118 o echo: Add an echo
119 o echos: Add a sequence of echos
120 o flanger: Stereo flanger
121 o overdrive: Non-linear distortion
122 o phaser: Phase shifter
123 o repeat: Loop the audio a number of times
124 o reverb: Add reverberation
125 o reverse: Reverse the audio (to search for Satanic messages ;-)
126 o tremolo: Sinusoidal volume modulation
127
128 o Volume/level effects
129 o compand: Signal level compression/expansion/limiting
130 o contrast: Phase contrast volume enhancement
131 o dcshift: Apply or remove DC offset
132 o fade: Apply a fade-in and/or fade-out to the audio
133 o gain: Apply gain or attenuation; normalise/equalise/balance/headroom
134 o loudness: Gain control with ISO 226 loudness compensation
135 o mcompand: Multi-band compression/expansion/limiting
136 o norm: Normalise to 0dB (or other)
137 o vol: Adjust audio volume
138
139 o Editing effects
140 o pad: Pad (usually) the ends of the audio with silence
141 o silence: Remove portions of silence from the audio
142 o splice: Perform the equivalent of a cross-faded tape splice
143 o trim: Cuts portions out of the audio
144 o vad: Voice activity detector
145
146 o Mixing effects
147 o channels: Auto mix or duplicate to change number of channels
148 o divide+: Divide sample values by those in the 1st channel (W.I.P.)
149 o remix: Produce arbitrarily mixed output channels
150 o swap: Swap pairs of channels
151
152 o Pitch/tempo effects
153 o bend: Bend pitch at given times without changing tempo
154 o pitch: Adjust pitch (= key) without changing tempo
155 o speed: Adjust pitch & tempo together
156 o stretch: Adjust tempo without changing pitch (simple alg.)
157 o tempo: Adjust tempo without changing pitch (WSOLA alg.)
158
159 o Mastering effects
160 o dither: Add dither noise to increase quantisation SNR
161 o rate: Change audio sampling rate
162
163 o Specialised filters/mixers
164 o deemph: ISO 908 CD de-emphasis (shelving) IIR filter
165 o earwax: Process CD audio to best effect for headphone use
166 o noisered: Filter out noise from the audio
167 o oops: Out Of Phase Stereo (or `Karaoke') effect
168 o riaa: RIAA vinyl playback equalisation
169
170 o Analysis `effects'
171 o noiseprof: Produce a DFT profile of the audio (use with noisered)
172 o spectrogram: graph signal level vs. frequency & time (needs `libpng')
173 o stat: Enumerate audio peak & RMS levels, approx. freq., etc.
174 o stats: Multichannel aware `stat'
175
176 o Miscellaneous effects
177 o ladspa: Apply LADSPA plug-in effects e.g. CMT (Computer Music Toolkit)
178 o synth: Synthesise/modulate audio tones or noise signals
179 o newfile: Create a new output file when an effects chain ends.
180 o restart: Restart 1st effects chain when multiple chains exist.
181
182 o Low-level signal processing effects
183 o biquad: 2nd-order IIR filter using externally provided coefficients
184 o downsample: Reduce sample rate by discarding samples
185 o fir: FFT convolution FIR filter using externally provided coefficients
186 o upsample: Increase sample rate by zero stuffing
187
188 + Experimental or incomplete effect; may change in future.
189
190Multiple audio files can be combined (and then further processed with
191effects) using any one of the following combiner methods:
192
193 o concatenate
194 o mix
195 o merge: E.g. two mono files to one stereo file
196 o sequence: For playing multiple audio files/streams
197
README.osx
README.sh
1#!/bin/sh
2
3cat > README << .
4 SoX: Sound eXchange
5 ===================
6
7SoX (Sound eXchange) is the Swiss Army knife of sound processing tools: it
8can convert sound files between many different file formats & audio devices,
9and can apply many sound effects & transformations, as well as doing basic
10analysis and providing input to more capable analysis and plotting tools.
11
12SoX is licensed under the GNU GPL and GNU LGPL. To be precise, the 'sox'
13and 'soxi' programs are distributed under the GPL, while the library
14'libsox' (in which most of SoX's functionality resides) is dual-licensed.
15Note that some optional components of libsox are GPL only: if you use these,
16you must use libsox under the GPL. See INSTALL for the list of optional
17components and their licences.
18
19If this distribution is of source code (as opposed to pre-built binaries),
20then you will need to compile and install SoX as described in the 'INSTALL'
21file.
22
23Changes between this release and previous releases of SoX can be found in
24the 'ChangeLog' file; a summary of the file formats and effects supported in
25this release can be found below. Detailed documentation for using SoX can
26be found in the distributed 'man' pages:
27
28 o sox(1)
29 o soxi(1)
30 o soxformat(7)
31 o libsox(3)
32
33or in plain text or PDF files for those systems without man.
34
35The majority of SoX features and fixes are contributed by SoX users - thank
36you very much for making SoX a success! There are several new features
37wanted for SoX, listed on the feature request tracker at the SoX project
38home-page:
39
40 http://sourceforge.net/projects/sox
41
42users are encouraged to implement them!
43
44Please submit bug reports, new feature requests, and patches to the relevant
45tracker at the above address, or by email:
46
47 mailto:sox-devel@lists.sourceforge.net
48
49Also accessible via the project home-page is the SoX users' discussion
50mailing list which you can join to discuss all matters SoX with other SoX
51users; the mail address for this list is:
52
53 mailto:sox-users@lists.sourceforge.net
54
55.
56cat FEATURES.in \
57 | sed "s/!!/ /" \
58 | sed "s/^\*\*/ o /" \
59 | sed "s/^\*/ o /" \
60 | sed "s/(:[a-zA-Z0-9_= -]*:)//g" \
61 >> README
62
63echo version=pmwiki-2.2.0-beta65 ordered=1 urlencoded=1 > Docs.Features
64echo -n text= >> Docs.Features
65cat FEATURES.in|sed "s/%/%25/g"|sed "s/$/%0a/"|tr -d '\n' >> Docs.Features
66
README.win32
1SoX
2---
3
4This file contains information specific to the Win32 version of SoX.
5Please refer to the README file for general information.
6
7The binary SOX.EXE can be installed anywhere you desire. The only
8restriction is that the included ZLIB1..DLL and LIBGOMP-1.DLL must be
9located in the same directory as SOX.EXE or somewhere within your PATH.
10
11SoX Helper Applications
12-----------------------
13
14SoX also includes support for SOXI.EXE, PLAY.EXE and REC.EXE and their
15behaviors are documented in included PDF's. They have the same
16install restrictions as SOX.EXE.
17
18SOXI.EXE, PLAY.EXE, and REC.EXE are not distributed with this package to
19reduce size requirements. They are, in fact, only copies of the original
20SOX.EXE binary which changes SOX.EXE's behavior based on the
21executable's filename.
22
23If you wish to make use of these utils then you can create them
24yourself.
25
26copy sox.exe soxi.exe
27copy sox.exe play.exe
28copy sox.exe rec.exe
29
30If you are concerned with disk space, the play and record
31functionality can be equated using the "-d" option with SOX.EXE. soxi
32functionality can be equated using the "--info" option with SOX.EXE. The
33rough syntax is:
34
35play: sox [input files and options] -d [effects]
36rec: sox -d [output file and options] [effects]
37soxi: sox --info [input files and options]
38
39Acknowledgements
40----------------
41
42SOX.EXE included in this package makes use of the following projects.
43See the cygbuild script included with the source code package for
44further information on how it was compiled and packaged.
45
46 SoX - http://sox.sourceforge.net
47
48 FLAC - http://flac.sourceforge.net
49
50 LADSPA - http://www.ladspa.org
51
52 libid3tag - http://www.underbit.com/products/mad
53
54 libsndfile - http://www.mega-nerd.com/libsndfile
55
56 Ogg Vorbis - http://www.vorbis.com
57
58 PNG - http://www.libpng.org/pub/png
59
60 WavPack - http://www.wavpack.com
61
62 wget - http://www.gnu.org/software/wget
63
64Enjoy,
65The SoX Development Team
66
67Appendix - wget Support
68-----------------------
69
70SoX can make use of the wget command line utility to load files over
71the internet. A binary copy of wget has been included with this
72package of SoX for your convience.
73
74For SoX to make use of wget, it must be located either in your PATH or
75within the same directory that SoX is ran from.
76
77Custom configuration of wget can be made by editing the file wget.ini
78contained in the same directory as wget.exe.
79
80Please consult wget's homepage for access to source code as well as
81further instructions on configuring.
82
83http://www.gnu.org/software/wget
84
85Appendix - MP3 Support
86----------------------
87
88SoX contains support for reading and writing MP3 files but does not ship
89with the DLL's that perform decoding and encoding of MP3 data because
90of patent restrictions. For further details, refer to:
91
92http://en.wikipedia.org/wiki/MP3#Licensing_and_patent_issues
93
94MP3 support can be enabled by placing Lame encoding DLL and/or
95MAD decoding DLL into the same directory as SOX.EXE. These
96can be compiled yourself, they may turn up on searches of the internet
97or may be included with other MP3 applications already installed
98on your system. For encoding/writing, try searching for lame-enc.dll,
99libmp3lame-0.dll, libmp3lame.dll, or cygmp3lame-0.dll. For
100decoding/reading, try searching for libmad-0.dll, libmad.dll or cygmad-0.dll.
101
102Instructions are included here for using MSYS to create the DLL's.
103It is assumed you already have MSYS installed on your system
104with a working gcc compiler. The commands are ran from MSYS
105bash shell.
106
107Obtain the latest Lame and MAD source code from approprate locations.
108
109Lame MP3 encoder http://lame.sourceforge.net
110MAD MP3 decoder http://www.underbit.com/products/mad
111
112cd lame-398-2
113./configure --disabled-static --enable-shared
114make
115cp libmp3lame/.libs/libmp3lame-0.dll /path/to/sox
116
117MAD libraries up to 0.15.1b have a bug in configure that will not allow
118building DLL under mingw. This can be resolved by adding LDFLAGS
119to configure and editing the generated Makefile to remove an invalid
120option.
121
122cd libmad-0.15.1b
123./configure --enable-shared --disable-static LDFLAGS="-no-undefined"
124[edit Makefile, search for "-fforce-mem" and delete it.]
125make
126cp libmad-0.dll /path/to/sox/
127
128Appendix - AMR-NB/AMR-WB Support
129--------------------------------
130
131SoX contains support for reading and writing AMR-NB and AMR-WB files but
132does not ship with the DLL's that perform decoding and encoding of AMR
133data because of patent restrictions.
134
135AMR-NB/AMR-WB support can be enabled by placing required DLL's
136into the same directory as SOX.EXE. These can be compiled yourself,
137they may turn up on searches of the internet or may be included with other
138MP3 applications already installed on your system. For AMR-NB support,
139try searching for libamrnb-3.dll, libopencore-amrnb-0.dll, or
140libopencore-amrnb.dll. For AMR-WB support, try searching for libamrwb-3.dll,
141libopencore-amrwb-0.dll, or libopencore-amrwb.dll.
142
143Instructions are included here for using MSYS to create the DLL's.
144It is assumed you already have MSYS installed on your system with
145working gcc compiler. These commands are ran from MSYS bash shell.
146
147Obtain the latest amrnb and amrwb source code from
148http://sourceforge.net/projects/opencore-amr .
149
150cd opencore-amr-0.1.2
151./configure --enable-shared --disable-static LDFLAGS="-no-undefined"
152make
153cp amrnb/.libs/libopencore-amrnb-0.dll /path/to/sox
154cp amrwb/.libs/libopencore-amrwb-0.dll /path/to/sox
155
156Appendix - LADSPA Plugins
157-------------------------
158
159SoX has built in support for LADSPA Plugins. These plugins are
160mostly built for Linux but some are available for Windows.
161The Audacity GUI application has a page that points to a collection
162of Windows LADSPA plugins.
163
164http://audacity.sourceforge.net/download/plugins
165
166SoX will search for these plugins based on LADSPA_PATH
167enviornment variable. See sox.txt for further information.
168