Файл: system/vendor/james-heinrich/getid3/changelog.txt
Строк: 6538
/////////////////////////////////////////////////////////////////
///
getID3() by James Heinrich <info@getid3.org> //
//
available at http://getid3.sourceforge.net //
//
or https://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.19: [2019-12-17] James Heinrich ::
1.9.19-201912131005
» add placeholder support for WTV (Windows Recorded
TV Show)
* bugfix (G:210) PHP 7.4 deprecated get_magic_quotes
* bugfix
(G:207) improved LAME version string parsing
* bugfix (G:206) inverted
logic in CopyTagsToComments
* bugfix (G:203) use getimagesizefromstring if
available
* Quicktime decode 'uuid' atom for 360fly cameras
1.9.18:
[2019-07-24] James Heinrich :: 1.9.18-201907240906
* bugfix (G:198) use
native hash functions instead of obsolete external binaries
* bugfix
(G:194) PHP 7.4 compatibility: fix deprecated curly brace array access
*
bugfix (G:191) unsupported operand types module.audio.ac3.php:763
* bugfix
(G:189) false UTF-16 <BOM> and no termination strings
* bugfix
(G:188) add support for DS2 v8
* bugfix (G:187) RIFF.WAVE.scot parsing
*
bugfix (G:184) invalid regex pattern (ID3v1)
* bugfix (G:183) reduced
information for GIF files with $option_extra_info=false
* bugfix (G:175)
mp4 max buffer size
* bugfix (G:174) TIFF parsing improvements
* bugfix
(G:121) trailing nulls in ID3v2 strings
* standardize "track"
-> "track_number"
1.9.17: [2019-02-07] James Heinrich ::
1.9.17-201902071234
* bugfix (G:178) HandleAllTags should skip
"picture"
* bugfix (G:177) error checking for reading more than
PHP memory_limit
* bugfix (G:176) improved mp3 detection in remote-file
demo
* bugfix (G:173) Add filepointer option to analyze/openfile
function
* bugfix (G:170) Add support for WXXX (URL) and APIC (attached
picture) subframes inside ID3v2 chapters
* bugfix: write.id3v2 year
field
* bugfix: mp3.APE permit optional " dB" in ReplayGain
tags
* placeholder support for .xz file format
1.9.16: [2018-10-17] James
Heinrich :: 1.9.16-201810171314
* bugfix (G:168) Ogg FLAC not parsed
*
bugfix (G:163) invalid MP3 header error on VBR
* bugfix (G:162) prevent
writing multiple ID3v2 versions
* bugfix (G:161) MP3 VBR header
duration
* bugfix (G:160) OggOpus duration sometimes incorrect
* bugfix
(G:157) quicktime GPS invalid argument
* bugfix (G:148) MPEG-2 aspect
ratio
* bugfix (G:147) Quicktime fourcc codec name lookup
* bugfix
(G:147) Quicktime audio/video bitrate guessing
* bugfix (G:145)
incompatible variable types
* bugfix (G:139) Quicktime islt subatoms
>5
* bugfix (G:137) ID3v2 semi-numeric genres
* bugfix (G:136) ID3v2
unsynchronised typo
* bugfix (#2514) FLAC zero-byte block header
* bugfix
(#2488) MIME types (FLAC, WAV, gzip)
* bugfix (#2468) Quicktime video
rotation
* bugfix (#2207) metaflac + attached pictures
* bugfix (#2151)
improved demo UNC filename support
* bugfix (#1966) fread fail when PHP
memory_limit -1
* bugfix (#1908) Quicktime rotation detection (using
matrix values)
* bugfix (#1908) Quicktime "rcif" and
"dscp" atoms
* bugfix (#1900) demo.joinmp3 cut from end
*
security: avoid disabled demo reflection
* TIFF: expand list of named
tags, expose as 'tag_name' key for all entries
* Quicktime: parse some
GoPro-specific data
* helperapps (Windows): updated vorbiscomment.exe,
metaflac.exe to v1.3.2
* add more image formats supported by
getimagesize()
1.9.15: [2017-10-26] James Heinrich :: 1.9.15-201709291043
» (G:108) add basic APNG support
» (G:107) add basic WebP support
* return RIFF.WAV.CART comments in merged comments section
* add
support for QuickTime 'loci' chunk
* bugfix: (#2124) support for
Quicktime/MP4 "chpl" (CHaPter List) atom
* bugfix: (G:128)
undefinied bsmod in module.ac3
* bugfix: (#2114) possible issue with
UTF8 filenames and metaflac
* bugfix: (G:123) remove MySQL engine and
collation from create table
* bugfix: (#2066) fix AAC MIME type, remove
video key for audio-only files
* bugfix: (G:111) QuickTime stsd
number_entries deadlock
* bugfix: (G:110) PHP memory limit with space
* bugfix: (G:109) improved animated GIF support
* bugfix: (#1966) GPS
track in QuickTime
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:
https://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() - https://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