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

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

1) Requirements
2) Building
3) Using imp3sh

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

You will need the following components to build imp3sh:

	-Linux (2.2 or 2.4 kernel) and gcc

	-ncurses library 
	      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
	If you install these libs via RPM, you will also need to install
	the corresponding 'devel' RPMs.

As of 0.2.3, 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 have to be replaced. 

To get a different Xaudio binary, visit http://www.xaudio.com. There are ports
to Win32, MaxOS, QNX, Solaris, and a host of others.

imp3sh is a command interpreter, and should work well with most terminal 
emulators. Here is a list of terminal emulators that have been tested so far:

  linux-tty, xterm, rxvt, Gnome terminal, Eterm (Enlightenment), kterm (KDE)

  Note: on at least one terminal (i.e., kterm), the HOME and END keys do not
	work properly. This seems to stem from improperly formed terminfo 
	entries.

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