<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<title>Installing ExifTool</title>
<link rel=stylesheet type='text/css' href='style.css' title='Style'>
<style type="text/css">
<!--
li { margin-top: .5em }
.lt { color: #666 }
-->
</style></head>
<body>
<h1 class='up'>Installing ExifTool</h1>
<p>See the appropriate section below with instructions for installing ExifTool
on your specific platform:</p>
<ul>
<li><a href="#Windows">Windows</a></li>
<li><a href="#OSX">Macintosh OS X</a></li>
<li><a href="#Unix">Unix Platforms</a></li>
</ul>
<p>Also see <a href="index.html#running">these instructions</a> for help running
ExifTool.</p>
<hr>
<h2><a name="Windows">Windows</a></h2>
<p>In Windows, there is a choice of two different versions of ExifTool to
install. The Perl distribution requires Perl to be installed on your system.
(A good, free Perl interpreter can be downloaded from
<a href="http://www.activeperl.com/Products/ActivePerl/">activeperl.com</a>.)</p>
<p>If you don't already have Perl, it is easier to install the stand-alone ExifTool
executable, but note that the stand-alone version doesn't include the HTML
documentation or some other files of the full distribution.</p>
<h3>Stand-Alone Executable</h3>
<ol>
<li><b>Download</b> the <b>Windows Executable</b> from the <a href="index.html">ExifTool home page</a>.
<br><span class='lt'>(The file you download will have a name like "<code>exiftool-#.##.zip</code>".)</span></li>
<li><b>Extract "<code>exiftool(-k).exe</code>"</b> from the
"<code>.zip</code>" file, and place it <b>on your Desktop</b>.
<br><span class='lt'>(Double-click on "<code>exiftool-#.##.zip</code>" to open
the archive, then drag "<code>exiftool(‑k).exe</code>" to your Desktop.)</span></li>
</ol>
<p>You can now double-click on "<code>exiftool(-k).exe</code>" to read the application
documentation, or drag-and-drop files and folders to run exiftool on selected files.</p>
<p>To install exiftool for <b>use from the command line</b>, continue with the
following steps:</p>
<ol start=3>
<li><b>Rename</b> "<code>exiftool(-k).exe</code>" to <b>"<code>exiftool.exe</code>"</b>.</li>
<li><b>Move "<code>exiftool.exe</code>"</b> to the "<code>C:\WINDOWS</code>" directory
(or any other directory in your PATH).</li>
</ol>
<p>You can now run exiftool by typing "<code>exiftool</code>" at the command
prompt.</p>
<h3>Full Perl Distribution</h3>
<p>You must have Perl installed to use this version. (A free version of Perl
can be downloaded from
<a href="http://www.activeperl.com/Products/ActivePerl/">activeperl.com</a>.)</p>
<ol>
<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
<br><span class='lt'>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
<li><b>Extract the ExifTool files</b> from the archive.
<br><span class='lt'>(The archive is a gzipped tar file, and can be opened with
various Windows utilities, including WinZip.)</span></li>
<li><b>Copy "<code>exiftool</code>"</b> and the <b>"<code>lib</code>"</b>
directory from the exiftool distribution to "<code>C:\WINDOWS</code>".</li>
<li><b>Rename</b> "<code>exiftool</code>" to <b>"<code>exiftool.pl</code>"</b>
in the "<code>C:\WINDOWS</code>" directory.</li>
</ol>
<p>Now, if you have made the proper Windows associations for the
"<code>.pl</code>" extension (an option in the ActivePerl installation), you
can run exiftool by typing "<code>exiftool.pl</code>" at the
"<code>cmd.exe</code>" prompt. Otherwise you should type
"<code>perl c:\windows\exiftool.pl</code>".</p>
<hr>
<h2><a name="OSX">Macintosh OS X</a></h2>
<p>If you have installed the BSDSDK package from the Xcode Developer Tools, you
should follow the install procedure for <a href="#Unix">Unix platforms</a> in
the next section instead of the steps below. The Unix install has the advantage
of making the ExifTool library available for your Perl scripts, as well as
installing the man pages and POD documentation.</p>
<p>Otherwise, you have a choice of two packages to install: The OS X package, or
the full Perl distribution. Both of the procedures below install the ExifTool
files in the same location. Installing the OS X package is easier, but the full
distribution includes HTML documentation and some other files not included in
the OS X package. Both versions run natively on PPC and Intel Macs.</p>
<h3>OS X Package</h3>
<ol>
<li><b>Download</b> the <b>ExifTool OS X Package</b> from the <a href="index.html">ExifTool home page</a>.
<br><span class='lt'>(The file you download will have a name like "<code>ExifTool-#.##.dmg</code>".)</span></li>
<li><b>Install</b> as a normal <b>OS X package</b>.
<br><span class='lt'>(Open the disk image, double-click on the install package, and follow the instructions.)
</span></li>
</ol>
<p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
<h3>Full Perl Distribution</h3>
<ol>
<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
to your Desktop.
<br><span class='lt'>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
<li><b>Launch</b> the <b>Terminal</b> application from the Utilities folder in your Applications folder.</li>
<li>In the Terminal window, <b>type the following</b>:
<pre class='code'> cd ~/Desktop
tar -xzf Image-ExifTool-#.##.tar.gz
cd Image-ExifTool-#.##
sudo cp -r exiftool lib /usr/bin
</pre>
where "<code>#.##</code>" is replaced with the version number of ExifTool you downloaded.
<br><span class='lt'>(Note: The last step above will require you to enter your
password.)</span></li>
</ol>
<p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
<p><span class='lt'>(Note: The OS X installations above place exiftool and its
"lib" directory in /usr/bin, while the standard Unix "make install" described
below puts exiftool in /usr/bin and the individual libraries in
/Library/Perl/#.#.#, where "#.#.#" is the Perl version. If both sets of
libraries exist, /usr/bin/lib takes precedence for exiftool, but
/Library/Perl/#.## is the default for any other Perl scripts.)</span></p>
<hr>
<h2><a name="Unix">Unix Platforms</a></h2>
<ol>
<li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
<br><span class='lt'>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
<li>Change to the download directory (with "<code>cd <i>DIR</i></code>"), and <b>type the following</b>:
<pre class='code'> tar -xzf Image-ExifTool-#.##.tar.gz
cd Image-ExifTool-#.##
perl Makefile.PL
make test
sudo make install
</pre>
where "<code>#.##</code>" is replaced with the version number of ExifTool you downloaded.
<br><span class='lt'>(Note: The last step above will require you to enter your
password. The "<code>make test</code>" step is not required, but useful because
it runs a full suite of tests to validate that ExifTool is working properly on
your system.)</span></li>
</ol>
<p>You can now run exiftool by typing "<code>exiftool</code>". Also, you can
consult the ExifTool documentation with commands like:</p>
<blockquote><pre class='code'>perldoc exiftool
perldoc Image::ExifTool
perldoc Image::ExifTool::TagNames
</pre></blockquote>
<p>or</p>
<blockquote><pre class='code'>man exiftool
man Image::ExifTool
man Image::ExifTool::TagNames
</pre></blockquote>
<hr>
<p class='lf'><a href="index.html"><-- Back to ExifTool home page</a></p>
</body>
</html>