view INSTALL @ 41:c145ff12f2d0

Various improvements
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 19 Jun 2003 23:50:00 +0000
parents f6afce365705
children 7047a6390b08
line wrap: on
line source

Requirements
============
- XMMS version 1.2.0 or later (http://www.xmms.org/)

- Gtk+ and Glib 1.2.8 or later (http://www.gtk.org/)

- C and C++-compiler. Preferably gcc and g++, I have
  no idea whether this compiles with any other
  compilers ... sorry.

- You need either one or both of the following:
   * libsidplay1
   * libsidplay2

Only v1 or v2 is required and you can only compile in support
for either one, but not both! See below for more information
about them.


Where to get XMMS?
==================
Latest version of XMMS should be available from

	http://www.xmms.org/

Please refer to XMMS documentation for information
on it's usage and installation (etc).


Where to get libSIDPlay1?
=========================
The library is available at SIDPlay's homepage:

http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/

You only need libsidplay, the sidplay-base is not necessary
if you are sure that you don't need the commandline player.


Where to get libSIDPlay2?
=========================
The library is available at SourceForge:

http://sidplay2.sourceforge.net/

You need the "sidplay-libs-2.1.0" package! Earlier versions
WILL NOT WORK! Later versions MAY work, but it is not really
guaranteed.


Building a CVS-version
======================
To build a CVS-version of XMMS-SID, you need to have latest
(STABLE) versions of following tools installed, including:

 - GNU autoconf 2.56 or later
 - GNU automake 1.7 or later
 - GNU libtool 1.4.3 or later
 - Glade for Gtk+ 1.2 programs (I use Glade 0.6.4)

If you have all required tools installed, just run the
"bootstrap.sh"-script which generates all necessary
build-files. After successfull bootstrapping, you can
continue to install the package normally.


Installing XMMS-SID
===================
When you have the requirements installed and working
succesfully, you can try compiling XMMS-SID.

Invoke configure-script (use parameter --help for help)

$ ./configure

You may need to select which version of libSIDPlay you want to
use by specifying either --with-sidplay1 or --with-sidplay2
options. If none are specified, configure will use the first
one found.

The configure-script will print out lots of information and in
the end it tells you some of the selected build options.

If configure passed without errors, try compilation. (Depending
on your system, you may need to invoke 'gmake' instead of 'make'.)

$ make

If that went OK too, then you may try installation (as root, if
you are installing globally for the system). Again, you may need
to invoke 'gmake' instead of 'make'.

# make install

If everything went as supposed, you may now try (re)starting XMMS
and go play with your shiny new XMMS-SID-plugin! :-)