comparison INSTALL @ 2:475f4623feba

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