/////////////////////////////////////////////////////////////////

[0] Fix | Delete

/// getID3() by James Heinrich <info@getid3.org> //

[1] Fix | Delete

// available at http://getid3.sourceforge.net //

[2] Fix | Delete

// or https://www.getid3.org //

[3] Fix | Delete

// also https://github.com/JamesHeinrich/getID3 //

[4] Fix | Delete

/////////////////////////////////////////////////////////////////

[5] Fix | Delete

[6] Fix | Delete

*****************************************************************

[7] Fix | Delete

*****************************************************************

[8] Fix | Delete

[9] Fix | Delete

getID3() is released under multiple licenses. You may choose

[10] Fix | Delete

from the following licenses, and use getID3 according to the

[11] Fix | Delete

terms of the license most suitable to your project.

[12] Fix | Delete

[13] Fix | Delete

GNU GPL: https://gnu.org/licenses/gpl.html (v3)

[14] Fix | Delete

https://gnu.org/licenses/old-licenses/gpl-2.0.html (v2)

[15] Fix | Delete

https://gnu.org/licenses/old-licenses/gpl-1.0.html (v1)

[16] Fix | Delete

[17] Fix | Delete

GNU LGPL: https://gnu.org/licenses/lgpl.html (v3)

[18] Fix | Delete

[19] Fix | Delete

Mozilla MPL: https://www.mozilla.org/MPL/2.0/ (v2)

[20] Fix | Delete

[21] Fix | Delete

getID3 Commercial License: https://www.getid3.org/#gCL (payment required)

[22] Fix | Delete

[23] Fix | Delete

*****************************************************************

[24] Fix | Delete

*****************************************************************

[25] Fix | Delete

Copies of each of the above licenses are included in the 'licenses'

[26] Fix | Delete

directory of the getID3 distribution.

[27] Fix | Delete

[28] Fix | Delete

[29] Fix | Delete

+----------------------------------------------+

[30] Fix | Delete

| If you want to donate, there is a link on |

[31] Fix | Delete

| https://www.getid3.org for PayPal donations. |

[32] Fix | Delete

+----------------------------------------------+

[33] Fix | Delete

[34] Fix | Delete

[35] Fix | Delete

Quick Start

[36] Fix | Delete

===========================================================================

[37] Fix | Delete

[38] Fix | Delete

Q: How can I check that getID3() works on my server/files?

[39] Fix | Delete

A: Unzip getID3() to a directory, then access /demos/demo.browse.php

[40] Fix | Delete

[41] Fix | Delete

[42] Fix | Delete

[43] Fix | Delete

Support

[44] Fix | Delete

===========================================================================

[45] Fix | Delete

[46] Fix | Delete

Q: I have a question, or I found a bug. What do I do?

[47] Fix | Delete

A: The preferred method of support requests and/or bug reports is the

[48] Fix | Delete

forum at http://support.getid3.org/

[49] Fix | Delete

[50] Fix | Delete

[51] Fix | Delete

[52] Fix | Delete

Sourceforge Notification

[53] Fix | Delete

===========================================================================

[54] Fix | Delete

[55] Fix | Delete

It's highly recommended that you sign up for notification from

[56] Fix | Delete

Sourceforge for when new versions are released. Please visit:

[57] Fix | Delete

http://sourceforge.net/project/showfiles.php?group_id=55859

[58] Fix | Delete

and click the little "monitor package" icon/link. If you're

[59] Fix | Delete

previously signed up for the mailing list, be aware that it has

[60] Fix | Delete

been discontinued, only the automated Sourceforge notification

[61] Fix | Delete

will be used from now on.

[62] Fix | Delete

[63] Fix | Delete

[64] Fix | Delete

[65] Fix | Delete

What does getID3() do?

[66] Fix | Delete

===========================================================================

[67] Fix | Delete

[68] Fix | Delete

Reads & parses (to varying degrees):

[69] Fix | Delete

