jd3Lib - Java ID3/MP3 Library

File Release Notes and Changelog

Release Name: jd3lib-a4

Notes:
-----------------------------------------------------------------------
jd3Lib - fourth release alpha4
-----------------------------------------------------------------------

After a long time here is finaly a lifesign of the jd3lib. Jonatahn stopped the development of the library because he had no time any more to work on it. So i took over and to development continues. This release is a small Bugfix release which contains all the work which was done after the alpha3 and there was quite a lot. The biggest improvements where made in the MPEGAudioFrameHeader class which should work with a lot more MP3 files than the alpha3 did. The next release will be a complete Bugfix release. After the currently known bugs will 
be fixed the development will go on. New Features will be implemented after that please use the offical project Homepage 
http://sourceforge.net/projects/jd3lib/
to file feature requests and bug  reports we need you all as our testers. One last word to the Jakarta Ant build.xml which was introduced in the last release. We made a step backwards and use only the standard java tools again. We do that to ensure that everybody can easily build the library.

Changes:
-just bugfixes and cleanup of sourcecode
-fixed Bug #562622 in the MP3FileFilter should work with any .mp3 Files now
-made improvements to the MPEGAudioFrameHeader Class so that it now accepts most MPEG-Audio files

* Check out changes.txt for full list of changes

Instructions:
Just compile everything in the helliker/id3 directory. You may use the 
"make.helliker.id3.sh.or.bat" script to compile.
In win32 enviroments just starting the batch file would be enough. In Unix 
envirmoments you might have to change the
Right to executable, but then be able to run the script as shell script. 
Documentation is in the javadoc directory.
The MP3File class is the starting point.

Next Up:
-bug fixing
-redesign of the class structure

Future:
-support all versions of id3v2
-copy data between tags of different versions
-beta version perhaps?

Thanks go out to the following people for code snippets and other help:
Jonathan Hilliker,Reed Esau, Ralph Zazula, David Barron, Philip Gladstone,Tech'

Here are some projects using my library:(from alpha3 not up to date)
HTML Directory List Generator (http://hdlg.martinlabelle.com)
jMagePlayer (http://jmageplayer.magenet.com)
jReceiver (http://jreceiver.sourceforge.net)

* Let me know about your project, I am interested!

Contact Info:
gruni@users.sourceforge.net
http://sourceforge.net/projects/jd3lib
-----------------------------------------------------------------------
(c) 2002 Andreas Grunewald

Changes:
Release a4:
-no new Features because of new developers. The sourcecode was cleaned up and the Javadoc a bit more extended.
-fixed Bug #562622 in the MP3FileFilter should work with any .mp3 Files now
-made improvements to the MPEGAudioFrameHeader Class so that it now accepts most MPEG-Audio files

Release a3:
-successfully parses MP3ext padding
-removed size check that causes many people headaches
-fixed MP3File.equals method
-doesn't break when the 1st mpeg frame is corrupt
-ignores bad frame sizes when parsing
-removed unnecessary encoding which was giving someone exceptions
-supports VBR files (calculates correct playing time and avg bitrate)
-Playlist class supports MusicMatch playlists
-Playlist class optimized in various ways
-MP3Comparator class optimized slightly
-created ID3Tag interface that will be of much use in later versions
-ID3v1Tag and ID3v2Tag adhere to ID3Tag interface
-added additional functionality to MPEGAudioFrameHeader
-added functionality for parsing "x/y" type track fields in id3v2 tags
-various other optimizations scattered about

Release a2:
-fixed a major bug with id3v2 tags that caused many problems
 (I wasn't decoding/encoding the header size as a synchsafe int)
-fixed about a dozen file handle leaks
-mpeg frames are searched from beginning of file instead of after
 id3v2 tag
-padding size calculation now accurate
-id3v2 writing and removing much more stable
-added several Nullsoft genres I missed
-fixed ArrayIndexOutOfBoundsException problem encountered
 sometimes while writing id3v2 tags

Release a1:
-Reads, creates, updates, and removes id3v2.3 and id3v2.4 tags
-Reads, creates, updates, and removes id3v1 tags
-Extracts MPEG data such as bit rate, sample rate, channel mode, etc.
-Calculates playing time of mp3 from mpeg information (no good w/VBR)
-Can read and create Winamp styled playlists
-Offers other utility classes such as MP3FileFilter and MP3Comparator
-NullsoftID3GenreTable object keeps a list of genres for you and can
 automatically determine the id3v1 genre from an id3v2 string or the
 other way around