Файловый менеджер - Редактировать - /home/bean7936/perfect-community.com/442aa3/readme.txt.tar
Назад
home/bean7936/perfect-community.com/wp-includes/ID3/readme.txt 0000644 00000063332 15174677554 0020024 0 ustar 00 ///////////////////////////////////////////////////////////////// /// getID3() by James Heinrich <info@getid3.org> // // available at http://getid3.sourceforge.net // // or https://www.getid3.org // // also https://github.com/JamesHeinrich/getID3 // ///////////////////////////////////////////////////////////////// ***************************************************************** ***************************************************************** getID3() 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. GNU GPL: https://gnu.org/licenses/gpl.html (v3) https://gnu.org/licenses/old-licenses/gpl-2.0.html (v2) https://gnu.org/licenses/old-licenses/gpl-1.0.html (v1) GNU LGPL: https://gnu.org/licenses/lgpl.html (v3) Mozilla MPL: https://www.mozilla.org/MPL/2.0/ (v2) getID3 Commercial License: https://www.getid3.org/#gCL (no longer available, existing licenses remain valid) ***************************************************************** ***************************************************************** Copies of each of the above licenses are included in the 'licenses' directory of the getID3 distribution. +----------------------------------------------+ | If you want to donate, there is a link on | | https://www.getid3.org for PayPal donations. | +----------------------------------------------+ Quick Start =========================================================================== Q: How can I check that getID3() works on my server/files? A: Unzip getID3() to a directory, then access /demos/demo.browse.php Support =========================================================================== Q: I have a question, or I found a bug. What do I do? A: The preferred method of support requests and/or bug reports is the forum at http://support.getid3.org/ Sourceforge Notification =========================================================================== It's highly recommended that you sign up for notification from Sourceforge for when new versions are released. Please visit: http://sourceforge.net/project/showfiles.php?group_id=55859 and click the little "monitor package" icon/link. If you're previously signed up for the mailing list, be aware that it has been discontinued, only the automated Sourceforge notification will be used from now on. What does getID3() do? =========================================================================== Reads & parses (to varying degrees): ¤ tags: * APE (v1 and v2) * ID3v1 (& ID3v1.1) * ID3v2 (v2.4, v2.3, v2.2) * Lyrics3 (v1 & v2) ¤ audio-lossy: * MP3/MP2/MP1 * MPC / Musepack * Ogg (Vorbis, OggFLAC, Speex, Opus) * AAC / MP4 * AC3 * DTS * RealAudio * Speex * DSS * VQF ¤ audio-lossless: * AIFF * AU * Bonk * CD-audio (*.cda) * FLAC * LA (Lossless Audio) * LiteWave * LPAC * MIDI * Monkey's Audio * OptimFROG * RKAU * Shorten * TTA * VOC * WAV (RIFF) * WavPack ¤ audio-video: * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) * AVI (RIFF) * Flash * Matroska (MKV) * MPEG-1 / MPEG-2 * NSV (Nullsoft Streaming Video) * Quicktime (including MP4) * RealVideo ¤ still image: * BMP * GIF * JPEG * PNG * TIFF * SWF (Flash) * PhotoCD ¤ data: * ISO-9660 CD-ROM image (directory structure) * SZIP (limited support) * ZIP (directory structure) * TAR * CUE Writes: * ID3v1 (& ID3v1.1) * ID3v2 (v2.3 & v2.4) * VorbisComment on OggVorbis * VorbisComment on FLAC (not OggFLAC) * APE v2 * Lyrics3 (delete only) Requirements =========================================================================== * PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier) * PHP 5.0.5 (or higher) for getID3() 1.8.x (and up) * PHP 5.3.0 (or higher) for getID3() 1.9.17 (and up) * PHP 5.3.0 (or higher) for getID3() 2.0.x (and up) * at least 4MB memory for PHP. 8MB or more is highly recommended. 12MB is required with all modules loaded. Usage =========================================================================== See /demos/demo.basic.php for a very basic use of getID3() with no fancy output, just scanning one file. See structure.txt for the returned data structure. *> For an example of a complete directory-browsing, <* *> file-scanning implementation of getID3(), please run <* *> /demos/demo.browse.php <* See /demos/demo.mysql.php for a sample recursive scanning code that scans every file in a given directory, and all sub-directories, stores the results in a database and allows various analysis / maintenance operations To analyze remote files over HTTP or FTP you need to copy the file locally first before running getID3(). Your code would look something like this: // Copy remote file locally to scan with getID3() $remotefilename = 'http://www.example.com/filename.mp3'; if ($fp_remote = fopen($remotefilename, 'rb')) { $localtempfilename = tempnam('/tmp', 'getID3'); if ($fp_local = fopen($localtempfilename, 'wb')) { while ($buffer = fread($fp_remote, 32768)) { fwrite($fp_local, $buffer); } fclose($fp_local); $remote_headers = array_change_key_case(get_headers($remotefilename, 1), CASE_LOWER); $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); // Initialize getID3 engine $getID3 = new getID3; $ThisFileInfo = $getID3->analyze($localtempfilename, $remote_filesize, basename($remotefilename)); // Delete temporary file unlink($localtempfilename); } fclose($fp_remote); } Note: since v1.9.9-20150212 it is possible a second and third parameter to $getID3->analyze(), for original filesize and original filename respectively. This permits you to download only a portion of a large remote file but get accurate playtime estimates, assuming the format only requires the beginning of the file for correct format analysis. See /demos/demo.write.php for how to write tags. What does the returned data structure look like? =========================================================================== See structure.txt It is recommended that you look at the output of /demos/demo.browse.php scanning the file(s) you're interested in to confirm what data is actually returned for any particular filetype in general, and your files in particular, as the actual data returned may vary considerably depending on what information is available in the file itself. Notes =========================================================================== getID3() 1.x: If the format parser encounters a critical problem, it will return something in $fileinfo['error'], describing the encountered error. If a less critical error or notice is generated it will appear in $fileinfo['warning']. Both keys may contain more than one warning or error. If something is returned in ['error'] then the file was not correctly parsed and returned data may or may not be correct and/or complete. If something is returned in ['warning'] (and not ['error']) then the data that is returned is OK - usually getID3() is reporting errors in the file that have been worked around due to known bugs in other programs. Some warnings may indicate that the data that is returned is OK but that some data could not be extracted due to errors in the file. getID3() 2.x: See above except errors are thrown (so you will only get one error). Disclaimer =========================================================================== getID3() has been tested on many systems, on many types of files, under many operating systems, and is generally believe to be stable and safe. That being said, there is still the chance there is an undiscovered and/or unfixed bug that may potentially corrupt your file, especially within the writing functions. By using getID3() you agree that it's not my fault if any of your files are corrupted. In fact, I'm not liable for anything :) License =========================================================================== GNU General Public License - see license.txt This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to: Free Software Foundation, Inc. 59 Temple Place - Suite 330 Boston, MA 02111-1307, USA. FAQ: Q: Can I use getID3() in my program? Do I need a commercial license? A: You're generally free to use getID3 however you see fit. The only case in which you would require a commercial license is if you're selling your closed-source program that integrates getID3. If you sell your program including a copy of getID3, that's fine as long as you include a copy of the sourcecode when you sell it. Or you can distribute your code without getID3 and say "download it from getid3.sourceforge.net" Why is it called "getID3()" if it does so much more than just that? =========================================================================== v0.1 did in fact just do that. I don't have a copy of code that old, but I could essentially write it today with a one-line function: function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); } Future Plans =========================================================================== https://www.getid3.org/phpBB3/viewforum.php?f=7 * Better support for MP4 container format * Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0) * Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm) * Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669) * Support for ACE (thanks Vince) * Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid) * Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header * Ability to "clean" ID3v2 padding (replace invalid padding with valid padding) * Warn if MP3s change version mid-stream (in full-scan mode) * check for corrupt/broken mid-file MP3 streams in histogram scan * Support for lossless-compression formats (http://www.firstpr.com.au/audiocomp/lossless/#Links) (http://compression.ca/act-sound.html) (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) * Support for RIFF-INFO chunks * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html (thanks Nick Humfrey <njhØsurgeradio*co*uk>) * http://abcavi.narod.ru/sof/abcavi/infotags.htm (thanks Kibi) * Better support for Bink video * http://www.hr/josip/DSP/AudioFile2.html * http://www.pcisys.net/~melanson/codecs/ * Detect mp3PRO * Support for PSD * Support for JPC * Support for JP2 * Support for JPX * Support for JB2 * Support for IFF * Support for ICO * Support for ANI * Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) * Support for DVD-IFO (region, subtitles, aspect ratio, etc) (thanks p*quaedackersØplanet*nl) * More complete support for SWF - parsing encapsulated MP3 and/or JPEG content (thanks n8n8Øyahoo*com) * Support for a2b * Optional scan-through-frames for AVI verification (thanks rockcohenØmassive-interactive*nl) * Support for TTF (thanks infoØbutterflyx*com) * Support for DSS (https://www.getid3.org/phpBB3/viewtopic.php?t=171) * Support for SMAF (http://smaf-yamaha.com/what/demo.html) https://www.getid3.org/phpBB3/viewtopic.php?t=182 * Support for AMR (https://www.getid3.org/phpBB3/viewtopic.php?t=195) * Support for 3gpp (https://www.getid3.org/phpBB3/viewtopic.php?t=195) * Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) * Parse XML data returned in Ogg comments * Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) * ID3v2 genre string creator function * More complete parsing of JPG * Support for all old-style ASF packets * ASF/WMA/WMV tag writing * Parse declared T??? ID3v2 text information frames, where appropriate (thanks Christian Fritz for the idea) * Recognize encoder: http://www.guerillasoft.com/EncSpot2/index.html http://ff123.net/identify.html http://www.hydrogenaudio.org/?act=ST&f=16&t=9414 http://www.hydrogenaudio.org/?showtopic=11785 * Support for other OS/2 bitmap structures: Bitmap Array('BA'), Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT') http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm * Support for WavPack RAW mode * ASF/WMA/WMV data packet parsing * ID3v2FrameFlagsLookupTagAlter() * ID3v2FrameFlagsLookupFileAlter() * obey ID3v2 tag alter/preserve/discard rules * http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm * proper checking for LINK/LNK frame validity in ID3v2 writing * proper checking for ASPI-TLEN frame validity in ID3v2 writing * proper checking for COMR frame validity in ID3v2 writing * http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html * decode GEOB ID3v2 structure as encoded by RealJukebox, decode NCON ID3v2 structure as encoded by MusicMatch (probably won't happen - the formats are proprietary) Known Bugs/Issues in getID3() that may be fixed eventually =========================================================================== https://www.getid3.org/phpBB3/viewtopic.php?t=25 * Cannot determine bitrate for MPEG video with VBR video data (need documentation) * Interlace/progressive cannot be determined for MPEG video (need documentation) * MIDI playtime is sometimes inaccurate * AAC-RAW mode files cannot be identified * WavPack-RAW mode files cannot be identified * mp4 files report lots of "Unknown QuickTime atom type" (need documentation) * Encrypted ASF/WMA/WMV files warn about "unhandled GUID ASF_Content_Encryption_Object" * Bitrate split between audio and video cannot be calculated for NSV, only the total bitrate. (need documentation) * All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the problem of large VorbisComments spanning multiple Ogg pages, but but only OggVorbis files can be processed with vorbiscomment. * The version of "head" supplied with Mac OS 10.2.8 (maybe other versions too) does only understands a single option (-n) and therefore fails. getID3 ignores this and returns wrong md5_data. Known Bugs/Issues in getID3() that cannot be fixed -------------------------------------------------- https://www.getid3.org/phpBB3/viewtopic.php?t=25 * 32-bit PHP installations only: Files larger than 2GB cannot always be parsed fully by getID3() due to limitations in the 32-bit PHP filesystem functions. NOTE: Since v1.7.8b3 there is partial support for larger-than- 2GB files, most of which will parse OK, as long as no critical data is located beyond the 2GB offset. Known will-work: * all file formats on 64-bit PHP * ZIP (format doesn't support files >2GB) * FLAC (current encoders don't support files >2GB) Known will-not-work: * ID3v1 tags (always located at end-of-file) * Lyrics3 tags (always located at end-of-file) * APE tags (always located at end-of-file) Maybe-will-work: * Quicktime (will work if needed metadata is before 2GB offset, that is if the file has been hinted/optimized for streaming) * RIFF.WAV (should work fine, but gives warnings about not being able to parse all chunks) * RIFF.AVI (playtime will probably be wrong, is only based on "movi" chunk that fits in the first 2GB, should issue error to show that playtime is incorrect. Other data should be mostly correct, assuming that data is constant throughout the file) * PHP <= v5 on Windows cannot read UTF-8 filenames Known Bugs/Issues in other programs ----------------------------------- https://www.getid3.org/phpBB3/viewtopic.php?t=25 * MusicBrainz Picard (at least up to v1.3.2) writes multiple ID3v2.3 genres in non-standard forward-slash separated text rather than parenthesis-numeric+refinement style per the ID3v2.3 specs. Tags written in ID3v2.4 mode are written correctly. (detected and worked around by getID3()) * PZ TagEditor v4.53.408 has been known to insert ID3v2.3 frames into an existing ID3v2.2 tag which, of course, breaks things * Windows Media Player (up to v11) and iTunes (up to v10+) do not correctly handle ID3v2.3 tags with UTF-16BE+BOM encoding (they assume the data is UTF-16LE+BOM and either crash (WMP) or output Asian character set (iTunes) * Winamp (up to v2.80 at least) does not support ID3v2.4 tags, only ID3v2.3 see: http://forums.winamp.com/showthread.php?postid=387524 * Some versions of Helium2 (www.helium2.com) do not write ID3v2.4-compliant Frame Sizes, even though the tag is marked as ID3v2.4) (detected by getID3()) * MP3ext V3.3.17 places a non-compliant padding string at the end of the ID3v2 header. This is supposedly fixed in v3.4b21 but only if you manually add a registry key. This fix is not yet confirmed. (detected by getID3()) * CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment strings, supposed to be in the format "NAME=value" but actually written just "value" (detected by getID3()) * Oggenc 0.9-rc3 flags the encoded file as ABR whether it's actually ABR or VBR. * iTunes (versions "v7.0.0.70" is known-guilty, probably other versions are too) writes ID3v2.3 comment tags using an ID3v2.2 frame name (3-bytes) null-padded to 4 bytes which is not valid for ID3v2.3+ (detected by getID3() since 1.9.12-201603221746) * iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably other versions are too) writes ID3v2.3 comment tags using a frame name 'COM ' which is not valid for ID3v2.3+ (it's an ID3v2.2-style frame name) (detected by getID3()) * MP2enc does not encode mono CBR MP2 files properly (half speed sound and double playtime) * MP2enc does not encode mono VBR MP2 files properly (actually encoded as stereo) * tooLAME does not encode mono VBR MP2 files properly (actually encoded as stereo) * AACenc encodes files in VBR mode (actually ABR) even if CBR is specified * AAC/ADIF - bitrate_mode = cbr for vbr files * LAME 3.90-3.92 prepends one frame of null data (space for the LAME/VBR header, but it never gets written) when encoding in CBR mode with the DLL * Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for TwinVQF v2.0 (detected by getID3()) * Ahead Nero encodes TwinVQF files 1 second shorter than they should be * AAC-ADTS files are always actually encoded VBR, even if CBR mode is specified (the CBR-mode switches on the encoder enable ABR mode, not CBR as such, but it's not possible to tell the difference between such ABR files and true VBR) * STREAMINFO.audio_signature in OggFLAC is always null. "The reason it's like that is because there is no seeking support in libOggFLAC yet, so it has no way to go back and write the computed sum after encoding. Seeking support in Ogg FLAC is the #1 item for the next release." - Josh Coalson (FLAC developer) NOTE: getID3() will calculate md5_data in a method similar to other file formats, but that value cannot be compared to the md5_data value from FLAC data in a FLAC file format. * STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 & v0.4.0 - getID3() will calculate md5_data in a method similar to other file formats, but that value cannot be compared to the md5_data value from FLAC v0.5.0+ * RioPort (various versions including 2.0 and 3.11) tags ID3v2 with a WCOM frame that has no data portion * Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis files, thus making them corrupt. * Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the last byte of data from an MP3 file when appending a new ID3v1 tag. (detected by getID3()) * Lossless-Audio files encoded with and without the -noseek switch do actually differ internally and therefore cannot match md5_data * iTunes has been known to append a new ID3v1 tag on the end of an existing ID3v1 tag when ID3v2 tag is also present (detected by getID3()) * MediaMonkey may write a blank RGAD ID3v2 frame but put actual replay gain adjustments in a series of user-defined TXXX frames (detected and handled by getID3() since v1.9.2) Reference material: =========================================================================== [www.id3.org material now mirrored at http://id3lib.sourceforge.net/id3/] * http://www.id3.org/id3v2.4.0-structure.txt * http://www.id3.org/id3v2.4.0-frames.txt * http://www.id3.org/id3v2.4.0-changes.txt * http://www.id3.org/id3v2.3.0.txt * http://www.id3.org/id3v2-00.txt * http://www.id3.org/mp3frame.html * http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html <mathewhendry@hotmail.com> * http://www.dv.co.yu/mpgscript/mpeghdr.htm * http://www.mp3-tech.org/programmer/frame_header.html * http://users.belgacom.net/gc247244/extra/tag.html * http://gabriel.mp3-tech.org/mp3infotag.html * http://www.id3.org/iso4217.html * http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT * http://www.xiph.org/ogg/vorbis/doc/framing.html * http://www.xiph.org/ogg/vorbis/doc/v-comment.html * http://leknor.com/code/php/class.ogg.php.txt * http://www.id3.org/iso639-2.html * http://www.id3.org/lyrics3.html * http://www.id3.org/lyrics3200.html * http://www.psc.edu/general/software/packages/ieee/ieee.html * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html * http://www.jmcgowan.com/avi.html * http://www.wotsit.org/ * http://www.herdsoft.com/ti/davincie/davp3xo2.htm * http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html * "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org) * http://midistudio.com/Help/GMSpecs_Patches.htm * http://www.xiph.org/archives/vorbis/200109/0459.html * http://www.replaygain.org/ * http://www.lossless-audio.com/ * http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe * http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf * http://www.uni-jena.de/~pfk/mpp/sv8/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/sv8/) * http://jfaul.de/atl/ * http://www.uni-jena.de/~pfk/mpp/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/) * http://www.libpng.org/pub/png/spec/png-1.2-pdg.html * http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm * http://www.fastgraph.com/help/bmp_os2_header_format.html * http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm * http://flac.sourceforge.net/format.html * http://www.research.att.com/projects/mpegaudio/mpeg2.html * http://www.audiocoding.com/wiki/index.php?page=AAC * http://libmpeg.org/mpeg4/doc/w2203tfs.pdf * http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt * http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm * http://www.nullsoft.com/nsv/ * http://www.wotsit.org/download.asp?f=iso9660 * http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html * http://www.cdroller.com/htm/readdata.html * http://www.speex.org/manual/node10.html * http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc * http://www.faqs.org/rfcs/rfc2361.html * http://ghido.shelter.ro/ * http://www.ebu.ch/tech_t3285.pdf * http://www.sr.se/utveckling/tu/bwf * http://ftp.aessc.org/pub/aes46-2002.pdf * http://cartchunk.org:8080/ * http://www.broadcastpapers.com/radio/cartchunk01.htm * http://www.hr/josip/DSP/AudioFile2.html * http://home.attbi.com/~chris.bagwell/AudioFormats-11.html * http://www.pure-mac.com/extkey.html * http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt * http://www.headbands.com/gspot/ * http://www.openswf.org/spec/SWFfileformat.html * http://j-faul.virtualave.net/ * http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html * http://cui.unige.ch/OSG/info/AudioFormats/ap11.html * http://sswf.sourceforge.net/SWFalexref.html * http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt * http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm * http://developer.apple.com/quicktime/icefloe/dispatch012.html * http://www.csdn.net/Dev/Format/graphics/PCD.htm * http://tta.iszf.irk.ru/ * http://www.atsc.org/standards/a_52a.pdf * http://www.alanwood.net/unicode/ * http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html * http://www.its.msstate.edu/net/real/reports/config/tags.stats * http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt * http://brennan.young.net/Comp/LiveStage/things.html * http://www.multiweb.cz/twoinches/MP3inside.htm * http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended * http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ * http://www.unicode.org/unicode/faq/utf_bom.html * http://tta.corecodec.org/?menu=format * http://www.scvi.net/nsvformat.htm * http://pda.etsi.org/pda/queryform.asp * http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm * http://trac.musepack.net/trac/wiki/SV8Specification * http://wyday.com/cuesharp/specification.php * http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html * http://www.codeproject.com/Articles/8295/MPEG-Audio-Frame-Header * http://dsd-guide.com/sites/default/files/white-papers/DSFFileFormatSpec_E.pdf * https://fileformats.fandom.com/wiki/Torrent_file home/bean7936/public_html/wp-includes/ID3/readme.txt 0000644 00000063332 15174716725 0016071 0 ustar 00 ///////////////////////////////////////////////////////////////// /// getID3() by James Heinrich <info@getid3.org> // // available at http://getid3.sourceforge.net // // or https://www.getid3.org // // also https://github.com/JamesHeinrich/getID3 // ///////////////////////////////////////////////////////////////// ***************************************************************** ***************************************************************** getID3() 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. GNU GPL: https://gnu.org/licenses/gpl.html (v3) https://gnu.org/licenses/old-licenses/gpl-2.0.html (v2) https://gnu.org/licenses/old-licenses/gpl-1.0.html (v1) GNU LGPL: https://gnu.org/licenses/lgpl.html (v3) Mozilla MPL: https://www.mozilla.org/MPL/2.0/ (v2) getID3 Commercial License: https://www.getid3.org/#gCL (no longer available, existing licenses remain valid) ***************************************************************** ***************************************************************** Copies of each of the above licenses are included in the 'licenses' directory of the getID3 distribution. +----------------------------------------------+ | If you want to donate, there is a link on | | https://www.getid3.org for PayPal donations. | +----------------------------------------------+ Quick Start =========================================================================== Q: How can I check that getID3() works on my server/files? A: Unzip getID3() to a directory, then access /demos/demo.browse.php Support =========================================================================== Q: I have a question, or I found a bug. What do I do? A: The preferred method of support requests and/or bug reports is the forum at http://support.getid3.org/ Sourceforge Notification =========================================================================== It's highly recommended that you sign up for notification from Sourceforge for when new versions are released. Please visit: http://sourceforge.net/project/showfiles.php?group_id=55859 and click the little "monitor package" icon/link. If you're previously signed up for the mailing list, be aware that it has been discontinued, only the automated Sourceforge notification will be used from now on. What does getID3() do? =========================================================================== Reads & parses (to varying degrees): ¤ tags: * APE (v1 and v2) * ID3v1 (& ID3v1.1) * ID3v2 (v2.4, v2.3, v2.2) * Lyrics3 (v1 & v2) ¤ audio-lossy: * MP3/MP2/MP1 * MPC / Musepack * Ogg (Vorbis, OggFLAC, Speex, Opus) * AAC / MP4 * AC3 * DTS * RealAudio * Speex * DSS * VQF ¤ audio-lossless: * AIFF * AU * Bonk * CD-audio (*.cda) * FLAC * LA (Lossless Audio) * LiteWave * LPAC * MIDI * Monkey's Audio * OptimFROG * RKAU * Shorten * TTA * VOC * WAV (RIFF) * WavPack ¤ audio-video: * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) * AVI (RIFF) * Flash * Matroska (MKV) * MPEG-1 / MPEG-2 * NSV (Nullsoft Streaming Video) * Quicktime (including MP4) * RealVideo ¤ still image: * BMP * GIF * JPEG * PNG * TIFF * SWF (Flash) * PhotoCD ¤ data: * ISO-9660 CD-ROM image (directory structure) * SZIP (limited support) * ZIP (directory structure) * TAR * CUE Writes: * ID3v1 (& ID3v1.1) * ID3v2 (v2.3 & v2.4) * VorbisComment on OggVorbis * VorbisComment on FLAC (not OggFLAC) * APE v2 * Lyrics3 (delete only) Requirements =========================================================================== * PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier) * PHP 5.0.5 (or higher) for getID3() 1.8.x (and up) * PHP 5.3.0 (or higher) for getID3() 1.9.17 (and up) * PHP 5.3.0 (or higher) for getID3() 2.0.x (and up) * at least 4MB memory for PHP. 8MB or more is highly recommended. 12MB is required with all modules loaded. Usage =========================================================================== See /demos/demo.basic.php for a very basic use of getID3() with no fancy output, just scanning one file. See structure.txt for the returned data structure. *> For an example of a complete directory-browsing, <* *> file-scanning implementation of getID3(), please run <* *> /demos/demo.browse.php <* See /demos/demo.mysql.php for a sample recursive scanning code that scans every file in a given directory, and all sub-directories, stores the results in a database and allows various analysis / maintenance operations To analyze remote files over HTTP or FTP you need to copy the file locally first before running getID3(). Your code would look something like this: // Copy remote file locally to scan with getID3() $remotefilename = 'http://www.example.com/filename.mp3'; if ($fp_remote = fopen($remotefilename, 'rb')) { $localtempfilename = tempnam('/tmp', 'getID3'); if ($fp_local = fopen($localtempfilename, 'wb')) { while ($buffer = fread($fp_remote, 32768)) { fwrite($fp_local, $buffer); } fclose($fp_local); $remote_headers = array_change_key_case(get_headers($remotefilename, 1), CASE_LOWER); $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); // Initialize getID3 engine $getID3 = new getID3; $ThisFileInfo = $getID3->analyze($localtempfilename, $remote_filesize, basename($remotefilename)); // Delete temporary file unlink($localtempfilename); } fclose($fp_remote); } Note: since v1.9.9-20150212 it is possible a second and third parameter to $getID3->analyze(), for original filesize and original filename respectively. This permits you to download only a portion of a large remote file but get accurate playtime estimates, assuming the format only requires the beginning of the file for correct format analysis. See /demos/demo.write.php for how to write tags. What does the returned data structure look like? =========================================================================== See structure.txt It is recommended that you look at the output of /demos/demo.browse.php scanning the file(s) you're interested in to confirm what data is actually returned for any particular filetype in general, and your files in particular, as the actual data returned may vary considerably depending on what information is available in the file itself. Notes =========================================================================== getID3() 1.x: If the format parser encounters a critical problem, it will return something in $fileinfo['error'], describing the encountered error. If a less critical error or notice is generated it will appear in $fileinfo['warning']. Both keys may contain more than one warning or error. If something is returned in ['error'] then the file was not correctly parsed and returned data may or may not be correct and/or complete. If something is returned in ['warning'] (and not ['error']) then the data that is returned is OK - usually getID3() is reporting errors in the file that have been worked around due to known bugs in other programs. Some warnings may indicate that the data that is returned is OK but that some data could not be extracted due to errors in the file. getID3() 2.x: See above except errors are thrown (so you will only get one error). Disclaimer =========================================================================== getID3() has been tested on many systems, on many types of files, under many operating systems, and is generally believe to be stable and safe. That being said, there is still the chance there is an undiscovered and/or unfixed bug that may potentially corrupt your file, especially within the writing functions. By using getID3() you agree that it's not my fault if any of your files are corrupted. In fact, I'm not liable for anything :) License =========================================================================== GNU General Public License - see license.txt This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to: Free Software Foundation, Inc. 59 Temple Place - Suite 330 Boston, MA 02111-1307, USA. FAQ: Q: Can I use getID3() in my program? Do I need a commercial license? A: You're generally free to use getID3 however you see fit. The only case in which you would require a commercial license is if you're selling your closed-source program that integrates getID3. If you sell your program including a copy of getID3, that's fine as long as you include a copy of the sourcecode when you sell it. Or you can distribute your code without getID3 and say "download it from getid3.sourceforge.net" Why is it called "getID3()" if it does so much more than just that? =========================================================================== v0.1 did in fact just do that. I don't have a copy of code that old, but I could essentially write it today with a one-line function: function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); } Future Plans =========================================================================== https://www.getid3.org/phpBB3/viewforum.php?f=7 * Better support for MP4 container format * Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0) * Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm) * Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669) * Support for ACE (thanks Vince) * Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid) * Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header * Ability to "clean" ID3v2 padding (replace invalid padding with valid padding) * Warn if MP3s change version mid-stream (in full-scan mode) * check for corrupt/broken mid-file MP3 streams in histogram scan * Support for lossless-compression formats (http://www.firstpr.com.au/audiocomp/lossless/#Links) (http://compression.ca/act-sound.html) (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) * Support for RIFF-INFO chunks * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html (thanks Nick Humfrey <njhØsurgeradio*co*uk>) * http://abcavi.narod.ru/sof/abcavi/infotags.htm (thanks Kibi) * Better support for Bink video * http://www.hr/josip/DSP/AudioFile2.html * http://www.pcisys.net/~melanson/codecs/ * Detect mp3PRO * Support for PSD * Support for JPC * Support for JP2 * Support for JPX * Support for JB2 * Support for IFF * Support for ICO * Support for ANI * Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) * Support for DVD-IFO (region, subtitles, aspect ratio, etc) (thanks p*quaedackersØplanet*nl) * More complete support for SWF - parsing encapsulated MP3 and/or JPEG content (thanks n8n8Øyahoo*com) * Support for a2b * Optional scan-through-frames for AVI verification (thanks rockcohenØmassive-interactive*nl) * Support for TTF (thanks infoØbutterflyx*com) * Support for DSS (https://www.getid3.org/phpBB3/viewtopic.php?t=171) * Support for SMAF (http://smaf-yamaha.com/what/demo.html) https://www.getid3.org/phpBB3/viewtopic.php?t=182 * Support for AMR (https://www.getid3.org/phpBB3/viewtopic.php?t=195) * Support for 3gpp (https://www.getid3.org/phpBB3/viewtopic.php?t=195) * Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) * Parse XML data returned in Ogg comments * Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) * ID3v2 genre string creator function * More complete parsing of JPG * Support for all old-style ASF packets * ASF/WMA/WMV tag writing * Parse declared T??? ID3v2 text information frames, where appropriate (thanks Christian Fritz for the idea) * Recognize encoder: http://www.guerillasoft.com/EncSpot2/index.html http://ff123.net/identify.html http://www.hydrogenaudio.org/?act=ST&f=16&t=9414 http://www.hydrogenaudio.org/?showtopic=11785 * Support for other OS/2 bitmap structures: Bitmap Array('BA'), Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT') http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm * Support for WavPack RAW mode * ASF/WMA/WMV data packet parsing * ID3v2FrameFlagsLookupTagAlter() * ID3v2FrameFlagsLookupFileAlter() * obey ID3v2 tag alter/preserve/discard rules * http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm * proper checking for LINK/LNK frame validity in ID3v2 writing * proper checking for ASPI-TLEN frame validity in ID3v2 writing * proper checking for COMR frame validity in ID3v2 writing * http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html * decode GEOB ID3v2 structure as encoded by RealJukebox, decode NCON ID3v2 structure as encoded by MusicMatch (probably won't happen - the formats are proprietary) Known Bugs/Issues in getID3() that may be fixed eventually =========================================================================== https://www.getid3.org/phpBB3/viewtopic.php?t=25 * Cannot determine bitrate for MPEG video with VBR video data (need documentation) * Interlace/progressive cannot be determined for MPEG video (need documentation) * MIDI playtime is sometimes inaccurate * AAC-RAW mode files cannot be identified * WavPack-RAW mode files cannot be identified * mp4 files report lots of "Unknown QuickTime atom type" (need documentation) * Encrypted ASF/WMA/WMV files warn about "unhandled GUID ASF_Content_Encryption_Object" * Bitrate split between audio and video cannot be calculated for NSV, only the total bitrate. (need documentation) * All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the problem of large VorbisComments spanning multiple Ogg pages, but but only OggVorbis files can be processed with vorbiscomment. * The version of "head" supplied with Mac OS 10.2.8 (maybe other versions too) does only understands a single option (-n) and therefore fails. getID3 ignores this and returns wrong md5_data. Known Bugs/Issues in getID3() that cannot be fixed -------------------------------------------------- https://www.getid3.org/phpBB3/viewtopic.php?t=25 * 32-bit PHP installations only: Files larger than 2GB cannot always be parsed fully by getID3() due to limitations in the 32-bit PHP filesystem functions. NOTE: Since v1.7.8b3 there is partial support for larger-than- 2GB files, most of which will parse OK, as long as no critical data is located beyond the 2GB offset. Known will-work: * all file formats on 64-bit PHP * ZIP (format doesn't support files >2GB) * FLAC (current encoders don't support files >2GB) Known will-not-work: * ID3v1 tags (always located at end-of-file) * Lyrics3 tags (always located at end-of-file) * APE tags (always located at end-of-file) Maybe-will-work: * Quicktime (will work if needed metadata is before 2GB offset, that is if the file has been hinted/optimized for streaming) * RIFF.WAV (should work fine, but gives warnings about not being able to parse all chunks) * RIFF.AVI (playtime will probably be wrong, is only based on "movi" chunk that fits in the first 2GB, should issue error to show that playtime is incorrect. Other data should be mostly correct, assuming that data is constant throughout the file) * PHP <= v5 on Windows cannot read UTF-8 filenames Known Bugs/Issues in other programs ----------------------------------- https://www.getid3.org/phpBB3/viewtopic.php?t=25 * MusicBrainz Picard (at least up to v1.3.2) writes multiple ID3v2.3 genres in non-standard forward-slash separated text rather than parenthesis-numeric+refinement style per the ID3v2.3 specs. Tags written in ID3v2.4 mode are written correctly. (detected and worked around by getID3()) * PZ TagEditor v4.53.408 has been known to insert ID3v2.3 frames into an existing ID3v2.2 tag which, of course, breaks things * Windows Media Player (up to v11) and iTunes (up to v10+) do not correctly handle ID3v2.3 tags with UTF-16BE+BOM encoding (they assume the data is UTF-16LE+BOM and either crash (WMP) or output Asian character set (iTunes) * Winamp (up to v2.80 at least) does not support ID3v2.4 tags, only ID3v2.3 see: http://forums.winamp.com/showthread.php?postid=387524 * Some versions of Helium2 (www.helium2.com) do not write ID3v2.4-compliant Frame Sizes, even though the tag is marked as ID3v2.4) (detected by getID3()) * MP3ext V3.3.17 places a non-compliant padding string at the end of the ID3v2 header. This is supposedly fixed in v3.4b21 but only if you manually add a registry key. This fix is not yet confirmed. (detected by getID3()) * CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment strings, supposed to be in the format "NAME=value" but actually written just "value" (detected by getID3()) * Oggenc 0.9-rc3 flags the encoded file as ABR whether it's actually ABR or VBR. * iTunes (versions "v7.0.0.70" is known-guilty, probably other versions are too) writes ID3v2.3 comment tags using an ID3v2.2 frame name (3-bytes) null-padded to 4 bytes which is not valid for ID3v2.3+ (detected by getID3() since 1.9.12-201603221746) * iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably other versions are too) writes ID3v2.3 comment tags using a frame name 'COM ' which is not valid for ID3v2.3+ (it's an ID3v2.2-style frame name) (detected by getID3()) * MP2enc does not encode mono CBR MP2 files properly (half speed sound and double playtime) * MP2enc does not encode mono VBR MP2 files properly (actually encoded as stereo) * tooLAME does not encode mono VBR MP2 files properly (actually encoded as stereo) * AACenc encodes files in VBR mode (actually ABR) even if CBR is specified * AAC/ADIF - bitrate_mode = cbr for vbr files * LAME 3.90-3.92 prepends one frame of null data (space for the LAME/VBR header, but it never gets written) when encoding in CBR mode with the DLL * Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for TwinVQF v2.0 (detected by getID3()) * Ahead Nero encodes TwinVQF files 1 second shorter than they should be * AAC-ADTS files are always actually encoded VBR, even if CBR mode is specified (the CBR-mode switches on the encoder enable ABR mode, not CBR as such, but it's not possible to tell the difference between such ABR files and true VBR) * STREAMINFO.audio_signature in OggFLAC is always null. "The reason it's like that is because there is no seeking support in libOggFLAC yet, so it has no way to go back and write the computed sum after encoding. Seeking support in Ogg FLAC is the #1 item for the next release." - Josh Coalson (FLAC developer) NOTE: getID3() will calculate md5_data in a method similar to other file formats, but that value cannot be compared to the md5_data value from FLAC data in a FLAC file format. * STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 & v0.4.0 - getID3() will calculate md5_data in a method similar to other file formats, but that value cannot be compared to the md5_data value from FLAC v0.5.0+ * RioPort (various versions including 2.0 and 3.11) tags ID3v2 with a WCOM frame that has no data portion * Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis files, thus making them corrupt. * Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the last byte of data from an MP3 file when appending a new ID3v1 tag. (detected by getID3()) * Lossless-Audio files encoded with and without the -noseek switch do actually differ internally and therefore cannot match md5_data * iTunes has been known to append a new ID3v1 tag on the end of an existing ID3v1 tag when ID3v2 tag is also present (detected by getID3()) * MediaMonkey may write a blank RGAD ID3v2 frame but put actual replay gain adjustments in a series of user-defined TXXX frames (detected and handled by getID3() since v1.9.2) Reference material: =========================================================================== [www.id3.org material now mirrored at http://id3lib.sourceforge.net/id3/] * http://www.id3.org/id3v2.4.0-structure.txt * http://www.id3.org/id3v2.4.0-frames.txt * http://www.id3.org/id3v2.4.0-changes.txt * http://www.id3.org/id3v2.3.0.txt * http://www.id3.org/id3v2-00.txt * http://www.id3.org/mp3frame.html * http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html <mathewhendry@hotmail.com> * http://www.dv.co.yu/mpgscript/mpeghdr.htm * http://www.mp3-tech.org/programmer/frame_header.html * http://users.belgacom.net/gc247244/extra/tag.html * http://gabriel.mp3-tech.org/mp3infotag.html * http://www.id3.org/iso4217.html * http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT * http://www.xiph.org/ogg/vorbis/doc/framing.html * http://www.xiph.org/ogg/vorbis/doc/v-comment.html * http://leknor.com/code/php/class.ogg.php.txt * http://www.id3.org/iso639-2.html * http://www.id3.org/lyrics3.html * http://www.id3.org/lyrics3200.html * http://www.psc.edu/general/software/packages/ieee/ieee.html * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html * http://www.jmcgowan.com/avi.html * http://www.wotsit.org/ * http://www.herdsoft.com/ti/davincie/davp3xo2.htm * http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html * "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org) * http://midistudio.com/Help/GMSpecs_Patches.htm * http://www.xiph.org/archives/vorbis/200109/0459.html * http://www.replaygain.org/ * http://www.lossless-audio.com/ * http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe * http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf * http://www.uni-jena.de/~pfk/mpp/sv8/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/sv8/) * http://jfaul.de/atl/ * http://www.uni-jena.de/~pfk/mpp/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/) * http://www.libpng.org/pub/png/spec/png-1.2-pdg.html * http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm * http://www.fastgraph.com/help/bmp_os2_header_format.html * http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm * http://flac.sourceforge.net/format.html * http://www.research.att.com/projects/mpegaudio/mpeg2.html * http://www.audiocoding.com/wiki/index.php?page=AAC * http://libmpeg.org/mpeg4/doc/w2203tfs.pdf * http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt * http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm * http://www.nullsoft.com/nsv/ * http://www.wotsit.org/download.asp?f=iso9660 * http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html * http://www.cdroller.com/htm/readdata.html * http://www.speex.org/manual/node10.html * http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc * http://www.faqs.org/rfcs/rfc2361.html * http://ghido.shelter.ro/ * http://www.ebu.ch/tech_t3285.pdf * http://www.sr.se/utveckling/tu/bwf * http://ftp.aessc.org/pub/aes46-2002.pdf * http://cartchunk.org:8080/ * http://www.broadcastpapers.com/radio/cartchunk01.htm * http://www.hr/josip/DSP/AudioFile2.html * http://home.attbi.com/~chris.bagwell/AudioFormats-11.html * http://www.pure-mac.com/extkey.html * http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt * http://www.headbands.com/gspot/ * http://www.openswf.org/spec/SWFfileformat.html * http://j-faul.virtualave.net/ * http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html * http://cui.unige.ch/OSG/info/AudioFormats/ap11.html * http://sswf.sourceforge.net/SWFalexref.html * http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt * http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm * http://developer.apple.com/quicktime/icefloe/dispatch012.html * http://www.csdn.net/Dev/Format/graphics/PCD.htm * http://tta.iszf.irk.ru/ * http://www.atsc.org/standards/a_52a.pdf * http://www.alanwood.net/unicode/ * http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html * http://www.its.msstate.edu/net/real/reports/config/tags.stats * http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt * http://brennan.young.net/Comp/LiveStage/things.html * http://www.multiweb.cz/twoinches/MP3inside.htm * http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended * http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ * http://www.unicode.org/unicode/faq/utf_bom.html * http://tta.corecodec.org/?menu=format * http://www.scvi.net/nsvformat.htm * http://pda.etsi.org/pda/queryform.asp * http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm * http://trac.musepack.net/trac/wiki/SV8Specification * http://wyday.com/cuesharp/specification.php * http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html * http://www.codeproject.com/Articles/8295/MPEG-Audio-Frame-Header * http://dsd-guide.com/sites/default/files/white-papers/DSFFileFormatSpec_E.pdf * https://fileformats.fandom.com/wiki/Torrent_file home/bean7936/deribos.com/wp-content3e392d/plugins/secupress/readme.txt 0000644 00000030356 15174745605 0021606 0 ustar 00 === SecuPress with Simple SSL – Simple and Performant Security === Contributors: SecuPress, juliobox, GregLone, Superment Tags: wordpress security, malware, security plugin, security Requires at least: 5.4 Tested up to: 6.9 Requires PHP: 7.2 Stable tag: 2.6 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Protect your WordPress with SecuPress, analyze and ensure the safety of your website daily. == Description == = Test it now! = You can [test SecuPress Free now](https://demo.tastewp.com/secupress/). = YOU MADE IT, WE KEEP IT SAFE! = The most advanced WordPress Protection on the market. SecuPress is focused on WordPress attacks and Malwares, not just "usual web protections" like many. Protect your WordPress with malware scans ; block bots & suspicious IPs. Get a complete [WordPress security toolkit](https://secupress.me/) for free or as a pro plugin. SecuPress is GDPR compliant. **What’s the difference between free and pro version?** If you are proactive, our free WordPress security plugin is a great choice! No time to activate weekly scans? Then [SecuPress pro](https://secupress.me/) is the way to go. Our plugin takes care of everything with automated tasks. = Here are some of our most popular features: = * Brute Force Login Protection * Password Spraying Protection * Firewall features * Security alerts (1) * Malware Scanner (1) * Block country by geolocation (1) = We have included some features you won’t find in most WordPress security plugins: = * Protection of Security Keys * Block visits from Bad Bots * Vulnerable Plugins & Themes detection (1) * Security Reports in PDF format (1) You can check out [Frequently Asked Questions](https://secupress.me/faq/) or get in touch with our [support](https://secupress.me/support/). Want to know all about SecuPress? You can read our documentation here: [docs.secupress.me](https://docs.secupress.me). **How will you know it works?** Well, we have a dedicated security scanner that will give you a clear security grade and report for your website. This way, you’ll know exactly what to fix. = WordPress Features = **Security Audit** SecuPress is the only plugin with a full scanner able to fix the issues for you. And when it requires a decision from you, it will ask you before proceeding. With this feature, you can check 35 security points in 5 minutes and let us take care of the rest. Once done, you get a security grade that gives you a clear idea of what your security level is. You can export this analysis in PDF format to share with others (clients or colleagues) (1). **Users & Login** This feature is the easiest way to make sure your users’ data is protected and to keep their accounts from being compromised. With this feature you can limit the number of bad login attempts, ban non-existing usernames login attempts and set a non-login time slot. SecuPress also makes sure you control the sessions of your users. SecuPress also adds a [2FA](https://secupress.me/blog/two-factor-authentication/) (Two Factor Authentication) because it’s almost a mandatory feature when it comes to WordPress security! The plugin also gives you greater user and password control as you can set: * Password lifetimes for your users. * Enforce strong password use. * Forbid the use of vague usernames like www or admin. Tired of bots finding your WordPress login page? Finally, don't let bots find your login page, just move it with the famous Move Login plugin, now included in SecuPress. **Plugins and Themes** SecuPress helps you detect themes and plugins that are vulnerable or that have been tampered with to include malicious code. If you install one of these, your security module will send out an email alert and give you a warning in WordPress. SecuPress takes security further by limiting plugin activation, deactivation, installation and removal in your production (live) website. Plugin and theme uploads via .zip files will be on lockdown as well to block off this easy hacking route. **WordPress Core** SecuPress reinforces the WordPress Core to keep it safe. The security plugin optimizes what’s under the hood to secure the config file by setting the proper parameters. **Sensitive Data** SecuPress secures content in many ways: * The plugin secures WordPress Endpoints and APIs by blocking bad requests for XML-RPC or REST API. * It blocks bad bots with its Robots Blackhole feature. * It provides an anti-hotlink feature to preserve your bandwidth. * The plugin packs 7 anti-disclose security modules to make sure no precious information is available to hackers in your PHP or WordPress itself. * Profile and SecuPress settings pages are password protected to keep sensitive information away from prying eyes. **Firewall** * SecuPress is one of the most efficient WordPress bouncer you’ll ever see! * The plugin blocks malicious incoming requests. * It blocks bad User Agents (no bad crawlers allowed). * Bad requests methods also get the boot in a single click. * URLs are kept in check: no bad URL contents. * SQL injection scanners are kept out as well. * Brute force attempts are stopped in their tracks. * GeoIP Blocking by country gives you more control over your traffic. **Malware Scan** SecuPress has a unique malware scan developed by our security experts. It hunts down bad files and provides you with an easy step-by-step report that lets you take action. It looks into: * Bad files in your FTP. * Your uploads folder for dangerous files. * Potential phishing attempts via `index.php` loads. **Backups** We know firsthand how painful it is to pick up the pieces after an attack damages your WordPress. SecuPress preserves your data to help you avoid lost content or settings if your website comes under attack. The plugin backs up your database and files and lets you download them to guarantee you peace of mind. **Anti Spam** Did you know that 60% of the traffic on the Internet is generated by bots? Most of them happen to be spam bots. We developed our own anti-spam system that works quietly in the background. Just activate it and enjoy a spam free experience. **Alerts** Alerts are an essential tool when your website is under attack. When something important happens on your website, SecuPress will send you an alert via email. We’re working on alerts via SMS, Slack & Twitter as well. You also receive a daily report that provides a debrief of the attempted attack and all the activities blocked by SecuPress. **Scheduled Security Tasks** SecuPress can run 3 separate scheduled tasks for you. It’s like having a security patrol on your WordPress. **Scheduled Scanner:** SecuPress scans your website to detect any issues. After the scan is complete, you get a report in your inbox outlining any actions you have to take to protect your website. **Scheduled Backup:** our team knows that everyone at one time or another forgets to back things up. We made it an automatic task to help ensure you always can recover from an attack with your content safe. **Scheduled Malware Scan:** this security feature scans your website at regular intervals to hunt down any malware that may have gotten into your WordPress. **Logs** SecuPress will keep a log of important security activities and 404 pages triggered by users, bots or even Chuck Norris. This lets you keep an eye on what’s going on in your WordPress at any time. You can also control banned IPs from this option. *(1) Available in the [Pro Version](https://secupress.me/features/).* *(SecuPress est une extension de sécurité WordPress française)* == Installation == *It's important to delete all other security plugins before activating SecuPress.* 1. Upload the plugin files to the `/wp-content/plugins/secupress` directory, or install the plugin through the WordPress plugins screen directly. 1. Activate the plugin through the 'Plugins' screen in WordPress. 1. Use the SecuPress->Settings screen to configure the plugin. == Frequently Asked Questions == = What does SecuPress do, exactly? = SecuPress is a plugin for WordPress sites which enables better security without sacrificing usability. It’s easy to use for you and hard to hack for pirates. First, SecuPress will scan your site, looking for vulnerabilities and provide a report detailing how to harden your WordPress. The majority of recommendations are easy to implement by checking a box; very few will require a manual setup. = What makes SecuPress better than any other security plugin? = SecuPress protects your website on multiple fronts: anti spam, double authentication. The best feature for users remains how easy to use this plugin is. You don’t need to be an experienced technician to use and secure your WordPress like an expert! Our security alarms hosted on our servers supply daily data about the most recent vulnerable plugins and themes. This allows you to always be aware and safe. = Is SecuPress compatible with multisites installation? = Yes, SecuPress can be activated for all your sub-sites, just activate it from your main network site. = Is SecuPress compatible with all web hosters? = Yes, SecuPress is compatible with all web hosters like o2switch, OVH, Siteground, BlueHost, PlanetHoster, WP Engine or GoDaddy? If you encounter an issue, do not hesitate to contact our support team. = Is SecuPress compatible with all caching plugins like WP Rocket, WP Fastest Cache, W3 Total Cache, WP Super Cache? = Yes, SecuPress is compatible with all WordPress caching plugins. If you encounter an issue, do not hesitate to contact our support team. = Is SecuPress compatible with all multilingual plugins like WeGlot, PolyLang, WPML, qTranslate? = Yes, SecuPress is compatible with all multilingual WordPress plugins. If you have an issue, please get in touch with us and let us know! = Is SecuPress compatible with all server engines like Apache, Nginx, IIS7? = Yes, SecuPress is compatible with all server engines. If you encounter an issue, do not hesitate to contact our support team. = Is SecuPress compatible with other security plugins like WordFence, Solid Security (iThemes Security), Really Simple SSL Security, Bullet Proof Security, Sucuri Security? = The answer is no. SecuPress is not compatible with another security plugin. Just like two caching plugins do not make your website faster, two security plugins do not make your WordPress more secure. Security rules tend to be overwritten or conflict with other rules if two security plugins are installed. This can cause errors on your website and is not recommended. == Screenshots == 1. All modules from SecuPress 2. A module page (here is Users & Login) 3. The first scan 4. The 1st step: result of the scan 5. The 2nd step: choose what to automatically fix (1) 6. SecuPress is now fixing issues for you (1) 7. The 3rd step: manual fix, when you have to decide something 8. The 4th step: final report, you can export it as PDF (1) == Changelog == = 2.6 = * 16 January 2026 * New: GeoIP Location on Login * New: Search field in admin UI. * New: Scanner for malwares in our 35 scanners. * Improvement: UI for Malware Scanner has been improved, and will be again ;) You'll find a "WP File Integrity" which has always been there since 1.0, just not mentionned as is. * Improvement: Add WP 2FA compatibility to Easy Login scan * Fix: Dashboard Widget not displaying graphs * Fix: PHP Version Scanner was saying that the last version was "ok tier" * Fix: PasswordLess activation checkbox was not checked after reload * Fix: Remove secupress-data directory on uninstall (I forgot, my bad) * Fix: "wp-includes/version.php" should not be tagged "different" anymore if you use a localised zip (in malware scanners) * Fix: Possible fatal error when deactivating the module "Disable all actions on plugins" + "disable all actions on FTP" * Fix: Possible fatal error "Call to undefined method SecuPress_Background_Process_Bad_Plugins::is_processing()" == Upgrade Notice == * SecuPress 2.6+ now requires PHP 7.2 minimum. * SecuPress 2.3.18+ now requires WP 5.4 minimum. == TODO == Create a trust score for each non WP file and displays it Create a "suspicious" status for alerts Revamp alerts Revamp logs Add http logs PHP 8.O min replace %s by ###USERNAME### in emails .htaccess scanner login rest disclose scanner move EDD updater+white label into a mu to allow upgrade+rollback even with plugin deactivated give possibility to rename logins target="_blank" on doc links AI Scanner Improve malware scanner, again
| ver. 1.6 |
Github
|
.
| PHP 8.3.30 | Генерация страницы: 0 |
proxy
|
phpinfo
|
Настройка