WS Tools 0.4.8
==============

The programs are written in C++, I believe this gives many advantages over C
although it is more difficult to work with initially. If anyone wants to add
something and they know how to write in C, write it in C and I'll convert
and integrate it into the C++. Obviously wou will need a working C++
compiler, you will also need the pthreads library which is usually included
with libc these days.

You will need the FFTW FFT library. This is downloadable from
http://www.fftw.org. On my system I build FFTW as a shared library, the
default is not to build it shared, it doesn't really make any difference to
the performance of WS Tools but it does save some disk space. To build FFTW
for a non shared library use the instructions given in the FFTW INSTALL
file. If you want to build a shared library then use the command
"./configure --enable-shared" instead of "./configure", once you have typed
"make install" as root, then type "ldconfig" as root to update the shared
library cache.

Please note that FFTW is available as either a 2.x.y release and a 3.x.y
release. From WS Tools 0.4.8 either version can be used, however a choice
has to be made in the top level Makefile as to which one to use, the default
is FFTW 3.x.y.

You will need the libsndfile library
http://www.zip.com.au/~erikd/libsndfile/ which handles the WAV files.

You will need the wxWidgets library. This is available from
http://www.wxwidgets.org, I am using the 2.4.1 release, the system will not
compile with the 2.2.9 release. WS Tools should be OK for any combination of
the wxWidgets flags, it works with GTK+ 1 and GTK+ 2, and in Unicode (GTK+ 2
only). I personally use wxGTK-2.4.2 and GTK1. I suggest you build the
libraries yourself as you need debugging enabled.

The command I use to build wxGTK is:

./configure --enable-gui --with-gtk --enable-debug_flag
make

then logon as root and:

make install
ldconfig

then return to your normal userid.

Follow the instructions for each library and remember that each library
requires not only to be built, but also to be installed. This usually
involves performing the steps above that require root priveliges.

So that it builds a library using GTK1 for the GUI.

Once you have all the reuired libraries installed, check the Makefile in the
top level directory and change the installation directory if you want. By
default it is set to /usr/local/bin.

Once you are happy with that setting then build WS Tools by typing "make".

After a while the process will end and you should be left with two
executables in the top level directory, named JT44 and FSK441.

To install them in their final locations login as root and then type:

make install

Thats all there is to it. Run the programs by typing JT44 or FSK441 as
appropriate.

Share and Enjoy