¤ tags:

[70] Fix | Delete

* APE (v1 and v2)

[71] Fix | Delete

* ID3v1 (& ID3v1.1)

[72] Fix | Delete

* ID3v2 (v2.4, v2.3, v2.2)

[73] Fix | Delete

* Lyrics3 (v1 & v2)

[74] Fix | Delete

[75] Fix | Delete

¤ audio-lossy:

[76] Fix | Delete

* MP3/MP2/MP1

[77] Fix | Delete

* MPC / Musepack

[78] Fix | Delete

* Ogg (Vorbis, OggFLAC, Speex, Opus)

[79] Fix | Delete

* AAC / MP4

[80] Fix | Delete

* AC3

[81] Fix | Delete

* DTS

[82] Fix | Delete

* RealAudio

[83] Fix | Delete

* Speex

[84] Fix | Delete

* DSS

[85] Fix | Delete

* VQF

[86] Fix | Delete

[87] Fix | Delete

¤ audio-lossless:

[88] Fix | Delete

* AIFF

[89] Fix | Delete

* AU

[90] Fix | Delete

* Bonk

[91] Fix | Delete

* CD-audio (*.cda)

[92] Fix | Delete

* FLAC

[93] Fix | Delete

* LA (Lossless Audio)

[94] Fix | Delete

* LiteWave

[95] Fix | Delete

* LPAC

[96] Fix | Delete

* MIDI

[97] Fix | Delete

* Monkey's Audio

[98] Fix | Delete

* OptimFROG

[99] Fix | Delete

* RKAU

[100] Fix | Delete

* Shorten

[101] Fix | Delete

* TTA

[102] Fix | Delete

* VOC

[103] Fix | Delete

* WAV (RIFF)

[104] Fix | Delete

* WavPack

[105] Fix | Delete

[106] Fix | Delete

¤ audio-video:

[107] Fix | Delete

* ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV)

[108] Fix | Delete

* AVI (RIFF)

[109] Fix | Delete

* Flash

[110] Fix | Delete

* Matroska (MKV)

[111] Fix | Delete

* MPEG-1 / MPEG-2

[112] Fix | Delete

* NSV (Nullsoft Streaming Video)

[113] Fix | Delete

* Quicktime (including MP4)

[114] Fix | Delete

* RealVideo

[115] Fix | Delete

[116] Fix | Delete

¤ still image:

[117] Fix | Delete

* BMP

[118] Fix | Delete

* GIF

[119] Fix | Delete

* JPEG

[120] Fix | Delete

* PNG

[121] Fix | Delete

* TIFF

[122] Fix | Delete

* SWF (Flash)

[123] Fix | Delete

* PhotoCD

[124] Fix | Delete

[125] Fix | Delete

¤ data:

[126] Fix | Delete

* ISO-9660 CD-ROM image (directory structure)

[127] Fix | Delete

* SZIP (limited support)

[128] Fix | Delete

* ZIP (directory structure)

[129] Fix | Delete

* TAR

[130] Fix | Delete

* CUE

[131] Fix | Delete

[132] Fix | Delete

[133] Fix | Delete

Writes:

[134] Fix | Delete

* ID3v1 (& ID3v1.1)

[135] Fix | Delete

* ID3v2 (v2.3 & v2.4)

[136] Fix | Delete

* VorbisComment on OggVorbis

[137] Fix | Delete

* VorbisComment on FLAC (not OggFLAC)

[138] Fix | Delete

* APE v2

[139] Fix | Delete

* Lyrics3 (delete only)

[140] Fix | Delete

[141] Fix | Delete

[142] Fix | Delete

[143] Fix | Delete

Requirements

[144] Fix | Delete

===========================================================================

[145] Fix | Delete

[146] Fix | Delete

* PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier)

[147] Fix | Delete

* PHP 5.0.5 (or higher) for getID3() 1.8.x (and up)

[148] Fix | Delete

