Jahsing! 0.93 Java-based MP3 Player/Playlist Editor
Copyright 1998,1999,2000 Duane C. Cato/ Arawak Island Information Systems
This document created: 24 October, 1999
Last modified: 24 October, 1999

-- DISCLAIMER --
This program was written by Duane C. Cato and is Copyright (c) Arawak Island Information Systems (C) 1998. 
It is distributed as ShareWare, which means that the program may be freely used as long as it is not for 
commercial purposes. Should you want to use it for any commercial or profit-generating purpose, I request that 
you contact me at following address for pricing:

Duane C. Cato
Suite 212,
Shop 27, 1 St. Lucia Avenue,
Kingston 10, Jamaica,
West Indies

e-mail: dcato@cwjamaica.com

The latest version should always be at http://www.jidb.com/arawak/jahsing.

SYNOPSIS
JahSing! builds on the framework and capabilties developed in JahSee;  
it is still possible to run it on any Java enabled platform. 
Note that the application makes use of several Sun libraries (Java Foundation Classes (JFC) 
and Java Media FrameWork (JMF) for both the user interface and to provide cross-platform 
high resolution sound capability. These are  provided in the installation zip, so there 
should be no need to get them from the providers (JavaSoft Inc.).

JahSing! is a full-featured, configurable MP3 player/playlister, capable of working on any 
operating system with a Java VM available. In addition to using its own internal MP3 player 
engine, JahSing! also can be configured to use external MP3 players, eg., Winamp, Sonique, 
as well as many of other third party MP3 players.
The latest version can always be found at http://www.jidb.com/arawak/jahsing/jahsingXXX.zip, 
where XXX is the current version number. The current version is 0.93, and can be downloaded 
here. 

Requirements
A System with a Java 1.1 compatible runtime or development environment available. If IE4 is 
installed, this will be acceptable. Other alternatives include the Java SDK from Sun, and 
Java 1.1 SDK/runtimes on other platforms (OS/2, Next etc.). Also, the actual code for the 
application is quite small (274 KB). I have NOT run the application on all platforms, but I 
expect that the Java-based nature of the code will enable JahSing! to run wthout modification 
on many Java 1.1 platforms. So far, JahSing! has been tested successfully on Windows JVM, 
Sun JVM on Windows, and Sun's JVM on Solaris.
In order to fully support all of the features of JahSing! a MP3 player that can perform MP3 
http streaming is advisable. On Windows 95/NT, one popular player is Winamp (www.winamp.com). 
However, in a pinch, the Media player that comes with Windows will work most of the time. Other 
players and MP3 resources can be found at MP3.COM. Note, that the internal MP3 player in JahSing! 
is capable of playing only valid MP3 streams at this time; Shoutcast streams cannot be played 
using the JahSing! MP3 engine - however, we're working on making this a reality in short order!

Installation
To install the application, one need only unzip the installation zip file jahsing093.zip to an 
empty directory on your system. The following files should be placed in the directory:

jahSee.jar
JahSeeIE4.bat 
JahSee.bat 
JahSee.sh 
swingall.jar
jmf.jar

Running JahSing!
To run JahSing!, one can invoke it using the applicable runner for your system. 
For IE4 users, use JahSeeIE4.bat, those using the Java SDK on Windows, 
can use JahSing.bat. Users on Unix systems, and other OS's can modify the JahSing.sh 
shell script for their system. 

Setting up a PLayer
When JahSing is first invoked, it will display an empty playlist. in order to invoke your 
preferred player from the playlist editor, you will need
to configure it to locate your MP3 player. This is done as follows:
1. Click on Edit->Options.
2. When the MP3 Player Locate window comes up, click on Locate. Browse to the MP3 player 
executable. Note, it may be necessary to change the 
file-mask to locate executable files on non-Windows systems.
3. Select the player application, and hit OK.
if you prefer not to use an external player - JahSing will revert to its internal Java 
based MP3 player - perfect for platforms with Java, but no MP3 player!

Adding the MP3's
1. To add MP3's to the playlist, click the [ADD] button, or choose it from the Edit menu.
2. Select the MP3 to be included in the list.

Playing MP3's
1. Highlight the MP3 to be played, then choose Play->Play Selected to play it. Or choose 
Play all to play the entire playlist.
You can also double click on the MP3 to play it.

