Installation guide

Latest revision as of 15:40, 5 June 2015

Languages:

English • Español

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.

[edit] 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

[edit] 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

[edit] Troubleshooting

[edit] 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

[edit] 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/

[edit] 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

@@ Line 8: / Line 8: @@
 {|cellspacing="20px"|
 |
-* GNU Autotools (only for the SVN version)
+* GNU Autotools (only for the development version)
 * Ogre (needed by the 3D interface)
 * CEGUI (needed by the 3D interface)
@@ Line 20: / Line 20: @@
 * libvorbis (needed for OGG vorbis file support)
 * SoundTouch (needed for sample stretching)
+* Boost
 |}
@@ Line 25: / Line 26: @@
 <pre>
-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
+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
 </pre>
-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
-<pre>
-# apt-get install libboost-serialization1.35-dev libboost1.35-dev libsigc++-2.0-dev
-</pre>
-then continue with the following installation (first check that file configure.ac has commented this line: PACKAGE_DATA_DIR="./data")
-<pre># autoreconf</pre>
-<pre># ./configure</pre>
-<pre># make</pre>
-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:
+If you downloaded the program from Git you will first need to generate the compilation scripts:
 <pre>
 autoreconf
@@ Line 72: / Line 57: @@
 </pre>
-==Troubleshooting==
+== 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:
+<pre>deb http://ppa.launchpad.net/andrewfenn/ubuntu hardy main</pre>
+==== On Ubuntu 8.04 I can't find Boost 0.35 ====
-* While installing on Ubuntu the configure script says 'libsoundtouch not found', while I've just installed it!
+You can find proper ''.deb'' packages here:
+https://launchpad.net/ubuntu/intrepid/+source/boost1.35/
-Yes, this is actually a bug. Hope the developers'll fix it soon.
+==== On Ubuntu 8.04 I have properly installed ''libsoundtouch'' but it is not detected ====
-* I was unable to compile the source, some errors associated with 'cstring' library appeared.
+Run this command before executing ''configure'':
-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).
+<pre>sed s/soundtouch-1.0/libSoundTouch/ configure > configure</pre>

Installation guide

Installation guide

From Psychosynth

Latest revision as of 15:40, 5 June 2015

Contents

[edit] Dependencies

[edit] Installing

[edit] Troubleshooting

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

[edit] On Ubuntu 8.04 I can't find Boost 0.35

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