Installation guide

From Psychosynth

Revision as of 19:59, 6 February 2009 by Danielfernando (Talk | contribs)

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.

Dependencies

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

  • GNU Autotools (only for the SVN 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)

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 libois-dev libcegui-mk2-dev libasound2-dev libjack-dev liblo0-dev libsndfile-dev libxml2-dev libsoundtouch1-dev libvorbis-dev

When installing using bzr files previous you have to install some dependencies before (tested on lenny), use dpkg -l |grep libboost to check that previous version is not installed, if is installed remove all packets that shows the output of dpkg -l |grep liboost

# apt-get install libboost-serialization1.35-dev libboost1.35-dev libsigc++-2.0-dev

then continue with the following installation (first check that file configure.ac has commented this line: PACKAGE_DATA_DIR="./data")

# autoreconf
# ./configure
# make

and then run the program simply typing psynth3d, if the program gives you the output: [/alsa] WARNING: Could not write to device. (Broken pipe) change the audio to oss in config menu.

Installing

If you downloaded the program from Bazaar 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

  • While installing on Ubuntu the configure script says 'libsoundtouch not found', while I've just installed it!

Yes, this is actually a bug in 0.1-1. The problem is that the configure script have some trouble finding right package on Ubuntu (seems it's only Ubuntu problem). It should be fixed in next release.


  • I was unable to compile the source, some errors associated with 'cstring' library appeared.

It's just because you've got too new gcc. The source was prepared for older compiler. There are two ways of solving this issue: a) you can backport the compiler (I don't recommend this) or b) you can wait for new source code that'll work with the newest gcc (although this solution may require patience, as psychosynt is not very often updated). It also should be fixed in next release.

    • The above mentioned errors happens in Ubuntu 8.10. Using Ubuntu 8.04, the compilation runs ok but when executed, the software crashes the system.