==============
IMP3SH INSTALL
==============

As of 0.2.1, I have not built imp3sh on anything other than Linux... It might
compile on other Unix variants (or cygwin), but the included Xaudio binary
will most likely have to be changed or replaced altogether.

-----------------
Table O' Contents
-----------------

1) Requirements
2) Building
3) Using imp3sh

   ------------
1) Requirements
   ------------

You will need the following components to build imp3sh:

	-Linux and GNU gcc, of course

	-ncurses library 
	      I just use this to access the terminfo database.
	      You should have it, but if you don't try getting it here: 

	      http://linuxberg.surfnet.nl/files/console/dev/ncurses-5.2.tar.gz

	-For Ogg/Vorbis support, you must have the following libraries 
	 installed:

	 'libao', 'libogg', and 'libvorbis'

	These libraries are available for download in rpm and tarfile 
	formats at http://www.vorbis.com/download_unix.psp

   --------
2) Building
   --------

Copy the source file to a directory and untar it:

     tar xfvz imp3sh.X.X.X.tar.gz

Enter the newly created directory:

     cd imp3sh.X.X.X/

Configure the makefiles:

     ./configure

If no errors were reported:

     make

To install, become root and:

     make install

If you have any problems building imp3sh, please email me at:

     kman_can@yahoo.com


   ------------
3) Using imp3sh
   ------------

There are three README files included to help you get comfortable with imp3sh.
For best results, you should read them in this order:

  'README'            : covers basic topics

  'README.playlists'  : explains how to setup playlists/queues and your
                        resource file.

  'README.advanced'   : covers some advanced features of imp3sh
