annotate INSTALL.txt @ 823:f0558e69a074

Rename Resampling- to DecodingWavFileReader, and use it whenever we have an audio file that is not quickly seekable using libsndfile. Avoids very slow performance when analysing ogg files.
author Chris Cannam
date Wed, 17 Jul 2013 15:40:01 +0100
parents c224dfa749a2
children def2db9c4ab0
rev   line source
Chris@647 1
Chris@647 2 To compile from source
Chris@647 3 ----------------------
Chris@647 4
Chris@647 5 This file provides various instructions useful when compiling the SV
Chris@647 6 libraries from source, but it doesn't have a complete recipe for any
Chris@647 7 one platform -- there are too many variables. However, you can find a
Chris@647 8 recipe for one platform (Ubuntu Linux) in the file INSTALL.ubuntu.
Chris@647 9
Chris@647 10 To build, run
Chris@647 11
Chris@647 12 $ ./configure && make
Chris@647 13
Chris@647 14 The following additional libraries are required or optional when
Chris@647 15 building the SV core libraries:
Chris@647 16
Chris@647 17 REQUIRED Qt v4.4 or newer http://qt.nokia.com/
Chris@647 18 REQUIRED Vamp Plugin SDK v2.x http://www.vamp-plugins.org/
Chris@647 19 REQUIRED Rubber Band Library http://www.breakfastquay.com/rubberband/
Chris@647 20 REQUIRED libsndfile http://www.mega-nerd.com/libsndfile/
Chris@647 21 REQUIRED libsamplerate http://www.mega-nerd.com/SRC/
Chris@647 22 REQUIRED FFTW3 http://www.fftw.org/
Chris@647 23 REQUIRED bzip2 library http://www.bzip.org/
Chris@647 24 REQUIRED Redland RDF libraries http://librdf.org/
Chris@647 25
Chris@647 26 Optional MAD mp3 decoder http://www.underbit.com/products/mad/
Chris@647 27 Optional Oggz and fishsound http://www.annodex.net/software/libraries.html
Chris@647 28 Optional liblo OSC library http://www.plugin.org.uk/liblo/
Chris@647 29
Chris@647 30 The Redland RDF libraries include the Raptor RDF parser library,
Chris@647 31 Rasqal RDF query library, and librdf, the Redland RDF datastore (which
Chris@647 32 depends on both of those). The SV libraries require all of these.
Chris@647 33
Chris@647 34 If you are going to build the rest of the SV libraries, you will also
Chris@647 35 need one or more of:
Chris@647 36
Chris@647 37 Optional JACK http://www.jackaudio.org/
Chris@647 38 Optional PortAudio v19 http://www.portaudio.com/
Chris@647 39 Optional PulseAudio http://www.pulseaudio.org/
Chris@647 40
Chris@647 41 Although JACK, PortAudio, and PulseAudio are individually optional,
Chris@647 42 you will need to have one or the other of them in order to get any
Chris@647 43 audio playback. Usually JACK is preferred on Linux, with PulseAudio
Chris@647 44 as a backup, and PortAudio is used elsewhere.
Chris@647 45
Chris@647 46 On Linux, you will need the ALSA libraries (used for MIDI).
Chris@647 47
Chris@647 48 If you happen to be using a Debian-based Linux, you probably want to
Chris@647 49 apt-get install the following packages: libqt4-dev libsndfile1-dev
Chris@647 50 libsamplerate0-dev fftw3-dev libbz2-dev libjack-dev libmad0-dev
Chris@647 51 liboggz1-dev libfishsound1-dev libasound2-dev liblo0-dev liblrdf0-dev
Chris@647 52 librdf0-dev .
Chris@647 53