view README @ 282:d9319859a4cf tip

(none)

Sound Access - Easaier Frontend Client 
======================================

Sound Access is a program for viewing and analysing the contents
of a multimedia archive.

With Sound Access you can:

 * Query a multimedia archive on audio caracteristics (author, 
 title, tonality, audio content...)
 
 * Load and visualize audio files, related metadata and related media
 
 * Add your own annotation metadata to an audio file of the archive 
 and export it in an external file

 * Run feature-extraction plugins to calculate metadata
 automatically, using algorithms such as beat trackers, pitch
 detectors and so on

 * Run realtime audio plugin in cascade for source modification (source 
 segmentation, noise reduction, pitch/scale modification...)

 * Play back the original audio with related metadata and 
 related media, taking care to synchronise playback with the 
 display position

 * Slow down playback and loop segments of interest, including
 seamless looping of complex non-contiguous areas

Sound Access can also be controlled remotely using the Open Sound
Control (OSC) protocol.


To compile from source
----------------------

First, please consider getting one of the ready-to-run binary
distributions available from http://sourceforge.net/projects/easaier/.

The following additional libraries are required or optional when
building Sound Access:

REQUIRED	Vamp Plugin SDK		http://www.sonicvisualiser.org/

REQUIRED	Qt4 Free Edition	http://www.trolltech.com/
REQUIRED	libsndfile		http://www.mega-nerd.com/libsndfile/
REQUIRED	libsamplerate		http://www.mega-nerd.com/SRC/
REQUIRED	FFTW3			http://www.fftw.org/
REQUIRED	bzip2 library		http://www.bzip.org/

Optional	JACK			http://www.jackaudio.org/
Optional	PortAudio v18 or v19	http://www.portaudio.com/
Optional	MAD mp3 decoder		http://www.underbit.com/products/mad/
Optional	Oggz and fishsound	http://www.xiph.org/downloads/
Optional    liblo OSC library	http://www.plugin.org.uk/liblo/

Although JACK and PortAudio are individually optional, you will need
to have one or the other of them in order to get any audio playback.
Usually JACK is preferred on Linux and PortAudio elsewhere.

If you happen to be using a Debian-based Linux, you probably want to
apt-get install the following packages: libqt4-dev libsndfile1-dev
libsamplerate0-dev fftw3-dev libbz2-dev libjack0.100.0-dev libmad0-dev
liboggz1-dev libfishsound1-dev liblo0-dev.

If you are building on a Unix-like system that supports pkg-config and
uses it for all appropriate libraries (such as a modern Linux
distribution) then you should be able to just run "qmake" (being
careful to ensure it is the Qt 4 version of qmake you are running, and
not a Qt 3 version).

If you do not have pkg-config, you should first edit the file sv.prf
and comment out any of the optional HAVE_* lines (in the section
starting "If you don't have pkg-config...") for library dependencies
that you aren't using.  Then run the Qt 4 "qmake" command.  This will
create the proper Makefile.

(If you're on the Mac and you have Qt3 installed as well, you must
export QMAKESPEC=macx-g++ before you do this, or Qt will get confused.)

Then type "make".  The program will then either build, or not build.

Under Windows, the VC project is provided. You can used it to 
compile the sources with Visual Studio 2005 Pro or Visual Studio Express 2005.
Note that in this case Qt must also be compiled with Visual Studio
(http://qtnode.net/wiki/Qt4_with_Visual_Studio).


Qt Library Version Requirements
-------------------------------

Sound Access requires Qt version 4.x.  It can not be built with
Qt 3 or earlier.

You can build Sound Access using Qt 4.0, 4.1, or 4.2, but the
build scripts provided will only work with Qt 4.2 because of an
incompatible change in the Qt build utilities.  Please read
README.Qt41 if you want to build with Qt 4.0 or 4.1.


Credits
-------

Sound Access was developed under the EASAIER project funded by the 
European Commission (EU-FP6-IST-033902).

http://www.easaier.org

Sound Access is based on Sonic Visualizer (http://www.sonicvisualiser.org/)
developped by Chris Cannam, with additional DSP and program
design work by Christian Landone.  Code copyright 2005-2007 Chris
Cannam with parts copyright 2006-2007 Queen Mary, University of
London, except where indicated in the individual source files.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.  See the file COPYING included with
this distribution for more information.


More information
----------------

http://www.easaier.org