MPEGJAVA
copyright (c) 1999, 2000 by joeshmoe.com

this version:
-------------
this is version 1.0


what it is:
-----------
mpegjava consists of several class files which allow information to
be gathered about mpeg audio files (mp3, mp2, etc). Some of the
information that can be discerned: bit rate, play time, sample rate,
mpeg version, mpeg layer, and more. mpegjava also allows the viewing
and editing of id3 tags and provides a convenient mechanism for
looking up text values for id3 genres.  mpegjava is not a decoding
engine.  it will not convert your mpeg files to wav and will not let
you play back these files from your sound system.


supported formats:
------------------
mpeg1 and mpeg2. currently, mpeg2.5 is not supported. all three mpeg
audio layers (i, ii, and iii) are supported. both variable bit rate
(vbr) and constant bit rate (cbr) files are supported. id3 version 1
tags are supported. version 2 tags are not. 


the license:
------------
this package is copyright (c) 1999 by joeshmoe.com. it may be freely
used for non-commercial and/or development purposes. commericial use
requires the payment of a nominal license fee. contact
license@joeshmoe.com to purchase a license for commericial use. 


requests, bug reports, and change submission:
--------------------------------------------
it is requested that all users who modify this source code send their
changes to joeshmoe.com. bugs reports and modifications can sent to
bugs@joeshmoe.com.  


thanks to:
----------
the x11amp project
justin frankel, author of winamp
xing technologies 


how to use:
-----------
there are three main classes in this package. mpegprober loads
information about an mpeg audio file. id3tagger reads an id3 tag from
an mpeg file and allows the user to edit an existing id3 tag or append
one. genrelookup performs translation between the genre digit codes
used inside of id3 tags and the actual text name of the genres.

for more information, please see the javadoc in the 'doc' directory.


latest version:
---------------
the latest version of mpegjava is available at
http://www.joeshmoe.com/mpegjava/.

changelog:
----------

--1.0
Fixed a bug that could cause a NullPointerException when using an ID3Tag with
null values in it.


--1.0beta
initial relase
