ref: a2236768b3430b83754d178eca0646b11edc2fe8
dir: /INSTALL/
Install Instructions for libsamplerate
======================================
The following instructions explain how to install libsamplerate under
Linux and other Unix like systems including Mac OSX. (For windows,
see http://www.mega-nerd.com/SRC/win32.html).
Preliminaries
-------------
1) Included with libsamplerate is a command line program named
sndfile-resample which uses libnsdile:
http://www.mega-nerd.com/libsndfile/
for file I/O. If you want to use sndfile-resample you need to
ensure that libsndfile is correctly installed first. If it is, the
command "pkg-config --cflags --libs sndfile" should print out
something like this:
-lsndfile
If pkg-config doesn't exist you will need need to install it. If
pkg-config cannot find libsndfile you may need install it. If you
install from from a Linux distribution package, make sure you also
install the libsndfile-devel package which contains the header files.
If libsndfile is installed, you may need to set the PKG_CONFIG_PATH
environment variable. If libsndfile is installed in /usr/local/lib,
you will need to set PKG_CONFIG_PATH using:
export PKG_CONFIG=/usr/local/lib/pkgconfig
Pkg-config should now work. If it doesn't you need to fix it if you
want to use sndfile-resample.
2) The included tests suite for libsamplerate needs libfftw3 which is
available here:
http://www.fftw.org/
If FFTW3 is not available, libsamplerate should still compile and
install without problems but the test suite will not be as
comprehensive as it normally is.
Building
--------
Building and verifying libsamplerate is a four or five step process.
1) The first step is to run configure
./configure
which should print out something like the following:
checking build system type...
...
...
-=-=-=-=-=-=-=-=-= Configuration Complete =-=-=-=-=-=-=-=-=-=-
Configuration summary :
Version : ..................... X.Y.Z
Enable debugging : ............ no
Tools :
Compiler is GCC : ............. yes
GCC major version : ........... 3
Extra tools required for testing and examples :
Use FFTW : .................... yes
Have libsndfile : ............. yes
Installation directories :
Library directory : ........... /usr/local/lib
Program directory : ........... /usr/local/bin
Pkgconfig directory : ......... /usr/local/lib/pkgconfig
Compiling some other packages against libsamplerate may require
the addition of "/usr/local/lib/pkgconfig" to the
PKG_CONFIG_PATH environment variable.
There are a number of configure options. See the output of
configure when run with the --help command line option.
2) If all goes well with the above then compiling the library can be
done with
make
3) When that has finished, the test suite can be run using:
make check
4) The final step is to install the library. This step needs to be
carried out as the root user (or with sudo):
make install
This command will by default install the library in the directory
/usr/local/lib. It can in installed in other location by using the
--prefix option in step 1).
5) On linux, one more step is required, the registering of the library
with the system. This is done by running the following command
(also as the root user):
ldconfig -v
As a final test, you can run
sndfile-resample
to make sure everything is installed correctly.