* PHP 5.3.0 (or higher) for getID3() 1.9.17 (and up)

[149] Fix | Delete

* PHP 5.3.0 (or higher) for getID3() 2.0.x (and up)

[150] Fix | Delete

* at least 4MB memory for PHP. 8MB or more is highly recommended.

[151] Fix | Delete

12MB is required with all modules loaded.

[152] Fix | Delete

[153] Fix | Delete

[154] Fix | Delete

[155] Fix | Delete

Usage

[156] Fix | Delete

===========================================================================

[157] Fix | Delete

[158] Fix | Delete

See /demos/demo.basic.php for a very basic use of getID3() with no

[159] Fix | Delete

fancy output, just scanning one file.

[160] Fix | Delete

[161] Fix | Delete

See structure.txt for the returned data structure.

[162] Fix | Delete

[163] Fix | Delete

*> For an example of a complete directory-browsing, <*

[164] Fix | Delete

*> file-scanning implementation of getID3(), please run <*

[165] Fix | Delete

*> /demos/demo.browse.php <*

[166] Fix | Delete

[167] Fix | Delete

See /demos/demo.mysql.php for a sample recursive scanning code that

[168] Fix | Delete

scans every file in a given directory, and all sub-directories, stores

[169] Fix | Delete

the results in a database and allows various analysis / maintenance

[170] Fix | Delete

operations

[171] Fix | Delete

[172] Fix | Delete

To analyze remote files over HTTP or FTP you need to copy the file

[173] Fix | Delete

locally first before running getID3(). Your code would look something

[174] Fix | Delete

like this:

[175] Fix | Delete

[176] Fix | Delete

// Copy remote file locally to scan with getID3()

[177] Fix | Delete

$remotefilename = 'http://www.example.com/filename.mp3';

[178] Fix | Delete

if ($fp_remote = fopen($remotefilename, 'rb')) {

[179] Fix | Delete

$localtempfilename = tempnam('/tmp', 'getID3');

[180] Fix | Delete

if ($fp_local = fopen($localtempfilename, 'wb')) {

[181] Fix | Delete

while ($buffer = fread($fp_remote, 32768)) {

[182] Fix | Delete

fwrite($fp_local, $buffer);

[183] Fix | Delete

}

[184] Fix | Delete

fclose($fp_local);

[185] Fix | Delete

[186] Fix | Delete

$remote_headers = array_change_key_case(get_headers($remotefilename, 1), CASE_LOWER);

[187] Fix | Delete

$remote_filesize = (isset($remote_headers['content-length']) ? (is_array($remote_headers['content-length']) ? $remote_headers['content-length'][count($remote_headers['content-length']) - 1] : $remote_headers['content-length']) : null);

[188] Fix | Delete

[189] Fix | Delete

// Initialize getID3 engine

[190] Fix | Delete

$getID3 = new getID3;

[191] Fix | Delete

[192] Fix | Delete

$ThisFileInfo = $getID3->analyze($localtempfilename, $remote_filesize, basename($remotefilename));

[193] Fix | Delete

[194] Fix | Delete

// Delete temporary file

[195] Fix | Delete

unlink($localtempfilename);

[196] Fix | Delete

}

[197] Fix | Delete

fclose($fp_remote);

[198] Fix | Delete

}

[199] Fix | Delete

[200] Fix | Delete

Note: since v1.9.9-20150212 it is possible a second and third parameter

[201] Fix | Delete

to $getID3->analyze(), for original filesize and original filename

[202] Fix | Delete

respectively. This permits you to download only a portion of a large remote

[203] Fix | Delete

file but get accurate playtime estimates, assuming the format only requires

[204] Fix | Delete

the beginning of the file for correct format analysis.

[205] Fix | Delete

[206] Fix | Delete

See /demos/demo.write.php for how to write tags.

[207] Fix | Delete

[208] Fix | Delete

[209] Fix | Delete

[210] Fix | Delete

