README 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233
  1. ExifTool by Phil Harvey (phil at owl.phy.queensu.ca)
  2. ----------------------------------------------------------------------------
  3. ExifTool is a customizable set of Perl modules plus a full-featured
  4. application for reading and writing meta information in a wide variety of
  5. files, including the maker note information of many digital cameras by
  6. various manufacturers such as Canon, Casio, FLIR, FujiFilm, GE, HP,
  7. JVC/Victor, Kodak, Leaf, Minolta/Konica-Minolta, Nikon, Nintendo,
  8. Olympus/Epson, Panasonic/Leica, Pentax/Asahi, Phase One, Reconyx, Ricoh,
  9. Samsung, Sanyo, Sigma/Foveon and Sony.
  10. Below is a list of file types and meta information formats currently
  11. supported by ExifTool (r = read, w = write, c = create):
  12. File Types
  13. ------------+-------------+-------------+-------------+------------
  14. 3FR r | DVB r/w | KEY r | ORF r/w | RWL r/w
  15. 3G2 r/w | DYLIB r | LA r | OTF r | RWZ r
  16. 3GP r/w | EIP r | LFP r | PAC r | RM r
  17. AA r | EPS r/w | LNK r | PAGES r | SEQ r
  18. AAX r/w | EPUB r | M2TS r | PBM r/w | SO r
  19. ACR r | ERF r/w | M4A/V r/w | PCD r | SR2 r/w
  20. AFM r | EXE r | MEF r/w | PDB r | SRF r
  21. AI r/w | EXIF r/w/c | MIE r/w/c | PDF r/w | SRW r/w
  22. AIFF r | EXR r | MIFF r | PEF r/w | SVG r
  23. APE r | EXV r/w/c | MKA r | PFA r | SWF r
  24. ARW r/w | F4A/V r/w | MKS r | PFB r | THM r/w
  25. ASF r | FFF r/w | MKV r | PFM r | TIFF r/w
  26. AVI r | FLA r | MNG r/w | PGF r | TORRENT r
  27. AZW r | FLAC r | MOBI r | PGM r/w | TTC r
  28. BMP r | FLV r | MODD r | PLIST r | TTF r
  29. BTF r | FPF r | MOI r | PICT r | VCF r
  30. CHM r | FPX r | MOS r/w | PMP r | VRD r/w/c
  31. COS r | GIF r/w | MOV r/w | PNG r/w | VSD r
  32. CR2 r/w | GZ r | MP3 r | PPM r/w | WAV r
  33. CRW r/w | HDP r/w | MP4 r/w | PPT r | WDP r/w
  34. CS1 r/w | HDR r | MPC r | PPTX r | WEBP r
  35. DCM r | HTML r | MPG r | PS r/w | WEBM r
  36. DCP r/w | ICC r/w/c | MPO r/w | PSB r/w | WMA r
  37. DCR r | ICS r | MQV r/w | PSD r/w | WMV r
  38. DFONT r | IDML r | MRW r/w | PSP r | WV r
  39. DIVX r | IIQ r/w | MXF r | QTIF r/w | X3F r/w
  40. DJVU r | IND r/w | NEF r/w | RA r | XCF r
  41. DLL r | INX r | NRW r/w | RAF r/w | XLS r
  42. DNG r/w | ITC r | NUMBERS r | RAM r | XLSX r
  43. DOC r | J2C r | ODP r | RAR r | XMP r/w/c
  44. DOCX r | JNG r/w | ODS r | RAW r/w | ZIP r
  45. DPX r | JP2 r/w | ODT r | RIFF r |
  46. DR4 r/w/c | JPEG r/w | OFR r | RSRC r |
  47. DSS r | K25 r | OGG r | RTF r |
  48. DV r | KDC r | OGV r | RW2 r/w |
  49. Meta Information
  50. ----------------------+----------------------+---------------------
  51. EXIF r/w/c | CIFF r/w | Ricoh RMETA r
  52. GPS r/w/c | AFCP r/w | Picture Info r
  53. IPTC r/w/c | Kodak Meta r/w | Adobe APP14 r
  54. XMP r/w/c | FotoStation r/w | MPF r
  55. MakerNotes r/w/c | PhotoMechanic r/w | Stim r
  56. Photoshop IRB r/w/c | JPEG 2000 r | DPX r
  57. ICC Profile r/w/c | DICOM r | APE r
  58. MIE r/w/c | Flash r | Vorbis r
  59. JFIF r/w/c | FlashPix r | SPIFF r
  60. Ducky APP12 r/w/c | QuickTime r | DjVu r
  61. PDF r/w/c | Matroska r | M2TS r
  62. PNG r/w/c | MXF r | PE/COFF r
  63. Canon VRD r/w/c | PrintIM r | AVCHD r
  64. Nikon Capture r/w/c | FLAC r | ZIP r
  65. GeoTIFF r/w/c | ID3 r | (and more)
  66. See html/index.html for more details about ExifTool features.
  67. ExifTool can be downloaded from
  68. http://owl.phy.queensu.ca/~phil/exiftool/
  69. RUNNING
  70. The exiftool script can be run right away without the need to install
  71. Image::ExifTool. For example, from within the exiftool directory you can
  72. extract the information from one of the included test files by typing:
  73. ./exiftool t/images/ExifTool.jpg
  74. If you move the exiftool script to a different directory, you must also
  75. either move the contents of the lib directory or install the Image::ExifTool
  76. package so the script can find the necessary libraries.
  77. Note: If you are using the Windows cmd shell, you may need to rename
  78. 'exiftool' to 'exiftool.pl' to run it directly from the command line.
  79. Alternatively, you can run exiftool with the command 'perl exiftool'.
  80. IF YOU ARE STILL CONFUSED
  81. The exiftool script is a command line application. You run it by typing
  82. commands in a terminal window. The first step is to determine the name of
  83. the directory where you downloaded the ExifTool distribution package.
  84. Assuming, for example, you downloaded it to a folder called "Desktop" in
  85. your home directory, then you would type the following commands in a
  86. terminal window to extract and run ExifTool:
  87. cd ~/Desktop
  88. gzip -dc Image-ExifTool-##.##.tar.gz | tar -xf -
  89. cd Image-ExifTool-##.##
  90. ./exiftool t/images/ExifTool.jpg
  91. Note: You must replace "##.##" in the above commands with the actual version
  92. number of ExifTool that you downloaded. These commands extract meta
  93. information from one of the test images. To use one of your images instead,
  94. enter the full path name of your file in place of "t/images/ExifTool.jpg".
  95. INSTALLATION
  96. You can install the Image::ExifTool package to make it available for use by
  97. other Perl scripts by typing the following:
  98. perl Makefile.PL
  99. make
  100. make test
  101. make install
  102. Notes:
  103. i) You need root access for the last step above.
  104. ii) Some Perl installations (like the standard OSX installation) may not
  105. contain the necessary files to complete the first step above. But no
  106. worries: You can install ExifTool manually by moving 'exiftool' and the
  107. 'lib' directory to any directory in your current PATH (ie. /usr/bin).
  108. iii) In Windows, "dmake" or "nmake" may be used if "make" is not
  109. available. The "nmake" utility may be downloaded from Microsoft at
  110. http://support.microsoft.com/default.aspx?scid=kb;en-us;Q132084 but note
  111. that is utility is very old, and may not work with Makefiles generated by
  112. newer Perl versions.
  113. (Also see html/install.html for more help with installation.)
  114. DEPENDENCIES
  115. Requires Perl version 5.004 or later. No other special libraries are
  116. required, however the following modules are recommended for decoding
  117. compressed and/or encrypted information from the indicated file types, and
  118. for calculating digest values for some information types:
  119. Archive::Zip (ZIP, DOCX, PPTX, XLSX, ODP, ODS, ODT, EIP, iWork)
  120. Compress::Zlib (DNG, PNG, PDF, DCM, MIE and SWF files)
  121. Digest::MD5 (PDF files, IPTC information, and JPG Extended XMP)
  122. Digest::SHA (PDF with AES-256 encryption)
  123. IO::Compress::Bzip2 (RWZ files)
  124. Win32::API (for proper handling of Windows file times)
  125. Win32API::File (for Windows Unicode file names and file times)
  126. Win32::FindFile (for Windows Unicode directory support, app only)
  127. Time::HiRes (allows generation of ProcessingTime tag)
  128. COPYRIGHT AND LICENSE
  129. Copyright 2003-2016, Phil Harvey
  130. This is free software; you can redistribute it and/or modify it under the
  131. same terms as Perl itself.
  132. DISTRIBUTION FILES
  133. Below is a list of the files/directories included in the full ExifTool
  134. distribution package:
  135. Changes - Revision history
  136. MANIFEST - Full list of distribution files
  137. META.yml - Standard CPAN dependency file
  138. Makefile.PL - Makefile for installation
  139. README - This file
  140. arg_files/ - Argument files to convert metadata formats:
  141. exif2iptc.args - Arguments for converting EXIF to IPTC
  142. exif2xmp.args - Arguments for converting EXIF to XMP
  143. gps2xmp.args - Arguments for converting GPS to XMP
  144. iptc2exif.args - Arguments for converting IPTC to EXIF
  145. iptc2xmp.args - Arguments for converting IPTC to XMP
  146. iptcCore.args - Complete list of IPTC Core XMP tags
  147. pdf2xmp.args - Arguments for converting PDF to XMP
  148. xmp2exif.args - Arguments for converting XMP to EXIF
  149. xmp2gps.args - Arguments for converting XMP to GPS
  150. xmp2iptc.args - Arguments for converting XMP to IPTC
  151. xmp2pdf.args - Arguments for converting XMP to PDF
  152. config_files/ - Sample ExifTool configuration files:
  153. ExifTool_config - General example showing basic features
  154. convert_regions.config - Convert between MWG and MP face regions
  155. photoshop_paths.config - For extracting or copying Photoshop paths
  156. picasa_faces.config - Convert from Picasa to MWG/MP face regions
  157. exiftool - The exiftool application (Perl script)
  158. fmt_files/ - Output formatting example files:
  159. gpx.fmt - Format file for creating GPX track
  160. gpx_wpt.fmt - Format file for creating GPX waypoints
  161. kml.fmt - Format file for creating KML output files
  162. html/ - HTML documentation
  163. html/TagNames/ - HTML tag name documentation
  164. lib/ - ExifTool Perl library modules
  165. perl-Image-ExifTool.spec - Red Hat Packaging Manager specification file
  166. t/ - Verification test code
  167. t/images/ - Verification test images
  168. ADDITIONAL INFORMATION
  169. Read the following files included in the full distribution for more
  170. information:
  171. html/index.html - Main ExifTool documentation
  172. html/install.html - Installation instructions
  173. html/history.html - Revision history
  174. html/ExifTool.html - API documentation
  175. html/TagNames/index.html - Tag name documentation
  176. html/geotag.html - Geotag feature
  177. html/faq.html - Frequently asked questions
  178. html/filename.html - Renaming/moving files
  179. html/metafiles.html - Working with metadata sidecar files
  180. html/struct.html - Working with structured XMP information
  181. lib/Image/ExifTool/README - ExifTool library modules documentation
  182. and if you have installed Image::ExifTool, you can also consult perldoc or
  183. the man pages:
  184. perldoc exiftool
  185. perldoc Image::ExifTool
  186. perldoc Image::ExifTool::TagNames
  187. man exiftool
  188. man Image::ExifTool
  189. man Image::ExifTool::TagNames
  190. Note: If the man pages don't work, it is probably because your man path is
  191. not set to include the installed documentation. See "man man" for
  192. information about how to set the man path.
  193. ----------------------------------------------------------------------------