mpegjava

mpegjava
mpegjava@joeshmoe.com
a set of java classes for manipulating information about mpeg audio files.

A PRODUCTION OF

what it does:
mpeg-java 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. mpeg-java 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 and 1.1 tags are supported. version 2 tags are not read, but are intelligently skipped over when found.

the license:
this package is copyright (c) 1999-2001 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.
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, creator of winamp
xing technologies
dieter freismuth
tom wadzinski, creator of orca

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 for this package.

download:
current version: 1.1

mpegjava11.jar - the class files for the mpegjava package

mpegjava11-complete.jar - the complete mpegjava package including class
files, source code, and documentation

changelog:

1.1
added support for id3v1.1 (courtesy of tom wadzinski)
added intelligent skipping of id3v2 tags (courtesy of tom wadzinski)
now using the iso 8859-1 character encoding for id3 tags (thanks to dieter freismuth)

1.0
fixed a bug that could cause a nullpointerexception when using an id3tag with null values in it.
bitrates were being incorrectly reported for some files due to an invalid bitmask
fixed filehandle leak in mpegprober

1.0beta
initial relase