What does the returned data structure look like?

[211] Fix | Delete

===========================================================================

[212] Fix | Delete

[213] Fix | Delete

See structure.txt

[214] Fix | Delete

[215] Fix | Delete

It is recommended that you look at the output of

[216] Fix | Delete

/demos/demo.browse.php scanning the file(s) you're interested in to

[217] Fix | Delete

confirm what data is actually returned for any particular filetype in

[218] Fix | Delete

general, and your files in particular, as the actual data returned

[219] Fix | Delete

may vary considerably depending on what information is available in

[220] Fix | Delete

the file itself.

[221] Fix | Delete

[222] Fix | Delete

[223] Fix | Delete

[224] Fix | Delete

Notes

[225] Fix | Delete

===========================================================================

[226] Fix | Delete

[227] Fix | Delete

getID3() 1.x:

[228] Fix | Delete

If the format parser encounters a critical problem, it will return

[229] Fix | Delete

something in $fileinfo['error'], describing the encountered error. If

[230] Fix | Delete

a less critical error or notice is generated it will appear in

[231] Fix | Delete

$fileinfo['warning']. Both keys may contain more than one warning or

[232] Fix | Delete

error. If something is returned in ['error'] then the file was not

[233] Fix | Delete

correctly parsed and returned data may or may not be correct and/or

[234] Fix | Delete

complete. If something is returned in ['warning'] (and not ['error'])

[235] Fix | Delete

then the data that is returned is OK - usually getID3() is reporting

[236] Fix | Delete

errors in the file that have been worked around due to known bugs in

[237] Fix | Delete

other programs. Some warnings may indicate that the data that is

[238] Fix | Delete

returned is OK but that some data could not be extracted due to

[239] Fix | Delete

errors in the file.

[240] Fix | Delete

[241] Fix | Delete

getID3() 2.x:

[242] Fix | Delete

See above except errors are thrown (so you will only get one error).

[243] Fix | Delete

[244] Fix | Delete

[245] Fix | Delete

[246] Fix | Delete

Disclaimer

[247] Fix | Delete

===========================================================================

[248] Fix | Delete

[249] Fix | Delete

getID3() has been tested on many systems, on many types of files,

[250] Fix | Delete

under many operating systems, and is generally believe to be stable

[251] Fix | Delete

and safe. That being said, there is still the chance there is an

[252] Fix | Delete

undiscovered and/or unfixed bug that may potentially corrupt your

[253] Fix | Delete

file, especially within the writing functions. By using getID3() you

[254] Fix | Delete

agree that it's not my fault if any of your files are corrupted.

[255] Fix | Delete

In fact, I'm not liable for anything :)

[256] Fix | Delete

[257] Fix | Delete

[258] Fix | Delete

[259] Fix | Delete

License

[260] Fix | Delete

===========================================================================

[261] Fix | Delete

[262] Fix | Delete

GNU General Public License - see license.txt

[263] Fix | Delete

[264] Fix | Delete

This program is free software; you can redistribute it and/or

[265] Fix | Delete

modify it under the terms of the GNU General Public License

[266] Fix | Delete

as published by the Free Software Foundation; either version 2

[267] Fix | Delete

of the License, or (at your option) any later version.

[268] Fix | Delete

[269] Fix | Delete

This program is distributed in the hope that it will be useful,

[270] Fix | Delete

but WITHOUT ANY WARRANTY; without even the implied warranty of

[271] Fix | Delete

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

[272] Fix | Delete

GNU General Public License for more details.

[273] Fix | Delete

[274] Fix | Delete

You should have received a copy of the GNU General Public License

[275] Fix | Delete

along with this program; if not, write to:

[276] Fix | Delete

Free Software Foundation, Inc.

[277] Fix | Delete

59 Temple Place - Suite 330

[278] Fix | Delete

Boston, MA 02111-1307, USA.

[279] Fix | Delete

[280] Fix | Delete

