Installation guide

2009-02-06T19:59:48Z

Danielfernando: /* Troubleshooting */

{{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 ==

Then, to try the software you will need these third party libraries and programs:
{|cellspacing="20px"|
|
* 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:

<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
</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:
<pre>
autoreconf
</pre>

Now you will need to run the configuration script to detect the the libraries and set up the compilation settings.
<pre>
./configure
</pre>

Check that everything has been detected correctly and then compile the program:
<pre>
make
</pre>

At last we must run these commands with superuser privileges to install:
<pre>
make install
ldconfig
</pre>

We can now run the 3D simulator:
<pre>
psynth3d
</pre>

==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.

Installation guide

2009-02-05T13:58:31Z

Danielfernando: /* Troubleshooting */

{{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 ==

Then, to try the software you will need these third party libraries and programs:
{|cellspacing="20px"|
|
* 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:

<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
</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:
<pre>
autoreconf
</pre>

Now you will need to run the configuration script to detect the the libraries and set up the compilation settings.
<pre>
./configure
</pre>

Check that everything has been detected correctly and then compile the program:
<pre>
make
</pre>

At last we must run these commands with superuser privileges to install:
<pre>
make install
ldconfig
</pre>

We can now run the 3D simulator:
<pre>
psynth3d
</pre>

==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, everything works fine

Psychosynth - User contributions [en]

Installation guide

Installation guide