ExifTool by Phil Harvey (phil at owl.phy.queensu.ca) ---------------------------------------------------------------------------- ExifTool is a customizable set of Perl libraries plus an application script for reading and writing meta information in image, audio and video files, including the maker note information of many digital cameras by various manufacturers such as Canon, Casio, FujiFilm, JVC/Victor, Kodak, Leaf, Minolta/Konica-Minolta, Nikon, Olympus/Epson, Panasonic/Leica, Pentax/Asahi, Ricoh, Sanyo and Sigma/Foveon. ExifTool reads EXIF, GPS, IPTC, XMP, JFIF, MakerNotes, GeoTIFF, ICC Profile, Photoshop IRB, AFCP and ID3 meta information from JPG, JP2, TIFF, GIF, BMP, PICT, QTIF, PNG, MNG, JNG, MIFF, PPM, PGM, PBM, EPS, PS, AI, PDF, PSD, DCM, ACR, THM, CRW, CR2, ERF, MRW, NEF, PEF, ORF, RAF, RAW, SRF, SR2, MOS, X3F and DNG images, MP3, WAV, WMA and AIFF audio files, AVI, MOV, MP4 and WMV videos, and XMP, ICC and MIE data files. ExifTool writes EXIF, GPS, IPTC, XMP, JFIF, MakerNotes, ICC Profile, Photoshop IRB and AFCP meta information to JPEG, TIFF, GIF, EPS, PS, PSD, XMP, ICC, MIE, PPM, PGM, PBM, PNG, MNG, JNG, CRW, THM, CR2, ERF, MRW, NEF, PEF, MOS and DNG images. See html/index.html for more details about ExifTool features. ExifTool can be downloaded from Main server URL: http://owl.phy.queensu.ca/~phil/exiftool/ Alternate URL: http://130.15.24.87/~phil/exiftool/ Note: Please do not make links to the alternate URL above, because this server is not permanent. RUNNING The exiftool script can be run right away without the need to install Image::ExifTool. For example, from within the exiftool directory you can extract the information from one of the included test files by typing: ./exiftool t/images/ExifTool.jpg If you move the exiftool script to a different directory, you must also either move the contents of the lib directory or install the Image::ExifTool package so the script can find the necessary libraries. Note: If you are using the Windows cmd shell, you may need to rename 'exiftool' to 'exiftool.pl' to run it directly from the command line. Alternatively, you can run exiftool with the command 'perl exiftool'. IF YOU ARE STILL CONFUSED The exiftool script is a command line application. You run it by typing commands in a terminal window. The first step is to determine the name of the directory where you downloaded the ExifTool distribution package. Assuming, for example, you downloaded it to a folder called "Desktop" in your home directory, then you would type the following commands in a terminal window to extract and run ExifTool: cd ~/Desktop tar -xzf Image-ExifTool-#.##.tar.gz cd Image-ExifTool-#.## ./exiftool t/images/ExifTool.jpg Note: You must replace "#.##" in the above commands with the actual version number of ExifTool that you downloaded. These commands extract meta information from one of the test images. To use one of your images instead, enter the full path name of your file in place of "t/images/ExifTool.jpg". INSTALLATION You can install the Image::ExifTool package to make it available for use by other Perl scripts by typing the following: perl Makefile.PL make make test make install Notes: i) You need root access for the last step above. ii) Some Perl installations (like the standard OSX installation) may not contain the necessary files to complete the first step above. But no worries: You can install ExifTool manually by moving 'exiftool' and the 'lib' directory to any directory in your current PATH. DEPENDENCIES Requires Perl version 5.004 or later. No other special libraries are required, however Compress::Zlib is used if available to read/write compressed information in PNG, PDF, DCM, DNG and MIE images, and Digest::MD5 is used if available to read encrypted information in PDF files. COPYRIGHT AND LICENCE Copyright 2003-2006, Phil Harvey This is free software; you can redistribute it and/or modify it under the same terms as Perl itself. ADDITIONAL INFORMATION Read the following files included with the ExifTool distribution for more information: html/index.html - Main ExifTool documentation html/history.html - ExifTool revision history html/ExifTool.html - ExifTool API documentation html/TagNames/index.html - ExifTool tag name documentation lib/Image/ExifTool/README - ExifTool support modules documentation and if you have installed Image::ExifTool, you can also consult perldoc or the man pages: perldoc exiftool perldoc Image::ExifTool perldoc Image::ExifTool::TagNames man exiftool man Image::ExifTool man Image::ExifTool::TagNames ----------------------------------------------------------------------------