FAQ:

[281] Fix | Delete

Q: Can I use getID3() in my program? Do I need a commercial license?

[282] Fix | Delete

A: You're generally free to use getID3 however you see fit. The only

[283] Fix | Delete

case in which you would require a commercial license is if you're

[284] Fix | Delete

selling your closed-source program that integrates getID3. If you

[285] Fix | Delete

sell your program including a copy of getID3, that's fine as long

[286] Fix | Delete

as you include a copy of the sourcecode when you sell it. Or you

[287] Fix | Delete

can distribute your code without getID3 and say "download it from

[288] Fix | Delete

getid3.sourceforge.net"

[289] Fix | Delete

[290] Fix | Delete

[291] Fix | Delete

[292] Fix | Delete

Why is it called "getID3()" if it does so much more than just that?

[293] Fix | Delete

===========================================================================

[294] Fix | Delete

[295] Fix | Delete

v0.1 did in fact just do that. I don't have a copy of code that old, but I

[296] Fix | Delete

could essentially write it today with a one-line function:

[297] Fix | Delete

function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); }

[298] Fix | Delete

[299] Fix | Delete

[300] Fix | Delete

Future Plans

[301] Fix | Delete

===========================================================================

[302] Fix | Delete

https://www.getid3.org/phpBB3/viewforum.php?f=7

[303] Fix | Delete

[304] Fix | Delete

* Better support for MP4 container format

[305] Fix | Delete

* Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0)

[306] Fix | Delete

* Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm)

[307] Fix | Delete

* Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669)

[308] Fix | Delete

* Support for ACE (thanks Vince)

[309] Fix | Delete

* Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid)

[310] Fix | Delete

* Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header

[311] Fix | Delete

* Ability to "clean" ID3v2 padding (replace invalid padding with valid padding)

[312] Fix | Delete

* Warn if MP3s change version mid-stream (in full-scan mode)

[313] Fix | Delete

* check for corrupt/broken mid-file MP3 streams in histogram scan

[314] Fix | Delete

* Support for lossless-compression formats

[315] Fix | Delete

