lbajardsilogic@0: lbajardsilogic@0: Sonic Visualiser lbajardsilogic@0: ================ lbajardsilogic@0: lbajardsilogic@0: Sonic Visualiser is a program for viewing and analysing the contents lbajardsilogic@0: of music audio files. lbajardsilogic@0: lbajardsilogic@0: With Sonic Visualiser you can: lbajardsilogic@0: lbajardsilogic@0: * Load audio files in various formats and view their waveforms lbajardsilogic@0: lbajardsilogic@0: * Look at audio visualisations such as spectrogram views, with lbajardsilogic@0: interactive adjustment of display parameters lbajardsilogic@0: lbajardsilogic@0: * Annotate audio data by adding labelled time points and defining lbajardsilogic@0: segments, point values and curves lbajardsilogic@0: lbajardsilogic@0: * Run feature-extraction plugins to calculate annotations lbajardsilogic@0: automatically, using algorithms such as beat trackers, pitch lbajardsilogic@0: detectors and so on lbajardsilogic@0: lbajardsilogic@0: * Import annotation data from various text formats and MIDI files lbajardsilogic@0: lbajardsilogic@0: * Play back the original audio with synthesised annotations, taking lbajardsilogic@0: care to synchronise playback with the display position lbajardsilogic@0: lbajardsilogic@0: * Slow down and speed up playback and loop segments of interest, lbajardsilogic@0: including seamless looping of complex non-contiguous areas lbajardsilogic@0: lbajardsilogic@0: * Export annotations and audio selections to external files. lbajardsilogic@0: lbajardsilogic@0: Sonic Visualiser can also be controlled remotely using the Open Sound lbajardsilogic@0: Control (OSC) protocol. lbajardsilogic@0: lbajardsilogic@0: lbajardsilogic@0: To compile from source lbajardsilogic@0: ---------------------- lbajardsilogic@0: lbajardsilogic@0: First, please consider getting one of the ready-to-run binary lbajardsilogic@0: distributions available from http://www.sonicvisualiser.org/ . lbajardsilogic@0: lbajardsilogic@0: The following additional libraries are required or optional when lbajardsilogic@0: building Sonic Visualiser: lbajardsilogic@0: lbajardsilogic@0: REQUIRED Vamp Plugin SDK http://www.sonicvisualiser.org/ lbajardsilogic@0: lbajardsilogic@0: REQUIRED Qt4 Free Edition http://www.trolltech.com/ lbajardsilogic@0: REQUIRED libsndfile http://www.mega-nerd.com/libsndfile/ lbajardsilogic@0: REQUIRED libsamplerate http://www.mega-nerd.com/SRC/ lbajardsilogic@0: REQUIRED FFTW3 http://www.fftw.org/ lbajardsilogic@0: REQUIRED bzip2 library http://www.bzip.org/ lbajardsilogic@0: lbajardsilogic@0: Optional JACK http://www.jackaudio.org/ lbajardsilogic@0: Optional PortAudio v18 or v19 http://www.portaudio.com/ lbajardsilogic@0: Optional MAD mp3 decoder http://www.underbit.com/products/mad/ lbajardsilogic@0: Optional Oggz and fishsound http://www.annodex.net/software/libraries.html lbajardsilogic@0: Optional liblo OSC library http://www.plugin.org.uk/liblo/ lbajardsilogic@0: lbajardsilogic@0: Although JACK and PortAudio are individually optional, you will need lbajardsilogic@0: to have one or the other of them in order to get any audio playback. lbajardsilogic@0: Usually JACK is preferred on Linux and PortAudio elsewhere. lbajardsilogic@0: lbajardsilogic@0: If you happen to be using a Debian-based Linux, you probably want to lbajardsilogic@0: apt-get install the following packages: libqt4-dev libsndfile1-dev lbajardsilogic@0: libsamplerate0-dev fftw3-dev libbz2-dev libjack0.100.0-dev libmad0-dev lbajardsilogic@0: liboggz1-dev libfishsound1-dev liblo0-dev. lbajardsilogic@0: lbajardsilogic@0: If you are building on a Unix-like system that supports pkg-config and lbajardsilogic@0: uses it for all appropriate libraries (such as a modern Linux lbajardsilogic@0: distribution) then you should be able to just run "qmake" (being lbajardsilogic@0: careful to ensure it is the Qt 4 version of qmake you are running, and lbajardsilogic@0: not a Qt 3 version). lbajardsilogic@0: lbajardsilogic@0: If you do not have pkg-config, you should first edit the file sv.prf lbajardsilogic@0: and comment out any of the optional HAVE_* lines (in the section lbajardsilogic@0: starting "If you don't have pkg-config...") for library dependencies lbajardsilogic@0: that you aren't using. Then run the Qt 4 "qmake" command. This will lbajardsilogic@0: create the proper Makefile. lbajardsilogic@0: lbajardsilogic@0: (If you're on the Mac and you have Qt3 installed as well, you must lbajardsilogic@0: export QMAKESPEC=macx-g++ before you do this, or Qt will get confused.) lbajardsilogic@0: lbajardsilogic@0: Then type "make". The program will then either build, or not build. lbajardsilogic@0: lbajardsilogic@0: lbajardsilogic@0: Qt Library Version Requirements lbajardsilogic@0: ------------------------------- lbajardsilogic@0: lbajardsilogic@0: Sonic Visualiser requires Qt version 4.x. It can not be built with lbajardsilogic@0: Qt 3 or earlier. lbajardsilogic@0: lbajardsilogic@0: You can build Sonic Visualiser using Qt 4.0, 4.1, or 4.2, but the lbajardsilogic@0: build scripts provided will only work with Qt 4.2 because of an lbajardsilogic@0: incompatible change in the Qt build utilities. Please read lbajardsilogic@0: README.Qt41 if you want to build with Qt 4.0 or 4.1. lbajardsilogic@0: lbajardsilogic@0: lbajardsilogic@0: Credits lbajardsilogic@0: ------- lbajardsilogic@0: lbajardsilogic@0: Sonic Visualiser was developed at the Centre for Digital Music, lbajardsilogic@0: Queen Mary, University of London. lbajardsilogic@0: lbajardsilogic@0: http://www.elec.qmul.ac.uk/digitalmusic/ lbajardsilogic@0: lbajardsilogic@0: The main program is by Chris Cannam, with additional DSP and program lbajardsilogic@0: design work by Christian Landone. Code copyright 2005-2007 Chris lbajardsilogic@0: Cannam with parts copyright 2006-2007 Queen Mary, University of lbajardsilogic@0: London, except where indicated in the individual source files. lbajardsilogic@0: lbajardsilogic@0: This project was partially funded by the European Commission through lbajardsilogic@0: the SIMAC project IST-FP6-507142 and the EASAIER project IST-FP6-033902. lbajardsilogic@0: lbajardsilogic@0: This program is free software; you can redistribute it and/or modify lbajardsilogic@0: it under the terms of the GNU General Public License as published by lbajardsilogic@0: the Free Software Foundation; either version 2 of the License, or (at lbajardsilogic@0: your option) any later version. See the file COPYING included with lbajardsilogic@0: this distribution for more information. lbajardsilogic@0: lbajardsilogic@0: lbajardsilogic@0: More information lbajardsilogic@0: ---------------- lbajardsilogic@0: lbajardsilogic@0: http://www.sonicvisualiser.org/ lbajardsilogic@0: