Installation guide

From Psychosynth

(Difference between revisions)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
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.
+
{{Languages}}
 +
 
 +
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 ==
 
== Dependencies ==
Line 6: Line 8:
 
{|cellspacing="20px"|
 
{|cellspacing="20px"|
 
|
 
|
−
* GNU Autotools (only for the SVN version)
+
* GNU Autotools (only for the development version)
 
* Ogre (needed by the 3D interface)
 
* Ogre (needed by the 3D interface)
 
* CEGUI (needed by the 3D interface)
 
* CEGUI (needed by the 3D interface)
Line 18: Line 20:
 
* libvorbis (needed for OGG vorbis file support)
 
* libvorbis (needed for OGG vorbis file support)
 
* SoundTouch (needed for sample stretching)
 
* SoundTouch (needed for sample stretching)
 +
* Boost
 
|}
 
|}
  
Line 23: Line 26:
  
 
<pre>
 
<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>
 
</pre>
  
 
== Installing ==
 
== 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>
 
<pre>
 
autoreconf
 
autoreconf
Line 53: Line 56:
 
psynth3d
 
psynth3d
 
</pre>
 
</pre>
 +
 +
== 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 ====
 +
 +
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'':
 +
 +
<pre>sed s/soundtouch-1.0/libSoundTouch/ configure > configure</pre>

Latest revision as of 15:40, 5 June 2015

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

[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