Phraseanet/lib/exiftool/README

ExifTool by Phil Harvey (phil at owl.phy.queensu.ca)
----------------------------------------------------------------------------

ExifTool is a customizable set of Perl modules plus an application script
for reading and writing meta information in a wide variety of files,
including the maker note information of many digital cameras by various
manufacturers such as Canon, Casio, FujiFilm, HP, JVC/Victor, Kodak, Leaf,
Minolta/Konica-Minolta, Nikon, Olympus/Epson, Panasonic/Leica, Pentax/Asahi,
Ricoh, Samsung, Sanyo, Sigma/Foveon and Sony.

Below is a list of file types and meta information formats currently
supported by ExifTool (r = read, w = write, c = create):

  File Types
  ------------+-------------+-------------+-------------+------------
  3FR   r     | DVB   r     | M2TS  r     | PAGES r     | RW2   r/w  
  3G2   r     | DYLIB r     | M4A/V r     | PBM   r/w   | RWL   r/w
  3GP   r     | EIP   r     | MEF   r/w   | PDF   r/w   | RWZ   r
  ACR   r     | EPS   r/w   | MIE   r/w/c | PEF   r/w   | RM    r
  AFM   r     | ERF   r/w   | MIFF  r     | PFA   r     | SO    r
  AI    r/w   | EXE   r     | MKA   r     | PFB   r     | SR2   r/w
  AIFF  r     | EXIF  r/w/c | MKS   r     | PFM   r     | SRF   r
  APE   r     | F4A/V r     | MKV   r     | PGM   r/w   | SRW   r/w
  ARW   r/w   | FLA   r     | MNG   r/w   | PICT  r     | SVG   r
  ASF   r     | FLAC  r     | MOS   r/w   | PMP   r     | SWF   r
  AVI   r     | FLV   r     | MOV   r     | PNG   r/w   | THM   r/w
  BMP   r     | FPX   r     | MP3   r     | PPM   r/w   | TIFF  r/w
  BTF   r     | GIF   r/w   | MP4   r     | PPT   r     | TTC   r
  COS   r     | GZ    r     | MPC   r     | PPTX  r     | TTF   r
  CR2   r/w   | HDP   r/w   | MPG   r     | PS    r/w   | VRD   r/w/c
  CRW   r/w   | HTML  r     | MPO   r/w   | PSB   r/w   | WAV   r
  CS1   r/w   | ICC   r/w/c | MQV   r     | PSD   r/w   | WDP   r/w
  DCM   r     | IIQ   r     | MRW   r/w   | PSP   r     | WEBP  r
  DCP   r/w   | IND   r/w   | NEF   r/w   | QTIF  r     | WEBM  r
  DCR   r     | ITC   r     | NRW   r/w   | RA    r     | WMA   r
  DFONT r     | JNG   r/w   | NUMBERS r   | RAF   r/w   | WMV   r
  DIVX  r     | JP2   r/w   | ODP   r     | RAM   r     | X3F   r/w
  DJVU  r     | JPEG  r/w   | ODS   r     | RAR   r     | XCF   r
  DLL   r     | K25   r     | ODT   r     | RAW   r/w   | XLS   r
  DNG   r/w   | KDC   r     | OGG   r     | RIFF  r     | XLSX  r
  DOC   r     | KEY   r     | ORF   r/w   | RSRC  r     | XMP   r/w/c
  DOCX  r     | LNK   r     | OTF   r     | RTF   r     | ZIP   r

  Meta Information
  ----------------------+----------------------+---------------------
  EXIF           r/w/c  |  Kodak Meta     r/w  |  Picture Info   r
  GPS            r/w/c  |  FotoStation    r/w  |  Adobe APP14    r
  IPTC           r/w/c  |  PhotoMechanic  r/w  |  MPF            r
  XMP            r/w/c  |  JPEG 2000      r    |  Stim           r
  MakerNotes     r/w/c  |  DICOM          r    |  APE            r
  Photoshop IRB  r/w/c  |  Flash          r    |  Vorbis         r
  ICC Profile    r/w/c  |  FlashPix       r    |  SPIFF          r
  MIE            r/w/c  |  QuickTime      r    |  DjVu           r
  JFIF           r/w/c  |  Matroska       r    |  M2TS           r
  Ducky APP12    r/w/c  |  GeoTIFF        r    |  PE/COFF        r
  PDF            r/w/c  |  PrintIM        r    |  AVCHD          r
  CIFF           r/w    |  ID3            r    |  ZIP            r
  AFCP           r/w    |  Ricoh RMETA    r    |  (and more)

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
   gzip -dc Image-ExifTool-#.##.tar.gz | tar -xf -
   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 (ie. /usr/bin).

   iii) In Windows, the "nmake" utility may be downloaded from Microsoft at
   http://support.microsoft.com/default.aspx?scid=kb;en-us;Q132084 -- Type
   "nmake" instead of "make" in the commands above if using this utility.

DEPENDENCIES

Requires Perl version 5.004 or later.  No other special libraries are
required, however the following modules are recommended for decoding
compressed and/or encrypted information from the indicated file types, and
for calculating digest values for some information types:

Archive::Zip        (ZIP, DOCX, PPTX, XLSX, ODP, ODS, ODT, EIP and iWork)
Compress::Zlib      (DNG, PNG, PDF, DCM, MIE and SWF files)
Digest::MD5         (PDF files, IPTC information, and Extended XMP in JPEG)
Digest::SHA         (PDF with AES-256 encryption)
IO::Compress::Bzip2 (RWZ files)

COPYRIGHT AND LICENCE

Copyright 2003-2010, 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 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

Note: If the man pages don't work, it is probably because your man path is
not set to include the installed documentation.  See "man man" for
information about how to set the man path.

----------------------------------------------------------------------------