
REQUIREMENTS
=============

You need at least the following packages in order to successfully
compile and run the SoundTracker (included are commands which help you
to find out your installed version, if any):

- gtk+ 1.2.2					gtk-config --version
  (available from http://www.gtk.org/)

- optionally, audiofile library 0.1.5		audiofile-config --version
  (available from http://www.68k.org/~michael/audiofile/)

- optionally, GNOME 1.0.1			gnome-config --version
  (available from http://www.gnome.org/)

- under Linux, glibc 2.1.x is recommended
  (available from ftp://ftp.gnu.org/gnu/glibc/)

Installing GNOME is strongly recommended. Some features are only
available when you compile with GNOME.  You only need the gnome-libs
distribution, it's really not hard to compile yourself.  RedHat 6.0
and other recent distributions also carry a recent GNOME installation.
You do NOT need to run an actual GNOME desktop if you like KDE or
plain X11 better, but having the libraries installed helps.

If you don't have libaudiofile, you will not be able to load or save
samples in the sample editor (loading and saving modules will work,
though).

gtk+-1.2.1 and older versions have a bug which makes the GUI freeze as
soon as you click into the menu bar.

FOR LIBC5 SYSTEMS
==================

This program makes extensive use of threads. This can be troublesome
if you are using a libc5 system. You need thread-safe X libraries in
this case. If SoundTracker keeps crashing as soon as you start it
(with strange X I/O errors), you don't have them.

You can download them from:

ftp://ftp.soundtracker.org/pub/misc/libc5-threadsafe-libX11.tar.gz

Install instructions are in the archive.


COMPILING & INSTALLING
=======================

IF YOU HAVE DOWNLOADED THE SOURCE PACKAGE:
-------------------------------------------

./configure
make

If this gives errors or warnings, please report.

If it worked (which is highly probable on any i386 Linux system which
fulfills the requirements listed above), you can now 'make install' as
root (which also makes the executable setuid root in order to gain
maximum audio performance).

IF YOU HAVE DOWNLOADED THE .tar.gz BINARY PACKAGE:
---------------------------------------------------

Note that this binary is compiled without GNOME and NLS support, and
linked against glibc-2.1 and gtk+-1.2 (it will probably work on
glibc-2.0 systems as well). If you want GNOME or NLS support, compile
the package on your own, or get the RPM package.

1. Copy the soundtracker executable to /usr/local/bin.

2. Optionally:

   chown root.root /usr/local/bin/soundtracker
   chmod 4755 /usr/local/bin/soundtracker

   This will make the audio performance a little bit smoother.

IF YOU HAVE DOWNLOADED THE .rpm BINARY PACKAGE:
------------------------------------------------

Ah, oh. You already have everything in place, or you wouldn't be able
to read this :-)