(http://www.firstpr.com.au/audiocomp/lossless/#Links)

[316] Fix | Delete

(http://compression.ca/act-sound.html)

[317] Fix | Delete

(http://web.inter.nl.net/users/hvdh/lossless/lossless.htm)

[318] Fix | Delete

* Support for RIFF-INFO chunks

[319] Fix | Delete

* http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html

[320] Fix | Delete

(thanks Nick Humfrey <njhØsurgeradio*co*uk>)

[321] Fix | Delete

* http://abcavi.narod.ru/sof/abcavi/infotags.htm

[322] Fix | Delete

(thanks Kibi)

[323] Fix | Delete

* Better support for Bink video

[324] Fix | Delete

* http://www.hr/josip/DSP/AudioFile2.html

[325] Fix | Delete

* http://www.pcisys.net/~melanson/codecs/

[326] Fix | Delete

* Detect mp3PRO

[327] Fix | Delete

* Support for PSD

[328] Fix | Delete

* Support for JPC

[329] Fix | Delete

* Support for JP2

[330] Fix | Delete

* Support for JPX

[331] Fix | Delete

* Support for JB2

[332] Fix | Delete

* Support for IFF

[333] Fix | Delete

* Support for ICO

[334] Fix | Delete

* Support for ANI

[335] Fix | Delete

* Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl)

[336] Fix | Delete

* Support for DVD-IFO (region, subtitles, aspect ratio, etc)

[337] Fix | Delete

(thanks p*quaedackersØplanet*nl)

[338] Fix | Delete

* More complete support for SWF - parsing encapsulated MP3 and/or JPEG content

[339] Fix | Delete

(thanks n8n8Øyahoo*com)

[340] Fix | Delete

* Support for a2b

[341] Fix | Delete

* Optional scan-through-frames for AVI verification

[342] Fix | Delete

(thanks rockcohenØmassive-interactive*nl)

[343] Fix | Delete

* Support for TTF (thanks infoØbutterflyx*com)

[344] Fix | Delete

* Support for DSS (https://www.getid3.org/phpBB3/viewtopic.php?t=171)

[345] Fix | Delete

* Support for SMAF (http://smaf-yamaha.com/what/demo.html)

[346] Fix | Delete

https://www.getid3.org/phpBB3/viewtopic.php?t=182

[347] Fix | Delete

* Support for AMR (https://www.getid3.org/phpBB3/viewtopic.php?t=195)

[348] Fix | Delete

* Support for 3gpp (https://www.getid3.org/phpBB3/viewtopic.php?t=195)

[349] Fix | Delete

* Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com)

[350] Fix | Delete

* Parse XML data returned in Ogg comments

[351] Fix | Delete

* Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com)

[352] Fix | Delete

* ID3v2 genre string creator function

[353] Fix | Delete

* More complete parsing of JPG

[354] Fix | Delete

* Support for all old-style ASF packets

[355] Fix | Delete

* ASF/WMA/WMV tag writing

[356] Fix | Delete

* Parse declared T??? ID3v2 text information frames, where appropriate

[357] Fix | Delete

(thanks Christian Fritz for the idea)

[358] Fix | Delete

* Recognize encoder:

[359] Fix | Delete

http://www.guerillasoft.com/EncSpot2/index.html

[360] Fix | Delete

http://ff123.net/identify.html

[361] Fix | Delete

http://www.hydrogenaudio.org/?act=ST&f=16&t=9414

[362] Fix | Delete

http://www.hydrogenaudio.org/?showtopic=11785

[363] Fix | Delete

* Support for other OS/2 bitmap structures: Bitmap Array('BA'),

[364] Fix | Delete

Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT')

[365] Fix | Delete

http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm

[366] Fix | Delete

* Support for WavPack RAW mode

[367] Fix | Delete

* ASF/WMA/WMV data packet parsing

[368] Fix | Delete

* ID3v2FrameFlagsLookupTagAlter()

[369] Fix | Delete

* ID3v2FrameFlagsLookupFileAlter()

[370] Fix | Delete

* obey ID3v2 tag alter/preserve/discard rules

[371] Fix | Delete

* http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm

[372] Fix | Delete

* proper checking for LINK/LNK frame validity in ID3v2 writing

[373] Fix | Delete

* proper checking for ASPI-TLEN frame validity in ID3v2 writing

[374] Fix | Delete

* proper checking for COMR frame validity in ID3v2 writing

[375] Fix | Delete

* http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html

[376] Fix | Delete

* decode GEOB ID3v2 structure as encoded by RealJukebox,

[377] Fix | Delete

decode NCON ID3v2 structure as encoded by MusicMatch

[378] Fix | Delete

(probably won't happen - the formats are proprietary)

[379] Fix | Delete

[380] Fix | Delete

[381] Fix | Delete

[382] Fix | Delete

Known Bugs/Issues in getID3() that may be fixed eventually

[383] Fix | Delete

===========================================================================

[384] Fix | Delete

https://www.getid3.org/phpBB3/viewtopic.php?t=25

[385] Fix | Delete

[386] Fix | Delete

* Cannot determine bitrate for MPEG video with VBR video data

[387] Fix | Delete

(need documentation)

[388] Fix | Delete

* Interlace/progressive cannot be determined for MPEG video

[389] Fix | Delete

(need documentation)

[390] Fix | Delete

* MIDI playtime is sometimes inaccurate

[391] Fix | Delete

* AAC-RAW mode files cannot be identified

[392] Fix | Delete

* WavPack-RAW mode files cannot be identified

[393] Fix | Delete

* mp4 files report lots of "Unknown QuickTime atom type"

[394] Fix | Delete

(need documentation)

[395] Fix | Delete

* Encrypted ASF/WMA/WMV files warn about "unhandled GUID

[396] Fix | Delete

ASF_Content_Encryption_Object"

[397] Fix | Delete

* Bitrate split between audio and video cannot be calculated for

[398] Fix | Delete

NSV, only the total bitrate. (need documentation)

[399] Fix | Delete

* All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the

[400] Fix | Delete

problem of large VorbisComments spanning multiple Ogg pages, but

[401] Fix | Delete

but only OggVorbis files can be processed with vorbiscomment.

[402] Fix | Delete

* The version of "head" supplied with Mac OS 10.2.8 (maybe other

[403] Fix | Delete

versions too) does only understands a single option (-n) and

[404] Fix | Delete

therefore fails. getID3 ignores this and returns wrong md5_data.

[405] Fix | Delete

[406] Fix | Delete

[407] Fix | Delete

[408] Fix | Delete

Known Bugs/Issues in getID3() that cannot be fixed

[409] Fix | Delete

--------------------------------------------------

[410] Fix | Delete

https://www.getid3.org/phpBB3/viewtopic.php?t=25

[411] Fix | Delete

[412] Fix | Delete

* 32-bit PHP installations only:

[413] Fix | Delete

Files larger than 2GB cannot always be parsed fully by getID3()

[414] Fix | Delete

due to limitations in the 32-bit PHP filesystem functions.

[415] Fix | Delete

NOTE: Since v1.7.8b3 there is partial support for larger-than-

[416] Fix | Delete

2GB files, most of which will parse OK, as long as no critical

[417] Fix | Delete

data is located beyond the 2GB offset.

[418] Fix | Delete

Known will-work:

[419] Fix | Delete

* all file formats on 64-bit PHP

[420] Fix | Delete

* ZIP (format doesn't support files >2GB)

[421] Fix | Delete

* FLAC (current encoders don't support files >2GB)

[422] Fix | Delete

Known will-not-work:

[423] Fix | Delete

* ID3v1 tags (always located at end-of-file)

[424] Fix | Delete

* Lyrics3 tags (always located at end-of-file)

[425] Fix | Delete

* APE tags (always located at end-of-file)

[426] Fix | Delete

Maybe-will-work:

[427] Fix | Delete

* Quicktime (will work if needed metadata is before 2GB offset,

[428] Fix | Delete

that is if the file has been hinted/optimized for streaming)

[429] Fix | Delete

* RIFF.WAV (should work fine, but gives warnings about not being

[430] Fix | Delete

able to parse all chunks)

[431] Fix | Delete

* RIFF.AVI (playtime will probably be wrong, is only based on

[432] Fix | Delete

"movi" chunk that fits in the first 2GB, should issue error

[433] Fix | Delete

to show that playtime is incorrect. Other data should be mostly

[434] Fix | Delete

correct, assuming that data is constant throughout the file)

[435] Fix | Delete

* PHP <= v5 on Windows cannot read UTF-8 filenames

[436] Fix | Delete

[437] Fix | Delete

[438] Fix | Delete

Known Bugs/Issues in other programs

[439] Fix | Delete

-----------------------------------

[440] Fix | Delete

https://www.getid3.org/phpBB3/viewtopic.php?t=25

[441] Fix | Delete

[442] Fix | Delete

* MusicBrainz Picard (at least up to v1.3.2) writes multiple

[443] Fix | Delete

ID3v2.3 genres in non-standard forward-slash separated text

[444] Fix | Delete

rather than parenthesis-numeric+refinement style per the ID3v2.3

[445] Fix | Delete

specs. Tags written in ID3v2.4 mode are written correctly.

[446] Fix | Delete

(detected and worked around by getID3())

[447] Fix | Delete

* PZ TagEditor v4.53.408 has been known to insert ID3v2.3 frames

[448] Fix | Delete

into an existing ID3v2.2 tag which, of course, breaks things

[449] Fix | Delete

* Windows Media Player (up to v11) and iTunes (up to v10+) do

[450] Fix | Delete

not correctly handle ID3v2.3 tags with UTF-16BE+BOM

[451] Fix | Delete

encoding (they assume the data is UTF-16LE+BOM and either

[452] Fix | Delete

crash (WMP) or output Asian character set (iTunes)

[453] Fix | Delete

* Winamp (up to v2.80 at least) does not support ID3v2.4 tags,

[454] Fix | Delete

only ID3v2.3

[455] Fix | Delete

see: http://forums.winamp.com/showthread.php?postid=387524

[456] Fix | Delete

* Some versions of Helium2 (www.helium2.com) do not write

[457] Fix | Delete

ID3v2.4-compliant Frame Sizes, even though the tag is marked

[458] Fix | Delete

as ID3v2.4) (detected by getID3())

[459] Fix | Delete

* MP3ext V3.3.17 places a non-compliant padding string at the end

[460] Fix | Delete

of the ID3v2 header. This is supposedly fixed in v3.4b21 but

[461] Fix | Delete

only if you manually add a registry key. This fix is not yet

[462] Fix | Delete

confirmed. (detected by getID3())

[463] Fix | Delete

* CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment

[464] Fix | Delete

strings, supposed to be in the format "NAME=value" but actually

[465] Fix | Delete

written just "value" (detected by getID3())

[466] Fix | Delete

* Oggenc 0.9-rc3 flags the encoded file as ABR whether it's

[467] Fix | Delete

actually ABR or VBR.

[468] Fix | Delete

* iTunes (versions "v7.0.0.70" is known-guilty, probably

[469] Fix | Delete

other versions are too) writes ID3v2.3 comment tags using an

[470] Fix | Delete

ID3v2.2 frame name (3-bytes) null-padded to 4 bytes which is

[471] Fix | Delete

not valid for ID3v2.3+

[472] Fix | Delete

(detected by getID3() since 1.9.12-201603221746)

[473] Fix | Delete

* iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably

[474] Fix | Delete

other versions are too) writes ID3v2.3 comment tags using a

[475] Fix | Delete

frame name 'COM ' which is not valid for ID3v2.3+ (it's an

[476] Fix | Delete

ID3v2.2-style frame name) (detected by getID3())

[477] Fix | Delete

* MP2enc does not encode mono CBR MP2 files properly (half speed

[478] Fix | Delete

sound and double playtime)

[479] Fix | Delete

* MP2enc does not encode mono VBR MP2 files properly (actually

[480] Fix | Delete

encoded as stereo)

[481] Fix | Delete

* tooLAME does not encode mono VBR MP2 files properly (actually

[482] Fix | Delete

encoded as stereo)

[483] Fix | Delete

* AACenc encodes files in VBR mode (actually ABR) even if CBR is

[484] Fix | Delete

specified

[485] Fix | Delete

* AAC/ADIF - bitrate_mode = cbr for vbr files

[486] Fix | Delete

* LAME 3.90-3.92 prepends one frame of null data (space for the

[487] Fix | Delete

LAME/VBR header, but it never gets written) when encoding in CBR

[488] Fix | Delete

mode with the DLL

[489] Fix | Delete

* Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed

[490] Fix | Delete

to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for

[491] Fix | Delete

TwinVQF v2.0 (detected by getID3())

[492] Fix | Delete

* Ahead Nero encodes TwinVQF files 1 second shorter than they

[493] Fix | Delete

should be

[494] Fix | Delete

* AAC-ADTS files are always actually encoded VBR, even if CBR mode

[495] Fix | Delete

is specified (the CBR-mode switches on the encoder enable ABR

[496] Fix | Delete

mode, not CBR as such, but it's not possible to tell the

[497] Fix | Delete

difference between such ABR files and true VBR)

[498] Fix | Delete

* STREAMINFO.audio_signature in OggFLAC is always null. "The reason

[499] Fix | Delete