Installation guide

From Psychosynth

First of all you must get a copy of the sources of this program. Go to the download section if you do not have them yet. Note that this document is only to install from the sources -if there is a binary package for your distribution, use that instead.

Contents

Dependencies

Then, to try the software you will need these third party libraries and programs:

  • GNU Autotools (only for the development version)
  • Ogre (needed by the 3D interface)
  • CEGUI (needed by the 3D interface)
  • OIS (needed by the 3D interface)
  • liblo (needed for the network support)
  • libxml2 (needed for XML config support)
  • Alsa (needed for ALSA sound output)
  • Jack (needed for Jack sound ouput)
  • libsndfile (needed for pcm file support)
  • libvorbis (needed for OGG vorbis file support)
  • SoundTouch (needed for sample stretching)
  • Boost

In Debian and Ubuntu you can install all those dependencies with the following command. Anyways, I suggest installing liblo from the original sources because the version in the repositories is outdated and contains a bug:

apt-get install automake libtool libogre-dev libceguiogre-dev libois-dev libcegui-mk2-dev libasound2-dev libjack-dev liblo0-dev libsndfile-dev libxml2-dev libsoundtouch1-dev libvorbis-dev libboost-serialization1.35-dev libboost1.35-dev libsigc++-2.0-dev

Installing

If you downloaded the program from Git you will first need to generate the compilation scripts:

autoreconf

Now you will need to run the configuration script to detect the the libraries and set up the compilation settings.

./configure

Check that everything has been detected correctly and then compile the program:

make

At last we must run these commands with superuser privileges to install:

make install
ldconfig

We can now run the 3D simulator:

psynth3d

Troubleshooting

On Ubuntu 8.10 or Debian Sid I get a linkage problem related to CEGUI::Exception

You must add this repository to your sources.list and update Ogre and Cegui to their latest versions:

deb http://ppa.launchpad.net/andrewfenn/ubuntu hardy main

On Ubuntu 8.04 I can't find Boost 0.35

You can find proper .deb packages here: https://launchpad.net/ubuntu/intrepid/+source/boost1.35/

On Ubuntu 8.04 I have properly installed libsoundtouch but it is not detected

Run this command before executing configure:

sed s/soundtouch-1.0/libSoundTouch/ configure > configure