Mercurial > hg > sonic-annotator
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 | 
