annotate INSTALL @ 49:6c87f6443fe6

* Update copyright date and CHANGELOG
author Chris Cannam
date Tue, 08 Mar 2011 12:45:23 +0000
parents 91d20795a109
children 52d71675a953
rev   line source
Chris@2 1
Chris@2 2 To compile from source
Chris@2 3 ----------------------
Chris@2 4
Chris@2 5 First, please consider getting one of the ready-to-run binary
Chris@2 6 distributions available from http://www.omras2.org/SonicAnnotator .
Chris@2 7
Chris@2 8 The following additional libraries are required or optional when
Chris@2 9 building Sonic Annotator:
Chris@2 10
Chris@2 11 REQUIRED Vamp Plugin SDK http://www.vamp-plugins.org/
Chris@2 12
Chris@2 13 REQUIRED Qt4 Free Edition http://www.trolltech.com/
Chris@2 14 REQUIRED libsndfile http://www.mega-nerd.com/libsndfile/
Chris@2 15 REQUIRED libsamplerate http://www.mega-nerd.com/SRC/
Chris@2 16 REQUIRED FFTW3 http://www.fftw.org/
Chris@2 17 REQUIRED Redland RDF libraries http://librdf.org/
Chris@2 18
Chris@2 19 Optional MAD mp3 decoder http://www.underbit.com/products/mad/
Chris@2 20 Optional Oggz and fishsound http://www.annodex.net/software/libraries.html
Chris@2 21
Chris@2 22 The Redland RDF libraries include the Raptor RDF parser library,
Chris@2 23 Rasqal RDF query library, and librdf, the Redland RDF datastore (which
Chris@2 24 depends on both of those). Sonic Annotator uses Rasqal and Redland
Chris@2 25 directly, and so indirectly also requires Raptor. For best
Chris@2 26 performance it's strongly recommended that you build with Redland
Chris@2 27 1.0.8 or newer.
Chris@2 28
Chris@2 29 If you happen to be using a Debian-based Linux, you probably want to
Chris@24 30 apt-get install the following packages: libqt4-dev libsndfile1-dev \
Chris@24 31 libsamplerate0-dev fftw3-dev libmad0-dev liboggz1-dev \
Chris@24 32 libfishsound1-dev liblrdf0-dev librdf0-dev libbz2-dev libasound2-dev .
Chris@2 33
Chris@2 34 If you are building on a Unix-like system that supports pkg-config and
Chris@2 35 uses it for all appropriate libraries (such as a modern Linux
Chris@2 36 distribution) then you should be able to just run "qmake" (being
Chris@2 37 careful to ensure it is the Qt 4 version of qmake you are running, and
Chris@2 38 not a Qt 3 version).
Chris@2 39
Chris@2 40 If you do not have pkg-config, you should first edit the file sv.prf
Chris@2 41 and comment out any of the optional HAVE_* lines (in the section
Chris@2 42 starting "If you don't have pkg-config...") for library dependencies
Chris@2 43 that you aren't using. Then run the Qt 4 "qmake" command. This will
Chris@2 44 create the proper Makefile.
Chris@2 45
Chris@2 46 (If you're on the Mac and you have Qt3 installed as well, you must
Chris@2 47 export QMAKESPEC=macx-g++ before you do this, or Qt will get confused.)
Chris@2 48
Chris@2 49 Then type "make". The program will then either build, or not build.
Chris@47 50 If it builds, the result will be a binary file in sonic-annotator (on
Chris@47 51 Linux) or release/Sonic Annotator.exe (on Win32), or a bundle in
Chris@47 52 sonic-annotator.app. There should be nothing to install apart from
Chris@47 53 the executable itself and any of the above listed third-party shared
Chris@47 54 libraries that are not already installed.
Chris@2 55
Chris@2 56
Chris@2 57 Qt Library Version Requirements
Chris@2 58 -------------------------------
Chris@2 59
Chris@2 60 Sonic Annotator requires Qt version 4.3 or newer. It can not be
Chris@2 61 built with Qt3 or with Qt 4.0.x, 4.1.x, or 4.2.x.
Chris@2 62
Chris@2 63