Name |
Date |
Size |
#Lines |
LOC |
||
---|---|---|---|---|---|---|
.. | 10-Nov-2020 | - | ||||
demos/ | H | 10-Nov-2020 | - | 7,275 | 5,341 | |
getid3/ | H | 10-Nov-2020 | - | 43,591 | 27,717 | |
helperapps/ | H | 10-Nov-2020 | - | 55 | 38 | |
licenses/ | H | 10-Nov-2020 | - | 1,835 | 1,476 | |
README.md | H A D | 09-Nov-2020 | 22.4 KiB | 608 | 507 | |
changelog.txt | H A D | 09-Nov-2020 | 151.9 KiB | 2,975 | 2,804 | |
dependencies.txt | H A D | 09-Nov-2020 | 1.2 KiB | 26 | 24 | |
license.txt | H A D | 09-Nov-2020 | 1.3 KiB | 30 | 21 | |
readme.txt | H A D | 09-Nov-2020 | 25.6 KiB | 628 | 532 | |
structure.txt | H A D | 09-Nov-2020 | 130 KiB | 2,277 | 2,199 |
README.md
1getID3() by James Heinrich (<info@getid3.org>) 2=== 3**Available at <http://getid3.sourceforge.net> or <https://www.getid3.org>** 4 5getID3() is released under multiple licenses. You may choose from the following licenses, and use getID3 according to the terms of the license most suitable to your project. 6 7**GNU GPL:** 8 9* [v3](https://gnu.org/licenses/gpl.html) 10 11* [v2](https://gnu.org/licenses/old-licenses/gpl-2.0.html) 12 13* [v1](https://gnu.org/licenses/old-licenses/gpl-1.0.html) 14 15**GNU LGPL:** 16 17* [v3](https://gnu.org/licenses/lgpl.html) 18 19**Mozilla MPL:** 20 21* [v2](https://www.mozilla.org/MPL/2.0/) 22 23**getID3 Commercial License:** 24 25* [gCL](https://www.getid3.org/#gCL) (payment required) 26 27* * * 28Copies of each of the above licenses are included in the `licenses/` 29directory of the getID3 distribution. 30 31If you want to donate, there is a link on <https://www.getid3.org> for PayPal donations. 32 33 34 35Quick Start 36=== 37 38**Q:** How can I check that getID3() works on my server/files? 39 40**A:** Unzip getID3() to a directory, then access `/demos/demo.browse.php` 41 42 43 44Support 45=== 46 47**Q:** I have a question, or I found a bug. What do I do? 48 49**A:** The preferred method of support requests and/or bug reports is the forum at <http://support.getid3.org/> 50 51 52 53Sourceforge Notification 54=== 55 56It's highly recommended that you sign up for notification from 57Sourceforge for when new versions are released. Please visit: 58<http://sourceforge.net/project/showfiles.php?group_id=55859> 59and click the little "monitor package" icon/link. If you're 60previously signed up for the mailing list, be aware that it has 61been discontinued, only the automated Sourceforge notification 62will be used from now on. 63 64 65 66What does getID3() do? 67=== 68 69Reads & parses (to varying degrees): 70 71+ tags: 72 * APE (v1 and v2) 73 * ID3v1 (& ID3v1.1) 74 * ID3v2 (v2.4, v2.3, v2.2) 75 * Lyrics3 (v1 & v2) 76 77+ audio-lossy: 78 * MP3/MP2/MP1 79 * MPC / Musepack 80 * Ogg (Vorbis, OggFLAC, Speex, Opus) 81 * AAC / MP4 82 * AC3 83 * DTS 84 * RealAudio 85 * Speex 86 * DSS 87 * VQF 88 89+ audio-lossless: 90 * AIFF 91 * AU 92 * Bonk 93 * CD-audio (*.cda) 94 * FLAC 95 * LA (Lossless Audio) 96 * LiteWave 97 * LPAC 98 * MIDI 99 * Monkey's Audio 100 * OptimFROG 101 * RKAU 102 * Shorten 103 * TTA 104 * VOC 105 * WAV (RIFF) 106 * WavPack 107 108+ audio-video: 109 * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) 110 * AVI (RIFF) 111 * Flash 112 * Matroska (MKV) 113 * MPEG-1 / MPEG-2 114 * NSV (Nullsoft Streaming Video) 115 * Quicktime (including MP4) 116 * RealVideo 117 118+ still image: 119 * BMP 120 * GIF 121 * JPEG 122 * PNG 123 * TIFF 124 * SWF (Flash) 125 * PhotoCD 126 127+ data: 128 * ISO-9660 CD-ROM image (directory structure) 129 * SZIP (limited support) 130 * ZIP (directory structure) 131 * TAR 132 * CUE 133 134 135+ Writes: 136 * ID3v1 (& ID3v1.1) 137 * ID3v2 (v2.3 & v2.4) 138 * VorbisComment on OggVorbis 139 * VorbisComment on FLAC (not OggFLAC) 140 * APE v2 141 * Lyrics3 (delete only) 142 143 144 145Requirements 146=== 147 148* PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier) 149* PHP 5.0.5 (or higher) for getID3() 1.8.x (and up) 150* PHP 5.0.5 (or higher) for getID3() 2.0.x (and up) 151* at least 4MB memory for PHP. 8MB or more is highly recommended. 152 12MB is required with all modules loaded. 153 154 155 156Usage 157=== 158 159See /demos/demo.basic.php for a very basic use of getID3() with no 160fancy output, just scanning one file. 161 162See structure.txt for the returned data structure. 163 164**For an example of a complete directory-browsing, file-scanning implementation of getID3(), please run /demos/demo.browse.php** 165 166See /demos/demo.mysql.php for a sample recursive scanning code that 167scans every file in a given directory, and all sub-directories, stores 168the results in a database and allows various analysis / maintenance 169operations 170 171To analyze remote files over HTTP or FTP you need to copy the file 172locally first before running getID3(). Your code would look something 173like this: 174 175``` php 176<?php 177 178// Copy remote file locally to scan with getID3() 179$remotefilename = 'http://www.example.com/filename.mp3'; 180if ($fp_remote = fopen($remotefilename, 'rb')) { 181 $localtempfilename = tempnam('/tmp', 'getID3'); 182 if ($fp_local = fopen($localtempfilename, 'wb')) { 183 while ($buffer = fread($fp_remote, 8192)) { 184 fwrite($fp_local, $buffer); 185 } 186 fclose($fp_local); 187 // Initialize getID3 engine 188 $getID3 = new getID3; 189 $ThisFileInfo = $getID3->analyze($localtempfilename); 190 // Delete temporary file 191 unlink($localtempfilename); 192 } 193 fclose($fp_remote); 194} 195 196``` 197 198 199**See /demos/demo.write.php for how to write tags.** 200 201What does the returned data structure look like? 202=== 203 204See structure.txt 205 206It is recommended that you look at the output of 207/demos/demo.browse.php scanning the file(s) you're interested in to 208confirm what data is actually returned for any particular filetype in 209general, and your files in particular, as the actual data returned 210may vary considerably depending on what information is available in 211the file itself. 212 213 214 215Notes 216=== 217 218getID3() 1.x: 219--- 220If the format parser encounters a critical problem, it will return 221something in `$fileinfo['error']`, describing the encountered error. If 222a less critical error or notice is generated it will appear in 223`$fileinfo['warning']`. Both keys may contain more than one warning or 224error. If something is returned in ['error'] then the file was not 225correctly parsed and returned data may or may not be correct and/or 226complete. If something is returned in `['warning']` (and not `['error']`) 227then the data that is returned is OK - usually getID3() is reporting 228errors in the file that have been worked around due to known bugs in 229other programs. Some warnings may indicate that the data that is 230returned is OK but that some data could not be extracted due to 231errors in the file. 232 233getID3() 2.x: 234--- 235See above except errors are thrown (so you will only get one error). 236 237Disclaimer 238=== 239 240getID3() has been tested on many systems, on many types of files, 241under many operating systems, and is generally believe to be stable 242and safe. That being said, there is still the chance there is an 243undiscovered and/or unfixed bug that may potentially corrupt your 244file, especially within the writing functions. By using getID3() you 245agree that it's not my fault if any of your files are corrupted. 246In fact, I'm not liable for anything :) 247 248License 249=== 250 251GNU General Public License - see license.txt 252 253This program is free software; you can redistribute it and/or 254modify it under the terms of the GNU General Public License 255as published by the Free Software Foundation; either version 2 256of the License, or (at your option) any later version. 257 258This program is distributed in the hope that it will be useful, 259but WITHOUT ANY WARRANTY; without even the implied warranty of 260MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 261GNU General Public License for more details. 262 263You should have received a copy of the GNU General Public License 264along with this program; if not, write to: 265Free Software Foundation, Inc. 26659 Temple Place - Suite 330 267Boston, MA 02111-1307, USA. 268 269FAQ: 270--- 271**Q:** Can I use getID3() in my program? Do I need a commercial license? 272 273**A:** You're generally free to use getID3 however you see fit. The only 274 case in which you would require a commercial license is if you're 275 selling your closed-source program that integrates getID3. If you 276 sell your program including a copy of getID3, that's fine as long 277 as you include a copy of the sourcecode when you sell it. Or you 278 can distribute your code without getID3 and say "download it from 279 getid3.sourceforge.net" 280 281 282 283Why is it called "getID3()" if it does so much more than just that? 284=== 285 286v0.1 did in fact just do that. I don't have a copy of code that old, but I 287could essentially write it today with a one-line function: 288 289``` php 290function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); } 291 292``` 293 294 295Future Plans 296=== 297<https://www.getid3.org/phpBB3/viewforum.php?f=7> 298 299* Better support for MP4 container format 300* Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0) 301* Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm) 302* Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669) 303* Support for ACE (thanks Vince) 304* Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid) 305* Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header 306* Ability to "clean" ID3v2 padding (replace invalid padding with valid padding) 307* Warn if MP3s change version mid-stream (in full-scan mode) 308* check for corrupt/broken mid-file MP3 streams in histogram scan 309* Support for lossless-compression formats 310 (http://www.firstpr.com.au/audiocomp/lossless/#Links) 311 (http://compression.ca/act-sound.html) 312 (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) 313* Support for RIFF-INFO chunks 314 * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html 315 (thanks Nick Humfrey <njhØsurgeradio*co*uk>) 316 * http://abcavi.narod.ru/sof/abcavi/infotags.htm 317 (thanks Kibi) 318* Better support for Bink video 319* http://www.hr/josip/DSP/AudioFile2.html 320* http://www.pcisys.net/~melanson/codecs/ 321* Detect mp3PRO 322* Support for PSD 323* Support for JPC 324* Support for JP2 325* Support for JPX 326* Support for JB2 327* Support for IFF 328* Support for ICO 329* Support for ANI 330* Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) 331* Support for DVD-IFO (region, subtitles, aspect ratio, etc) 332 (thanks p*quaedackersØplanet*nl) 333* More complete support for SWF - parsing encapsulated MP3 and/or JPEG content 334 (thanks n8n8Øyahoo*com) 335* Support for a2b 336* Optional scan-through-frames for AVI verification 337 (thanks rockcohenØmassive-interactive*nl) 338* Support for TTF (thanks infoØbutterflyx*com) 339* Support for DSS (https://www.getid3.org/phpBB3/viewtopic.php?t=171) 340* Support for SMAF (http://smaf-yamaha.com/what/demo.html) 341 https://www.getid3.org/phpBB3/viewtopic.php?t=182 342* Support for AMR (https://www.getid3.org/phpBB3/viewtopic.php?t=195) 343* Support for 3gpp (https://www.getid3.org/phpBB3/viewtopic.php?t=195) 344* Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) 345* Parse XML data returned in Ogg comments 346* Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) 347* ID3v2 genre string creator function 348* More complete parsing of JPG 349* Support for all old-style ASF packets 350* ASF/WMA/WMV tag writing 351* Parse declared T??? ID3v2 text information frames, where appropriate 352 (thanks Christian Fritz for the idea) 353* Recognize encoder: 354 http://www.guerillasoft.com/EncSpot2/index.html 355 http://ff123.net/identify.html 356 http://www.hydrogenaudio.org/?act=ST&f=16&t=9414 357 http://www.hydrogenaudio.org/?showtopic=11785 358* Support for other OS/2 bitmap structures: Bitmap Array('BA'), 359 Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT') 360 http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm 361* Support for WavPack RAW mode 362* ASF/WMA/WMV data packet parsing 363* ID3v2FrameFlagsLookupTagAlter() 364* ID3v2FrameFlagsLookupFileAlter() 365* obey ID3v2 tag alter/preserve/discard rules 366* http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm 367* proper checking for LINK/LNK frame validity in ID3v2 writing 368* proper checking for ASPI-TLEN frame validity in ID3v2 writing 369* proper checking for COMR frame validity in ID3v2 writing 370* http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html 371* decode GEOB ID3v2 structure as encoded by RealJukebox, 372 decode NCON ID3v2 structure as encoded by MusicMatch 373 (probably won't happen - the formats are proprietary) 374 375 376 377Known Bugs/Issues in getID3() that may be fixed eventually 378=== 379<https://www.getid3.org/phpBB3/viewtopic.php?t=25> 380 381* Cannot determine bitrate for MPEG video with VBR video data 382 (need documentation) 383* Interlace/progressive cannot be determined for MPEG video 384 (need documentation) 385* MIDI playtime is sometimes inaccurate 386* AAC-RAW mode files cannot be identified 387* WavPack-RAW mode files cannot be identified 388* mp4 files report lots of "Unknown QuickTime atom type" 389 (need documentation) 390* Encrypted ASF/WMA/WMV files warn about "unhandled GUID 391 ASF_Content_Encryption_Object" 392* Bitrate split between audio and video cannot be calculated for 393 NSV, only the total bitrate. (need documentation) 394* All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the 395 problem of large VorbisComments spanning multiple Ogg pages, but 396 but only OggVorbis files can be processed with vorbiscomment. 397* The version of "head" supplied with Mac OS 10.2.8 (maybe other 398 versions too) does only understands a single option (-n) and 399 therefore fails. getID3 ignores this and returns wrong md5_data. 400 401 402 403Known Bugs/Issues in getID3() that cannot be fixed 404--- 405<https://www.getid3.org/phpBB3/viewtopic.php?t=25> 406 407* 32-bit PHP installations only: 408 Files larger than 2GB cannot always be parsed fully by getID3() 409 due to limitations in the 32-bit PHP filesystem functions. 410 NOTE: Since v1.7.8b3 there is partial support for larger-than- 411 2GB files, most of which will parse OK, as long as no critical 412 data is located beyond the 2GB offset. 413 Known will-work: 414 * all file formats on 64-bit PHP 415 * ZIP (format doesn't support files >2GB) 416 * FLAC (current encoders don't support files >2GB) 417 Known will-not-work: 418 * ID3v1 tags (always located at end-of-file) 419 * Lyrics3 tags (always located at end-of-file) 420 * APE tags (always located at end-of-file) 421 Maybe-will-work: 422 * Quicktime (will work if needed metadata is before 2GB offset, 423 that is if the file has been hinted/optimized for streaming) 424 * RIFF.WAV (should work fine, but gives warnings about not being 425 able to parse all chunks) 426 * RIFF.AVI (playtime will probably be wrong, is only based on 427 "movi" chunk that fits in the first 2GB, should issue error 428 to show that playtime is incorrect. Other data should be mostly 429 correct, assuming that data is constant throughout the file) 430 431 432 433Known Bugs/Issues in other programs 434--- 435<https://www.getid3.org/phpBB3/viewtopic.php?t=25> 436 437* Windows Media Player (up to v11) and iTunes (up to v10+) do 438 not correctly handle ID3v2.3 tags with UTF-16BE+BOM 439 encoding (they assume the data is UTF-16LE+BOM and either 440 crash (WMP) or output Asian character set (iTunes) 441* Winamp (up to v2.80 at least) does not support ID3v2.4 tags, 442 only ID3v2.3 443 see: http://forums.winamp.com/showthread.php?postid=387524 444* Some versions of Helium2 (www.helium2.com) do not write 445 ID3v2.4-compliant Frame Sizes, even though the tag is marked 446 as ID3v2.4) (detected by getID3()) 447* MP3ext V3.3.17 places a non-compliant padding string at the end 448 of the ID3v2 header. This is supposedly fixed in v3.4b21 but 449 only if you manually add a registry key. This fix is not yet 450 confirmed. (detected by getID3()) 451* CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment 452 strings, supposed to be in the format "NAME=value" but actually 453 written just "value" (detected by getID3()) 454* Oggenc 0.9-rc3 flags the encoded file as ABR whether it's 455 actually ABR or VBR. 456* iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably 457 other versions are too) writes ID3v2.3 comment tags using a 458 frame name 'COM ' which is not valid for ID3v2.3+ (it's an 459 ID3v2.2-style frame name) (detected by getID3()) 460* MP2enc does not encode mono CBR MP2 files properly (half speed 461 sound and double playtime) 462* MP2enc does not encode mono VBR MP2 files properly (actually 463 encoded as stereo) 464* tooLAME does not encode mono VBR MP2 files properly (actually 465 encoded as stereo) 466* AACenc encodes files in VBR mode (actually ABR) even if CBR is 467 specified 468* AAC/ADIF - bitrate_mode = cbr for vbr files 469* LAME 3.90-3.92 prepends one frame of null data (space for the 470 LAME/VBR header, but it never gets written) when encoding in CBR 471 mode with the DLL 472* Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed 473 to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for 474 TwinVQF v2.0 (detected by getID3()) 475* Ahead Nero encodes TwinVQF files 1 second shorter than they 476 should be 477* AAC-ADTS files are always actually encoded VBR, even if CBR mode 478 is specified (the CBR-mode switches on the encoder enable ABR 479 mode, not CBR as such, but it's not possible to tell the 480 difference between such ABR files and true VBR) 481* STREAMINFO.audio_signature in OggFLAC is always null. "The reason 482 it's like that is because there is no seeking support in 483 libOggFLAC yet, so it has no way to go back and write the 484 computed sum after encoding. Seeking support in Ogg FLAC is the 485 #1 item for the next release." - Josh Coalson (FLAC developer) 486 NOTE: getID3() will calculate md5_data in a method similar to 487 other file formats, but that value cannot be compared to the 488 md5_data value from FLAC data in a FLAC file format. 489* STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 & 490 v0.4.0 - getID3() will calculate md5_data in a method similar to 491 other file formats, but that value cannot be compared to the 492 md5_data value from FLAC v0.5.0+ 493* RioPort (various versions including 2.0 and 3.11) tags ID3v2 with 494 a WCOM frame that has no data portion 495* Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis 496 files, thus making them corrupt. 497* Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the 498 last byte of data from an MP3 file when appending a new ID3v1 tag. 499 (detected by getID3()) 500* Lossless-Audio files encoded with and without the -noseek switch 501 do actually differ internally and therefore cannot match md5_data 502* iTunes has been known to append a new ID3v1 tag on the end of an 503 existing ID3v1 tag when ID3v2 tag is also present 504 (detected by getID3()) 505* MediaMonkey may write a blank RGAD ID3v2 frame but put actual 506 replay gain adjustments in a series of user-defined TXXX frames 507 (detected and handled by getID3() since v1.9.2) 508 509 510 511 512Reference material: 513=== 514 515[www.id3.org](http://www.id3.org) material now mirrored at <http://id3lib.sourceforge.net/id3/> 516 517* http://www.id3.org/id3v2.4.0-structure.txt 518* http://www.id3.org/id3v2.4.0-frames.txt 519* http://www.id3.org/id3v2.4.0-changes.txt 520* http://www.id3.org/id3v2.3.0.txt 521* http://www.id3.org/id3v2-00.txt 522* http://www.id3.org/mp3frame.html 523* http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html <mathewhendry@hotmail.com> 524* http://www.dv.co.yu/mpgscript/mpeghdr.htm 525* http://www.mp3-tech.org/programmer/frame_header.html 526* http://users.belgacom.net/gc247244/extra/tag.html 527* http://gabriel.mp3-tech.org/mp3infotag.html 528* http://www.id3.org/iso4217.html 529* http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT 530* http://www.xiph.org/ogg/vorbis/doc/framing.html 531* http://www.xiph.org/ogg/vorbis/doc/v-comment.html 532* http://leknor.com/code/php/class.ogg.php.txt 533* http://www.id3.org/iso639-2.html 534* http://www.id3.org/lyrics3.html 535* http://www.id3.org/lyrics3200.html 536* http://www.psc.edu/general/software/packages/ieee/ieee.html 537* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html 538* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html 539* http://www.jmcgowan.com/avi.html 540* http://www.wotsit.org/ 541* http://www.herdsoft.com/ti/davincie/davp3xo2.htm 542* http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html 543* "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org) 544* http://midistudio.com/Help/GMSpecs_Patches.htm 545* http://www.xiph.org/archives/vorbis/200109/0459.html 546* http://www.replaygain.org/ 547* http://www.lossless-audio.com/ 548* http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe 549* http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf 550* http://www.uni-jena.de/~pfk/mpp/sv8/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/sv8/) 551* http://jfaul.de/atl/ 552* http://www.uni-jena.de/~pfk/mpp/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/) 553* http://www.libpng.org/pub/png/spec/png-1.2-pdg.html 554* http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm 555* http://www.fastgraph.com/help/bmp_os2_header_format.html 556* http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm 557* http://flac.sourceforge.net/format.html 558* http://www.research.att.com/projects/mpegaudio/mpeg2.html 559* http://www.audiocoding.com/wiki/index.php?page=AAC 560* http://libmpeg.org/mpeg4/doc/w2203tfs.pdf 561* http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt 562* http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm 563* http://www.nullsoft.com/nsv/ 564* http://www.wotsit.org/download.asp?f=iso9660 565* http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html 566* http://www.cdroller.com/htm/readdata.html 567* http://www.speex.org/manual/node10.html 568* http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc 569* http://www.faqs.org/rfcs/rfc2361.html 570* http://ghido.shelter.ro/ 571* http://www.ebu.ch/tech_t3285.pdf 572* http://www.sr.se/utveckling/tu/bwf 573* http://ftp.aessc.org/pub/aes46-2002.pdf 574* http://cartchunk.org:8080/ 575* http://www.broadcastpapers.com/radio/cartchunk01.htm 576* http://www.hr/josip/DSP/AudioFile2.html 577* http://home.attbi.com/~chris.bagwell/AudioFormats-11.html 578* http://www.pure-mac.com/extkey.html 579* http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt 580* http://www.headbands.com/gspot/ 581* http://www.openswf.org/spec/SWFfileformat.html 582* http://j-faul.virtualave.net/ 583* http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html 584* http://cui.unige.ch/OSG/info/AudioFormats/ap11.html 585* http://sswf.sourceforge.net/SWFalexref.html 586* http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt 587* http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm 588* http://developer.apple.com/quicktime/icefloe/dispatch012.html 589* http://www.csdn.net/Dev/Format/graphics/PCD.htm 590* http://tta.iszf.irk.ru/ 591* http://www.atsc.org/standards/a_52a.pdf 592* http://www.alanwood.net/unicode/ 593* http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html 594* http://www.its.msstate.edu/net/real/reports/config/tags.stats 595* http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt 596* http://brennan.young.net/Comp/LiveStage/things.html 597* http://www.multiweb.cz/twoinches/MP3inside.htm 598* http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended 599* http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ 600* http://www.unicode.org/unicode/faq/utf_bom.html 601* http://tta.corecodec.org/?menu=format 602* http://www.scvi.net/nsvformat.htm 603* http://pda.etsi.org/pda/queryform.asp 604* http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm 605* http://trac.musepack.net/trac/wiki/SV8Specification 606* http://wyday.com/cuesharp/specification.php 607* http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html 608
readme.txt
1///////////////////////////////////////////////////////////////// 2/// getID3() by James Heinrich <info@getid3.org> // 3// available at http://getid3.sourceforge.net // 4// or https://www.getid3.org // 5// also https://github.com/JamesHeinrich/getID3 // 6///////////////////////////////////////////////////////////////// 7 8***************************************************************** 9***************************************************************** 10 11 getID3() is released under multiple licenses. You may choose 12 from the following licenses, and use getID3 according to the 13 terms of the license most suitable to your project. 14 15GNU GPL: https://gnu.org/licenses/gpl.html (v3) 16 https://gnu.org/licenses/old-licenses/gpl-2.0.html (v2) 17 https://gnu.org/licenses/old-licenses/gpl-1.0.html (v1) 18 19GNU LGPL: https://gnu.org/licenses/lgpl.html (v3) 20 21Mozilla MPL: https://www.mozilla.org/MPL/2.0/ (v2) 22 23getID3 Commercial License: https://www.getid3.org/#gCL (payment required) 24 25***************************************************************** 26***************************************************************** 27Copies of each of the above licenses are included in the 'licenses' 28directory of the getID3 distribution. 29 30 31 +----------------------------------------------+ 32 | If you want to donate, there is a link on | 33 | https://www.getid3.org for PayPal donations. | 34 +----------------------------------------------+ 35 36 37Quick Start 38=========================================================================== 39 40Q: How can I check that getID3() works on my server/files? 41A: Unzip getID3() to a directory, then access /demos/demo.browse.php 42 43 44 45Support 46=========================================================================== 47 48Q: I have a question, or I found a bug. What do I do? 49A: The preferred method of support requests and/or bug reports is the 50 forum at http://support.getid3.org/ 51 52 53 54Sourceforge Notification 55=========================================================================== 56 57It's highly recommended that you sign up for notification from 58Sourceforge for when new versions are released. Please visit: 59http://sourceforge.net/project/showfiles.php?group_id=55859 60and click the little "monitor package" icon/link. If you're 61previously signed up for the mailing list, be aware that it has 62been discontinued, only the automated Sourceforge notification 63will be used from now on. 64 65 66 67What does getID3() do? 68=========================================================================== 69 70Reads & parses (to varying degrees): 71 ¤ tags: 72 * APE (v1 and v2) 73 * ID3v1 (& ID3v1.1) 74 * ID3v2 (v2.4, v2.3, v2.2) 75 * Lyrics3 (v1 & v2) 76 77 ¤ audio-lossy: 78 * MP3/MP2/MP1 79 * MPC / Musepack 80 * Ogg (Vorbis, OggFLAC, Speex, Opus) 81 * AAC / MP4 82 * AC3 83 * DTS 84 * RealAudio 85 * Speex 86 * DSS 87 * VQF 88 89 ¤ audio-lossless: 90 * AIFF 91 * AU 92 * Bonk 93 * CD-audio (*.cda) 94 * FLAC 95 * LA (Lossless Audio) 96 * LiteWave 97 * LPAC 98 * MIDI 99 * Monkey's Audio 100 * OptimFROG 101 * RKAU 102 * Shorten 103 * TTA 104 * VOC 105 * WAV (RIFF) 106 * WavPack 107 108 ¤ audio-video: 109 * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) 110 * AVI (RIFF) 111 * Flash 112 * Matroska (MKV) 113 * MPEG-1 / MPEG-2 114 * NSV (Nullsoft Streaming Video) 115 * Quicktime (including MP4) 116 * RealVideo 117 118 ¤ still image: 119 * BMP 120 * GIF 121 * JPEG 122 * PNG 123 * TIFF 124 * SWF (Flash) 125 * PhotoCD 126 127 ¤ data: 128 * ISO-9660 CD-ROM image (directory structure) 129 * SZIP (limited support) 130 * ZIP (directory structure) 131 * TAR 132 * CUE 133 134 135Writes: 136 * ID3v1 (& ID3v1.1) 137 * ID3v2 (v2.3 & v2.4) 138 * VorbisComment on OggVorbis 139 * VorbisComment on FLAC (not OggFLAC) 140 * APE v2 141 * Lyrics3 (delete only) 142 143 144 145Requirements 146=========================================================================== 147 148* PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier) 149* PHP 5.0.5 (or higher) for getID3() 1.8.x (and up) 150* PHP 5.3.0 (or higher) for getID3() 1.9.17 (and up) 151* PHP 5.3.0 (or higher) for getID3() 2.0.x (and up) 152* at least 4MB memory for PHP. 8MB or more is highly recommended. 153 12MB is required with all modules loaded. 154 155 156 157Usage 158=========================================================================== 159 160See /demos/demo.basic.php for a very basic use of getID3() with no 161fancy output, just scanning one file. 162 163See structure.txt for the returned data structure. 164 165*> For an example of a complete directory-browsing, <* 166*> file-scanning implementation of getID3(), please run <* 167*> /demos/demo.browse.php <* 168 169See /demos/demo.mysql.php for a sample recursive scanning code that 170scans every file in a given directory, and all sub-directories, stores 171the results in a database and allows various analysis / maintenance 172operations 173 174To analyze remote files over HTTP or FTP you need to copy the file 175locally first before running getID3(). Your code would look something 176like this: 177 178// Copy remote file locally to scan with getID3() 179$remotefilename = 'http://www.example.com/filename.mp3'; 180if ($fp_remote = fopen($remotefilename, 'rb')) { 181 $localtempfilename = tempnam('/tmp', 'getID3'); 182 if ($fp_local = fopen($localtempfilename, 'wb')) { 183 while ($buffer = fread($fp_remote, 32768)) { 184 fwrite($fp_local, $buffer); 185 } 186 fclose($fp_local); 187 188 $remote_headers = array_change_key_case(get_headers($remotefilename, 1), CASE_LOWER); 189 $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); 190 191 // Initialize getID3 engine 192 $getID3 = new getID3; 193 194 $ThisFileInfo = $getID3->analyze($localtempfilename, $remote_filesize, basename($remotefilename)); 195 196 // Delete temporary file 197 unlink($localtempfilename); 198 } 199 fclose($fp_remote); 200} 201 202Note: since v1.9.9-20150212 it is possible a second and third parameter 203to $getID3->analyze(), for original filesize and original filename 204respectively. This permits you to download only a portion of a large remote 205file but get accurate playtime estimates, assuming the format only requires 206the beginning of the file for correct format analysis. 207 208See /demos/demo.write.php for how to write tags. 209 210 211 212What does the returned data structure look like? 213=========================================================================== 214 215See structure.txt 216 217It is recommended that you look at the output of 218/demos/demo.browse.php scanning the file(s) you're interested in to 219confirm what data is actually returned for any particular filetype in 220general, and your files in particular, as the actual data returned 221may vary considerably depending on what information is available in 222the file itself. 223 224 225 226Notes 227=========================================================================== 228 229getID3() 1.x: 230If the format parser encounters a critical problem, it will return 231something in $fileinfo['error'], describing the encountered error. If 232a less critical error or notice is generated it will appear in 233$fileinfo['warning']. Both keys may contain more than one warning or 234error. If something is returned in ['error'] then the file was not 235correctly parsed and returned data may or may not be correct and/or 236complete. If something is returned in ['warning'] (and not ['error']) 237then the data that is returned is OK - usually getID3() is reporting 238errors in the file that have been worked around due to known bugs in 239other programs. Some warnings may indicate that the data that is 240returned is OK but that some data could not be extracted due to 241errors in the file. 242 243getID3() 2.x: 244See above except errors are thrown (so you will only get one error). 245 246 247 248Disclaimer 249=========================================================================== 250 251getID3() has been tested on many systems, on many types of files, 252under many operating systems, and is generally believe to be stable 253and safe. That being said, there is still the chance there is an 254undiscovered and/or unfixed bug that may potentially corrupt your 255file, especially within the writing functions. By using getID3() you 256agree that it's not my fault if any of your files are corrupted. 257In fact, I'm not liable for anything :) 258 259 260 261License 262=========================================================================== 263 264GNU General Public License - see license.txt 265 266This program is free software; you can redistribute it and/or 267modify it under the terms of the GNU General Public License 268as published by the Free Software Foundation; either version 2 269of the License, or (at your option) any later version. 270 271This program is distributed in the hope that it will be useful, 272but WITHOUT ANY WARRANTY; without even the implied warranty of 273MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 274GNU General Public License for more details. 275 276You should have received a copy of the GNU General Public License 277along with this program; if not, write to: 278Free Software Foundation, Inc. 27959 Temple Place - Suite 330 280Boston, MA 02111-1307, USA. 281 282FAQ: 283Q: Can I use getID3() in my program? Do I need a commercial license? 284A: You're generally free to use getID3 however you see fit. The only 285 case in which you would require a commercial license is if you're 286 selling your closed-source program that integrates getID3. If you 287 sell your program including a copy of getID3, that's fine as long 288 as you include a copy of the sourcecode when you sell it. Or you 289 can distribute your code without getID3 and say "download it from 290 getid3.sourceforge.net" 291 292 293 294Why is it called "getID3()" if it does so much more than just that? 295=========================================================================== 296 297v0.1 did in fact just do that. I don't have a copy of code that old, but I 298could essentially write it today with a one-line function: 299 function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); } 300 301 302Future Plans 303=========================================================================== 304https://www.getid3.org/phpBB3/viewforum.php?f=7 305 306* Better support for MP4 container format 307* Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0) 308* Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm) 309* Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669) 310* Support for ACE (thanks Vince) 311* Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid) 312* Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header 313* Ability to "clean" ID3v2 padding (replace invalid padding with valid padding) 314* Warn if MP3s change version mid-stream (in full-scan mode) 315* check for corrupt/broken mid-file MP3 streams in histogram scan 316* Support for lossless-compression formats 317 (http://www.firstpr.com.au/audiocomp/lossless/#Links) 318 (http://compression.ca/act-sound.html) 319 (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) 320* Support for RIFF-INFO chunks 321 * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html 322 (thanks Nick Humfrey <njhØsurgeradio*co*uk>) 323 * http://abcavi.narod.ru/sof/abcavi/infotags.htm 324 (thanks Kibi) 325* Better support for Bink video 326* http://www.hr/josip/DSP/AudioFile2.html 327* http://www.pcisys.net/~melanson/codecs/ 328* Detect mp3PRO 329* Support for PSD 330* Support for JPC 331* Support for JP2 332* Support for JPX 333* Support for JB2 334* Support for IFF 335* Support for ICO 336* Support for ANI 337* Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) 338* Support for DVD-IFO (region, subtitles, aspect ratio, etc) 339 (thanks p*quaedackersØplanet*nl) 340* More complete support for SWF - parsing encapsulated MP3 and/or JPEG content 341 (thanks n8n8Øyahoo*com) 342* Support for a2b 343* Optional scan-through-frames for AVI verification 344 (thanks rockcohenØmassive-interactive*nl) 345* Support for TTF (thanks infoØbutterflyx*com) 346* Support for DSS (https://www.getid3.org/phpBB3/viewtopic.php?t=171) 347* Support for SMAF (http://smaf-yamaha.com/what/demo.html) 348 https://www.getid3.org/phpBB3/viewtopic.php?t=182 349* Support for AMR (https://www.getid3.org/phpBB3/viewtopic.php?t=195) 350* Support for 3gpp (https://www.getid3.org/phpBB3/viewtopic.php?t=195) 351* Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) 352* Parse XML data returned in Ogg comments 353* Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) 354* ID3v2 genre string creator function 355* More complete parsing of JPG 356* Support for all old-style ASF packets 357* ASF/WMA/WMV tag writing 358* Parse declared T??? ID3v2 text information frames, where appropriate 359 (thanks Christian Fritz for the idea) 360* Recognize encoder: 361 http://www.guerillasoft.com/EncSpot2/index.html 362 http://ff123.net/identify.html 363 http://www.hydrogenaudio.org/?act=ST&f=16&t=9414 364 http://www.hydrogenaudio.org/?showtopic=11785 365* Support for other OS/2 bitmap structures: Bitmap Array('BA'), 366 Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT') 367 http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm 368* Support for WavPack RAW mode 369* ASF/WMA/WMV data packet parsing 370* ID3v2FrameFlagsLookupTagAlter() 371* ID3v2FrameFlagsLookupFileAlter() 372* obey ID3v2 tag alter/preserve/discard rules 373* http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm 374* proper checking for LINK/LNK frame validity in ID3v2 writing 375* proper checking for ASPI-TLEN frame validity in ID3v2 writing 376* proper checking for COMR frame validity in ID3v2 writing 377* http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html 378* decode GEOB ID3v2 structure as encoded by RealJukebox, 379 decode NCON ID3v2 structure as encoded by MusicMatch 380 (probably won't happen - the formats are proprietary) 381 382 383 384Known Bugs/Issues in getID3() that may be fixed eventually 385=========================================================================== 386https://www.getid3.org/phpBB3/viewtopic.php?t=25 387 388* Cannot determine bitrate for MPEG video with VBR video data 389 (need documentation) 390* Interlace/progressive cannot be determined for MPEG video 391 (need documentation) 392* MIDI playtime is sometimes inaccurate 393* AAC-RAW mode files cannot be identified 394* WavPack-RAW mode files cannot be identified 395* mp4 files report lots of "Unknown QuickTime atom type" 396 (need documentation) 397* Encrypted ASF/WMA/WMV files warn about "unhandled GUID 398 ASF_Content_Encryption_Object" 399* Bitrate split between audio and video cannot be calculated for 400 NSV, only the total bitrate. (need documentation) 401* All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the 402 problem of large VorbisComments spanning multiple Ogg pages, but 403 but only OggVorbis files can be processed with vorbiscomment. 404* The version of "head" supplied with Mac OS 10.2.8 (maybe other 405 versions too) does only understands a single option (-n) and 406 therefore fails. getID3 ignores this and returns wrong md5_data. 407 408 409 410Known Bugs/Issues in getID3() that cannot be fixed 411-------------------------------------------------- 412https://www.getid3.org/phpBB3/viewtopic.php?t=25 413 414* 32-bit PHP installations only: 415 Files larger than 2GB cannot always be parsed fully by getID3() 416 due to limitations in the 32-bit PHP filesystem functions. 417 NOTE: Since v1.7.8b3 there is partial support for larger-than- 418 2GB files, most of which will parse OK, as long as no critical 419 data is located beyond the 2GB offset. 420 Known will-work: 421 * all file formats on 64-bit PHP 422 * ZIP (format doesn't support files >2GB) 423 * FLAC (current encoders don't support files >2GB) 424 Known will-not-work: 425 * ID3v1 tags (always located at end-of-file) 426 * Lyrics3 tags (always located at end-of-file) 427 * APE tags (always located at end-of-file) 428 Maybe-will-work: 429 * Quicktime (will work if needed metadata is before 2GB offset, 430 that is if the file has been hinted/optimized for streaming) 431 * RIFF.WAV (should work fine, but gives warnings about not being 432 able to parse all chunks) 433 * RIFF.AVI (playtime will probably be wrong, is only based on 434 "movi" chunk that fits in the first 2GB, should issue error 435 to show that playtime is incorrect. Other data should be mostly 436 correct, assuming that data is constant throughout the file) 437* PHP <= v5 on Windows cannot read UTF-8 filenames 438 439 440Known Bugs/Issues in other programs 441----------------------------------- 442https://www.getid3.org/phpBB3/viewtopic.php?t=25 443 444* MusicBrainz Picard (at least up to v1.3.2) writes multiple 445 ID3v2.3 genres in non-standard forward-slash separated text 446 rather than parenthesis-numeric+refinement style per the ID3v2.3 447 specs. Tags written in ID3v2.4 mode are written correctly. 448 (detected and worked around by getID3()) 449* PZ TagEditor v4.53.408 has been known to insert ID3v2.3 frames 450 into an existing ID3v2.2 tag which, of course, breaks things 451* Windows Media Player (up to v11) and iTunes (up to v10+) do 452 not correctly handle ID3v2.3 tags with UTF-16BE+BOM 453 encoding (they assume the data is UTF-16LE+BOM and either 454 crash (WMP) or output Asian character set (iTunes) 455* Winamp (up to v2.80 at least) does not support ID3v2.4 tags, 456 only ID3v2.3 457 see: http://forums.winamp.com/showthread.php?postid=387524 458* Some versions of Helium2 (www.helium2.com) do not write 459 ID3v2.4-compliant Frame Sizes, even though the tag is marked 460 as ID3v2.4) (detected by getID3()) 461* MP3ext V3.3.17 places a non-compliant padding string at the end 462 of the ID3v2 header. This is supposedly fixed in v3.4b21 but 463 only if you manually add a registry key. This fix is not yet 464 confirmed. (detected by getID3()) 465* CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment 466 strings, supposed to be in the format "NAME=value" but actually 467 written just "value" (detected by getID3()) 468* Oggenc 0.9-rc3 flags the encoded file as ABR whether it's 469 actually ABR or VBR. 470* iTunes (versions "v7.0.0.70" is known-guilty, probably 471 other versions are too) writes ID3v2.3 comment tags using an 472 ID3v2.2 frame name (3-bytes) null-padded to 4 bytes which is 473 not valid for ID3v2.3+ 474 (detected by getID3() since 1.9.12-201603221746) 475* iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably 476 other versions are too) writes ID3v2.3 comment tags using a 477 frame name 'COM ' which is not valid for ID3v2.3+ (it's an 478 ID3v2.2-style frame name) (detected by getID3()) 479* MP2enc does not encode mono CBR MP2 files properly (half speed 480 sound and double playtime) 481* MP2enc does not encode mono VBR MP2 files properly (actually 482 encoded as stereo) 483* tooLAME does not encode mono VBR MP2 files properly (actually 484 encoded as stereo) 485* AACenc encodes files in VBR mode (actually ABR) even if CBR is 486 specified 487* AAC/ADIF - bitrate_mode = cbr for vbr files 488* LAME 3.90-3.92 prepends one frame of null data (space for the 489 LAME/VBR header, but it never gets written) when encoding in CBR 490 mode with the DLL 491* Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed 492 to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for 493 TwinVQF v2.0 (detected by getID3()) 494* Ahead Nero encodes TwinVQF files 1 second shorter than they 495 should be 496* AAC-ADTS files are always actually encoded VBR, even if CBR mode 497 is specified (the CBR-mode switches on the encoder enable ABR 498 mode, not CBR as such, but it's not possible to tell the 499 difference between such ABR files and true VBR) 500* STREAMINFO.audio_signature in OggFLAC is always null. "The reason 501 it's like that is because there is no seeking support in 502 libOggFLAC yet, so it has no way to go back and write the 503 computed sum after encoding. Seeking support in Ogg FLAC is the 504 #1 item for the next release." - Josh Coalson (FLAC developer) 505 NOTE: getID3() will calculate md5_data in a method similar to 506 other file formats, but that value cannot be compared to the 507 md5_data value from FLAC data in a FLAC file format. 508* STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 & 509 v0.4.0 - getID3() will calculate md5_data in a method similar to 510 other file formats, but that value cannot be compared to the 511 md5_data value from FLAC v0.5.0+ 512* RioPort (various versions including 2.0 and 3.11) tags ID3v2 with 513 a WCOM frame that has no data portion 514* Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis 515 files, thus making them corrupt. 516* Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the 517 last byte of data from an MP3 file when appending a new ID3v1 tag. 518 (detected by getID3()) 519* Lossless-Audio files encoded with and without the -noseek switch 520 do actually differ internally and therefore cannot match md5_data 521* iTunes has been known to append a new ID3v1 tag on the end of an 522 existing ID3v1 tag when ID3v2 tag is also present 523 (detected by getID3()) 524* MediaMonkey may write a blank RGAD ID3v2 frame but put actual 525 replay gain adjustments in a series of user-defined TXXX frames 526 (detected and handled by getID3() since v1.9.2) 527 528 529 530 531Reference material: 532=========================================================================== 533 534[www.id3.org material now mirrored at http://id3lib.sourceforge.net/id3/] 535* http://www.id3.org/id3v2.4.0-structure.txt 536* http://www.id3.org/id3v2.4.0-frames.txt 537* http://www.id3.org/id3v2.4.0-changes.txt 538* http://www.id3.org/id3v2.3.0.txt 539* http://www.id3.org/id3v2-00.txt 540* http://www.id3.org/mp3frame.html 541* http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html <mathewhendry@hotmail.com> 542* http://www.dv.co.yu/mpgscript/mpeghdr.htm 543* http://www.mp3-tech.org/programmer/frame_header.html 544* http://users.belgacom.net/gc247244/extra/tag.html 545* http://gabriel.mp3-tech.org/mp3infotag.html 546* http://www.id3.org/iso4217.html 547* http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT 548* http://www.xiph.org/ogg/vorbis/doc/framing.html 549* http://www.xiph.org/ogg/vorbis/doc/v-comment.html 550* http://leknor.com/code/php/class.ogg.php.txt 551* http://www.id3.org/iso639-2.html 552* http://www.id3.org/lyrics3.html 553* http://www.id3.org/lyrics3200.html 554* http://www.psc.edu/general/software/packages/ieee/ieee.html 555* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html 556* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html 557* http://www.jmcgowan.com/avi.html 558* http://www.wotsit.org/ 559* http://www.herdsoft.com/ti/davincie/davp3xo2.htm 560* http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html 561* "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org) 562* http://midistudio.com/Help/GMSpecs_Patches.htm 563* http://www.xiph.org/archives/vorbis/200109/0459.html 564* http://www.replaygain.org/ 565* http://www.lossless-audio.com/ 566* http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe 567* http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf 568* http://www.uni-jena.de/~pfk/mpp/sv8/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/sv8/) 569* http://jfaul.de/atl/ 570* http://www.uni-jena.de/~pfk/mpp/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/) 571* http://www.libpng.org/pub/png/spec/png-1.2-pdg.html 572* http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm 573* http://www.fastgraph.com/help/bmp_os2_header_format.html 574* http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm 575* http://flac.sourceforge.net/format.html 576* http://www.research.att.com/projects/mpegaudio/mpeg2.html 577* http://www.audiocoding.com/wiki/index.php?page=AAC 578* http://libmpeg.org/mpeg4/doc/w2203tfs.pdf 579* http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt 580* http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm 581* http://www.nullsoft.com/nsv/ 582* http://www.wotsit.org/download.asp?f=iso9660 583* http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html 584* http://www.cdroller.com/htm/readdata.html 585* http://www.speex.org/manual/node10.html 586* http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc 587* http://www.faqs.org/rfcs/rfc2361.html 588* http://ghido.shelter.ro/ 589* http://www.ebu.ch/tech_t3285.pdf 590* http://www.sr.se/utveckling/tu/bwf 591* http://ftp.aessc.org/pub/aes46-2002.pdf 592* http://cartchunk.org:8080/ 593* http://www.broadcastpapers.com/radio/cartchunk01.htm 594* http://www.hr/josip/DSP/AudioFile2.html 595* http://home.attbi.com/~chris.bagwell/AudioFormats-11.html 596* http://www.pure-mac.com/extkey.html 597* http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt 598* http://www.headbands.com/gspot/ 599* http://www.openswf.org/spec/SWFfileformat.html 600* http://j-faul.virtualave.net/ 601* http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html 602* http://cui.unige.ch/OSG/info/AudioFormats/ap11.html 603* http://sswf.sourceforge.net/SWFalexref.html 604* http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt 605* http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm 606* http://developer.apple.com/quicktime/icefloe/dispatch012.html 607* http://www.csdn.net/Dev/Format/graphics/PCD.htm 608* http://tta.iszf.irk.ru/ 609* http://www.atsc.org/standards/a_52a.pdf 610* http://www.alanwood.net/unicode/ 611* http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html 612* http://www.its.msstate.edu/net/real/reports/config/tags.stats 613* http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt 614* http://brennan.young.net/Comp/LiveStage/things.html 615* http://www.multiweb.cz/twoinches/MP3inside.htm 616* http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended 617* http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ 618* http://www.unicode.org/unicode/faq/utf_bom.html 619* http://tta.corecodec.org/?menu=format 620* http://www.scvi.net/nsvformat.htm 621* http://pda.etsi.org/pda/queryform.asp 622* http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm 623* http://trac.musepack.net/trac/wiki/SV8Specification 624* http://wyday.com/cuesharp/specification.php 625* http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html 626* http://www.codeproject.com/Articles/8295/MPEG-Audio-Frame-Header 627* http://dsd-guide.com/sites/default/files/white-papers/DSFFileFormatSpec_E.pdf 628