p5-MP3-Info/MP3-Info-1.24/Changes

* v1.24 Sat Nov  8 17:05:15 PST 2008
   * RT #13970: get_mp3info goes into infinite loop if no 0xFF byte in file
   * Fix VBR check for files that have Info header.
   * Add VBRI check from KDF.
   * Fix parsing of id3v2 APIC frame when it uses UTF8 encoding
   * Support new WAV id3v2 block type, ID32 - Andy Grundman
   * Handle ULT like USLT

* v1.23 Thu Jul 26 14:11:08 2007

   * Handle all tags with NULL delimited lists - Patch from Justin Fletcher <gerph (at) gerph.org>
   * Fix MP3::Info for tag reading in AIF (and WAV, presumably) - kdf
   * Read RVA2 (signed short) in big-endian order - andyg

* v1.22 Tue Mar 13 16:16:59 2007

   * Backwards compatibility changes for non-SlimServer callers of MP3::Info

* v1.21 Thu Jan  4 13:41:42 PST 2007

   * Use Module::Install
   * Prefer Encode::Detect::Detector over Encode::Detect if available.
   * Skip over Lyrics3 tags
   * Pull out iTunes iTunNORM gain info.
   * Handle Named genres separated by nulls & multiple genres
   * Skip over broken iTunes ID3v2.2 frames that are in a ID3v2.3/2.4 header.
   * Patch from Justin Fletcher <gerph (at) gerph.org> to fix ID3v2.4 header & footer parsing.

* v1.20, Saturday, January 7, 2006

   * New maintainer & Sponsor:

	Dan Sully - daniel | at | electricrain.com
	Slim Devices, Inc - dan | at | slimdevices.com

   * Read ReplayGain Information in:

	- RVA, RVAD and RVA2 tags.
	- COMM tags via J.River Media Center
	- PRIV tags via Windows Media Player

   * Unicode / Encode optimizations to only guess if the string isn't ascii.

   * Proper numeric genre decoding, now in tune with the ID3 spec.

   * Parse and return PIC & APIC data.

   * Handle multiple COMM and TCON tags.

   * Parse APE tags that are in the ID3v1 header space.

   * Parse USLT - Lyrics tags, used by iTunes.

* v1.13, Wednesday, March 10, 2005

   Fix for UTF-16 handling.  (Wes Barris)

* v1.12, Wednesday, March 9, 2005

   Add OFFSET to info.  (Dan Sully)

* v1.11, Friday, January 14, 2005

   Fix for ID3v2 tags that happen to be UTF-16LE.  (Dan Sully)

* v1.10, Thursday, December 30, 2004

   Make utf8 enabled by default (if available).

   perl 5.6 is now required.

   Remove dependency on Symbol.pm.

   Use three-arg open.  (Alex Marandon)

   Make reading of genres a bit more nimble.  (Brian S. Stephan)

   Fix frame counting.  (Ben Winslow, Anthony DiSante)

   Fix syncsafe byte reading.  (Pierre-Yves Thoulon, et al)

   Some Unicode fixes.  (Ilya Konstantinov)

   More changes for Unicode.  Unicode::String no longer used; Encode is used
   instead.  Encode::Guess used as last resort.  (Dan Sully)

   Optimizations and other fixes.  (michael, Dan Sully)

   Support for reading ID3v2 tags from WAV and AIFF files.  Not fully
   supported.  (Dan Sully)

* v1.02, Sunday, March 2, 2003

   Fix broken argument parsing for use_mp3_utf8.  (Ben Gertzfield)

   Document that UTF8 can be access in ":all" export tag.  (Ben Gertzfield)

   Better document for new() method.

   Add can() method.  (Ken Williams)

   Stick failure warnings in $@.  (Jeffrey Friedl)

   Added support for reasonable data from ID3v2 tags with RAW_V2 == 2.
   (brian d foy and others)

   Deal with broken iTunes comment frames in ID3v2.3.0/2.4.0.  (Many users)

   remove_mp3tag() was reporting 128 bytes removed even if no bytes were
   removed.  (scfc_de)

   Allow calling methods on objects where tag does not exist (e.g., don't fail
   if there is no comment but you call $mp3->comment).

   Various bugfixes.


* v1.01, Friday, February 26, 2002

   That was less reasonable than previously thought.  Just strip off text
   encoding bit, and then bytes for language and "up to first null" if COMM
   field (COMM fields can have an extra comment about the comment, which is
   terminated with a NULL, of course ...). Some encoders like to put in an
   extra NULL at the end; plus, it was doing the wrong thing for
   non-Latin-1 text.  (Ben Gertzfield)

   Also make it work better with ID3v2.2 tags, and make a more reasonable
   guess at which comment to use if there's more than one.

   Add some support for ID3v2.4.0 and Unicode strings in tags; see
   use_mp3_utf8.  (Ben Gertzfield)

   Add TAGVERSION to get_mp3tag result.


* v1.00, Tuesday, January 22, 2002

   Get more reasonable data out of ID3v2 tags by stripping up to
   last null in tag.

   Don't get FRAME_LENGTH if no FRAMES (Woodrow Hill).


* v0.91, Saturday, February 10, 2001

   Fix dumb bug with /o.  (David Reuteler)

   Fix bug where get_mp3tag() would return an empty hashref instead of
   undef if ID3v1 tag is asked for, and there is no ID3v1 tag, but there is
   an ID3v2 tag.  (Stuart)


* v0.90, Sunday, January 14, 2001

   Added experimental OOP support for getting and setting data;
   doesn't work for removing tags.

   Made all functions optionally accept filehandle in place of filename.

   Remove all croaks/dies and replace with simple returns or carps/warns.
   (Jeffrey Sumler)

   Fix various input data problems, bad warnings, division by zero, etc.

   Undef $/ in set_mp3tag() so caller can't mess up the print.

   Fix bitrate if ID == 0 and VBR.  (Kyle Farrell, Per Bolmstedt)

   Split off _get_info() from get_mp3info(), so, eventually, programmers
   can access that functionality without passing in a file or filehandle.
   Not supported yet, but available for playing.

   Added total frames, leftover milliseconds, and formatted time.

   Fixed sample frequency for MPEG 2.5 files (perhaps not including
   VBR, though ... see bug above).

   Add in some additional genres.  (Peter Marschall)

   Added ID3v2 tag removal.  (Ronan Waide)  NOTE: this is DANGEROUS.  It is
   tested, but needs more testing.  The file is rewritten entirely.  Lots
   of data moving around.

   Added ID3v2.2.0 tag reading.  (Ronan Waide, Kee Hinckley)

   Changed ID3v2 tag recognition to only match [A-Z0-9] instead of \w.
   (Christoph Oberauer)


* v0.80, Monday, March 6, 2000

   Better stripping of bad data (after nulls) in ID3 tags (Dave O'Neill)

   Fixed VERSION in get_mp3info to properly return 2 when appropriate.
   (Bogdan Surdu)

   Added VBR support.  Average bitrate is returned as BITRATE, and
   minutes and seconds (MM and SS) should be accurate.
   (Andy Waite for pointer to MP3Ext)

   Made time calculation better overall.

   Made MP3 header validation routines more comprehensive.
   (Matthew Sachs for pointer to xmms source)

   Changed name to MP3::Info (with wrapper still named MP3::Info).


* v0.71, Thursday, July 8, 1999

   Several fixes to ID3v2 support unpack unsigned instead
   of signed, don't bail out after 4096-byte offsets on long ID3v2 headers.
   Thanks much to Matthew Sachs.


* v0.70, Saturday, July 3, 1999

   Added preliminary ID3v2 reading support in get_mp3tag().  Thanks much
   to Tom Brown.


* v0.64, Thursday, July 1, 1999

   Found bug in checking TRACKNUM parameter, used \d instead of \d+.
   Only gives spurious warnings, doesn't affect anything else.

   Cleaned up a bit, prepare for impending ID3v2 support.

   NOTE: truncate() broken in some builds of ActivePerl (517, maybe
   others).  No changes to module to fix problem.  (Brian Goodwin)


* v0.63, Friday, April 30, 1999

   Added ID3v1.1 support.  (Trond Michelsen, Pass F. B. Travis)

   Added 255 (\xFF) as default genre.  (Andrew Phillips)

   I think I fixed bug relating to spaces in ID3v2 headers.  (Tom Brown)


* v0.62, Sunday, March 7, 1999

   Doc updates.

   Fix small unnoticable bug where ID3v2 offset is tag size plus 10,
   not just tag size.

   Not publickly released.


* v0.61, Monday, March 1, 1999

   Fixed problem of not removing nulls on return from get_mp3tag() (was
   using spaces for padding before ... now trailing whitespace and
   all nulls are removed before returning tag info).

   Made tests more extensive (more for my own sanity when making all
   these changes than to make sure it works on other platforms and
   machines :).


* v0.60, Sunday, February 28, 1999

   Cleaned up a lot of stuff, added more comments, made get_mp3info()
   much faster and much more reliable, and added recognition of ID3v2
   headers.  (Tom Brown)


* v0.52, Sunday, February 21, 1999

   Fixed problem in get_mp3tag() that changed value of $_ in caller
   (Todd Hanneken).


* v0.51, Saturday, February 20, 1999

   Fixed problem with %winamp_genres having the wrong numbers
   (Matthew Sachs).


* v0.50, Friday, February 19, 1999

   Added remove_mp3tag().  Added VERSION to the hash returned by
   get_mp3info(), and fixed a bug where STEREO was not being set
   correctly.

   Export all genre data structures on request.  Added use_winamp_genres()
   to use WinAmp genres.  (Roland Steinbach)

   Added a $MPEG::MP3Info::try_harder ($MP3::Info::try_harder)
   variable that will try harder to find the MP3 header in a file.  False
   by default. Can take a long time to fail, but should find most headers
   at any offsets if set to true.

   Thanks to Matthew Sachs for his input and fixes, and for mp3tools.


* v0.20, Saturday, October 17, 1998

   Changed name from MPEG::MP3Tag to MPEG::MP3Info, because it does
   more than just TAG stuff now.

   Made header stuff even more reliable.  Lots of help and testing from
   Meng Weng Wong again.  :-)


* v0.13, Thursday, October 8, 1998

   Had some problems with header verification, got some code from Predrag
   Supurovic with his mpgtools. Great stuff.  Also did some looping to find
   a header if it is not in the "right" place.  I did what I think it is a
   smart way to do it, since some files have the header as far down as 2
   kbytes into the file.  First, I look at position 0, then at position 36
   (a position where I have found many headers), then I start at 0 again
   and jump in 128-byte chunks. Once I do that a bunch of times, I go back
   at the beginning and try at 0 and go ahead in 1-byte chunks for a bunch
   more times.

   If you have an MP3 that has the header begin at an odd place like byte
   761, then I suggest you strip out the junk before the header begins. :-)


* v0.12, Friday, October 2, 1998

   Added get_mp3info().  Thanks again to mp3tool source from
   Johann Lindvall, because I basically stole it straight (after
   converting it from C to Perl, of course).

   I did everything I could to find the header info, but if
   anyone has valid MP3 files that are not recognized, or has suggestions
   for improvement of the algorithms, let me know.


* v0.04, Tuesday, September 29, 1998

   Changed a few things, replaced a regex with an unpack().
   (Meng Weng Wong)


* v0.03, Tuesday, September 8, 1998

   First public release.