| 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_PATH=/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. |
| |