Chris@350: 
Chris@1671: To compile Sonic Visualiser from source
Chris@1671: =======================================
Chris@350: 
Chris@1671: Windows
Chris@1671: -------
Chris@350: 
Chris@1671: Use the Qt Creator IDE with either the MinGW compiler (for 32-bit
Chris@1671: builds) or Visual C++ (for 64-bit builds).
Chris@350: 
Chris@1671: For details, see the wiki page at
Chris@1671: 
Chris@1671: https://code.soundsoftware.ac.uk/projects/sonic-visualiser/wiki/WindowsBuild30
Chris@1671: 
Chris@1671: 
Chris@1671: MacOS
Chris@1671: -----
Chris@1671: 
Chris@1671: Build from the command line, but don't use the configure script.
Chris@1671: Instead install Qt v5.x and run the Qt "qmake" command, then "make".
Chris@1671: 
Chris@1671: 
Chris@1671: Linux
Chris@1671: -----
Chris@1671: 
Chris@1671: $ ./configure && make && make install
Chris@1671: 
Chris@1671: The following additional libraries are required or optional:
Chris@350: 
Chris@859: REQUIRED	Qt v5			http://qt-project.org/
Chris@350: REQUIRED	Vamp Plugin SDK	v2.x	http://www.vamp-plugins.org/
Chris@350: REQUIRED	Rubber Band Library	http://www.breakfastquay.com/rubberband/
Chris@350: REQUIRED	libsndfile		http://www.mega-nerd.com/libsndfile/
Chris@350: REQUIRED	libsamplerate		http://www.mega-nerd.com/SRC/
Chris@350: REQUIRED	FFTW3 			http://www.fftw.org/
Chris@350: REQUIRED	bzip2 library		http://www.bzip.org/
Chris@856: REQUIRED	Sord and Serd libraries	http://drobilla.net/software/
Chris@1671: REQUIRED	Cap'n Proto             http://capnproto.org/
Chris@350: 
Chris@350: Optional	MAD mp3 decoder		http://www.underbit.com/products/mad/
mathieu@441: Optional	Oggz and fishsound	http://xiph.org/oggz/
Chris@350: Optional        liblo OSC library	http://www.plugin.org.uk/liblo/
Chris@350: 
Chris@350: Optional	JACK			http://www.jackaudio.org/
Chris@350: Optional	PortAudio v19		http://www.portaudio.com/
Chris@350: Optional	PulseAudio    	 	http://www.pulseaudio.org/
Chris@350: 
Chris@350: Although JACK, PortAudio, and PulseAudio are individually optional,
Chris@1671: you will need to have at least one of them in order to get any audio
Chris@1671: playback.  Usually JACK is preferred on Linux, with PulseAudio as a
Chris@1671: backup, and PortAudio is used elsewhere.
Chris@350: 
Chris@350: On Linux, you will need the ALSA libraries (used for MIDI).
Chris@350: 
Chris@1671: Cap'n Proto is a tricky dependency at the time of writing, as the
Chris@1671: version needed is more recent than the last official release (which is
Chris@1671: 0.5.3 as I write -- hopefully this instruction will rapidly become
Chris@1671: obsolete). You can install a git checkout of Cap'n Proto like this:
Chris@350: 
Chris@1671: $ git clone https://github.com/sandstorm-io/capnproto
Chris@1671: $ cd capnproto/c++
Chris@1671: $ ./setup-autotools.sh && autoreconf -i 
Chris@1671: $ ./configure --enable-static --disable-shared
Chris@1671: $ make && make install
Chris@1671: 
Chris@1671: For the rest, if you happen to be using a Debian-based Linux, you
Chris@1671: probably want to apt install something like the following packages:
Chris@1671: 
Chris@1671: build-essential libbz2-dev libfftw3-dev libfishsound1-dev
Chris@1671: libid3tag0-dev liblo-dev liblrdf0-dev libmad0-dev liboggz2-dev
Chris@1671: libpulse-dev libsamplerate-dev libsndfile-dev libsord-dev
Chris@1671: libxml2-utils portaudio19-dev qt5-default libqt5svg5-dev raptor-utils
Chris@1671: librubberband-dev git mercurial autoconf automake libtool
Chris@1671: