--- /dev/null
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org> //
+// available at http://getid3.sourceforge.net //
+// or http://www.getid3.org //
+// also https://github.com/JamesHeinrich/getID3 //
+/////////////////////////////////////////////////////////////////
+// //
+// changelog.txt - part of getID3() //
+// See readme.txt for more details //
+// ///
+/////////////////////////////////////////////////////////////////
+
+ » denotes a major feature addition/change
+ ¤ denotes a change in the returned structure
+ ! denotes a cry for help from developers
+* Bugfix: denotes a fixed bug
+
+Version History
+===============
+
+1.9.14: [2017-03-27] James Heinrich
+ » Add experimental support for E-AC3
+ * bugfix (G:105): RIFF.WAVE.iXML multiple TIMESTAMP_SAMPLE_RATE
+ * bugfix (G:95): improperly initialized error/warning keys
+ * bugfix (G:94): ID3v2 write support for TXXX
+ * bugfix (G:93): all errors or warnings should pass through class method
+
+1.9.13: [2016-12-14] James Heinrich
+ * bugfix (G:89): ID3v2.4 custom genres with slashes
+ * bugfix (G:88): large QuickTime files exceed PHP memory limit
+ * bugfix (G:87): ID3v2 write GRID data not working properly
+ * bugfix (G:86): Increase autoloading definitions
+ * bugfix (G:84): ID3v2 available writable frames list
+ * bugfix (G:82): ID3v2 datetime logic
+ * bugfix (G:80): attempt to autodetect ID3v1 encoding
+ * bugfix (G:77): add partial support of DSSv6
+ * bugfix (G:76): add mysqli version of caching extension
+ * bugfix (G:75): mysql cache max key length
+ * bugfix (G:71): custom error handler to catch exif_read_data() errors
+ * bugfix (G:71): add support for mb_convert_encoding
+ * bugfix (G:70): ID3v2 POPM / UFID
+ * bugfix (G:68): workaround broken iTunes ID3v2
+ * bugfix (G:48): Quicktime set MIME to video/mp4 where applicable
+ * bugfix (#1930) fread on pipes
+ * bugfix (#1926) relax ID3v2.IsValidURL check
+
+1.9.12: [2016-03-02] James Heinrich
+ » Add support for Direct Stream Digital (DSD) /
+ DSD Storage Facility (DSF) file format
+ » Add detection (not parsing) of WebP image format
+ * bugfix (#1910): Quicktime embedded images
+
+1.9.11: [2015-12-24] James Heinrich
+ * bugfix (G:64): update constructor syntax for PHP 7
+ * bugfix (G:62): infinite loop in large PNG files
+ * bugfix (G:61): ID3v2 remove BOM from frame descriptions
+ * bugfix (G:60): missing "break" in module.audio-video.quicktime.php
+ * bugfix (G:59): .gitignore comments
+ * bugfix (G:58): inconsistency in relation to module.tag.id3v2.php
+ * bugfix (G:57): comparing instead of assign
+ * bugfix (G:56): unsupported MIME type "audio/x-wave"
+ * bugfix (G:55): readme.md variable reference
+ * bugfix (G:54): QuickTime false 1000fps
+ * bugfix (G:53): Quicktime / ID3v2 multiple genres
+ * bugfix (G:52): sys_get_temp_dir in GetDataImageSize
+ * bugfix (#1903): Quicktime meta atom not parsed
+ * demo.joinmp3.php enhancements
+ * m4b (audiobook) chapters not parsed correctly
+ * sqlite3 caching not working
+
+1.9.10: [2015-09-14] James Heinrich
+ * bugfix (G:49): Declaration of getID3_cached_sqlite3
+ * bugfix (#1892): extension.cache.mysql
+ * bugfix (#1891): duplicate default clause [Quicktime]
+ * bugfix (G:41): incorrect MP3 playtime
+ * bugfix: iconv problems on musl with //TRANSLIT
+ * Add arguments to analyze() for original filesize (and filename)
+ * ID3v2 simplify handling of multiple genres
+ * Corrected merging of multiple genres for ID3v2
+ * getid3_lib::GetDataImageSize return false on error
+
+1.9.9: [2014-12-18] James Heinrich
+ » Added basic support for OggOpus
+ » Add ID3v2 CHAP + CTOC support
+ * Add composer autoloader
+ * bugfix: removed non-printable ASCII in comment
+ * bugfix: possible memory leak in OggFLAC
+ * bugfix: sys_get_temp_dir undefined before PHP 5.2.1
+ * bugfix: improved fix for XXE security issue (CVE-2014-2053)
+ (thanks nacinØwordpress*org)
+ * bugfix: G:25 ID3v2 LINK utf8_encode not defined
+ * bugfix: G:22 ID3v2 TXXX description encoding
+ * bugfix: #1855 - copy image height/width/etc to comments
+ * bugfix: #1855 - PHP errors in badly written APE/ID3v2 tags
+ * bugfix: #1845 - Quicktime parsing with no PHP memory_limit
+ * bugfix: #1828 - ID3v2 writing unknown frame names
+
+1.9.8: [2014-05-11] James Heinrich
+ » Add support for AMR (Adaptive Multi-Rate audio codec)
+ new file: module.audio.amr.php
+ » Added composer.json, registered on packagist.org
+ * Added workaround for PHP Bug #39923 (undefined constant IMG_JPG)
+ * Bugfix: (#1813) avoid running out of memory when parsing large
+ Quicktime files
+ * Bugfix: (#1812) potential unwanted high-ASCII characters in errors
+ * Bugfix: close potential XXE security issue (CVE-2014-2053)
+ * Bugfix: (G:10) Avoid warnings from realpath() if SAFE MODE is enabled
+ * Bugfix: (G:12) If [tags] data contains an array of strings then html
+ encoding did not take place.
+ * Bugfix: (G:12) IPTC character set not specified
+ * Bugfix: possible divide by zero error in FLV module
+ * Bugfix: possible undefined key in ID3v2
+ * Bugfix: possible undefined key in MPEG video files
+ * Bugfix: demo.browse to use character set consistently
+
+1.9.7: [2013-07-05] James Heinrich
+ * Bugfix: [module.audio-video.quicktime.php] track languages set
+ with 15-bit-encoded ISO639-2 language codes not parsed correctly
+ * Bugfix: (#1717) QuickTime atom hierarchy broken
+ * Bugfix: (#1716) truncate MIDI file could cause infinite loop
+ * Bugfix: all source files converted to UTF-8
+
+1.9.6: [2013-06-03] James Heinrich
+ » getID3() is now licensed under GPL / LGPL / MozillaPL / gCL
+ See license.txt for more details.
+ * Bugfix: (#1550) Quicktime video track sample description parsed
+ incorrectly
+ * Bugfix: (#1550) Quicktime matrix U/V/W values calculated incorrectly
+ * [demo.browse] disable edit-tag and delete-file links by default
+ * Bugfix: option_max_2gb_check should issue warning not error on >2GB
+
+1.9.5: [2013-02-20] James Heinrich, Dmitry Arkhipov
+ » DTS-in-WAV now properly supported
+ ¤ DSS files return additional data in new keys, and some existing
+ keys have been renamed
+ * Bugfix: open_basedir not parsed correctly under Windows
+ (thanks yannick*jamontØgmail*com)
+ * Bugfix: [demo/demo.browse] might not display file or directory name
+ on PHP >=5.4.0 if filename not UTF-8 friendly
+ * Bugfix: [demo/demo.zip] could read more uncompressed data than
+ required; fail to read file if local data descriptor not set;
+ some wrong include files were listed; improved error message display
+ * Bugfix: [module.audio-video.riff] INFO comment chunks with null name
+ chunk not parsed correctly
+ * Bugfix: [module.archive.gz] gzip files with filename stored may have
+ filename reduplicated in [gzip][files] output
+ * Bugfix: [module.archive.zip] data_descriptor not parsed correctly
+ * Bugfix: [module.archive.zip] some newer compression methods unknown
+ * Bugfix: [module.archive.zip] not all flags parsed
+ * Bugfix: [module.archive.zip] local file header not parsed correctly
+ if file has zero values for compressed_size in Local File Header
+ * Bugfix: (#1493) better support for >2GB filesize on 32-bit Linux
+ * Bugfix: (#1474) unneccesary call to GetDataImageSize in JPEG module
+ * Bugfix: (#1470) GIF files falsely detected as TS format
+ * Bugfix: (#1431) Matroska did not parse PixelCrop* / DisplayUnit
+ (thanks jgerberØwikimedia*org)
+ * Bugfix: (#1430) split ID3v2 text values on null separator
+ * Bugfix: (#1426) MS Office 2007 file format now recognized as zip.msoffice
+ * Bugfix: (#1423) optimized CreateDeepArray function
+ * Bugfix: (#1415) add support for DS2 variant of DSS
+
+1.9.4b1: [2012-10-05] James Heinrich, Dmitry Arkhipov, Karl G. Holz
+ » New module: extension.cache.sqlite3.php (by Karl G. Holz)
+ » New demo: demos/getid3.demo.dirscan.php (by Karl G. Holz)
+ » PHP5 standards improvements (thanks phansysØgmail*com)
+ » more reliable >4GB file size parsing using COM (if available)
+ Scripting.FileSystemObject rather than parsing `dir` output
+ * added support for FLAC inside Matroska (audio bitrate cannot
+ be determined in this case)
+ * XMP module now returns all tags, not just whitelisted ones
+ * (#1297) Added detection of MPEG Transport Stream files.
+ Stub module.audio-video.ts.php incomplete
+ * (#1383) removed unneeded ?> tags (thanks daveØholyfield*info)
+ * Bugfix: XMP returns attributes array not just value strings
+ * Bugfix: (#1369) ID3v2 IPLS contents not parsed
+ * Bugfix: (#1357) demo.mysql.php mysql_table_exists() failed
+ * Bugfix: (#1355) copy Foobar2000 QuickTime tags to [comments]
+ * Bugfix: (#1351) QuickTime files with zero-sized atom boxes
+ could cause infinite loop
+ * Bugfix: (#1343) FLAC attached pictures Ogg not handled
+ * Bugfix: (#1343) ID3v2 inside WAV "id3 " chunk not handled
+ * Bugfix: (#1315) BMP detection was broken
+ * Bugfix: (#1309) ID3v2.2 content_group_description (TT2) did
+ not copy to same place as ID3v2.3/ID3v2.4 (TIT2)
+ * Bugfix: (#1308) [playtime_string] could show hh:mm:60
+ * Bugfix: (#1306) extension.cache.mysql.php keyword TYPE->ENGINE
+ * Bugfix: (#1295) missing video information if QuickTime file has
+ disabled tracks
+ * Bugfix: (#1275) MD5/SHA1 data hashes not working properly
+ under Windows
+
+
+1.9.3: [2011-12-13] Dmitry Arkhipov, James Heinrich
+ * Matroska module improved:
+ 1. Added support for A_MS/ACM audio codec
+ 2. Fixed issues in tags, cues, chapters and clusters parsing
+ 3. Fixed almost all errors with track_data_offset, errors
+ still may occur with Xiph data lacing
+ 4. Optimized audio/video streams population with usage of the
+ official default values for missing elements
+ 5. Audio/video keys are now populated with data from the
+ default stream, not from the first one as before
+ 6. Full WebM support
+ * Bugfix: demo.browse would not pop up warnings when clicked
+ if warning contains apostrophe/single-quote character
+ * Bugfix: (#1269) ID3v1 genre typo "Trash"->"Thrash" Metal
+
+
+1.9.2: [2011-12-08] James Heinrich, Dmitry Arkhipov
+ » significant rewrite to module.audio-video.matroska.php
+ ¤ (#1256) ID3 tags in AIFF 'ID3 ' chunks now parsed
+ ¤ (#1039) iXML data in WAV files now returned and parsed into
+ [riff][WAVE][iXML][0][data] and [riff][WAVE][iXML][0][parsed]
+ ¤ [playtime_string] now returns M:SS if less than 1 hour, and
+ H:MM:SS if 1 hour or longer
+ * Bugfix: (#1266) variable tablename: extension.cache.mysql.php
+ * Bugfix: (#1265) unescaped # in regex in write.id3v2.php
+ * Bugfix: (#1252) MediaMonkey writes blank ID3v2 RGAD frames
+ and puts replay-gain values in TXXX frames
+ * Bugfix: (#1251) FLV playtime could be inaccurate for longer
+ files where meta frame is present but meta-playtime is zero
+ * Bugfix: (#1216) show hex values of unknown atom names
+ * Bugfix: (#1215) undefined variable in PrintHexBytes()
+ * Bugfix: FLV audio bitrate was returning kbps not bps
+ * Bugfix: missing ) in write.real.php::RemoveReal()
+ * Bugfix: replace $this::VERSION with getID3::VERSION in
+ extension.cache.*.php
+
+
+1.9.1: [2011-08-10] James Heinrich
+ ¤ ASF Extended Header Object data now (partially) parsed
+ * Default getID3 encoding now set to UTF-8 not ISO-8859-1
+ * Bugfix: (#1212) truncated Matroska files may result in
+ infinite loop and memory exhaustion
+ * Bugfix: (#1203) parse RIFF JUNK chunks for version strings
+ * Bugfix: (#1201) multi-byte characters strings incorrectly
+ displayed by table_var_dump() in demo.browse.php
+ * Bugfix: (#1199) prevent PHP warning on malformed ID3v2 APIC
+ * Bugfix: (#1196) typo in module.audio-video.quicktime.php
+ * Bugfix: (#1195) QuicktimeStoreFrontCodeLookup() broken
+ * Bugfix: (#1194) mp4 embedded images not handled correctly
+ * Bugfix: (#1193) [image_mime] key not set fo WM/picture data
+ * Bugfix: (#1193) ASF Extended Header Object Metadata Library
+ now parsed for embedded images and handled per usual style
+ * Bugfix: (#1190) demo.mimeonly.php was broken since v1.9.0
+ * Bugfix: ID3v2 comment is now called 'comment' not 'comments'
+ * Bugfix: AVI unknown codec fourcc would be reported as blank
+ * Bugfix: AVI zero-size JUNK chunk would give warning
+
+
+1.9.0: [2011-06-20] James Heinrich
+ » changed all module classes to have proper constructors
+ with the actual analysis code moved to function Analyze()
+ * removed unnecessary ob_* calls, replaced with appropriate
+ checks and judicious use of @ error suppression
+ ¤ GETID3_VERSION constant replaced with $getID3->version()
+ ¤ picture data is now returned only in the original source
+ location and [comments][picture], it is no longer replicated
+ in [comments_html], [tags] or [tags_html]
+ ¤ Matroska tags are now returned in [comments] as per normal
+ ¤ Matroska tags are better supported, including pictures
+ ¤ GPS data in MP4 files (e.g. iPhone) is now parsed (#1157)
+ ¤ Matroska audio/video tracks with a default flag, the default
+ stream flag is now copied to [audio|video][streams] (#1147)
+ ¤ Nikon-specific data (NCDT atom) in Quicktime videos now parsed
+ ¤ QuickTime atoms 'meta' and 'data' now (mostly) parsed
+ * Bugfix: remove false warning of junk data on WAV+ID3v1
+ * Bugfix: DolbyDigitalWAV files returned wrong audio bitrate
+ * Bugfix: large attachment data in Matroska tags were not
+ returned completely.
+ * Bugfix: wrong image_mime used for images in demo.browse.php
+ * Bugfix: broken preg_match in module.audio.dss.php
+ * Bugfix: Lyrics3 end offset was off by 1
+ * Bugfix: audio channelmode could be wrong for 2 channels
+ (e.g. joint stereo reported as stereo)
+ * Bugfix: MultiByteCharString2HTML() would return empty string
+ if passed float or int value, now casts to string first
+ * Bugfix: FLAC.picture was not returning under [data] +
+ [image_mime] per standardized format
+ * Bugfix: BigEndian2Int() could incorrectly return negative
+ signed synchsafe integer instead of casting to float
+ * Bugfix: (#1177) ID3v2.4 extended headers were broken
+ * Bugfix: (#1173) some MIDI files not completely parsed
+ * Bugfix: (#1171) change helperapps error to nonblocking warning
+ * Bugfix: (#1170) possible infinite loop in FLV module
+ * Bugfix: (#1169) $this reference in static function (ID3v2)
+ * Bugfix: (#1156) demo.mysql.php not working
+ * Bugfix: (#1153) badly-tagged files could produce invalid
+ argument errors in module.tag.xmp.php
+ * Bugfix: (#1152) add error-suppression to iconv() calls
+ * Bugfix: (#1151) AAC-ADTS files could sometimes not find sync
+ * Bugfix: (#1136) last character of unicode tags (e.g. ASF)
+ was being truncated
+ * Bugfix: (#1133) write.id3v2.php IsValidURL() was broken
+ * Bugfix: (#1126) ID3v2.POPM field was being clobbered
+ * Bugfix: (#999, #1154) ID3v2 UFID data was missing
+
+
+1.8.5: [2011-02-18] James Heinrich
+ » support >2GB files on 64-bit PHP
+ - note current unofficial 64-bit PHP builds for Windows
+ do not actually support 64-bit integers so are still
+ subject to normal 32-bit limits (2GB) for file functions
+ » PHP v5.0.5 now minimum required version.
+ Removed obsolte functions from getid3.lib.php:
+ md5_file, sha1_file, image_type_to_mime_type
+ » IDivX tags now parsed on AVI files
+ ¤ embedded image data is returned inside [comments][picture]
+ in a 2-element array (data, image_mime) for all formats
+ * $this->overwrite_tags=false is now known to be buggy and
+ has been disabled for this version until a full review
+ of tag writing can be completed. Certainly affects ID3v2,
+ the other writable tag formats may or may not be broken
+ * getID3 constructor no longer checks for (or sets) timezone
+ * demo.browse.php now shows cover art as inline images
+ rather than dumped to separate files
+ * [audio][streams][x][language] now set when known
+ * Bugfix: RIFF-AVI "JUNK" chunks are now parsed properly,
+ including zero-sized ones (no more false errors)
+ * Bugfix: msoffice documents now return correct error message
+ * Bugfix: demo.browse.php now encodes data according to
+ current page encoding (default=UTF-8)
+ * Bugfix: (#1120) sometimes incorrect ID3v2 genre parsing
+ * Bugfix: (#1116) possibly incorrect warnings (or lack of)
+ for RIFFs > 2GB.
+ * Bugfix: (#1115) wrong RIFFtype in RIFF files
+ * Bugfix: (#1114) wrong MIME type may be set for Matroska
+ * Bugfix: (#1113) support DSS v3 files
+ * Bugfix: (#1111) cover art in APE tags now supported
+ * Bugfix: (#1091) RemoveID3v1() unitialized variables
+ * Bugfix: (# 504) do not set Quicktime resolution if
+ 'tkhd' atom is disabled
+ * Bugfix: (# 95) return [quicktime][controller] if known
+
+
+1.8.4: [2011-02-03] James Heinrich
+ * change default encoding in ID3v2 writing to UTF16-LE+BOM
+ (or ISO-8859-1 where possible) for better compatability
+ with broken versions of Windows Media Player and iTunes
+ * Bugfix: [FLV] incorrect overall bitrate in some files
+ * Bugfix: (#1102) missing parentheses in write[.id3v2].php
+ * Bugfix: (#510) undefined IsValidDottedIP() in write.id3v2.php
+
+
+1.8.3: [2011-01-18] James Heinrich
+ » magic_quotes_gpc must now be disabled to use getID3
+ » replace all error-suppressing @$variable calls with
+ isset() or empty() as appropriate for some configurations
+ where @ does not act to suppress warnings of undefined
+ variables (e.g. support forum thread #798)
+ * remove SafeStripSlashes() and FixTextFields functions
+ * [quicktime] use fourcc if codec name zero-length
+ * [quicktime] support "iods" atom
+ * Bugfix: (#1099) sometimes incorrect detection of safe_mode
+ * Bugfix: (#1095) more robust setting of temp dir
+ * Bugfix: (#1093) add support for ClusterSimpleBlock to
+ prevent "Undefined index: track_data_offsets" errors
+ in Matroska files
+ * Bugfix: [riff] prevent errors when RIFF.WAVE.BEXT chunk
+ contains null date/time (thanks moysevichØgmail*com)
+ * Bugfix: [quicktime] prevent divide-by-zero errors if
+ time_to_sample_table has zero-sample entry
+ (thanks moysevichØgmail*com)
+
+
+1.8.2: [2010-12-06] James Heinrich
+ * include startup warning for PHP < v5
+ * magic_quotes_runtime must now be disabled to use getID3
+ ¤ MusicBrainz / AmpliFIND data more accessible in returned data
+ from Quicktime-style files (e.g. MP4/AAC)
+ * Bugfix: (#1079) wrong encoding might be used for ID3v2
+ text data, and/or garbage data prepended before text
+ data; DataLengthIndicator value was being ignored
+ * Bugfix: (#1055) clearer warnings on non-EXIF contents in
+ JPEG [APP1]
+ * Bugfix: (#999) ID3v2 UFID data was missing
+
+
+1.8.1: [2010-11-25] James Heinrich
+ * replaced calls to deprecated mysql_escape_string() with
+ mysql_real_escape_string()
+ * Bugfix: (#1072) memory limit not handled correctly if
+ in gigabytes in php.ini (e.g. "2G")
+ * Bugfix: (#1068) wrong encoding for Quicktime tags
+ * Bugfix: (#1040) possible infinite loop in genre parsing
+ * Bugfix: (#1036) helperapps directory not resolving 8.3
+ path names correctly
+ * Bugfix: (#1023) dbm cache extension not correctly handling
+ types other than "db3"
+ * Bugfix: (#1023) mysql cache extension now base64_encodes
+ data to make binary-safe. Existing cached data must be
+ purged from your database cache
+ * Bugfix: (#1007) ClosestStandardMP3Bitrate() not selecting
+ most appropriate value
+ * Bugfix: (#996) inefficient and buggy ID3v1 and ID3v2
+ genre parsing
+ * Bugfix: (#974) track number handled incorrectly in
+ demo.write.php
+ * Bugfix: (#969) tempnam() calls failing with open_basedir
+ * Bugfix: (#955) UTF-16LE text files could be falsely
+ identified as corrupt mp3 files
+ * Bugfix: (#877) detect if mbstring.func_overload is set in php.ini
+ * Bugfix: (#858) PHP safe_mode setting in php.ini incorrectly
+ handled if set to "Off"
+ * Bugfix: (#838) prevent warnings with assorted unhandled
+ Quicktime atoms
+
+
+1.8.0: [2010-11-23] James Heinrich
+ » Changes required for PHP v5.3+ compatability, including:
+ - change ereg* functions to preg_* equivalents
+ - declare functions static as needed
+ note: users of PHP v4.x may need to stay with getID3 v1.7.x
+ » Added CUE (cuesheet) support
+ new file: module.misc.cue.php
+ (thanks Nigel Barnes ngbarnesØhotmail*com)
+ » Added XMP (Adobe Extensible Metadata Platform) support
+ currently used with module.graphic.jpg.php
+ new file: module.tag.xmp.php
+ (thanks Nigel Barnes ngbarnesØhotmail*com)
+ ¤ [jpg][exif][GPS][computed] now exists when possible with
+ calculated values (decimal latitude, longitude, altitude, time)
+ ¤ Prevent clobbering WMA artist with albumartist value; added WMA
+ partofset tag; added WMA tag picture data to WMA comments
+ (thanks ngbarnesØhotmail*com)
+ ¤ RIFF.WAVE.SNDM (SoundMiner) metadata now parsed
+ (thanks emerrittØwbgu*bgsu*edu)
+ ¤ FLAC embedded pictures now return [data_length] key
+ (thanks darrenburnhillØhotmail*com)
+ * added support for a number of new comment atom types added in
+ iTunes v4.0-v7.0 (thanks ngbarnesØhotmail*com)
+ * demo.browse.php now shows video resolution and framerate (if no
+ artist or title info present)
+ * additional FLV details parsed, may be faster as well
+ (thanks ngbarnesØhotmail*com)
+ * Bugfix: DSS files longer than 60 seconds had wrong playtime
+ * Bugfix: possible empty array encountered in APE tags
+ (thanks csnaitsirchØweb*de)
+ * Bugfix: prevent fatal error when calling BigEndian2Int() on
+ zero-length string (thanks taylor*fausakØgmail*com)
+ * Bugfix: prevent errors when parsing invalid Vorbis comments
+ (thanks dr*dieselØgmail*com)
+ * Bugfix: files could not be analyzed from Windows shares
+ (e.g. \\SERVER\Directory\Filename.mp3)
+ * Bugfix: RAR file opening should use 'filenamepath'
+ (thanks adrien*gibratØgmail*com)
+ * Bugfix: [asf][codec_list_object][codec_entries][x][description]
+ not containing expected comma-seperated values no longer aborts
+ (thanks larry_globusØyahoo*com)
+ * Bugfix: [id3v2] UFID was not returning data
+ (thanks joostØdecock*org)
+
+1.7.9: [2009-03-08] James Heinrich
+ » Added DSS (Digital Speech Standard) support
+ new file: module.audio.dss.php
+ (thanks luke*wilkinsØdtsam*com)
+ » Added MPC (Musepack) SV8 support
+ (thanks WaldoMonster)
+ ¤ some MPC [header] keys renamed to be the same between SV7/SV8
+ ¤ start aligning demos CSS styling with v2.x styles
+ new file: demos/getid3.css
+ ¤ JPEG now returns parsed IPTC tags in [iptc]
+ ¤ getid3_lib::GetDataImageSize now requires $imageinfo parameter
+ ¤ better support for Matroska files with AC3/DTS/MP3/OGG audio
+ (support still lacking for AAC)
+ ¤ standardize ID3v2 TCMP key to 'part_of_a_set' between reading
+ and writing (thanks aaron_stormØyahoo*com)
+ ¤ added ID3v2 keys 'TCMP','TCP' to for writing iTunes-style tags
+ (thanks aaron_stormØyahoo*com)
+ ¤ back-ported PICTURE tag handling in FLAC tags
+ (thanks WaldoMonster)
+ ¤ added alternate method to get [video][frame_rate] from QuickTime
+ * added partial support for "TCMP"/"TCP" ID3v2 frames (iTunes
+ non-standard part-of-a-compilation tag)
+ (thanks aaron_stormØyahoo*com)
+ * slightly improved scanning through FLV files speed
+ (thanks franki)
+ * faster Matroska scanning by stopping at cluster chunks once
+ needed header chunks are found (much faster for large files)
+ * added workaround for broken tagging programs that miss terminating
+ null byte for numeric ID3v2.4 genres
+ (thanks yam655Øgmail*com)
+ * Bugfix: MultiByteCharString2HTML() did not escape common HTML
+ special characters like & and ?
+ * Bugfix: cleaned up some malformed HTML errors in demo.browse.php
+ * Bugfix: under Windows files >2GB might not be processed due to
+ "dir" command not finding file with double directory slashes
+ * Bugfix: "MODule (assorted sub-formats)" was falsely matching
+ some random files (e.g. JPEGs) (thanks qwertywin)
+ * Bugfix: suppress PHP_notice on failed SWF-compressed
+ decompression failure (thanks mkron)
+
+
+1.7.8b3: [2008-07-13] James Heinrich
+ » Experimental partial support for files > 2GB (gets filesize
+ from shell call to "dir" or "ls", parse files with PHP only
+ up to 2GB limit). See readme.txt for details on what formats
+ work properly and other limitations
+ » Initial support for Matroska. Has only been tested with a
+ limited number of sample files, please report any bugs
+ » Experimental support for PHP-RAR reading. Known buggy, disabled
+ by default, enable with care
+ ¤ getid3_lib::CastAsInt() now returns ints up to 2^31 (not 2^30)
+ ¤ Quicktime: [video] now returns [frame_rate] and [fourcc] for MP4
+ video files
+ * MP3: headerless VBR files now only have up to 10 blocks of 5000
+ frames each scanned by default and bitrate extrapolated from that
+ distribution for speed (thanks glau*stuffØridiculousprods*com)
+ * Quicktime: support "co64" atom
+ * SWF: lower memory use when compressed SWF files processed
+ (thanks doughammondØblueyonder*co*uk)
+ * Bugfix: FLV height and width was calculated incorrectly
+ (thanks moysevichØgmail*com)
+ * Bugfix: FLV GETID3_FLV_TAG_META parsed incorrectly
+ (thanks moysevichØgmail*com)
+ * Bugfix: Quicktime: 'tkhd' matrix_v and matrix_d were switched
+ (thanks rjjmoroØhotmail*com)
+ * Bugfix: Quicktime: frame_rate was often incorrect for MP4 video
+ * Bugfix: getid3_lib::CastAsInt returned -2147483648 when passed
+ 2147483648 (0x80000000)
+
+
+1.7.8b2: [2007-10-15] James Heinrich, Allan Hansen
+ * Video bitrate now calculated even if not explicitly stated in
+ file metadata, but if overall and audio bitrates are known
+ * Bugfix: 'comments_html' missing last letter in id3v2 tags.
+ * Bugfix: module objects (e.g. getid3_riff) that are instantiated
+ in other modules are explicitly disposed once no longer needed.
+ * Bugfix: some AVI files were not returning audio information
+ because "strh" chunk was not being read in
+ * Bugfix: asf [audio][<streamnumber>][dataformat] should be set
+ to "wma" but wasn't
+ * Bugfix: [mpeg][audio][bitrate_mode] should always be one of
+ ("cbr", "vbr", "abr") but wasn't for some values in
+ LAMEvbrMethodLookup()
+ * Bugfix: MP3 audio in AVI files could show "cbr" instead of
+ correct audio bitrate_mode, and audio bitrate could be slightly
+ incorrect if multiple files were scanned in a loop (scanning
+ single files produced correct values).
+ * Bugfix: remove [audio/video][bitrate] key if falsely set to zero
+ * Bugfix: PlaytimeString returned non-matching value for negative
+ playtimes (which shouldn't happen either, but now they're at
+ least shown correctly, if they happen due to other bugs)
+ * Bugfix: Several ASF header values are invalid if the broadcast
+ flag is set, getID3() now calculates these values in other
+ ways if the broadcast flag is set (thanks fletchØpobox*com)
+ * Bugfix: lyrics3-flags-lyrics field was always false, and there
+ never was a lyrics3-flags-timestamp field present even though
+ the lyrics3-raw-IND field consisted of "10" (lyrics present,
+ timestamp not present). (thanks i*f*schulzØweb*de)
+ * Bugfix: TAR.GZ files produce PHP errors when
+ option_gzip_parse_contents == true in module.archive.gzip.php
+ (thanks alan*harderØsun*com)
+
+
+1.7.8b1: [2007-01-08] Allan Hansen
+ » Major update to readme.txt
+ » PHP 4.2.0 required
+ » Tagwriter requires metaflac 1.1.1+ in order to write FLAC tags.
+ » Removed broken and non-fixable tagwriting module for real format.
+ ! Developers please help fix the above module:
+ http://www.getid3.org/phpBB3/viewtopic.php?t=677
+ » Avoided security issues with demo.browse.php, demo.write.php and
+ demo.mysql.php. These demos are now disabled by default and has
+ to be enabled in the source.
+ * Bugfix: id3v2 genre broken since 1.7.7.
+ » Added DTS module (module.audio.dts.php)
+ ¤ ASF/WMV files now return largest video stream dimensions in
+ [video][resolution_x] and [video][resolution_y]
+ * Bugfix: Minor issues with midi module (avoid PHP_NOTICE).
+ * Bugfix: Minor issues with lyrics3 (avoid PHP_NOTICE).
+ * Bugfix: PHP_NOTICE issues in MultiByteCharString2HTML()
+ * Bugfix: PHP_NOTICE issue in BigEndian2Float()
+ * Bugfix: fread() zero bytes issue in real module.
+ * Bugfix: ASF module returned mime type video/x-ms-wma instead of
+ video/x-ms-wmv for certain FourCCs.
+ * Bugfix: PHP_NOTICE issues with broken ID3v2 tag/garbage.
+ * Bugfix: PNG module broken in regards to gIFg and gIFx chunks.
+ » Removed detection of short filenames 8dot3 under windows, as
+ it only worked for English versions of windows and has other
+ problems.
+ * Bugfix: Some CBR MP3 files detected as VBR with plenty of warnings.
+ * Bugfix: PHP_NOTICE issues in MP3 module.
+ * Bugfix: Quicktime returned incorrect frame rate.
+ * Bugfix: DivByZero on zero length FLV files.
+ * Bugfix: PHP_NOTICE one some FLV files.
+ * Bugfix: ID3v2 UTF-8/16 encoded frames terminated by \x00
+ * Bugfix: ID3v2 LINK frames iconv error.
+ * Bugfix: ID3v2 padding length calculated incorrectly.
+ * Bugfix: ID3v2.3 extended headers non-conformance
+ » SVG file detection.
+ » Added SVG user module (user_modules/module.graphic.svg.php).
+ Thanks to Roan Horning.
+ » PAR2 file detection (no parsing)
+ * Bugfix: Wave files being detected as MP3.
+ * Bugfix: ASF padding offset bug.
+ * Bugfix: Shorten module not working for wav files with fmt
+ chunks <> 16 bytes.
+ ¤ RIFF: Zero sized chunk invokes warning instead of error.
+ ¤ FLAC: Removed some ['raw'] keys.
+ ¤ MPC: Mime type returned: audio/x-musepack
+
+1.7.7: [2006-06-25] Allan Hansen
+ * Bugfix: AAC static bitrate cache wrong result when parsing
+ several files.
+ * Bugfix: Do not return NULL video bitrate for ASF v3.
+ * Bugfix: getid3_lib::GetImageSize() broken => JPG module broken.
+ * Bugfix: Encoder options should now be returned with correct
+ "--alt-preset n" / "--alt-preset cbr n" when scanning more files.
+ * Bugfix: Shorten module not escapeshellarg() filenames (UNIX only).
+ * Bugfix: Filenames not escapeshellarg() for md5_data and
+ sha1_data (UNIX only).
+ * Bugfix: UNIX: head and tail called with -cNNN instead of "-c NNN".
+ » Added detection support for PDF and MS Office documents
+ (*.doc, *.xls, *.pps, etc) (thanks zeromassmediaØgmail*com)
+ ¤ Bugfix: ID3v2 "TDRC" frame now used as "year" in comments if TYER
+ unavailable (TYER is deprecated in ID3v2.4)
+ (thanks matthiasØpanczyk*org)
+ ¤ Removed GETID3_OS_DIRSLASH, replaced with DIRECTORY_SEPARATOR
+ * Bugfix: added LAME preset guessing for presets 410,420,440,490
+ (thanks adminØlogbud*com)
+ * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
+ (thanks towbØgmx*net)
+ » TAR module no longer reads entire file into memory
+ » FLV module no longer reads entire file into memory
+ * Bugfix: added LAME preset guessing for presets 410,420,440,490
+ (thanks adminØlogbud*com)
+ * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
+ (thanks towbØgmx*net)
+ * Bugfix: Error message when padding in FLAC files were used up.
+ * Bugfix: Shorten module not working under windows.
+ ¤ Bugfix: gmmktime() instead of mktime().
+ ¤ Using gmmktime() instead of mktime() in ISO, ZIP, PNG and RIFF
+ modules to avoid E_STRICT notices with PHP5.1+.
+ * Bugfix: ['comments_html'] and ['comments'] contains different
+ value when having multiple tags (one of them ID3v1) and the
+ long field names.
+
+1.7.6: [2006-03-12] James Heinrich
+ * Rewrote getid3_lib::GetDataImageSize() to use GetImageSize()
+ instead of using code by filØrezox*com
+ * Bugfix: incorrect dimensions from disabled Quicktime tracks
+ (thanks m-1Øgmx*net)
+ * Bugfix: ['codec'] key warning in module.audio-video.asf.php
+ (thanks niel*archerØblueyonder*co*uk)
+ * Bugfix: undefined array in write.php
+ (thanks drewishØkatherinehouse*com)
+ * Bugfix: DeleteAPEtag() incorrectly failing when no tag present
+ (thanks drewishØkatherinehouse*com)
+ * Bugfix: ID3v2 writing frames with URL fields failing when URL
+ is not in ISO-8859-1 (thanks drewishØkatherinehouse*com)
+ * Bugfix: PHP notices on bad ID3v2 frames
+ (thanks cw264701Øohiou*edu)
+ * Bugfix: audio & video bitrates sometimes wrong in ASF files
+ (thanks kris_kauperØexcite*com)
+
+1.7.5: [2005-12-29] James Heinrich
+ » Added FLV (FLash Video) support -- new file:
+ module.audio-video.flv.php
+ (thanks Seth Kaufman <seth@whirl-i-gig.com> for code)
+ » Real tags can now be written (previous Real tag writing
+ code was not supposed to be in public releases, as it
+ was not complete)
+ » GETID3_HELPERAPPSDIR now autodetected under Windows
+ ¤ ASF lyrics now returned under [comments][lyrics]
+ * Bugfix: removed "--lowpass xxxxx" info from guessed
+ LAME presets when source frequency <= 32kHz
+ * Bugfix: ID3v2 extended header errors
+ * Bugfix: missing ob_end_clean() in write.id3v2.php
+ (thanks rasherØgmail*com)
+
+1.7.4: [2005-05-04] James Heinrich
+ ¤ Added ['quicktime']['hinting'] key (boolean)
+ (thanks jonØwebignition*net)
+ * Bugfix: major UTF-8 to UTF-16/ISO-8859-1 conversion
+ bug (empty string returned) when using iconv_fallback
+ (thanks chrisØfmgp*com)
+ * Bugfix: Missing 'lossless' key in RIFF-WAV
+ (thanks bobbfwedØcomcast*net)
+
+1.7.3: [2005-04-22] James Heinrich
+ » Added TAR support -- new file: module.archive.tar.php
+ (thanks Mike Mozolin <teddybearØmail*ru> for code!)
+ » Added GZIP support -- new file: module.archive.gzip.php
+ (thanks Mike Mozolin <teddybearØmail*ru> for code!)
+ * Bugfix: demo.browse.php now displays embedded images
+ internally instead of passing local filename as IMG
+ SRC (should allow demo.browse.php to correctly show
+ embedded images over a network)
+ (thanks patpowermanØhotmail*com)
+ * Bugfix: minor UTF-8 display issues in demo.browse.php
+ * Bugfix: demo.browse.php now works even if the evil
+ setting magic_quotes_gpc is turned on
+ (thanks patpowermanØhotmail*com)
+ * Bugfix: incorrect MIDI playtime for some files
+ (thanks joelØoneporpoise*com)
+ * Bugfix: 'url_source' typo in module.tag.id3v2.php
+ (thanks richardlynchØusers*sourceforge*net)
+ * Bugfix: Quicktime 'mvhd' matrix values were wrong
+ (thanks webØbobbymac*net)
+ ¤ ID3v2 now returns xx/yy for ['track'] (if
+ available), with xx in ['tracknum'] and yy in
+ ['totaltracks']. Previously ['tracknum'] was not
+ available and ['track'] had only xx.
+ Bugfixes and improvements to /demo/demo.mysql.php:
+ - remix/version parsed from tags and stored in
+ database, can be used when renaming files
+ - track number can be used for renaming files
+
+
+1.7.2: [2004-10-18] Allan Hansen
+ » Added support for WavPack v4.0+
+ (thanks ahØartemis*dk)
+ » Removed code for parsing EXE files
+ (thanks ahØartemis*dk)
+ Removed file: module.misc.exe.php
+ * Bugfix: Large ID3v2 tags inside ASF not parsed
+ properly under PHP5.
+ * Bugfix: Certain Wavpack3 files failed under PHP5 due
+ to new undocumented tmpfile() limit (same problem as
+ above).
+ * Bugfix: New iTunes crashes PHP - temp fix - no tags
+ on those files.
+ * Bugfix: ['nsv']['NSVs']['framerate_index'] might be
+ wrong (thanks ahØartemis*dk)
+ * Bugfix: transparent color was wrong from truecolor
+ PNG (thanks ahØartemis*dk)
+ * Bugfix: Changed MPC SV7 header size from 30 to 28,
+ this will change hash values for MPC files
+ (thanks ahØartemis*dk)
+ * Bugfix: Changed MPC SV4-6 header size from 28 to 8,
+ this will change hash values for MPC files
+ (thanks ahØartemis*dk)
+ ¤ Trim/unset wavpack encoder_options to match 2.0.0b2
+ output.
+ ¤ Commented-out unknown/unused values in NSV and ISO
+ modules (thanks ahØartemis*dk)
+
+
+1.7.1b1: [July-26-2004] James Heinrich
+ » Added support for Apple Lossless Audio Codec
+ » Added support for RealAudio Lossless
+ » Added support for TTA v3
+ » Added support for TIFF
+ New file: /getid3/module.graphic.tiff.php
+ » Modified iconv_fallback to work with UTF-8, UTF-16, UTF-16LE,
+ UTF-16BE and ISO-8859-1 even if iconv() and/or XML support is
+ not available. This means that iconv() is no longer required
+ for most users of getID3()
+ (thanks Jeremia, khleeØbitpass*com)
+ » Added support for Monkey's Audio v3.98+ (thanks ahØartemis*dk)
+ » Included new demo showing most-basic getID3() usage
+ New file: /demos/demo.basic.php
+ * Bugfix: LAME3.94+ presets cached incorrectly if multiple files
+ are scanned in one batch and first file is LAME3.93 or earlier
+ (thanks enoyandØyahoo*com)
+ * Bugfix: Added warning if compressed ID3v2 frame decompression
+ fails. (thanks Mike Billings)
+ * Bugfix: Assorted small fixes to ensure compatability with PHP5
+ * Bugfix: ID3v1 genre "Blues" could not be written
+ (thanks Jeremia)
+ * Bugfix: ['bitrate_mode'] typo in module.audio-video.real.php
+ (thanks asukakenjiØusers*sourceforge*net)
+ * Bugfix: ['zip']['files'] is now populated with filenames even
+ if End Of Central Directory couldn't be parsed
+ * Bugfix: ['audio']['lossless'] was incorrect for FLAC
+ (thanks WaldoMonster)
+ * Bugfix: MD5 File was incorrect in directory browse mode for
+ /demo/getid3.browse.php
+ * Bugfix: PHP v5 compatability changes (float array keys, fread()
+ calls with zero data length)
+ (thanks getid3Øjsc*pp*ru)
+ * Bugfix: was dying if on compressed ID3v2 frames if
+ gzuncompress() function was unavailable
+ * Bugfix: ['vqf']['COMM'] was always empty
+ * Bugfix: MIDI playtime was missing for single-track MIDI files
+ * Bugfix: removed � characters from ['comments_html']
+ (thanks p*quaedackersØplanet*nl)
+ * Bugfix: improved MIDI playtime accuracy
+ (thanks joelØoneporpoise*com)
+ * Bugfix: BMP subtypes 4 and 5 were not being identified
+ * Bugfix: frame_rate in AVI was incorrectly truncated to integer
+ * Bugfix: FLAC cuesheet track index was incorrect
+ (thanks tetsuo*yokozukaØoperamail*com)
+ ¤ ['quicktime']['display_scale'] now contains the playback scale
+ multiplier for QuickTime movies - a movie set to playback at
+ double-size will have "2" here. Other values are "1" and "0.5"
+ ¤ Added LAME preset guessing for --preset medium with v3.90.3
+ (thanks phwipØfish*co*uk)
+ ¤ Added $encoding_id3v1 to allow for ID3v1 encodings other than
+ the standard ISO-8859-1
+ ¤ Default AVI video bitrate_mode is now 'vbr'
+ (thanks eltoderØpisem*net)
+ Force getID3() to abort if Shorten files have ID3 or APE tags
+ (thanks ahØartemis*dk)
+ Editable textbox for parent directory in demo.browse.php
+ (thanks eltoderØpisem*net)
+
+
+1.7.0-hotfix [2004-03-17] Allan Hansen
+ (hotfix version released by Allan Hansen)
+ * Bugfix: PHP 4.1.x compatiblity - fgets($fp) => fgets($fp, 1024)
+ * Bugfix: Added default charset to TextEncodingNameLookup() in
+ module.tag.id3v2.php
+ Ø Removed option_no_iconv
+ iconv() support is only a requirement for WMA/WMW/ASF, and for
+ destination encodings other than ISO-8859-1 and UTF-8, iconv is
+ not needed otherwise. New 'iconv_req' in GetFileFormatArray()
+ only set for WMA/WMV/ASF. analyze() now refuses to analyse
+ WMA/ASF file if iconv is not present.
+ iconv_fallback() only dies on internal errors not missing iconv()
+
+
+1.7.0: [January-19-2004] James Heinrich
+ » Added support for RIFF/CDXA files (MPEG video in RIFF container
+ format (thanks chrisØdigitekdesign*com)
+ » Added support for TTA v2 (thanks ahØartemis*dk)
+ ¤ ID3v2 unsynchronisation scheme disabled by default because most
+ tag-reading programs cannot read unsynchronised tags. Can be
+ overridden by setting id3v2_use_unsynchronisation to true.
+ (thanks mikeØdelusion*org)
+ ¤ extention.*.php renamed to extension.*.php
+ (thanks tp62Øcornell*edu)
+ ¤ /demo/demo.check.php renamed to /demo/demo.browse.php
+ ¤ Added id3v2_paddedlength configuration parameter to WriteTags()
+ and renamed tag_language to id3v2_tag_language
+ ¤ MPEG audio layers are now represented as 1, 2 or 3 instead of
+ 'I', 'II', or 'III'
+ ¤ Added [audio][wformattag] and [video][fourcc] for WAV and AVI
+ ¤ Added [audio][streams] which contains one entry for each audio
+ stream present in the file (usually only one). The data is a
+ copy of what is usually found in [audio]. If there are multiple
+ audio streams then [audio] will contain a sum of the bitrates
+ of all audio streams, and the data format of the first stream
+ (if streams are of different data types)
+ ¤ Added BruteForce mode to mp3 scanning. Disabled by default as
+ it is extremely slow and only files that are broken enough to
+ not really play will gain any benefit from this.
+ ¤ Suppress '--resample xxxxx' appended to encoder options for mp3
+ with low-quality presets for default sampling frequencies
+ ¤ Enhanced LAME preset guessing for pre-3.93 with a better lookup
+ table, --resample/--lowpass guessing (thanks phwipØfish*co*uk)
+ ¤ RIFF files with non-MP3 contents no longer have
+ [audio][encoder_options] set
+ ¤ Added [audio][encoder_options] to audio formats where possible
+ (including LiteWave, LPAC, OptimFROG, TTA)
+ ¤ Moved [quantization] and [max_prediction_order] from
+ [lpac][flags] to just [lpac]
+ ¤ WavPack flags are now parsed into [wavpack][flags]
+ * Bugfix: APEtags with ReplayGain information stored with comma-
+ seperated decimal values (ie "0,95" instead of "0.95") were
+ giving wrong peak and gain values
+ * Bugfix: Filesize > 2GB not always detected correctly
+ * Bugfix: Some ID3v2 frames had data key unset incorrectly
+ (thanks chrisØdigitekdesign*com)
+ * Bugfix: Warnings on empty-strings-only comments
+ * Bugfix: ID3v2 tag writing may have had incorrect padding length
+ if padded length less than current ID3v2 tag length and
+ merge_existing_data is false (thanks mikeØdelusion*org)
+ * Bugfix: hash_data() for SHA1 was broken under Windows
+ * Bugfix: BigEndian2Float()/LittleEndian2Float() were broken
+ * Bugfix: LAME header calculated track peaks were incorrect for
+ LAME3.94a15 and earlier
+ * Bugfix: AVIs with VBR MP3 audio data reported incorrect bitrate
+ and bitrate_mode
+ * Bugfix: AVIs sometimes had incorrect or missing video and total
+ bitrates
+ * Bugifx: AVIs sometimes had incorrect ['avdataend'] and
+ therefore also incorrect data hashes (md5_data, sha1_data)
+ * Bugfix: ID3v1 genreid no longer returned for Unknown genre
+ * Bugfix: ID3v1 SCMPX genres were broken
+ Modified LAME header parsing to correctly process peak track
+ value for LAME3.94a16+ (thanks Gabriel)
+ md5_file() and sha1_file() now work under Windows in PHP < 4.2.0
+ and 4.3.0 respectively with helper apps
+ Default md5_data() tempfile location is now system temp directory
+ instead of same directory as file (thanks towbØtiscali*de)
+ Improved list of RIFF ['INFO'] comment key translations
+ More helpful error message when GETID3_HELPERAPPSDIR has spaces
+ /demo/demo.browse.php now autogets both MD5 and SHA1 hashes for
+ files < 50MB
+ Replaced PHP_OS comparisons with GETID3_OS_ISWINDOWS define
+ (thanks necroticØusers*sourceforge*net)
+
+
+1.7.0b5: [December-29-2003] James Heinrich
+ » Windows only: Various binary files are now required for some
+ file formats, especially for tag writing, as well as md5sum
+ (and other) calculations. These binaries are now stored in the
+ directory defined as GETID3_HELPERAPPSDIR in getid3.php
+ (default is /helperapps/ parallel to /getid3/).
+ Note: This directory must not have any spaces in the pathname.
+ All neccesary files are available as a seperate download.
+ See /helperapps/readme.txt for more information
+ New file: /helperapps/readme.txt
+ » Unified tag-writing interface for all tag formats
+ New file: /getid3/write.php
+ /getid3/write.apetag.php
+ /getid3/write.id3v1.php
+ /getid3/write.id3v2.php
+ /getid3/write.lyrics3.php
+ /getid3/write.metaflac.php
+ /getid3/write.vorbiscomment.php
+ » Added support for Shorten - requires shorten binary (head.exe
+ is also required under Windows).
+ New file: /getid3/module.audio.shorten.php
+ » Added support for RKAU
+ New file: /getid3/module.audio.rkau.php
+ » Added (minimal) support for SZIP
+ New file: /getid3/module.archive.szip.php
+ » Added MySQL caching extention (thanks ahØartemis*dk)
+ New file: /getid3/extention.cache.mysql.php
+ » Added DBM caching extention (thanks ahØartemis*dk)
+ New file: /getid3/extention.cache.dbm.php
+ » Added sha1_data hash option (thanks ahØartemis*dk)
+ » Added option to allow getID3() to skip ID3v2 without parsing it
+ for faster scanning when ID3v2 data is not required. If you
+ want to enable this feature delete /getid3/module.tag.id3v2.php
+ (thanks ahØartemis*dk)
+ ¤ 8-bit WAV data now calculates MD5 checksums as normal, not
+ converting to signed data as before, so stored md5_data_source
+ in FLAC files will no longer match md5_data for the equivalent
+ decoded 8-bit WAV. A warning will be generated for 8-bit FLAC
+ files
+ ¤ Added option_no_iconv option to allow getID3() to work
+ partially without iconv() support enabled in PHP
+ (thanks ahØartemis*dk)
+ ¤ All '*_ascii' keys removed for ASF/WMA/WMV files
+ ¤ All 'ascii*' keys removed for ID3v2 tags
+ ¤ Ogg filetypes now return MIME of "application/ogg" instead of
+ the previous "application/x-ogg"
+ (thanks blakewattersØusers*sourceforge*net)
+ ¤ Force contents of ['id3v2']['comments'] to UTF-8 format from
+ whatever encoding each frame may have (text encoding can vary
+ from frame to frame in ID3v2)
+ ¤ MP3Gain information from APE tags suppressed from ['tags'] and
+ parsed into ['replay_gain']
+ ¤ ReplayGain information (all formats) changed from "Radio" and
+ "Audiophile" to "Track" and "Album" respectively
+ ¤ ['volume'] and ['max_noclip_gain'] are now available in both
+ ['replay_gain']['track'] and ['replay_gain']['album'] for all
+ formats that calculate ReplayGain.
+ ¤ ['video']['total_frames'] is available for AVIs
+ ¤ All parsed ID3v2 frame data is now in ['id3v2'][XXXX][#]
+ (previously some frame types would have numeric array keys if
+ multiple instances of that frame type were allowed and other
+ frame types would not)
+ ¤ ASF/WMA "WM/Picture" images are now parsed in the same manner
+ as ID3v2 with the image (ex JPEG) data returned in [data]
+ rather than [value]
+ * Bugfix: Optional tag processing options were being ignored (ie
+ ID3v1 still processed even if option_tag_id3v1 == false)
+ (thanks ahØartemis*dk)
+ * Bugfix: fixed MultiByteCharString2HTML() for UTF-8
+ * Bugfix: Quicktime files not always reporting video frame_rate
+ * Bugfix: False ID3v1 synch patterns in APE or Lyrics3 tags are
+ now detected and incorrect ID3v1 data not returned
+ (thanks sebastian_maresØusers*sourceforge*net for the idea)
+ * Bugfix: WMA9 Lossless now reported as lossless
+ * Bugfix: two typos in ID3v1 genre list
+ * Bugfix: MPEG-2/2.5 ABR/VBR MP3 files had doubled playtime
+ * Bugfix: MPEG-2/2.5 LayerII (ie MP2: 24/22.05/16kHz) files were
+ not detected due to incorrect frame length calculation
+ * Bugfix: MPEG LayerI files were not detected due to incorrect
+ frame length calculation (must be multiple of slot length)
+ Added alternative md5_data via system call - twice as fast. Needs
+ "getID3()-WindowsSupport" to work under Windows.
+ (thanks ahØartemis*dk)
+ ID3v2.4 compressed frames are now supported
+ php_uname() calls changed to use PHP_OS constant
+ Added SCMPX extensions to ID3v1 genres (0xF0-0xFE)
+ Obfuscated contributor email address in changelog and sourcecode
+ Added memory-saving EmbeddedLookup() function for lookup tables
+ in RIFF and ID3v2 modules (thanks ahØartemis*dk)
+ Major memory patches to many modules by using
+ $var = &$INFO_ARRAY_AT_SOME_INDEX
+ in place of large multi-dimensional array declarations.
+ Memory saved: RIFF: ~200kB; ID3v2: ~475kB; ASF: ~50kB etc.
+ (thanks ahØartemis*dk)
+
+
+1.7.0b4: [November-19-2003] James Heinrich
+ » Support added for MPC files with old SV4-SV6 structure
+ » RealVideo now properly supported with resolution, framerate, etc
+ (thanks jcsston)
+ » RealAudio files with old-style file format (v2-v4) are now
+ fully supported
+ » Support added for DolbyDigital WAV files (thanks ahØartemis*dk)
+ ¤ ['RIFF'] is now ['riff'] to conform to make all root key names
+ lowercase
+ ¤ ['OFR'] is now ['ofr'] to conform to make all root key names
+ lowercase
+ ¤ ['tags_html'] is now available as a copy of ['tags'] but
+ with all text replaced with an HTML version of all characters
+ above chr(127), translated according to whatever the encoding
+ of the source tag is, in the HTML form Ӓ
+ ¤ CopyTagsToComments() is now available in getid3_lib
+ ¤ QuicktimeVR files now return a ['video']['dataformat'] of
+ 'quicktimevr' instead of 'quicktime' (thanks gtsØtsu*biz)
+ ¤ Quicktime video files with DivX, Xvid, 3ivx or MPEG4 video
+ streams now return those names as ['video']['dataformat']
+ ¤ MPEG video files are now identified with ['video']['codec'] set
+ to either 'MPEG-1' or 'MPEG-2' (rather than just 'MPEG'). If you
+ see a file wrongly identified, please report it!
+ (thanks fccHandler)
+ ¤ All bitrate values in ['mpeg']['audio'] is now reported in bps
+ rather than kbps (ie 128000 instead of 128) for consistancy
+ ¤ AVIs with MP2 audio now report ['audio']['dataformat'] as 'mp2'
+ rather than 'wav' (thanks metalbrainØnetian*com)
+ ¤ Added ['md5_data_source'] for OptimFROG
+ ¤ AC3 in RIFF-WAV now identified with ['audio']['dataformat']
+ returning 'ac3'
+ ¤ WavPack ['extra_bc'] now returned as integer
+ ¤ WavPack ['extras'] now returned as 3-element array of integers
+ ¤ MP3 ['audio']['encoder options'] now returns 'VBR' or 'CBR' only
+ (no bitrate) if no LAME preset is used, or 'VBR q??' where ?? is
+ a number 0-100 for Fraunhofer-encoded VBR MP3s
+ * Bugfix: VBR MP3s could have incorrect bitrate reported
+ * Bugfix: Quicktime files with MP4 audio were not returning
+ ['video']['dataformat'] (thanks robØmassive-interactive*nl)
+ * Bugfix: strpad vs str_pad typo in module.riff.php
+ (thanks nicojunØusers*sourceforge*net)
+ * Bugfix: ReplayGain information was often wrong for MPC files
+ * Bugfix: MD5 and other post-TAIL chunks were not being processed
+ in module.audio.optimfrog.php
+ * Bugfix: Undefined variable in table_var_dump() in demo/check.php
+ * Bugfix: QuickTime files now only return information in [audio]
+ or [video] if those exist in the file
+ * Bugfix: WavPack no longer tries to read entire compressed data
+ chunk
+ * Bugfix: Properly handle VBR MP3s with "Info" (rather than
+ "Xing") header frame. foobar2000 adds this to MP3 files when
+ "Fix MP3 Header" function is used (thanks ahØartemis*dk)
+ * Bugfix: Fraunhofer VBRI headers for MP3s were assuming 2-byte
+ entries for TOC rather than using stride, and were ignoring the
+ scaling value. (thanks sebastianØmaresweb*net)
+ Several QuickTime atoms have been added to an exclusion list
+ because they have been observed, but I have no idea what they
+ are supposed to do so I can't add real support for them, but
+ they should not generate warnings (robØmassive-interactive*nl)
+ Old MPC encoder (before v1.06) was return as v0.00, now returned
+ as 'Buschmann v1.7.0-v1.7.9 or Klemm v0.90-v1.05'
+ (thanks ahØartemis*dk)
+ Added check for magic_quotes_runtime and code to disable it if
+ neccesary (thanks stefan*kischkelØt-online*de)
+ Added 3ivx fourCCs to module.audio-video.quicktime.php
+ MP3 and AC3 streams are now parsed when contained inside RIFF-WAV
+ or RIFF-AVI container formats
+ Better detection of named presets in LAME 3.93/3.94
+
+
+1.7.0b3: [October-17-2003] James Heinrich
+ » AC-3 (aka Dolby Digital) is now supported.
+ New file: /getid3/module.audio.ac3.php
+ * Bugfix: ID3v2-writing function Unsynchronise() was broken, which
+ made ID3v2 tag containing binary data (typically pictures) get
+ corrupted. (thanks t*coombesØbendigo*vic*gov*au,
+ i*kuehlbornØndh*net, mikeØdelusion*org, mikeØftl*com)
+ * Bugfix: Zip comments now returned as array instead of string,
+ as they're supposed to be.
+ * Bugfix: Quicktime/MP4 files may have reported extremely low
+ bitrates (thanks spunkØdasspunk*com)
+ Improved double-ID3v1 check to prevent false detection when string
+ "TAG" is present in APE or Lyrics3
+ Fixed /demo/simple.php
+ Fixed /demo/joinmp3.php
+ Fixed /demo/mimeonly.php
+ Fixed /demo/write.php
+
+
+1.7.0b2: [October-15-2003] James Heinrich
+ » TTA Lossless Audio Compressor format now supported.
+ (http://tta.iszf.irk.ru)
+ New file: /getid3/module.graphic.tta.php
+ » PhotoCD (PCD) format now supported. Image data for the three
+ lowest resolutions (192x128, 384x256, 768x512) can be optionally
+ extracted.
+ New file: /getid3/module.graphic.pcd.php
+ ¤ RIFF-MP3 files now should return the same ['md5_data'] as the
+ identical MP3 file outside the RIFF container
+ ¤ Name of LAME preset used (if available, needs LAME v3.90+)
+ returned in ['mpeg']['audio']['LAME']['preset_used'] and also as
+ part of ['audio']['encoder_options']
+ ¤ VQF module now sets ['audio']['encoder_options'] to i.e. CBR96
+ ¤ MP3 module now sets ['audio']['encoder_options'] on CBR files
+ and all LAME-encoded files
+ ¤ MPC module now sets ['audio']['encoder_options']
+ ¤ Monkey module now sets ['audio']['encoder_options']
+ ¤ AAC module now sets ['audio']['encoder_options'] to profile name
+ ¤ ASF module now sets ['audio']['encoder_options']
+ ¤ Ogg module adds ['audio']['encoder_options'] -b 128 on
+ Ogg Vorbis 1.0+ ABR files
+ ¤ Ogg module adds ['audio']['encoder_options'] -q N on
+ Ogg Vorbis 1.0+ VBR files 44k/48k sample rate/stereo files only.
+ ¤ Ogg module ['audio']['encoder_options'] "Nominal birate: 80k" to
+ other Ogg Vorbis files.
+ ¤ ID3v2 track number now returned as string (with leading zeros,
+ if present in data) rather than integer (thanks Plamen)
+ ¤ ASF module returns ['asf']['comments']['encoding_time_unix'] if
+ available (from WM/EncodingTime)
+ ¤ Fixed /demo/mysql.php and added some new features:
+ - encoder options
+ - ID3v2 "Encoded By"
+ - non-empty comments
+ - total entries in database summary (totals & averages)
+ - database version update
+ * Bugfix: 'UNICODE' iconv() charset changed to 'UTF-16LE' or
+ 'UTF-16BE' as appropriate
+ * Bugfix: iconv_fallback() function created in case iconv() fails
+ * Bugfix: fixed MD5 calls in demo/check.php
+ * Bugfix: reenabled detection of APE + Lyrics3 tags in same file
+ * Bugfix: ASF module now returns ID3v1 genre as string instead of
+ number - patch from Eugene Toder.
+ * Bugfix: ASF module now reads non-standard field names,
+ i.e. "date" as well as WM/Year - patch from Eugene Toder.
+ * Bugfix: ASF module now returns genre as-is if it is not a
+ standard ID3v1 genre (thanks wonderboy)
+ * Bugfix: Eliminated false-synch problem in MP3 module
+ * Bugfix: Fixed missing root ['bitrate'] for most formats
+ * Bugfix: ['audio']['compression_ration'] missing for MPC
+ (thanks WaldoMonster)
+ * Bugfix: NSV module died in 1.7.0b1
+ * Bugfix: ASF module died in 1.7.0b1 when WM/Picture preset
+ * Bugfix: ASF tracknumber incorrect when specified by WM/Track
+ rather than WM/TrackNumber (thanks jgriffiniiiØhotmail*com)
+ * Bugfix: MPEG audio+video playtime should now be pretty accurate
+ (ie within 0.1% variation at most)
+ (thanks mgrimmØhealthtvchannel*org)
+ * Bugfix: ID3v2 not being copied to ['tags'] in some cases
+ * Bugfix: LAME CBR files with Info tag were being incorrectly
+ flagged as VBR (thanks Jojo)
+ * Bugfix: LAME tag not being detected for LAME 3.90 (original)
+ Changed regex pattern match for MP3 to include 3rd byte for more
+ reliable/accurate pattern matching
+ Added duplicate-ID3v1 tag checking (two ID3v1 tags, one after the
+ other) that has been known to occur with iTunes
+ (thanks towbØtiscali*de)
+ Added instructions for enabling iconv() support under Windows
+ Removed some unneccesary debugging code
+ Suppressed duplicate PHP warnings for missing include files
+ Included some missing dependencies in various files
+ /demo/audioinfo.class.php now copies ['audio']['encoder_options']
+
+
+1.7.0b1: [2003-09-28] Allan Hansen
+ This beta version was not made by James Heinrich. It was made by
+ Allan Hansen <ahØartemis*dk> - please send bug reports on this
+ beta directly to me.
+
+ James Heinrich will release 1.7.0 final, but it may take some time
+ to work out the bugs from the major rewrite.
+
+ This version could be called getID3lite. It makes a lot of checks
+ optional and makes it easy to remove support for undesired formats
+
+ It also is more library-like. Older versions of getID3() declared
+ an incredible amount of global scope functions and defined several
+ constants. 1.7.0beta1 still declares constants, but they are all
+ prepended by GETID3_. It declares no global scope functions - they
+ are all wrapped into classes.
+
+ » Made getID3() depend on iconv library: compile PHP --with-iconv
+ » Created new directory structure
+ Moved all demos to demos/
+ Moved all getID3() files to getid3/
+ Renamed most files to module.something
+ Changed header in all module.something to explain what they do
+ Simply remove all modules you don't need
+ Wrapped all modules into classes
+ * Bugfix: Implemented misc patches from Eugene Toder
+ * Bugfix: Implemented misc patches from "six"
+ ¤ Added root key 'encoding'
+ ¤ Added prefix GETID3_ to all defined constants.
+ ¤ Wrapped getid3.php into getid3 class
+ ¤ Wrapped getid3.functions.php into getid3_lib class
+ Removed unused functions
+ Moved several functions away from getid3.functions.php and
+ into the files where they are actually used.
+ Renamed getid3.functions.php to getid3.lib.php
+ Moved getid3.rgad.php functions into getid3_lib
+ Moved getid3.getimagesize.php funcitons ingo getid3_lib
+ ¤ Moved getid3.ogginfo.php into ogg module
+ ¤ Combined GetTagOnly() and GetAllFileInfo() in method analyze
+ ¤ Removed redundant and unuseful root keys
+ 'file_modified_time' == filemtime($filename)
+ 'md5_file' == md5_file($filename)
+ 'exist' == file_exists($filename)
+ ¤ Changed root key ['tags'] from array of string to array of array
+ of comments.
+ Simplified code for detecting base path.
+ Removed ob_ from InitializeFilepointerArray(). That was really a
+ ugly HACK to get output from fopen. If user want the reason,
+ he should open the file himself!
+ Checking for APE tags before lyrics3 - makes Lyrics3 not depend
+ on APE tag. It seems to work on my test file.
+ Changed ['error'] and ['warning'] in multiple files to append to
+ array instead of appending to string. That simplified code in
+ getid3.php too.
+ Simplified clean-up procedure: simply remove all empty root keys
+ Setting tags in individual modules instead of main getid3.php
+ Made Bonk and ASF modules non-dependent on id3 modules - id3
+ optional.
+ Rewrote HandleAllTags() - simplified and convert comments to
+ desired encoding.
+ Replaced all calls to RoughTranslateUnicodeToASCII() in ASF module
+ with a TrimConvert() method. This uses iconv() for conversion.
+ It also converts from UNICODE instead of UTF-16BE, as the spec
+ says it should.
+ Replaced all calls to RoughTranslateUnicodeToASCII() in id3v2
+ module with iconv(). id3v2 module also reads
+ $ThisFileInfo['encoding'] and converts all comments to this
+ format. All other formats just add their comments in their
+ native charset, but every comment field in id3v2 can have a
+ different encoding, so this is needed.
+ Did same thing as above with ISO module. However - it does not
+ work. I need to find out how to specify big-endian unicode !=
+ UNICODING encoding name given to iconv().
+ Built-in assume mp3 format in getid3.php
+ Temporarily nuked root key ['comments'] and CopyCommentsToRoot()
+ Updated demo/audioinfo.class.php
+ Updated demo/check.php - some thing don't work!
+ Other demos are out of order!
+
+
+1.6.5: [October-06-2003] James Heinrich
+ » Added support for LiteWave (thanks supportØclearjump*com)
+ Ø Split out speedup info from ['OFR']['OFR']['compression'] into
+ ['OFR']['OFR']['speedup']
+ Ø If EXIF functions for JPEG not available, now warning not error
+ Ø ID3v2 track number now returned as string (with leading zeros,
+ if present in data) rather than integer (thanks Plamen)
+ * Bugfix: now correctly parses cbSize element of WAVEFORMATEX
+ structure (thanks supportØclearjump*com)
+ * Bugfix: ASF module now reads non-standard field names,
+ i.e. "date" as well as WM/Year - patch from Eugene Toder.
+ * Bugfix: ASF module now returns genre as-is if it is not a
+ standard ID3v1 genre (thanks wonderboy)
+ * Bugfix: ['audio']['compression_ration'] missing for MPC
+ (thanks WaldoMonster)
+ Prevent infinite loop in MP3 histogram if framelength == 0
+ Added wFormatTag values 0x00FF and 0x2001 - 0x2005
+ (thanks steveØheadbands*com)
+ Added "twos" and "sowt" FourCCs for Mac AIFC
+
+
+1.6.4: [June-30-2003] James Heinrich
+ » Added support for free-format MP3s
+ (thanks Sebastian Mares for the idea)
+ » Compressed (Flash 6+) SWF files are now handled properly
+ (thanks alan*cheungØalumni*ust*hk)
+ » Added DeleteLyrics3() to getid3.lyrics3.php
+ » Added FixID3v1Padding() to getid3.putid3.php
+ » Added new simple MP3-splicing sample file
+ (thanks tommybobØmailandnews*com for the idea)
+ New file: getid3.demo.joinmp3.php
+ » Moved all contents of getid3.putid3.php into either
+ getid3.id3v1.php or getid3.id3v2.php or getid3.functions.php as
+ appropriate
+ Removed file: getid3.putid3.php
+ ¤ ['error'] and ['warning'] keys now return as arrays, not strings
+ ¤ New root key for all files: ['file_modified_time'] (UNIX time)
+ ¤ getid3.demo.scandir.php renamed to getid3.demo.mysql.php
+ ¤ New demo file returns the MIME type only for a single file
+ (thanks adminØe-tones*co*uk for the idea)
+ New file: getid3.demo.mimeonly.php
+ ¤ Added check for valid ID3v1 padding (strings should be padded
+ with null characters but some taggers incorrectly use spaces).
+ A warning will be generated if padding is invalid. New boolean
+ key ['id3v1']['padding_valid'] indicates padding validity.
+ ¤ CleanUpGetAllMP3info() removes more useless root keys for
+ unknown-format files
+ ¤ Extended LAME information in ['mpeg']['audio']['LAME'] is now
+ only returned for LAME v3.90+
+ ¤ LAME-encoded MP3s now return
+ ['mpeg']['audio']['LAME']['long_version'] as well as
+ ['mpeg']['audio']['LAME']['short_version'] - these are identical
+ in LAME v3.90+ but older versions will report longer more
+ detailed version information if available
+ ¤ New Lyrics3 values: ['lyrics3']['raw']['offset_start'] and
+ ['lyrics3']['raw']['offset_end']
+ ¤ New optional parameter on getAPEtagFilepointer() to scan from a
+ defined offset rather than end-of-file to allow scanning of APE
+ tags before Lyrics3 tags
+ ¤ ['tag_offset_start'] and ['tag_offset_end'] are now present in
+ ['ape'], ['lyrics3'], ['id3v1'] and ['id3v2']
+ ¤ Numerous changes to the returned structure and content for La
+ files, including parsing the seektable (if applicable) and
+ parsing RIFF data occuring after the end of the compressed audio
+ data (notably RIFF comments)
+ (thanks mikeØbevin*de)
+ ¤ getSWFHeaderFilepointer() now has optional 3rd parameter
+ $ReturnAllTagData (default == false) which if set to true will
+ return data on all tags in ['swf']['tags']
+ ¤ ['swf']['bgcolor'] now returns the 6-character string
+ representing the background color in HTML hex color format
+ (thanks ubergeekØubergeek*tv)
+ ¤ ['swf']['header']['frame_delay'] is no longer returned
+ ¤ getQuicktimeHeaderFilepointer() now has two additional optional
+ parameters: $ReturnAtomData (default == true) and
+ $ParseAllPossibleAtoms (default == false). Setting
+ $ReturnAtomData to false will reduce the size of the returned
+ data array by unsetting ['quicktime']['moov'] before returning.
+ Leaving $ParseAllPossibleAtoms as false now suppresses parsing
+ of several atom types that contain very large tables of data
+ that are not typically useful. Atom type suppressed are:
+ stts, stss, stsc, stsz, and stco
+ (thanks ubergeekØubergeek*tv)
+ ¤ ['fileformat'] no longer set to 'id3' if ID3v1 or ID3v2 tag
+ detected but no other data format recognized
+ * Bugfix: La files now return the correct values for
+ ['avdataoffset'] and ['avdataend'] and therefore the correct
+ values for ['md5_data'] - note that ['md5_data'] values will not
+ match values from previous versions of getID3() - the previous
+ versions were incorrect
+ (thanks mikeØbevin*de)
+ * Bugfix: A temporary file was being created in the web server's
+ root directory (not DocumentRoot) each time ['md5_data'] was
+ calculated, and not removed due to lack of permissions. Temp
+ file is now created (as it was supposed to be) in the directory
+ of the file being examined, or the system temp directory, and
+ properly removed when done.
+ * Bugfix: Several incorrect values were being returned inside
+ ['mpeg']['audio']['LAME'] (thanks bouvigneØmp3-tech*org)
+ * Bugfix: SWF frame rates values were usually incorrect.
+ (thanks alan.cheungØalumni*ust*hk and ubergeekØubergeek*tv)
+ * Bugfix: ID3v2.2 files always flagged 4 bytes of invalid padding
+ (thanks marcaØmac*com)
+ * Bugfix: Lyrics3 without ID3v1 was not working properly
+ * Bugfix: Lyrics3, APE & ID3v1 can all now exist in the same file.
+ A warning is issued if APE comes after Lyrics3 (because Lyrics3-
+ aware taggers probably are not APE-aware and therefore won't be
+ able to find the Lyrics3 tag) (thanks mp3gainØhotmail*com)
+ * Bugfix: WriteAPEtag() now writes the APE tag before any Lyrics3
+ tags (if present) and removes any incorrect ones that are after
+ existing Lyrics3 tags (thanks mp3gainØhotmail*com)
+ * Bugfix: RIFF-WAVE file with incorrect NumberOfSamples values in
+ the 'fact' chunk no longer cause incorrect playtime calculation
+ (thanks stprasadØindusnetworks*com)
+ * Bugfix: getid3.demo.simple.php had undefined variables if the
+ file needed to be deep-scanned with assumeFormat
+ * Bugfix: fixed previously-incorrect ['avdataend'] values for APE
+ and Lyrics3 tags in some cases, which in some cases means that
+ ['md5_data'] is different than previously (now correct)
+ Much-improved detection of AAC-ADTS, which also means MP3
+ format detection should now be nearly twice as fast
+ Truncated AVIs and WAVs are now reported
+ Number of new features and bugfixes in getid3.demo.mysql.php
+ Quicktime 'meta' atoms now parsed, so Quicktime MP4 files can now
+ return artist, title, album, etc (thanks spunkØdasspunk*com)
+ Consolidated all comments processing functions (processing the
+ ['comments'] and ['tags'] keys) into HandleAllTags() which now
+ also checks to ensure that APE tags are really better than ID3v2
+ before using them in ['comments']
+ Known issue with Meracl ID3 Tag Writer v1.3.4 truncating last byte
+ of MP3 file when appending new ID3v1 tag now specifically noted
+ (rather than generic Probably Truncated File message)
+ getid3.demo.mysql.php now stores last-modified time for each file
+ getid3.demo.mysql.php is now case-sensitive for filenames
+ getid3.demo.mysql.php can generate M3U playlists of any of the
+ groups of files it can select (duplicate filenames, tag types,
+ etc.)
+ getid3.demo.mysql.php can now find mismatched tag contents and
+ filenames
+ getid3.demo.check.php now shows total number of errors & warnings
+ GetFileFormatArray() now matches actual patterns for MP3 files
+ based on the first two bytes of the file, rather than just the
+ first one
+ Simplified DeleteAPEtag() and made it work properly with Lyrics3
+
+
+1.6.3: [May-17-2003] James Heinrich
+ » Added support for Bonk (thanks ahØartemis*dk)
+ New file: getid3.bonk.php
+ » Added support for AVR (thanks ahØartemis*dk)
+ New file: getid3.avr.php
+ ¤ Contents of getid3.id3.php moved to getid3.id3v1.php
+ Removed file: getid3.id3.php
+ ¤ Contents of getid3.frames.php moved to getid3.id3v2.php
+ Removed file: getid3.frames.php
+ ¤ Returned data structure documentation improved and updated and
+ now stored in getid3.structure.txt rather than getid3.readme.txt
+ New file: getid3.structure.txt
+ ¤ Now including the GNU General Public License in the distribution
+ as getid3.license.txt
+ New file: getid3.license.txt
+ ¤ Added new, optional, parameter to WriteAPEtag() (and also
+ GenerateAPEtag()) which must be set to TRUE if the values you
+ are passing are already UTF8-encoded, otherwise all data is
+ encoded to UTF8 by default. For all ASCII/ANSI data this value
+ should be left at the defaul value of FALSE.
+ ¤ Added third, optional, parameter to getID3v2Filepointer() -
+ $StartingOffset (default == 0) which can parse an ID3v2 tag
+ in a file at a position other than the start-of-file.
+ ¤ ['video']['pixel_aspect_ratio'] now returned when known
+ ¤ AVI files with WMA audio now return ['audio']['dataformat']
+ of 'wma' rather than 'wav'
+ ¤ ASF-WMA files now return the artist value from WM/AlbumArtist
+ in ['comments']['artist'] (thanks msibbaldØsaebauld*com)
+ ¤ ASF-WMA files now return the 'author' value from
+ ['asf']['content_description'] in ['comments']['artist']
+ instead of ['comments']['author']
+ ¤ ASF-WMA files now return the 'description' value from
+ ['asf']['content_description'] in ['comments']['comment']
+ instead of ['comments']['description']
+ * Bugfix: APE tag writing with multiple values for a tag (more
+ than one ARTIST for example) was not being correctly written
+ (thanks ahØartemis*dk)
+ * Bugfix: CreateDeepArray() was returning an empty-string key as
+ the top-level returned value - ['iso']['files'] now directly
+ contains the file listing without an empty array in between.
+ * Bugfix: ID3v2 genreid was not being returned in some cases.
+ * Bugfix: APEv1 tags would generate error messages
+ * Bugfix: APE tags would sometimes show phantom second entry for
+ each item (title, artist, etc) with no data
+ * Bugfix: APE tag writing was not UTF8-encoding the data -
+ non-ASCII characters (above chr(127)) were being incorrectly
+ stored (thanks ahØartemis*dk)
+ * Bugfix: getid3.demo.scandir.php had undefined function error
+ * Bugfix: getid3.demo.scandir.php would not display list of files
+ with no tags
+ Added link to getid3.demo.check.php from list of specific-tags
+ files in getid3.demo.scandir.php
+
+
+1.6.2: [May-04-2003] James Heinrich
+ » New official mirror site for getID3() - http://www.getid3.org
+ » Added basic support for SWF (Flash) (thanks n8n8Øyahoo*com)
+ New file: getid3.swf.php
+ » Added experimental support for parsing the audio portion of
+ MPEG-video files. I don't have any actual documentation for
+ this, so this part is experimental and not guaranteed accurate,
+ but it seems to be working OK as far as I have been able to test
+ it. Bug reports (or even better - documentation!) are welcome at
+ info@getid3.org
+ » Added new simple directory-scanning sample file
+ New file: getid3.demo.simple.php
+ » getid3.demo.write.php now writes APE tags as well.
+ ¤ Renamed getid3.write.php to getid3.demo.write.php
+ ¤ Renamed audioinfo.class.php to getid3.demo.audioinfo.class.php
+ ¤ getid3.php now automatically includes the getid3.functions.php
+ function library file, no need to include it seperately.
+ ¤ getLyrics3Filepointer() has been changed to be consistant with
+ all the other similar function structures - the parameters have
+ changed. The old function has been renamed to getLyrics3Data()
+ ¤ Added DeleteAPEtag() function to getid3.ape.php
+ ¤ HandleID3v1Tag() now only handles ID3v1. Lyrics3 processing is
+ now done by HandleLyrics3Tag()
+ ¤ If BitrateHistogram is enabled in getOnlyMPEGaudioInfo() it now
+ also returns ['mpeg']['audio']['version_distribution'] showing
+ the number of frames of each MPEG version (1, 2 or 2.5) - all
+ frames *should* be of the same MPEG version
+ ¤ getID3v1Filepointer() always returns TRUE now, even if it didn't
+ find a valid ID3v1 tag
+ ¤ getOnlyMPEGaudioInfo() now looks for MPEG sync in the first 128k
+ bytes rather than the first 64k bytes
+ ¤ Added dummy function GetAllMP3info() to generate warning not to
+ use that deprecated function.
+ ¤ ['video']['codec'] is now 'MPEG' for all MPEG video files (this
+ will change to 'MPEG-1' or 'MPEG-2' as soon as I figure out how
+ to determine that) (thanks jigalØspill*nl)
+ ¤ ['mpeg']['audio']['LAME']['mp3_gain'] renamed to
+ ['mpeg']['audio']['LAME']['mp3_gain_db'] (gain in dB)
+ ¤ Added ['mpeg']['audio']['LAME']['mp3_gain_factor'] (gain as a
+ multiplication factor)
+ ¤ Added support for Preset and Surround Info bytes from LAME VBR
+ tag (http://gabriel.mp3-tech.org/mp3infotag.html)
+ * Bugfix: APE tag writing would put the string 'Array' for all
+ values rather than the actual data (thanks ahØartemis*dk)
+ * Bugfix: Warning now generated for VBR MPEG-video files because
+ getID3() cannot determine average bitrate. If you know of
+ documentation that would tell me how to do this, please email
+ info@getid3.org
+ * Bugfix: Replay Gain values from Vorbis comments are now
+ returned in ['replay_gain'] (and not in ['comments'])
+ (thanks ahØartemis*dk)
+ * Bugfix: Replay Gain values from APE comments are now correctly
+ returned in ['replay_gain'] (thanks ahØartemis*dk)
+ * Bugfix: getid3.demo.check.php is now case-insensitive when
+ assuming a format for a corrupted file if standard detection
+ does not identify the file type.
+ * Bugfix: RIFF comments were overwriting/suppressing ID3 comments
+ for RIFF-MP3 files (thanks wmØwofuer*com)
+ * Bugfix: RIFF-MP3 files with 'RMP3' chunks instead of 'WAVE' were
+ not being correctly identified.
+ * Bugfix: ID3v2 padding shorter than the length of an ID3v2 frame
+ header was not correctly detected
+ * Bugfix: getid3.demo.check.php now does in-depth scanning for MP2
+ and MP1 files the same as for MP3 files based on file extension
+ if a MPEG-audio structure isn't found immediately at the start
+ of the file
+ * Bugfix: removed condition where RIFF-WAV was being scanned for
+ MPEG-audio signature when it shouldn't be present (non-MP3 WAV)
+ * Bugfix: ASF files were not always showing correct audio datatype
+ * Bugfix: array_merge_clobber() and array_merge_noclobber() were
+ not being conditionally defined in getid3.functions.php
+ (thanks rich.martinØreden-anders*com)
+ * Bugfix: stream_numbers was not being correctly returned in
+ bitrate_mutual_exclusion_object chunks of ASF files
+ * Bugfix: Added support for 24kHz and 12kHz audio in ASF files
+ * Bugfix: Removed possible undefined offset error in MP3s where
+ cannot find synch before end of file
+ * Bugfix: Removed potential out-of-memory crash situation when
+ parsing Real files with chunks larger than the available memory
+ (thanks jigalØspill*nl)
+ * Bugfix: ID3v1 was incorrectly taking precedence over ID3v2 in
+ the ['comments'] array (thanks lionelflØwanadoo*fr)
+ * Bugfix: No longer calculates overall bitrate and playtime for
+ VBR MPEG video files based on the audio bitrate.
+ * Bugfix: AssumeFormat was not working properly
+ Added summary footer line to getid3.demo.check.php
+ Added '.mpeg' to the list of assume-format-from-filenames list in
+ getid3.demo.check.php
+ MPEG-video files now more reliably detected
+ A number of additional features have been added to
+ getid3.demo.scandir.php
+ Added many RIFF-AVI audio types and fourcc video types to the
+ lookup functions in getid3.riff.php
+ Now identifes files with Lyrics3 v1 tags that are of incorrect
+ length (v1 Lyrics3 is supposed to be 5100 bytes long, but
+ [unknown program] writes variable-length tags (which is illegal
+ for Lyrics3 v1)). getID3() now correctly parses these tags and
+ issues a warning.
+ Split GetFileFormat() to GetFileFormat() and GetFileFormatArray()
+ HTML colors in getid3.demo.check.php are now defined as constant
+ variables at the top of the file (if you want to change them)
+ Added support for OptimFROG v4.50x (non-alpha) (new header fields)
+ (thanks floringhidoØyahoo*com)
+ Added support for Lossless Audio v0.4 (thanks mikeØbevin*de)
+
+
+1.6.1: [March-03-2003] James Heinrich
+ » Added support for writing APE v2.
+ WriteAPEtag() in getid3.ape.php
+ NOTE: APE v1 writing support will *not* be added to future
+ versions of getID3()
+ (thanks ahØartemis*dk and adamØphysco*com for the idea)
+ » Added support for AIFF (Audio Interchange File Format) including
+ AIFF, AIFC and 8SVX (thanks ahØartemis*dk for the idea)
+ Removed file: getid3.aiff.php
+ » Added support for OptimFROG (v4.50a and v4.2x)
+ (thanks ahØartemis*dk for the idea)
+ New file: getid3.optimfrog.php
+ » Added support for WavPack (thanks ahØartemis*dk for the idea)
+ » Added support for LPAC (thanks ahØartemis*dk for the idea)
+ » Added support for NeXT/Sun .au format
+ New file: getid3.au.php
+ » Added support for Creative SoundBlaster VOC format
+ New file: getid3.voc.php
+ » Added support for the BWF (Broadcast Wave File) RIFF chunks
+ "bext" and "MEXT" (thanks Ryan and njhØsurgeradio*co*uk)
+ » Added support for the CART (Broadcast Wave File) RIFF chunks
+ (thanks Ryan)
+ » Added getid3.demo.scandir.php - a sample recursive scanning demo
+ that scans every file in a given directory, and all sub-
+ directories, and stores the resulting data in MySQL database,
+ and then displays a list of duplicate files based on md5_data
+ ¤ ['md5_data_source'] now contains the MD5 value for the original
+ uncompressed data for formats that store that information
+ (currently only FLAC v0.5+). ['md5_data'] (if chosen to be
+ calculated) will contain the calculated MD5 value for the
+ compressed file. To check if 2 files are identical in every way,
+ including all comments: compare ['md5_file']. To check if two
+ files were compressed from the same source file: compare
+ ['md5_data_source']. To check if the compressed audio/video data
+ of two files is identical, even if comments or even the
+ container file format is different (MP3 in RIFF container,
+ FLAC in Ogg container, etc): compare ['md5_data'].
+ ¤ ['md5_data'] for 8-bit WAV files is now calculated based on a
+ converted version of the data from unsigned to signed (MSB
+ inverted) to match the MD5 value calculated by FLAC
+ ¤ New optional parameter added to GetAllFileInfo() -
+ $MD5dataIfMD5SourceKnown (default: false). If false the md5_data
+ value will NOT be calculated for files (such as FLAC) that have
+ ['md5_data_source'] set, even if $MD5data == true.
+ (thanks ahØartemis*dk)
+ ¤ getid3.check.php renamed to getid3.demo.check.php
+ ¤ Added GetTagOnly() function to getid3.php - similar to
+ GetAllFileInfo() except only takes a filename as a parameter and
+ only returns ID3v2, APE, Lyrics3 and ID3v1 tag information - no
+ attempt is made to parse the data contents of the file at all.
+ (thanks Phil for the idea)
+ ¤ Added ['audio']['lossless'] and ['video']['lossless'] for all
+ formats (when known). Both are boolean values - true means the
+ data is lossless-compressed, false means the data is lossy-
+ compressed.
+ ¤ Added ['audio']['compression_ratio'] and/or
+ ['video']['compression_ratio'] for all formats. Returns a number
+ (usually) less than 1, where 1 represents no compression and 0.5
+ represents a compressed file half the size of the original file
+ ¤ Added ['video']['bits_per_sample'] to all video formats (when
+ known)
+ ¤ Added ['video']['frame_rate'] to all video formats (when known)
+ ¤ ['fileformat'] set to 'mp1' or 'mp2' instead of 'mp3' when
+ ['audio']['dataformat'] is one of those (thanks ahØartemis*dk)
+ ¤ Added 4th parameter to md5_data(), $invertsign, which will invert
+ the MSB of each byte before MD5'ing. This is needed for 8-bit
+ WAV files because FLAC calculates the stored MD5 value on
+ signed data rather than the original byte values. ['md5_data']
+ of an 8-bit WAV will now match the ['md5_data_source'] value
+ (thanks lichvarmØphoenix*inf*upol*cz)
+ ¤ ['ape']['items']['data'] and ['ape']['items']['data_ascii'] now
+ contains an array of values, if the tag contains UTF-8 text (as
+ opposed to binary data)
+ ¤ ['mpeg']['audio']['bitratemode'] renamed to
+ ['mpeg']['audio']['bitrate_mode']
+ * Bugfix: Removed potential bug that could replace all MP3 file
+ contents with only the new ID3v2 tag in getid3.putid3.php
+ * Bugfix: md5_data values calculated for RIFF (WAV, AVI) files
+ were incorrect (thanks ahØartemis*dk)
+ * Bugfix: MP3 data in an MP4 wrapper fileformat could not identify
+ bitrate (thanks ahØartemis*dk)
+ * Bugfix: ['audio'] and/or ['video'] keys would sometimes get
+ removed even if not empty
+ * Bugfix: Prevented creation of null entries in
+ ['RIFF']['WAVE']['INFO'] if a comment entry was not present
+ * Bugfix: Potential infinite-loop condition in getid3.ogg.php
+ (thanks afshin.behniaØsbcglobal*net)
+ * Bugfix: Ogg files with illegal ID3v1 (and/or APE or Lyrics3)
+ tags were not finding the last Ogg page
+ (thanks afshin.behniaØsbcglobal*net)
+ * Bugfix: replay-gain values not properly set from LAME tag
+ * Bugfix: RIFF-MP3 had incorrect md5_data
+ * Bugfix: the LAME DLL CBR problem of not re-writing the LAME
+ frame at the beginning of the data is now detected for MP3s
+ with ID3v2 tags as well
+ * Bugfix: APE tags with multiple values (ie multiple entries in
+ the "artist" tag) are now shown properly in ['ape']['items']
+ * Bugfix: fixed condition where APE tag with no ID3v1 tag could be
+ mistaken for APE tag with ID3v1 (and incorrectly parsed)
+ * Bugfix: added warning if ID3v2 frame has zero-length data
+ (thanks cmassetØclubinternet*fr)
+ * Bugfix: getid3.frames.php looking for non-existant key in USER
+ frames
+ Improved detection of RIFF-MP3 data. [unknown program] encodes
+ RIFF-WAV data with a chunk name of 'RMP3' instead of the
+ standard 'RIFF'
+ Encoder now returned in both ['comments'] and ['audio']['encoder']
+ for RIFF-WAV files with an INFO.ISFT chunk
+ Generate a warning for FLAC files encoded with v0.3 or v0.4
+ because audio_signature is not calculated during encoding
+ (thanks ahØartemis*dk)
+ Modified getid3.check.php to display md5_data_source as well as
+ md5_file and md5_data if display-MD5 mode is selected
+ Modified getid3.check.php to assume-format based on file extension
+ in browse mode if fileformat is found to be 'id3' (formerly only
+ if the fileformat was null)
+ Changed scaling of BitrateColor() from representing 1-256kbps to
+ representing 1-768kbps for better display of high-bitrate files,
+ specifically lossless-compressed CD-audio (FLAC, LA, etc)
+
+
+1.6.0: [January-30-2003] James Heinrich
+ » Added support for OggFLAC (FLAC data stored in an Ogg container)
+ (thanks ahØartemis*dk for the idea)
+ » Added support for Speex (the data stored in an Ogg container)
+ » Comments are now available in the root 2-dimensional array
+ ['comments'] - each entry in this array will contain one or more
+ strings. For example, if there are two artists then
+ ['comments']['artist'][0] will contain the first one and
+ ['comments']['artist'][1] the other. All keys are forced
+ lowercase. Comments will be stored in the ['comments'] array in
+ this order of precedence:
+ 1) Native format tags (ASF, VQF, NSV, RIFF, Quicktime, Vorbis)
+ 2) APE tags
+ 3) ID3v2
+ 4) Lyrics3
+ 5) ID3v1
+ Lower-priority tags will not overwrite or append existing values
+ of higher-priority tags (for example, 'artist' in ID3v1 will be
+ ignored if already specified in APE), but missing values will be
+ filled in (for example, if 'album' is specified in ID3v2 but not
+ in APE, it will be included in the ['comments'] array).
+ Note: Root keys (['title'], ['artist'], etc) are NOT available
+ in this or future versions of getID3().
+ (thanks ahØartemis*dk)
+ » MD5 hashes are now available for all formats for both the entire
+ file (['md5_file']) and the portion of the file containing only
+ the audio/video data, stripped of all prepended/appended tags
+ like ID3v2, ID3v1, APE, etc - ['md5_data']
+ (thanks ahØartemis*dk for alternate md5_file() function that
+ runs on UNIX system running PHP < 4.2.0)
+ NOTE: Ogg files require the use of vorbiscomment to obtain the
+ md5_data value. vorbiscomment must be downloaded from
+ http://www.vorbis.com/download.psp and placed in the getID3()
+ directory. All Ogg formats (Vorbis, OggFLAC, Speex) are affected
+ by this problem, but only OggVorbis files can be processed with
+ vorbiscomment. OggFLAC and Speex files will be processed by
+ getID3(), but this may result in an incorrect value for md5_data
+ in the event that VorbisComments are larger than 1 page (4-8kB).
+ NOTE: md5_data for Ogg will not work if PHP is running in Safe
+ Mode
+ » There is now a wrapper class available, written by Allan Hansen,
+ which should simplify extracting most common basic information
+ (such as format, bitrate, comments).
+ New file: audioinfo.class.php
+ » OggWrite() in getid3.ogginfo.php has been replaced with a new
+ version that uses vorbiscomment to write the comments, because
+ of a reported bug that can corrupt OggVorbis files such they
+ cannot be played.
+ NOTE: Ogg comment writing now requires the use of vorbiscomment
+ which must be downloaded from http://www.vorbis.com/download.psp
+ and placed in the getID3() directory.
+ NOTE: Ogg comment writing will not work if PHP is running in
+ Safe Mode
+ ¤ New root key ['tags'] is now always returned for all formats.
+ It is an array that may contain any of:
+ * Native format tags: 'vqf', 'riff', 'vorbiscomment', 'asf',
+ 'nsv', 'real', 'midi', 'zip', 'quicktime'
+ * Appended data tags: 'ape', 'lyrics3', 'id3v2', 'id3v1'
+ ¤ New root key ['audio'] is an array containing any or all of:
+ codec, channels, channelmode, bitrate, bits_per_sample,
+ dataformat, bitrate_mode, sample_rate, encoder
+ Note: This replaces several root keys, including:
+ bitrate_audio, bits_per_sample, frequency, channels
+ ¤ New root key ['video'] is an array containing any or all of:
+ bitrate_mode, bitrate, codec, resolution_x, resolution_y,
+ resolution_y, frame_rate, encoder
+ Note: This replaces several root keys, including:
+ bitrate_video, resolution_x, resolution_y, frame_rate
+ ¤ ['id3']['id3v1'] has moved to ['id3v1']
+ ¤ ['id3']['id3v2'] has moved to ['id3v2']
+ ¤ ['audiodataoffset'] and ['audiodataend'] have been renamed to
+ ['avdataoffset'] and ['avdataend'] respectively
+ ¤ GetAllMP3info() has been changed to GetAllFileInfo() with a
+ different parameter list ($allowedFormats is no longer a
+ parameter). Check your code where you're calling
+ GetAllMP3Info() - you will need to change both the function
+ name and the parameter list if you pass more than 2 parameters
+ ¤ All formats now return ['audio']['dataformat'] and/or
+ ['video']['dataformat'] where appropriate - this goes along with
+ ['fileformat'] - ['fileformat'] will return the actual structure
+ of the file, whereas ['dataformat'] will return the format of
+ the data inside that structure. For example, an Ogg file can
+ contain Vobis data (normal), or it can contain FLAC data in the
+ Ogg container format. In that case, ['fileformat'] would be
+ 'ogg', but ['dataformat'] would be 'flac'.
+ Note: this means that WAV and AVI files now return a
+ ['fileformat'] of 'riff' rather than 'wav' or 'avi'.
+ ¤ ['filesize'] is no longer returned for files larger than 2GB
+ because PHP does not support large file access. Attempting to
+ parse a file larger than 2GB will result in a message stored in
+ ['error'] and ['filesize'] not set.
+ ¤ APEtag, ID3v1, and ID3v2 are now supported on ALL multimedia
+ files - even if illegal by format. Ogg will return warning if
+ ID3/APE tags are present. (thanks ahØartemis*dk)
+ ¤ All files: non-critical errors are now returned in the root key
+ ['warning'] rather than ['error'] (only critical errors that
+ prevent getID3() from correctly parsing the file are returned in
+ ['error'] (thanks ahØartemis*dk)
+ ¤ Renamed all references to $MP3fileInfo to $ThisFileInfo
+ ¤ Joliet now supported for ISO-9660.
+ ['iso']['supplementary_volume_descriptor'] is now returned, if
+ available, and ['iso']['files'] will contain ASCII equivalents
+ of the Unicode directory structure & filenames stored.
+ ¤ Moved Monkey's Audio code from getid3.ape.php to seperate file.
+ New file: getid3.monkey.php
+ ¤ Added new keys for ISO-9660: ['name_ascii'] for directories,
+ ['file_identifier_ascii'] for files
+ ¤ Added root key ['track'] for CD-audio files
+ ¤ Ogg/Vorbis-comment files now have comments returned inside
+ ['ogg']['comments_common'] as an array of strings, rather than
+ simple strings in ['ogg']
+ ¤ Quicktime files now have comments returned inside
+ ['quicktime']['comments'] as an array of strings, rather than
+ simple strings in ['quicktime']
+ ¤ ['mime_type'] is a new root key returned for all supported
+ formats (thanks ahØartemis*dk)
+ ¤ ['fileformat'] now returns 'mp1' instead of 'mp3' for MPEG-1
+ layer-I audio files (thanks ahØartemis*dk)
+ ¤ ['mpeg']['audio']['bitratemode'] now returns lowercase
+ ¤ MPEG-4 audio files which consist of MP3 data wrapped in a
+ Quicktime fileformat will now return the usual data in
+ ['mpeg']['audio']
+ ¤ Type-1 DV AVIs are now supported
+ ¤ DV AVIs will return 1 or 2 in ['RIFF']['video'][x]['dv_type']
+ ¤ Changed ['fileformat'] from 'mpg' to 'mpeg' for MPEG video files
+ ¤ ASF comments are now stored in ['asf']['comments'] instead of
+ ['asf']
+ ¤ RealMedia chunk data is now returned inside ['real']['chunks']
+ instead of ['real']
+ ¤ ['replay_gain'] now properly populated from APE tags
+ ¤ Added support for ASF_Old_ASF_Index_Object in ASF files
+ (thanks ahØartemis*dk)
+ ¤ AAC-ADTS files now return ['aac']['bitrate_distribution']
+ ¤ ParseVorbisComments() has been replaced with
+ ParseVorbisCommentsFilepointer() (with different parameters)
+ ¤ All references to any key ['frequency'] are now ['sample_rate']
+ ¤ Moved ID3v2 comments from ['id3v2'] into common root
+ ['comments'] structure, and now returns more values than before
+ * Bugfix: ['iso']['files'] and ['zip']['files'] could potentially
+ contain duplicate entries (in a numeric-indexed array) for files
+ if the directory structure specifies files multiple times.
+ Entries are now guaranteed unique, with the last entry for the
+ file overwriting any former ones.
+ * Bugfix: RIFF parsing had numerous issues, including:
+ - large AVIs would take a very very long time to parse
+ - chunks with odd (not even) sizes would cause the parser fail
+ - video and/or audio codecs not always identified
+ The ParseRIFF() function has been completely rewritten and fixes
+ all known issues with RIFF parsing. Users are, however,
+ encouraged to double-check output of any parsed (AVI/WAV/CDDA)
+ files.
+ * Bugfix: Modified getid3.riff.php to return correct total
+ bitrates for AVIs with multiple audio streams
+ * Bugfix: GetFileFormat() was not creating array structure
+ correctly (thanks ahØartemis*dk)
+ * Bugfix: LAME tag for MP3s can only specify up to 255kbps, so any
+ files with actual CBR bitrate of >=256 were reported incorrectly
+ * Bugfix: Lyrics3 synched lyrics were not being correctly returned
+ * Bugfix: CreateDeepArray() was broken for non-nested cases, which
+ meant ZIP and ISO ['files'] structures were broken
+ * Bugfix: Incorrect pattern matching for ZIP files meant no zip
+ files were being detected as such
+ * Bugfix: AAC-ADIF was returning an incorrect number of channels
+ (too few) in some cases (thanks ahØartemis*dk)
+ * Bugfix: Vorbis comments were returning an incorrect value for
+ ['dataoffset'] in some cases
+ * Bugfix: MPEG video ['marker_bit'] and ['vbv_buffer_size'] were
+ incorrect
+ * Bugfix: ['playtime_string'] could potentially have a value of
+ x minutes and 60 seconds (ie 3:60 instead of 4:00)
+ Added support for FLAC cuesheets (FLAC 1.1.0+)
+ (thanks ahØartemis*dk)
+ Improved parsing speed in MP3, MP2 and AAC (thanks ahØartemis*dk)
+ Extra error-checking added to try and identify corrupt files for
+ most audio formats (thanks ahØartemis*dk)
+ More accurate playtime calculation for RealMedia
+ (thanks ahØartemis*dk)
+ Changed all relevant files to use ['audiodataoffset'] and
+ ['audiodataend'] rather than ['filesize'] where appropriate
+ (thanks ahØartemis*dk)
+ Added text encoding type 255 as a duplicate of UTF-16BE but with
+ Big-Endian rather than Little-Endian byte order
+ Added many RIFF-AVI audio types and fourcc video types to the
+ lookup functions in getid3.riff.php
+ Added numerous new known GUIDs to getid3.asf.php
+ Added PoweredBygetID3() function to easily get a "powered by"
+ string with the current getID3() version.
+ Added "Morgan Multimedia Motion JPEG2000" (MJ2C), "DivX v5" (DX50)
+ and "XviD" (XVID) codecs to list of known codecs in
+ getid3.riff.php
+ Changed GETID3_INCLUDEPATH path seperators to forced /
+ (from \ for Windows)
+ Modified getid3.check.php to only change \ directory seperators to
+ / on Windows operating systems
+ Modified getid3.check.php to handle larger-than-2GB files (which
+ now do not return a filesize)
+ Modified getid3.check.php to handle ['dataformat_audio'] and
+ ['dataformat_video']
+ Modified getid3.check.php to show a list of present tags in one
+ column rather than one column for each of ID3v1, ID3v2, etc
+ Modified getid3.check.php to show MD5 values. Initially disabled
+ but can be enabled for a directory with a click. md5_file is
+ always calculated when displaying detailed info about a single
+ file; md5_data is calculated if the file is < 50MB
+ Modified getid3.check.php to show errors and warnings. Details are
+ visible with a mouseover or a click.
+ Changed getid3.check.php to use SafeStripSlashes instead of a
+ manual conditional directory name replacement for special
+ characters
+ Added sample recursive scanning sample code to getid3.readme.txt
+ (thanks lipisinØmail*ru for the idea)
+
+
+1.5.7: [January-10-2003] James Heinrich
+ » Added support for ISO 9660 (CD-ROM image) format. Most-useful
+ data is directory structure returned under ['iso']['files']
+ Note: Only ISO-9660 supported, not (yet) Joliet extension
+ (thanks nebula_djØsofthome*net for the idea)
+ New file: getid3.iso.php
+ ¤ ZIP files are now parsed by getID3() itself without relying on
+ built-in PHP functions and/or ZZipLib support.
+ (thanks Vince for the idea)
+ ¤ ZIP files now return a simple directory listing with filename
+ and filesize info only under ['zip']['files'].
+ Note: empty subdirectories will note appear in here, only files
+ and non-empty subdirectories. Information for all entries,
+ including empty subdirectories, is available under
+ ['zip']['central_directory'] (or under ['zip']['entries'] if the
+ Central Directory cannot be located (usually due to a trucated
+ file).
+ ¤ RIFF-WAV files with MP3 data (or MP3s with RIFF headers, if you
+ want to think of it that way) now have the MPEG audio portion
+ scanned and the usual data returned in ['mpeg']['audio'] if the
+ RIFF audio codec has wFormatTag of "85" (identified by getID3()
+ as "MPEG Layer 3")
+ (thanks ahØartemis*dk for the idea)
+ ¤ EXIF data (if present) is returned for JPEG files under
+ ['jpg']['exif'] (thanks nebula_djØsofthome*net)
+ ¤ ['filepath'] now returned for all files with the directory part
+ of the full filename.
+ ¤ ['filenamepath'] is now returned for all files (equivalent to
+ ['filepath'].'/'.['filename'])
+ * Bugfix: ['id3']['id3v2'][<framename>]['dataoffset'] was wrong
+ * Bugfix: MP3s tagged with iTunes have an invalid comment field
+ frame name ('COM ' - should be 'COMM') but the data is valid
+ otherwise; the frame is now renamed to 'COMM' and parsed
+ normally (with the error noted in ['error'])
+ (thanks kheller2Ømac*com for the sample file)
+ * Bugfix: Some ASF/WMA audio files were not being identified as
+ any format (thanks ahØartemis*dk)
+ * Bugfix: Warning now generated and ASCII format assumed for
+ invalid text encoding values in ID3v2
+ * Bugfix: Changed ZIP detection pattern from 'PK' to 'PK\x04\x03'
+ * Bugfix: Ogg/FLAC files with large Vorbis comments were dying in
+ an infinite loop with lots of error messages due to missing $fd
+ parameter on ParseVorbisComments() (thanks ahØartemis*dk)
+ * Bugfix: ['data'] and ['image_mime'] were being returned for all
+ Ogg comments even if they were not images for versions of PHP
+ that have image_type_to_mime_type() built in (ie PHP 4.3.0+)
+
+
+1.5.6: [December-31-2002] James Heinrich
+ » Added support for NSV (Nullsoft Streaming Video)
+ (www.nullsoft.com/nsv/)
+ (thanks demonØsoundplanet*com for the idea)
+ New file: getid3.nsv.php
+ » Added support for CD-audio track files (track01.cda etc)
+ ¤ Added standard ['frame_rate'] root value when known (AVI, NSV,
+ MPEG-video)
+ ¤ ASF files now report ['fileformat'] of:
+ 'wmv' when Windows Media Video codec v7/v8/v9 is used;
+ 'wma' when any 'Windows Media Audio' named audio codec is used
+ and no video stream is present;
+ 'asf' in all other cases (audio-only, video-only, or both)
+ ¤ Removed support for ZIP functions (will be rewritten to not
+ require ZZIPlib support in future versions)
+ ¤ Added function SafeStripSlashes() as a drop-in replacement for
+ stripslashes(), but that only strips slashes if magic_quotes_gpc
+ is set
+ ¤ Removed support for remote file scanning (HTTP / FTP)
+ ¤ Added ['aac']['frames'] (number of AAC frames in file)
+ ¤ Added ['mpeg']['audio']['frame_count'] when a bitrate histogram
+ is created
+ ¤ Average bitrate for VBR MP3/MP2 is calculated from actual counts
+ of frames of various bitrates (rather than relying on the header
+ values or filesize) when a bitrate histogram is created
+ ¤ RecursiveFrameScanning() split out into seperate function
+ (getid3.mp3.php)
+ ¤ Removed old function getMP3header() from getid3.mp3.php
+ ¤ Changed default MPEG_VALID_CHECK_FRAMES (number of mp3 frames
+ scanned to ensure a valid audio sequence has been located) from
+ 10 to 25. This means scanning will be slightly slower, but more
+ reliable/accurate
+ * Bugfix: ID3v2.2 - valid frame names not correctly detected
+ (thanks maeckerØweb*de for the sample file)
+ * Bugfix: ID3v2.2 - valid padding not correctly detected
+ (thanks maeckerØweb*de for the sample file)
+ * Bugfix: MIDI files with flat key signatures were not being
+ correctly reported (thanks alexleeisØshaw*ca for sample file)
+ * Bugfix: now returns message in ['error'] if file does not exist
+ * Bugfix: ['RIFF']['video'][x]['codec'] wasn't always being
+ correctly populated
+ * Bugfix: ['bitrate'] was incorrect for multi-stream RealMedia
+ * Bugfix: ['playtime_seconds'] was sometimes null or incorrect
+ for multi-stream RealMedia
+ * Bugfix: ChannelTypeID was incorrect in RVA2 ID3v2.4 frames
+ * Bugfix: Fixed potential divide-by-zero error for corrupt FLAC
+ files (thanks ahØartemis*dk)
+ * Bugfix: AAC-ADTS was not returning ['bitrate_mode'] unless
+ $ReturnExtendedInfo was TRUE (thanks ahØartemis*dk)
+ * Bugfix: LAME-encoded CBR MP3s now properly identified as CBR
+ with correct bitrate (thanks ahØartemis*dk)
+ * Bugfix: VBR MP2 (or headerless MP3) is now identified as VBR
+ rather than CBR. Note: to obtain VBR bitrate for headerless
+ files, the entire file is scanned and a histogram distribution
+ of bitrates is created, and the average bitrate calculated from
+ that. (thanks ahØartemis*dk for sample file)
+ Added support for DSIZ chunks in VQF, and checks to make sure size
+ of audio data matches DSIZ value, if present
+ (thanks ahØartemis*dk for sample file)
+ Rewrote GetAllMP3info() - removed some unneccesary code, changed
+ format-detection routine from ParseAsThisFormat() to
+ GetFileFormat() to allow for more flexible format parsing
+ (needed for ISO CD-ROM images, helpful for Quicktime and others)
+ Changed references in all files from string-cast indexes: ["$i"]
+ to non-cast indexes: [$i] where appropriate
+ Put a sans-serif 9pt style on all text in getid3.check.php
+ getAACADTSheaderFilepointer() now return TRUE if synch is lost
+ after the first frame has been successfully parsed (previously
+ it would return FALSE if synch was lost at any time, meaning the
+ file is most likely MP3, which was incorrect)
+ (thanks ahØartemis*dk for sample file)
+ Speed improvement code changes to getid3.mp3.php (up to 24% faster
+ in some cases) (thanks ahØartemis*dk for the code)
+ Changed all include_once() to require_once()
+
+
+1.5.5: [November-25-2002] James Heinrich
+ » Added support for La (Lossless Audio - www.lossless-audio.com)
+ (thanks ahØartemis*dk for the idea)
+ New file: getid3.la.php
+ ¤ Moved lookup functions from getid3.lookup.php to the files where
+ they are used.
+ New file: getid3.id3.php
+ New file: getid3.rgad.php
+ Removed file: getid3.lookup.php
+ ¤ getID3v1Filepointer() returns FALSE if ID3v1 tag not found
+ ¤ Added new paramter "ReturnExtendedInfo" to the function
+ getAACADTSheaderFilepointer() in getid3.aac.php which now
+ defaults to FALSE - if TRUE then the data for every frame is
+ returned (containing aac_frame_length, adts_buffer_fullness and
+ num_raw_data_blocks, which aren't usually very useful). Speed
+ improvement with FALSE is about 35%.
+ ¤ Now returns fopen() errors in ['error'], for example if a remote
+ file is not accessible.
+ ¤ Changed default number of MP3 audio frames to scan to determine
+ if a valid stream has been found from 5 to 10, now also defined
+ as a constant at the top of getid3.mp3.php This will result in
+ slightly slower MP3 parsing, but greater reliability in
+ detecting false/invalid/corrupted VBR headers.
+ ¤ fopen() errors now displayed in getid3.putid3.php
+ (thanks miguel.dieckmannØhamburg*de)
+ ¤ Added 4th parameter to decodeMPEGaudioHeader() $ScanAsCBR which
+ will force an MP3 audio frame sequence to be force-scanned in
+ CBR mode. You should never need to call this directly, it's only
+ used internally to scan for MP3 files that have an illegal VBR
+ header with CBR data. (thanks fletchØpobox*com)
+ * Bugfix: ASF_Marker_Object in getid3.asf.php was always returning
+ an error in non-existant "reserved_1" and failing
+ * Bugfix: VBR bitrate calculations in getid3.mp3.php only occur if
+ ['mpeg']['audio']['VBR_frames'] is defined.
+ (thanks fletchØpobox*com)
+ * Bugfix: getid3.putid3.php no longer deletes original MP3 if
+ ID3v2 tag writing fails (thanks miguel*dieckmannØhamburg*de)
+ * Bugfix: incorrect order of if-statement error messages in
+ getid3.putid3.php (thanks miguel*dieckmannØhamburg*de)
+ getid3.asf.php now notes the error and continues parsing rather
+ than failing when it encounters an error parsing a chunk
+ Now actually scan 1000 frames for AAC ADTS as reported in the
+ v1.5.4 changelog, rather than 100. (thanks ahØartemis*dk)
+ Improved scanning speed in getAACADTSheaderFilepointer() by ~30%
+ (thanks ahØartemis*dk for the fix)
+ Added FileSizeNiceDisplay() function to getid3.functions.php for
+ formatting filesize output in kB, MB, GB, etc.
+
+
+1.5.4: [October-07-2002] James Heinrich
+ » Added support for Quicktime.
+ New file: getid3.quicktime.php
+ » Added support for AAC files, both ADTS and ADIF header formats.
+ ADIF format is a pain because it's very similar to standard MP3
+ header format, and it's hard to distinguish between the two. I
+ have tried to make the detection accurate, but I have a limited
+ number of AAC test files to play with so if you have an AAC file
+ that gets detected as MP3/MP2 (or vice-versa), please send me
+ the details via email at infoØgetid3Øorg
+ ADTS format is very slow to parse because to get the bitrate of
+ VBR files the whole file has to be stepped through frame by
+ frame (getID3() scans up to the first 1000 frames and assumes
+ that to be close enough).
+ Note: I would suggest commenting out support for AAC (see top of
+ GetAllMP3info() function in getid3.php) unless you need it.
+ (thanks jfaulØgmx*de for the idea and sample Delphi source code)
+ New file: getid3.aac.php
+ » Added bitrate distribution analysis option for MP3 VBR files. A
+ new boolean parameter for getOnlyMPEGaudioInfo() enabled this
+ feature which steps through the MP3 file frame by frame and
+ counts how many frames of each bitrate exist. This information
+ is returned in ['mpeg']['audio']['bitrate_distribution']
+ Caution: this feature is very inefficient for large files and
+ takes a very long time and does lots of disk I/O. Use with care.
+ ¤ Changed layout of allowedFormats in GetAllMP3info() function in
+ getid3.php to allow easy removal of support for any of the
+ supported format. As stated above, I recommend commenting out
+ AAC unless needed.
+ ¤ Added ['flac']['compressed_audio_bytes'],
+ ['flac']['uncompressed_audio_bytes'], and
+ ['flac']['compression_ratio']
+ ¤ Replaced FXPT2DOT30toFloat() function with FixedPoint2_30()
+ * Bugfix: getid3.mpc.php was slightly miscalculating the number of
+ samples, therefore also bitrate and playtime
+ (thanks ahØartemis*dk for the fix)
+ * Bugfix: MonkeyCompressionLevelNameLookup() didn't know about
+ 'insane' compression (thanks ahØartemis*dk for the fix)
+ * Bugfix: MonkeySamplesPerFrame() was incorrect for MAC v3.95+
+ (thanks ahØartemis*dk for the fix)
+ * Bugfix: getid3.check.php wasn't processing the assumeFormat
+ directive when (register_globals == off)
+ * Bugfix: detecting of synch pattern for MP3 files with invalid
+ data at the beginning wasn't always correct, also meant possible
+ incorrect bitrate/duration/etc info for such corrupt files.
+ getid3.functions.php now includes a replacement utf8_decode()
+ function for those PHP installations that are not configured
+ with the --with-xml option. (thanks stephaneØtekartists*com)
+
+
+1.5.3: [September-30-2002] James Heinrich
+ » Added support for VQF. (thanks mtØmansonthomas*com for the idea)
+ New file: getid3.vqf.php
+ » Added support for FLAC. Comments, if present, are returned under
+ ['ogg'] because they follow the Ogg Vorbis structure standard.
+ New file: getid3.flac.php
+ ¤ OS/2-format bitmaps are now correctly interpreted. The format of
+ the bitmap is now returned in ['bmp']['type_os'] and
+ ['bmp']['type_version']. OS/2 bitmaps can be v1 or v2, Windows
+ can be v1, v4 or v5
+
+
+1.5.2: [September-25-2002] James Heinrich
+ » Support for RealMedia (audio & video) added
+ Note: only tested on G2 and v5 audio and video files - if anyone
+ has older and/or newer sample files, please test it and/or send
+ me the sample files.
+ (thanks stephaneØtekartists*com for idea)
+ New file: getid3.real.php
+ » Support for BMP added. Palette and pixel data can optionally be
+ extracted as well - this is slow and generally unneccesary, but
+ the option is there if you need it. Also includes PlotBMP()
+ which will take the extracted pixel data and output it as a true
+ color PNG. This function requires GD v2.0+
+ Note: Untested on 16-bit and 32-bit BMPs because I couldn't find
+ any sample files - if you know of a program that can create such
+ files, please email infoØgetid3Øorg
+ Note: Support for RGB (uncompressed), RLE8 and RLE4 is included
+ and tested. BITFIELDS support is also included for 16- & 32-bit
+ formats, but it's untested, so if anybody has any test files
+ please send them to infoØgetid3Øorg
+ Note: Support currently only for Windows-format BMPs, and trying
+ to parse an OS/2-format bitmap leads to unpredictable/invalid
+ results.
+ New file: getid3.bmp.php
+ » PNG now fully parsed, including all information chunks
+ New file: getid3.png.php
+ ¤ Support for GIF/JPG/PNG moved to seperate files and expanded,
+ including standard ['resolution_x'] and ['resolution_y'] as well
+ as more thorough parsing of header information
+ New file: getid3.gif.php
+ New file: getid3.jpg.php
+ table_var_dump() simplified and now outputs {-style character
+ entities for characters outside the normal alphanumeric range
+ CleanOggCommentName() changed to a regular expression
+ (thanks chris-getid3Øbolt*cx for rewriting the function)
+
+
+1.5.1: [September-20-2002] James Heinrich
+ » Added support for MPEGplus/Musepack SV7. ['fileformat'] is 'SV7'
+ for version 7 files (versions 4, 5 ,6 and 8 are not supported
+ yet, but will be of ['fileformat'] SV4, SV5, SV6 and SV8) when
+ they are supported (thanks Christian Fritz for the idea)
+ New file: getid3.mpc.php
+ ¤ ['bitrate_audio'], ['bitrate_video'], ['bitrate_mode'],
+ ['channels'], ['resolution_x'], and ['resolution_y'] keys added
+ for all appropriate formats
+ ¤ Ogg files with a COVERART comment now save and display the
+ attached image the same way as is done with ID3v2 APICs
+ ¤ ['ogg']['comments'][n]['data'] and
+ ['ogg']['comments'][n]['dataoffset'] is now returned for all
+ comments. ['ogg']['comments'][n]['data'] is only useful if
+ the field is supposed to contain binary data. It is a
+ base64_decode()'d version of ['value'].
+ ['ogg']['comments'][n]['dataoffset'] is the byte offset in the
+ file at which the 'COMMENTNAME=value string' starts, not the
+ start of just 'value'
+ ¤ ['ogg']['comments'][n]['image_mime'] is now returned if
+ ['ogg']['comments'][n]['data'] contains valid image data.
+ ¤ More than 3 Ogg pages may now be read in, if the comment data
+ is longer than 1 page (usually about 4kB)
+ ¤ ['fileformat'] is now 'mp2' rather than 'mp3' if it's MPEG-1,
+ Layer-II audio
+ ¤ ASF bitrates now calculated even if stream_bitrate_properties
+ object not present
+ ¤ ['asf']['stream_properties_object'] is now a numeric-key array
+ with one entry for each stream - the key being the stream number
+ ¤ ['replay_gain'] is returned for all audio formats that support
+ it (MP3-LAME, ID3v2, Ogg) (thanks Christian Fritz for the idea)
+ ¤ ['mpeg']['audio']['LAME']['RGAD']['radio_replay_gain'] is now
+ ['mpeg']['audio']['LAME']['RGAD']['radio'] (same for audiophile)
+ ¤ ASF/WMA files now use WM/Track to get track number from if
+ WM/TrackNumber is not available (thanks stephaneØtekartists*com)
+ ¤ ASF/WMV files now returns ['year'] and ['asf']['year']
+ ¤ ASV/WMV files now use ['content_description']['description'] for
+ the ['comment'] field (thanks stephaneØtekartists*com)
+ ¤ ['track'] is now always returned as an integer
+ * Bugfix: Ogg comments that are larger than one data page (usually
+ about 4kB) are now correctly parsed (thanks Christian Fritz)
+ * Bugfix: Ogg comment data is now UTF8-decoded
+ * Bugfix: Ogg comment writing now UTF8-encodes the data
+ * Bugfix: playtime for ASF files was off by <preroll> (usually
+ between 3 and 12 seconds)
+ * Bugfix: ['asf']['stream_properties_objects']['flags'] data was
+ possibly incorrect
+ * Bugfix: ASF Padding Object was overwriting
+ Stream Bitrate Properties Object data (now returned correctly in
+ ['asf']['padding_object']
+ * Bugfix: ASF Marker Object Reserved_2 field was incorrect
+ * Bugfix: ASF Bitrate Mutual Exclusion Object had incorrect stream
+ numbers
+ Warning displayed if incorrectly-formatted Ogg comment is present
+ (known to be an issue with CDex v1.40, but fixed by v1.50b7)
+ (thanks Christian Fritz)
+ Ogg comment writing now checks for valid comment names
+ Added bitrate column in getid3.check.php, and added some formatting
+ (font, colour)
+ Performance tweaks using bitwise math instead of binary string
+ operations
+
+
+1.5.0: [September-18-2002] James Heinrich
+ » Ogg comment writing support added. getid3.write.php has been
+ updated to allow for writing comment tags to both MP3 and Ogg.
+ Big thanks to Chris Bolt <chris-getid3Øbolt*cx> for writing the
+ OggWrite() function and offering it for inclusion in getID3()
+ New file: getid3.ogginfo.php
+ » Support for Monkey's Audio and APE tag added.
+ (thanks Christian Fritz for the idea)
+ New file: getid3.ape.php
+ ['fileformat'] now returns 'mac' for Monkey's Audio files, or
+ 'ape' for files with an APE tag (Monkey's Audio or other format)
+ » getid3.thumbnail.php has been removed from the distribution and
+ the table_var_dump() function now outputs APICs as seperate
+ files in the same directory as the analyzed file. This should
+ make the image-displaying more reliable as well as reduce
+ complexity. The naming convention for the images is
+ filename.ext.[byte offset of APIC data].[jpg|gif|png]
+ If anybody still has any problems with corrupted images please
+ let me know at infoØgetid3Øorg
+ » Support for extended Xing/LAME tag
+ (see http://users.belgacom.net/gc247244/extra/tag.html)
+ Data is returned in ['mpeg']['audio']['LAME']
+ ¤ ['ogg']['tracknumber'] has been renamed to ['ogg']['track'] and
+ ['track'] is now returned in the root of the array
+ ¤ ['ogg']['pageheader'][n]['flag'] has been renamed to
+ ['ogg']['pageheader'][n]['flags'] and the unprocessed flag byte
+ is available in ['ogg']['pageheader'][n]['flags_raw']
+ ¤ ['frequency'] is now returned for WAVE files in the root of the
+ array (thanks danielØelectroteque*org)
+ ¤ ASF files now return codec, bitrate, resolution, etc information
+ under ['asf']['video_media'] or ['asf']['audio_media']
+ * Bugfix: RVA2 and EQU2 writing in getid3.putid3.php were
+ incorrectly writing Volume Adjustment field
+ * Bugfix: EQU2 in getid3.frames.php was reading Volume Adjustment
+ as unsigned integer instead of signed integer
+ * Bugfix: handling of remote files over HTTP & FTP was broken
+ (thanks Vince)
+ * Bugfix: incorrect handling of some ASF packets
+ ASF/Windows Media format now more fully parsed, including Index
+ Objects
+ Added several new fourCC video codecs
+
+
+1.4.3: [September-15-2002] James Heinrich
+ » Now parses ASF / WMV / WMA files
+ ¤ New file: getid3.asf.php
+ * Bugfix: RoughTranslateUnicodeToASCII() would return nothing
+ if didn't find a terminator it was expecting
+ Added FILETIMEtoUNIXtime() function (for converting 64-bit
+ Microsoft FILETIME timestamps, used in ASF files and elsewhere,
+ to UNIX Epoch timestamps)
+ Added GUIDtoBytestring() and BytestringToGUID() functions
+
+
+1.4.2: [September-12-2002] James Heinrich
+ » getID3() now requires PHP v4.1.0 or higher because it now is
+ designed to work with register_globals = off and the new auto-
+ globals ($_GET, $_SERVER, etc).
+ * Bugfix: VBR MP3 files with Fraunhofer-style VBR header were not
+ being correctly detected in most cases
+ (thanks dkushnerØoddcast*com and mikeØftl*com for sample files)
+ * Bugfix: IsValidTextEncoding() was broken
+ * Bugfix: Add stripslashes($EditorFilename) to getid3.write.php
+ (writing was broken for files with ' or " in the filename)
+ (thanks mikeØftl*com and kthejoker)
+ * Bugfix: If there is garbage data between a valid VBR header
+ frame and a sequence of valid MPEG-audio frames the VBR data is
+ no longer discarded. (thanks to mikeØftl*com for sample
+ Fraunhofer-style VBR file produced with MusicMatch v7.2)
+ ¤ Changed variable system to work with (register_globals = off)
+ ¤ Moved relevant code into seperate PlaytimeString() function
+ ¤ Added nl2br() to table_var_dump() for cleaner output
+ ¤ Now returns the following keys from Fraunhofer-VBR files:
+ ['VBR_seek_offsets'], ['VBR_seek_offsets_stride'],
+ ['VBR_offsets_relative'] and ['VBR_offsets_absolute']
+ ¤ Added ID3v1matchesID3v2() function and implemented in
+ getid3.check.php (thanks to "Guest" in the forums for the idea)
+ Changed amount of data read in getid3.getimagesize.php from 10kB
+ to entire file. (thanks mikeØftl*com)
+ Wrapped function_exists() checks around function definitions in
+ getid3.functions.php
+ Fixed a lot of E_WARNING and E_NOTICE situations, especially in
+ ID3-writing code (getid3.putid3.php, etc)
+ Added checks to make sure all needed data is available for writing
+ ID3v2 tags
+
+
+1.4.1b5: [May-30-2002] James Heinrich
+ * Bugfix: Unsynchronise() was broken, now fixed
+ (thanks mikeØftl*com)
+ * Bugfix: GenerateID3v2Tag() now correctly uses non-synchsafe
+ integers for frame size descriptors in ID3v2.3 and ID3v2.2
+ (thanks mikeØftl*com)
+ ¤ Added ['artist'], ['title'], etc keys to root of returned
+ array to provide a common place to access any returned info
+ from any file type. Currently gets info from ID3v1, ID3v2,
+ Ogg, and RIFF/WAVE. Possible returned keys are:
+ title, artist, album, year, genre, comment, track
+ ¤ Modified LookupGenre() function to search for either genre based
+ on numeric ID, or now reverse lookup as well
+ ¤ Added ['artist'], ['title'], etc keys to ['RIFF'] information
+ if info tags are present
+ Added functionality to attach a picture to the ID3v2 tag in
+ getid3.write.php
+ Sorted genres into alphabetical order (special 3 at end of list)
+ in getid3.write.php
+ Changed the comment-edit field in getid3.write.php to a multi-line
+ <textarea> from a single-line <input>
+ getid3.write.php now only writes ID3v2 frames that have data
+ Added default TXXX field to getid3.write.php to put a tagger info
+ field when writing ID3v2 tags. Description is "ID3v2-tagged by"
+ and data is "getID3() v[version] (www.silisoftware.com)"
+ Changed getid3.check.php to use the new common info keys
+ Improved file-format detection in getid3.check.php - if the auto-
+ detect based on the first few bytes of the file doesn't find a
+ known format (for example if the header is corrupt), a more
+ thorough scan is done based on the file extension
+ Added 'Edit ID3' link from getid3.check.php to getid3.write.php for
+ MP3 files (thanks maxØgutalin*com for the idea)
+ Added 'Delete file' link from getid3.check.php to getid3.write.php
+ allowing you to permanently delete a file (be careful with this!!)
+ (thanks maxØgutalin*com for the idea)
+ Added some mouse-over titles for links in getid3.check.php
+
+
+1.4.1b4: [May-15-2002] James Heinrich
+ * Bugfix: getid3.check.php wasn't parsing MP3s with invalid headers
+ or padding at the beginning of the file - added 'assumeFormat'
+ parameter and 'Parse this file as:' options to force parsing in a
+ particular format (thanks Alcohol for the sample file)
+ * Bugfix: unset(['fileformat']) and ['error'] added in cases where
+ file cannot be parsed in the assumed or forced format
+
+
+1.4.1b3: [May-01-2002] James Heinrich
+ ¤ For Ogg files, now calculates the real average bitrate (returned
+ in ['ogg']['bitrate_average']) and so the playtime of the file is
+ calculated on actual average bitrate, not nominal bitrate, so it
+ should be accurate now (thanks to stephaneØtekartists*com for
+ telling me it was wrong)
+ * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
+ writing functions were called for more than one file, because of
+ the static array not being cleared between uses. This is an
+ updated fix because the one in 1.4.1b2 didn't work :o)
+ (thanks soulcatcherØevilsoft*org and yoyo)
+ Added rawurlencode() to the filename parameter in table_var_dump()
+ for images (wouldn't work with path/file names containing special
+ characters (#, &, ", +) (thanks Christian Fritz)
+ getid3.check.php no longer attempts to scan all MIDI tracks in
+ directory-browse mode, since this can take a long time. Detailed
+ single-file view is still fully scanned (new third parameter for
+ getMIDIHeaderFilepointer() controls this)
+ Small improvements to MoreNaturalSort()
+
+
+1.4.1b2: [April-18-2002] James Heinrich
+ ¤ GetAllMP3Info()'s 2nd parameter has changed from boolean to string
+ (now specifying the parse-this-file-as-this format, like 'mp3',
+ but also can be FALSE to mean don't assume any format, auto-detect
+ only), and a third parameter (array containing allowed formats)
+ has been added. The assumedFormat parameter allows a file to be
+ forced to be parsed as a certain format rather than relying on the
+ auto-detection of getID3() (ex: an MP3 wrapped in a RIFF/WAV
+ header will be auto-detected as RIFF/WAV, but if forced to parse
+ as MP3 will extract the original MP3 information)
+ (thanks reel_tazØusers*sourceforge*net)
+ * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
+ writing functions were called for more than one file, because of
+ the static array not being cleared between uses (thanks yoyo)
+ * Bugfix: Lyrics3 data wasn't being properly copied from the ['raw']
+ keys to the easy keys (['title'], etc.) (thanks Christian Fritz)
+ * Bugfix: some testing code was accidentally left in
+ getid3.thumbnail.php (thanks Christian Fritz)
+ * Bugfix: RIFF/WAVE files are now more likely to have all their
+ chunks parsed.
+ * Bugfix: RIFF/WAVE bitrate & playtime now better calculated
+ * Bugfix: MP3 scanning for synch doesn't go beyond 64k now, to stop
+ intensive scanning through large file that don't have a synch
+ (thanks soulcatcherØevilsoft*org for a weird sample file)
+ Improved performance when scanning for MP3 synch (about 600% faster
+ if the synch is never found)
+ ZIP files no longer return the contents of each compressed file, as
+ that would very easily be more data than PHP could handle.
+ (thanks davidbullockØtech-center*com)
+ getid3.check.php now displays entries in a more natural sort order:
+ case insensitive, ignores most punctuation, treats accented chars
+ the same as their unaccent equivalent (thanks mikeØftl*com)
+ Added support for SmartSound-format RIFF files (which are regular
+ RIFF/WAVE files with the first 4 chars changed from RIFF to SDSS)
+ All instances of while(list() = each()) replaced with foreach()
+
+
+1.4.1b1: [April-11-2002] James Heinrich
+ » Parses MIDI files.
+ NOTE: very slow at parsing, much slower than any other file type
+ NOTE: playtime is generally mostly accurate, but not always 100%
+ » Parses ZIP files (if ZZIPlib available, and only in PHP 4.0.7RC1
+ and later (see http://www.php.net/manual/en/ref.zip.php)
+ NOTE: currently untested as I'm unable to find php_zip.dll for
+ PHP/Win32 - if someone has a copy of this file, please email me:
+ infoØgetid3Øorg
+ » Parses JPEG files (requires GD installed)
+ » Parses PNG files (requires GD v1.6+ installed)
+ » Parses GIF files (requires GD < v1.6 installed)
+ » For MP3s, once a valid synch is detected, the next 5 frames are
+ also scanned for valid synch signatures, to prevent false
+ identification of synch. For corrupt MP3 files this will be a bit
+ slower, but hopefully produce more reliable results.
+ (Thanks to mpdjØbtinternet*com for bringing this to my attention,
+ and xbhoffØpacbell*net for explaining what was happening)
+ (Thanks also to macik for helping me with MP3 frame lengths:
+ http://66.96.216.160/cgi-bin/YaBB.pl
+ ?board=c&action=display&num=1018474068)
+ » The actual image data is now displayed (for JPEG, PNG and GIF
+ images only) rather than a binary text dump in getid3.check.php
+ (specifically table_var_dump()) for APIC frames. Made possible
+ by the inclusion of (a modified version of) GetURLImageSize() by
+ Filipe Laborde-Basto (www.rezox.com). You can right-click, save-as
+ to extract the image to a file.
+ NOTE: The actual image data is still returned in ['data']
+ ¤ ['image_mime'], ['image_width'], ['image_height'], ['image_bytes']
+ are now returned for APICs
+ ¤ split parsing functions out into seperate files: lyrics3, id3v1,
+ id3v2, mp3, ogg, riff, mpeg, midi, zip
+ ¤ ['ogg']['bitrate_ave'] -> ['ogg']['bitrate_nominal'] (thanks to
+ stephaneØtekartists*com for pointing out that "nominal" bitrate
+ may actually differ significantly from the "average" bitrate)
+ The real average bitrate seems to be only extractable by parsing
+ the entire file and calculating the average bitrate. This is not
+ yet an option, but hopefully in a future version of getID3()
+ ¤ ['filename'] now returned for all files
+ ¤ ['ogg']['date'] and ['ogg']['description'] now returned when
+ available (thanks stephaneØtekartists*com)
+ ¤ ['mpeg']['audio']['crc'] now contains the CRC (if present)
+ ¤ ['bitrate'] is now returned as a double instead of an int
+ ¤ ['dataoffset'] is now returned for all ID3v2 frames
+ * Bugfix: MP3 CRC presence ['mpeg']['audio']['protection'] was being
+ reported as opposite of what it actually should be
+ * Bugfix: MPEG videos weren't being detected (they were being
+ parsed as MP3), and even if they were, there was a typo in
+ getMPEGHeaderFilepointer() (thanks Christian Fritz)
+ * Bugfix: getid3.functions.php wasn't being included in
+ getid3.write.php (thanks mikeØftl*com)
+ * Bugfix: Browse:___ directory name in getid3.check.php wasn't
+ correct with directory names with ' and other strange characters
+ (thanks Christian Fritz)
+ ID3v2FrameProcessing() now checks to see if the next frame is valid
+ after it encounters an invalid FrameID, and if the next frameID
+ appears valid, it will just skip the current (invalid) frame and
+ continue processing (it would previously abort at the first sign
+ of incorrect structure) (thanks stephaneØtekartists*com)
+ getid3.check.php now scans filetypes based on content, not filename
+ extension, and shows the filetype in the displayed output. Files
+ are only scanned as MP3 if ID3v2 or MPEG-audio signatures are at
+ the immediate beginning of the file (MP3 used to be the default
+ format), so a corrupt file may not show up as MP3 format in the
+ browse screen, but in detail it will scan in-depth
+ getid3.check.php now has columns to show the presence of ID3v1,
+ ID3v2 and Lyrics3 content
+ Helium2 (www.helium2.com) has been known to write ID3v2.4 tags with
+ non-synchsafe-integer framesizes, getID3() now checks for this and
+ will override and parse the tag as ID3v2.3 if the tag would parse
+ fine as ID3v2.3 when it's really specified as ID3v2.4 (thanks
+ Christian Fritz for the test files)
+
+
+1.4.0b9: [April-05-2002] James Heinrich
+ » Ogg files now return bitrate and playtime (playtime calculated
+ from nominal bitrate and filesize, so it's only approximately
+ accurate). (thanks stephaneØtekartists*com for the idea)
+ * Bugfix: ID3v1 tags were not properly being parsed - track, genre
+ and comment fields were incorrect. (thanks Christian Fritz)
+ * Bugfix: getid3.check.php would not browse directories with single
+ quotes (') or double quotes (") in the directory name.
+ (thanks Christian Fritz)
+ * Bugfix: Improved detection of MPEG-video files (a sample MP3 file
+ had a false MPEG video signature at the beginning), and the MPEG-
+ video parsing function now only looks for the MPEG-video header
+ in the first 100k bytes of the file, to prevent needlessly
+ scanning very large files. Also will not infinitely loop if it
+ does not find what it's looking for. (thanks Christian Fritz)
+ ['error'] now returned if MP3 synch doesn't occur at beginning of
+ file if ID3v2 not used (ie there's some kind of padding there that
+ should not be)
+ Reduced use of fread() in getMPEGHeaderFilepointer() (now faster)
+ Added "file parsed in x.xxx seconds" to getid3.check.php
+ Added "browse: <directory>" link to getid3.check.php
+ Changed default ID3v2 majorversion from 2.4 to 2.3 in
+ getid3.write.php because Winamp (and probably many other
+ ID3v2-aware tools) can only read up to ID3v2.3
+ (thanks mikeØftl*com)
+
+
+1.4.0b8: [April-04-2002] James Heinrich
+ » Lyrics3 support added (thanks Christian Fritz for the idea)
+ ¤ check.php renamed to getid3.check.php
+ ¤ write.php renamed to getid3.write.php
+ ¤ ['id3']['id3v2']['error'] (if present) now reported in ['error']
+ ¤ ['mpeg']['audio']['error'] (if present) now reported in ['error']
+ * Bugfix: RoughTranslateUnicodeToASCII() was completely mangling
+ UTF-16/UTF-16BE encoded text
+ * Bugfix: The warning about MP3ext wasn't always showing up
+ (thanks davidbullockØtech-center*com)
+ getID3v1Filepointer() cleaned up & shortened
+ Moved the include_once() statements around so that a minimum of code
+ is included
+
+
+1.4.0b7: [April-03-2002] James Heinrich
+ » RIFFs (specifically AVIs) are now more completely parsed,
+ almost everything in the returned ['RIFF'] array has been moved
+ around and/or restructured. A lot of new data is in there too -
+ codecs, frame size, etc.
+ ¤ Better recursive parsing of RIFFs (sub-arrays are now in the right
+ place)
+ * Bugfix: the isset() idea introduced in beta 5 was incorrectly
+ implemented, such that ['asciidata'] and ['asciidescription'] were
+ never returned - this had the side effect that ID3v2 comments were
+ not copied to ['id3']['id3v2']['comment'] (thanks mikeØftl*com)
+ * Bugfix: MPEG audio synch wasn't being detected, and therefore MPEG
+ audio data not parsed, if no ID3v2 header present in an MP3
+ ID3v1 track number only returned if greater than zero
+ Removed !== FALSE (introduced in 1.4.0b6) from while(fread()) loops,
+ some users were reporting problems with that syntax.
+ Changed substr($string, 0, 1) to $string{0} syntax in most files
+ Reformatted changelog.txt to 72-column width
+
+
+1.4.0b6: [April-01-2002] James Heinrich
+ * Bugfix: 1.4.0b5 introduced a bug where any RIFF file other than
+ PCM WAVE (this includes any compressed WAV, as well as all AVIs)
+ would crash getID3()
+ Reduced use of fread() in getOggHeaderFilepointer() for increased
+ speed
+ Added constant FREAD_BUFFER_SIZE for many fread() operations
+ Added !== FALSE check to while(fread()) loops
+ (thanks davidbullockØtech-center*com)
+ Added more entries to RIFFwFormatTagLookup()
+ (still looking for a good complete list)
+ Converted use of hexdec() in getid3.lookup.php to 0x1234 notation
+
+
+1.4.0b5: [March-28-2002] James Heinrich
+ ¤ Renamed decodeheader() to decodeMPEGaudioHeader()
+ * Bugfix: Fixed infinite loop problem for RIFF/WAV files with
+ unknown chunks
+ * Bugfix: WXXX frames were incorrectly writing from ['URL'] instead
+ of ['url']
+ * Bugfix: RoughTranslateUnicodeToASCII() wasn't properly decoding
+ UTF-16/UTF-16BE
+ Changed all quoted strings from " to ' to hopefully improve speed
+ (although benchmarks have not yet shown any significant
+ improvement in speed) (thanks davidbullockØtech-center*com)
+ Improved code in check.php for dealing with symbolic links
+ (thanks davidbullockØtech-center*com)
+ Changed '<?' tags to '<?php' (thanks davidbullockØtech-center*com)
+ Added processing time indicator in check.php
+ (ie 'directory scanned in 2.45 seconds')
+ Replaced all instances of feof() to prevent infinite loop conditions
+ Moved lookup portions of decodeMPEGaudioHeader() to
+ getid3.lookup.php
+ Replaced $arrayname[$index] with $arrayname["$index"] to avoid PHP
+ E_NOTICEs (thanks davidbullockØtech-center*com)
+ Wrapped isset() around many if statements, to avoid PHP E_NOTICEs,
+ hence improve speed (up to 30x speed improvement reported in some
+ cases :)
+
+
+1.4.0b4: [March-26-2002] James Heinrich
+ ¤ RIFF/WAV file format now parsed, returned under ['riff']
+ ¤ Support for Relative Gain Adjustment in RIFF/WAV files
+ ¤ ['channels'] (1 or 2) now returned for MP3 and WAV files
+ ¤ ['bitrate'] now returned (in bits-per-second) at root level for
+ MP3 and WAV files
+ Added support for RGAD (Relative Gain ADjustment) ID3v2 frames, both
+ reading & writing
+ (see http://privatewww.essex.ac.uk/~djmrob/replaygain/ for details
+ on RGAD) (thanks Christian Fritz for the idea)
+ Removed some test data-dumping from the ID3v2 writing functions
+ Language code 'XXX' now returns descriptive string 'unknown' instead
+ of NULL
+ Seperated out comments from top of getid3.php into getid3.readme.txt
+ and changelog.txt
+ Split out non-lookup functions from getid3.lookup.php to
+ getid3.functions.php
+
+
+1.4.0b3: [March-25-2002] James Heinrich
+ ¤ ['asciidata'] for WXXX frames now returns correct information, but
+ under ['asciidescription'] (thanks Christian Fritz)
+ ¤ Added ['framenamelong'] to all returned frame data arrays with
+ text description of that frame (ie 'RVA2' would return 'Relative
+ volume adjustment (2)') (thanks Christian Fritz)
+ ¤ ['datalength'] is now ['indexeddatalength'] in ASPI frames (was
+ confliciting with the all-frames ['datalength'] as introduced in
+ v1.4.0b1
+ ¤ ['datalength'] now returned as integer (rather than double) where
+ possible
+
+
+1.4.0b2: [March-21-2002] James Heinrich
+ ¤ ['mpeg']['audio']['bitrate'] now returned as int rather than
+ double for VBR files
+ * Bugfix: MPEG audio information wasn't being parsed on files that
+ had neither ID3v1 or ID3v2
+ * Bugfix: COMM/WXXX frames weren't returning 'asciidata' in
+ ID3v2.2, which also meant the ['id3']['id3v2']['comment'] field
+ wasn't being returned (thanks stephaneØtekartists*com)
+ * Bugfix: file might not be found if filename actually contains
+ escaped chars or %xx-formatted characters
+ (thanks reel_tazØusers*sourceforge*net)
+ Added support for running with Register Globals turned off
+ (thanks reel_tazØusers*sourceforge*net)
+ Added urlencode() where needed in check.php
+ (thanks reel_tazØusers*sourceforge*net)
+ Fixed IE buffering/display problem in progress counter in check.php
+
+
+1.4.0b1: [March-11-2002] James Heinrich
+ » ID3v2 writing support via WriteID3v2() in putid3.php
+ RemoveID3v2() and RemoveID3v1() functions now available in
+ putid3.php All ID3v1 and ID3v2 writing functions have been moved
+ to putid3.php and example file write.php has been added to the
+ distribution
+ ¤ MPEG audio frame information (bitrate, frequency, etc) now
+ returned inside ['mpeg']['audio'] instead of just ['mpeg']
+ ¤ MPEG video information now parsed, returned in ['mpeg']['video']
+ Note: audio portion of video system files is not yet being parsed
+ ¤ All flag bits are now returned as boolean rather than int or
+ string
+ ¤ RVA2 data now returned as an array (multiple RVA2 tags are
+ allowed)
+ ¤ RVA2/EQU2 description returned under ['description'] rather than
+ ['identification']
+ ¤ RVAD/EQUA adjustments now returned as signed integers, rather than
+ absolute values which required you to check flag bytes
+ ¤ RVRB/REV data no longer returns under ['reverb'] array
+ ¤ WXXX/W???/LINK frames now return ['url'] instead of ['URL']
+ ¤ USER now properly returns both ['language'] and ['languagename']
+ ¤ OWNE now returns ['purchasedateunix'] as a UNIX timestamp
+ (only if ['purchasedate'] is a valid date)
+ ¤ ['id3']['id3v2']['padding'] now returned with information on padding
+ ¤ ['headerlength'] now includes the initial 6 or 10 bytes of the
+ ID3v2 header
+ ¤ ['artist'], ['title'], ['album'], ['tracknumber'], ['genre'] now
+ returned for easier access for Ogg files
+ ¤ added ['datalength'] to all ID3v2 frames: length of frame data,
+ not including frame header
+ ¤ ['fileformat'] now returns 'id3' if there are ID3v1 or ID3v2 tags
+ but no audio data
+ ¤ ['fileformat'] now returns 'mpg' if it's an MPEG system (video +
+ audio) file
+ * Bugfix: RVAD was being parsed incorrectly
+ * Bugfix: ['currency'] and ['purchasedate'] now correctly returned
+ in OWNE
+ * Bugfix: Frequncies in 'EQU2' frames were incorrectly double
+ * Bugfix: ['bytedeviation'] and ['msdeviation'] now properly
+ returned as integer rather than binary string for 'MLLT' frames
+ * Bugfix: ['filename'] now properly returned for 'GEOB' frames
+ * Bugfix: ['imagetype'] now properly returned for 'PIC' frames in
+ ID3v2.2
+ * Bugfix: Genre not being written if not set in WriteID3v1()
+ (thanks reel_tazØusers*sourceforge*net)
+ * Bugfix: Changed write mode to 'r+b' from 'a+' because ID3v1 tags
+ were being appended instead of overwritten if they already existed
+ (thanks reel_tazØusers*sourceforge*net)
+ * Bugfix: open would fail on filenames containing quotes
+ (thanks javierØcrackdealer*com)
+ * Bugfix: various values were incorrectly returned (unneeded ord())
+ in these frames: COMR, USER, ENCR, GRID, PRIV, SIGN
+ * Bugfix: ASPI ['bitsperpoint'] was not correctly returned
+ * Bugfix: RoughTranslateUnicodeToASCII() was not returning the last
+ char for UTF-16
+ * Bugfix: ['audiobytes'] now correctly 0 if no synch found
+ * Bugfix: GenreLookup was incorrectly returning 'Remix' instead of
+ 'Blues' for GenreID 0
+ Added sample directory browser to check.php
+ Seperated out MPEGaudio-parsing functionality into
+ getOnlyMPEGaudioInfo() which may be called directly if you don't
+ need any ID3 parsing (thanks djpretzelØcox*rr*com for idea)
+ Reduced use of fread() for increased performance in
+ getID3v1Filepointer()
+ Added clearstatcache() before checking filesize - size after writing
+ tag now correct
+ Added hack for mp3Rage (www.chaoticsoftware.com) that puts
+ ID3v2.3-formatted MIME type instead of 3-char ID3v2.2-format image
+ type (thanks xbhoffØpacbell*net for test file)
+
+
+1.3.2: [February-15-2002] James Heinrich
+ ¤ UFID/UFI, USLT/ULT, COMM/COM, APIC/PIC, GEOB/GEO, CRM, RVA2, EQU2,
+ POPM/POP, AENC/CRA, ENCR and GRID frame data now returned under
+ numeric array index rather than by ownerID
+ ¤ RVA2 frame data is now returned keyed by $channeltypeid instead of
+ $frame_idstring
+ ¤ WXXX/WXX frame description now returned under ['description']
+ instead of ['data']
+ Trailing null bytes now trimmed from frame (W??? & T???) text data
+ (it shouldn't be there to begin with, but a sample file encoded by
+ [unknown program] had data padded to 50 chars with null bytes,
+ which caused ParseID3v2GenreString() to freeze).
+
+
+1.3.1: [February-13-2002] James Heinrich
+ * Bugfix: ['playtime_seconds'] and ['playtime_string'] were not
+ being returned
+ * Bugfix: ['fileformat'] was incorrectly being returned as a
+ 2-element array
+ * Bugfix: USLT wasn't being correctly parsed
+ Improved RoughTranslateUnicodeToASCII()
+ (thanks reel_tazØusers*sourceforge*net for Unicode test file)
+
+
+1.3.0: [February-13-2002] James Heinrich
+ » ID3v1 writing support via WriteID3v1()
+ ¤ MPEG audio frame information (bitrate, frequency, etc) now
+ returned inside ['mpeg']
+ ¤ ['mpeg']['raw'] returns the integer values of the bits for MPEG
+ audio information as returned in ['mpeg'] by decodeheader()
+ (thanks reel_tazØusers*sourceforge*net)
+ ¤ 'protection', 'padding', 'private', 'copyright' and 'original' now
+ return as boolean
+ ¤ 'bitrate' and 'frequency' now return as int (except in special
+ case of 'free')
+ Language name as well as code retured where appropriate
+ (ie 'English' and 'eng')
+ Text frames with invalid TextEncoding value are now passed through
+ anyway
+ ID3v1 data (title, artist, album, year, comment) is now trimmed
+ (no more nulls)
+ RoughTranslateUnicodeToASCII() now uses utf8_decode() for UTF-8
+
+
+1.2.5: [January-30-2002] James Heinrich
+ * Bugfix: Playtime calculations for VBR files were off slightly
+ (rounding error)
+ * Bugfix: Extended header length was incorrectly calculated
+ * Bugfix: Genre strings such as '03' weren't being handled correctly
+ More complete support for ID3v2.3 FrameIDs
+ Split out getid3.frames.php (FrameID-specific parsing function)
+ Split out getid3.lookup.php (assorted lookup-table functions)
+ Searches for what directory getid3.*.php support files are in (must
+ be same as getid3.php, but doesn't have to be same as main file -
+ for example your main file could be /index.php, but including
+ /lib/getid3/getid3.php)
+ Simplified, tweaked, changed and/or eliminated several functions.
+
+
+1.2.4: [January-26-2002] James Heinrich
+ » Basic support for reading Ogg-Vorbis comment tags
+
+
+1.2.3: [January-24-2002] James Heinrich
+ » ID3v2.2.x 3-char FrameIDs are now fully parsed
+ Note: While I've included support for 22 FrameIDs as defined in
+ the specs, I don't have test files for all of them. If anyone
+ knows of programs that generate any of the untested tags, please
+ email infoØgetid3Øorg ! Here's what's tested and not:
+ Tested: T??, COM
+ Untested: UFI, TXX, W??, WXX, IPL, MCI, ETC, MLL, STC, ULT, SLT,
+ RVA, EQU, REV, PIC, GEO, CNT, POP, BUF, CRM, CRA, LNK
+ table_var_dump() now displays boolean variables as TRUE or FALSE
+ table_var_dump() now uses htmlspecialchars() to avoid broken-table
+ problems
+
+
+1.2.2: [January-18-2002] James Heinrich
+ ¤ Parses ID3v2 genres into ['id3']['id3v2']['genreid'] and
+ ['id3']['id3v2']['genrelist'] where appropriate
+ (thanks stephaneØtekartists*com for the idea)
+ Added ID3v2 genre abbreviations 'RX' (remix) and 'CR' (cover)
+
+
+1.2.1: [January-17-2002] James Heinrich
+ * Bugfix: 'mp3' was being returned in ['format'], but 'zip' was
+ being returned in ['fileformat'], both are now returned in
+ ['fileformat']
+ ¤ Splits ['id3']['id3v2']['track'] in the format '5/12' into
+ ['track'] = '5' and ['totaltracks'] = '12'
+ ¤ Enabled ['id3']['id3v2']['title'] etc for ID3v2.2.x
+ (3-char frame names) (thanks stephaneØtekartists*com)
+ ¤ Changed v1.?? version number format to v1.?.?
+ Scans through the file until it finds the MPEG synch (start of audio
+ frame) - some files encoded by LAME 3.91 had undocumented padding
+ after the ID3v2 header; getMP3headerFilepointer() now scans until
+ it finds synch (or EOF) (thanks adamØtrekjapan*com)
+ Improved Unicode conversion in RoughTranslateUnicodeToASCII()
+
+
+1.20: [January-15-2002] James Heinrich
+ » Support for variable-bitrate (VBR) files, both Xing and Fraunhofer
+ headers
+ » All 4-character FrameIDs are now fully parsed according to the
+ specs at http://www.id3.org/id3v2.4.0-frames.txt
+ ¤ This means that most no longer return ['flags'] and ['data']
+ Note: While I've included support for 30 FrameIDs as defined in
+ the specs, I don't have test files for all of them. If anyone
+ knows of programs that generate any of the untested tags, please
+ email infoØgetid3Øorg ! Here's what's tested and not:
+ Tested: UFID, T???, WXXX, USLT, SYLT, COMM, APIC, GEOB
+ Untested: TXXX, W???, MCDI, ETCO, MLLT, SYTC, RVA2, EQU2, RVRB,
+ PCNT, POPM, RBUF, AENC, USER, OWNE, COMR, ENCR, GRID,
+ PRIV, SIGN, SEEK, ASPI
+ ¤ Added 'title', 'artist', etc names to ID3v2 data (easier to access
+ than the 4-character FrameIDs of the ID3v2 standard)
+ (thanks jaksonØgmx.net)
+ * Bugfix: added fclose() at end of GetAllMP3Info()
+ (thanks stephaneØtekartists*com)
+ * Bugfix: ID3v1 wasn't being parsed if ID3v2 wasn't present
+ (thanks jaksonØgmx.net)
+ * Bugfix: several flags were being parsed incorrectly (the structure
+ had changed from ID3v2.3 to ID3v2.4) - v2.3 flags were being
+ incorrectly parsed
+ Much more compact implementation of decodeheader()
+ (thanks jaksonØgmx.net for the idea)
+ ID3v1 genres 126 through 147 (thanks jaksonØgmx.net)
+ New table_var_dump() function in check.php
+ (based partially on idea by jaksonØgmx.net)
+ Seperated ID3v1 retrieval into seperate function
+
+
+1.11: [December-23-2001] James Heinrich
+ All functions merged into file getid3.php
+ Updated documentation to reflect new returned information
+
+
+1.10: [December-20-2001] James Heinrich
+ * Bugfix: ID3v1 Track# was incorrectly being parsed whether it
+ existed or not
+ Changed calling procedure to recommend using
+ GetAllMP3info($filename) from getmp3header.php
+ Now includes check.php - example file
+ ¤ Checks to see if file is in ZIP or MP3 format
+ (returned in ['format'])
+ [Ed. Note: ['fileformat'] as of v1.2.1]
+
+
+1.06: [November-05-2001] James Heinrich
+ * Bugfix: ID3v2.2.x frames weren't being parsed since they use
+ 6-byte rather than 10-byte headers as v2.3+ does
+ (thanks spunkØmac*com for pointing that out)
+
+
+1.05: [September-06-2001] James Heinrich
+ * Bugfix: ID3v2 was being parsed even if it didn't exist
+
+
+1.04: [July-16-2001] James Heinrich
+ * Bugfix: typo in Extended Header section (strpad() should be
+ str_pad()) (thanks jurroonØyahoo*com)
+
+
+1.03: [May-07-2001] James Heinrich
+ * Bugfix: Added missing ['id3']['id3v1']['genreid'] and
+ ['id3']['id3v1']['genre']
+
+
+1.02: [May-05-2001] James Heinrich
+ ¤ Added ['getID3version']
+
+
+1.01: [May-04-2001] James Heinrich
+ » Added support for frame-level de-unsynchronisation (as per
+ ID3v2.4.0 specs) in addition to ID3v2.3.x tag-level
+ de-unsynchronisation
+
+
+1.00: [May-04-2001] James Heinrich
+ » Initial public release
+