1 ///////////////////////////////////////////////////////////////// |
1 ///////////////////////////////////////////////////////////////// |
2 /// getID3() by James Heinrich <info@getid3.org> // |
2 /// getID3() by James Heinrich <info@getid3.org> // |
3 // available at http://getid3.sourceforge.net // |
3 // available at http://getid3.sourceforge.net // |
4 // or http://www.getid3.org // |
4 // or http://www.getid3.org // |
|
5 // also https://github.com/JamesHeinrich/getID3 // |
5 ///////////////////////////////////////////////////////////////// |
6 ///////////////////////////////////////////////////////////////// |
6 |
7 |
7 ***************************************************************** |
8 ***************************************************************** |
8 ***************************************************************** |
9 ***************************************************************** |
9 |
10 |
65 |
66 |
66 What does getID3() do? |
67 What does getID3() do? |
67 =========================================================================== |
68 =========================================================================== |
68 |
69 |
69 Reads & parses (to varying degrees): |
70 Reads & parses (to varying degrees): |
70 # tags: |
71 ¤ tags: |
71 * APE (v1 and v2) |
72 * APE (v1 and v2) |
72 * ID3v1 (& ID3v1.1) |
73 * ID3v1 (& ID3v1.1) |
73 * ID3v2 (v2.4, v2.3, v2.2) |
74 * ID3v2 (v2.4, v2.3, v2.2) |
74 * Lyrics3 (v1 & v2) |
75 * Lyrics3 (v1 & v2) |
75 |
76 |
76 # audio-lossy: |
77 ¤ audio-lossy: |
77 * MP3/MP2/MP1 |
78 * MP3/MP2/MP1 |
78 * MPC / Musepack |
79 * MPC / Musepack |
79 * Ogg (Vorbis, OggFLAC, Speex) |
80 * Ogg (Vorbis, OggFLAC, Speex) |
80 * AAC / MP4 |
81 * AAC / MP4 |
81 * AC3 |
82 * AC3 |
102 * TTA |
103 * TTA |
103 * VOC |
104 * VOC |
104 * WAV (RIFF) |
105 * WAV (RIFF) |
105 * WavPack |
106 * WavPack |
106 |
107 |
107 # audio-video: |
108 ¤ audio-video: |
108 * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) |
109 * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) |
109 * AVI (RIFF) |
110 * AVI (RIFF) |
110 * Flash |
111 * Flash |
111 * Matroska (MKV) |
112 * Matroska (MKV) |
112 * MPEG-1 / MPEG-2 |
113 * MPEG-1 / MPEG-2 |
113 * NSV (Nullsoft Streaming Video) |
114 * NSV (Nullsoft Streaming Video) |
114 * Quicktime (including MP4) |
115 * Quicktime (including MP4) |
115 * RealVideo |
116 * RealVideo |
116 |
117 |
117 # still image: |
118 ¤ still image: |
118 * BMP |
119 * BMP |
119 * GIF |
120 * GIF |
120 * JPEG |
121 * JPEG |
121 * PNG |
122 * PNG |
122 * TIFF |
123 * TIFF |
123 * SWF (Flash) |
124 * SWF (Flash) |
124 * PhotoCD |
125 * PhotoCD |
125 |
126 |
126 # data: |
127 ¤ data: |
127 * ISO-9660 CD-ROM image (directory structure) |
128 * ISO-9660 CD-ROM image (directory structure) |
128 * SZIP (limited support) |
129 * SZIP (limited support) |
129 * ZIP (directory structure) |
130 * ZIP (directory structure) |
130 * TAR |
131 * TAR |
131 * CUE |
132 * CUE |
307 (http://www.firstpr.com.au/audiocomp/lossless/#Links) |
308 (http://www.firstpr.com.au/audiocomp/lossless/#Links) |
308 (http://compression.ca/act-sound.html) |
309 (http://compression.ca/act-sound.html) |
309 (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) |
310 (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) |
310 * Support for RIFF-INFO chunks |
311 * Support for RIFF-INFO chunks |
311 * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html |
312 * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html |
312 (thanks Nick Humfrey <njh@surgeradio*co*uk>) |
313 (thanks Nick Humfrey <njhØsurgeradio*co*uk>) |
313 * http://abcavi.narod.ru/sof/abcavi/infotags.htm |
314 * http://abcavi.narod.ru/sof/abcavi/infotags.htm |
314 (thanks Kibi) |
315 (thanks Kibi) |
315 * Better support for Bink video |
316 * Better support for Bink video |
316 * http://www.hr/josip/DSP/AudioFile2.html |
317 * http://www.hr/josip/DSP/AudioFile2.html |
317 * http://www.pcisys.net/~melanson/codecs/ |
318 * http://www.pcisys.net/~melanson/codecs/ |
322 * Support for JPX |
323 * Support for JPX |
323 * Support for JB2 |
324 * Support for JB2 |
324 * Support for IFF |
325 * Support for IFF |
325 * Support for ICO |
326 * Support for ICO |
326 * Support for ANI |
327 * Support for ANI |
327 * Support for EXE (comments, author, etc) (thanks p*quaedackers@planet*nl) |
328 * Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) |
328 * Support for DVD-IFO (region, subtitles, aspect ratio, etc) |
329 * Support for DVD-IFO (region, subtitles, aspect ratio, etc) |
329 (thanks p*quaedackers@planet*nl) |
330 (thanks p*quaedackersØplanet*nl) |
330 * More complete support for SWF - parsing encapsulated MP3 and/or JPEG content |
331 * More complete support for SWF - parsing encapsulated MP3 and/or JPEG content |
331 (thanks n8n8@yahoo*com) |
332 (thanks n8n8Øyahoo*com) |
332 * Support for a2b |
333 * Support for a2b |
333 * Optional scan-through-frames for AVI verification |
334 * Optional scan-through-frames for AVI verification |
334 (thanks rockcohen@massive-interactive*nl) |
335 (thanks rockcohenØmassive-interactive*nl) |
335 * Support for TTF (thanks info@butterflyx*com) |
336 * Support for TTF (thanks infoØbutterflyx*com) |
336 * Support for DSS (http://www.getid3.org/phpBB3/viewtopic.php?t=171) |
337 * Support for DSS (http://www.getid3.org/phpBB3/viewtopic.php?t=171) |
337 * Support for SMAF (http://smaf-yamaha.com/what/demo.html) |
338 * Support for SMAF (http://smaf-yamaha.com/what/demo.html) |
338 http://www.getid3.org/phpBB3/viewtopic.php?t=182 |
339 http://www.getid3.org/phpBB3/viewtopic.php?t=182 |
339 * Support for AMR (http://www.getid3.org/phpBB3/viewtopic.php?t=195) |
340 * Support for AMR (http://www.getid3.org/phpBB3/viewtopic.php?t=195) |
340 * Support for 3gpp (http://www.getid3.org/phpBB3/viewtopic.php?t=195) |
341 * Support for 3gpp (http://www.getid3.org/phpBB3/viewtopic.php?t=195) |
341 * Support for ID4 (http://www.wackysoft.cjb.net grizlyY2K@hotmail*com) |
342 * Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) |
342 * Parse XML data returned in Ogg comments |
343 * Parse XML data returned in Ogg comments |
343 * Parse XML data from Quicktime SMIL metafiles (klausrath@mac*com) |
344 * Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) |
344 * ID3v2 genre string creator function |
345 * ID3v2 genre string creator function |
345 * More complete parsing of JPG |
346 * More complete parsing of JPG |
346 * Support for all old-style ASF packets |
347 * Support for all old-style ASF packets |
347 * ASF/WMA/WMV tag writing |
348 * ASF/WMA/WMV tag writing |
348 * Parse declared T??? ID3v2 text information frames, where appropriate |
349 * Parse declared T??? ID3v2 text information frames, where appropriate |
422 able to parse all chunks) |
423 able to parse all chunks) |
423 * RIFF.AVI (playtime will probably be wrong, is only based on |
424 * RIFF.AVI (playtime will probably be wrong, is only based on |
424 "movi" chunk that fits in the first 2GB, should issue error |
425 "movi" chunk that fits in the first 2GB, should issue error |
425 to show that playtime is incorrect. Other data should be mostly |
426 to show that playtime is incorrect. Other data should be mostly |
426 correct, assuming that data is constant throughout the file) |
427 correct, assuming that data is constant throughout the file) |
427 |
428 * PHP <= v5 on Windows cannot read UTF-8 filenames |
428 |
429 |
429 |
430 |
430 Known Bugs/Issues in other programs |
431 Known Bugs/Issues in other programs |
431 ----------------------------------- |
432 ----------------------------------- |
432 http://www.getid3.org/phpBB3/viewtopic.php?t=25 |
433 http://www.getid3.org/phpBB3/viewtopic.php?t=25 |