123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255 |
- <!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 }
- .attn { padding: 0.5em; border: 1px solid gray; background: #fee }
- -->
- </style></head>
- <body>
- <h1 class='up'>Installing ExifTool</h1>
- <blockquote class=attn><b class=red>Note:</b> ExifTool <b>does <u>not</u> need
- to be installed</b> to run. Just download and extract either the full Perl
- distribution on Mac/Linux, or the Windows EXE version on Windows, and run it
- directly. <i class=lt>[But note that if you move the Perl "exiftool"
- application, you must also move its "lib" directory to the same location. This
- doesn't apply to the Windows version which unpacks the libraries into a
- temporary directory.]</i><br><br>However, the benefits of installation are:
- <ul><li>Makes ExifTool available to all users.</li>
- <li>Saves typing on the command line (by placing "exiftool" in your PATH).</li>
- <li>Installs the ExifTool documentation and API libraries (full Perl version only).</li>
- </ul></blockquote>
- <p>See the appropriate section below with instructions for installing or
- uninstalling 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.activestate.com/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. 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>.
- <br><span class=lt>(or "<code>exiftool(-k)</code>" to "<code>exiftool</code>" if file name
- extensions are hidden on your system)</span></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. (To get to the command prompt, select "Run..." from the Windows "Start"
- menu, then type "<code>cmd</code>" and press Return.)</p>
- <p><b>Notes:</b></p>
- <ol type='a'>
- <li>In Windows 7, running exiftool requires administrator privileges. If
- necessary, this may be enabled by right clicking on exiftool, then selecting
- <b>"Run this program as administrator"</b> from the Compatibility settings.</li>
- <li>Occasionally users have reported that exiftool gives errors when running
- this version for this first time. It is possible this may happen if a file gets
- corrupted during the download/installation process. In this case, follow the
- Uninstalling instructions below then re-install exiftool. Be sure that you have
- sufficient disk space in your TEMP directory for exiftool to unpack about 12 MB
- of temporary files -- these are the Perl libraries used by the exiftool
- application which are unpacked the first time exiftool is run.</li>
- </ol>
- <p><b>Uninstalling:</b></p>
- <ol type='i'>
- <li>Drag "<code>exiftool(-k).exe</code>" (or "<code>C:\WINDOWS\exiftool.exe</code>")
- into the Recycle bin.</li>
- <li>Drag the directory "<code>par-USER</code>" from your temporary directory to
- the Recycle bin. Here "<code>USER</code>" is your Windows user name and the
- location of the temporary directory depends on the value of the TEMP environment
- variable (typically "<code>C:\Documents and Settings\USER\Local Settings\Temp</code>"
- for Windows XP, or "<code>C:\Users\USER\AppData\Local\Temp</code>" for Windows 7).</li>
- </ol>
- <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.activestate.com/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>Rename</b> "<code>exiftool</code>" to <b>"<code>exiftool.pl</code>"</b>
- in the exiftool distribution.</li>
- <li><b>Move "<code>exiftool.pl</code>"</b> and the <b>"<code>lib</code>"</b>
- directory from the exiftool distribution to "<code>C:\WINDOWS</code>"
- (or any other directory in your PATH).</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>
- <p><b>Uninstalling:</b></p>
- <ol type='i'>
- <li>Drag "<code>C:\WINDOWS\exiftool.pl</code>" and
- "<code>C:\WINDOWS\lib</code>" into the Recycle bin. You should first confirm
- that "<code>C:\WINDOWS\lib</code>" contains only the "<code>File</code>"
- and "<code>Image</code>" sub-directories. Do not delete it if it
- contains anything else.</li>
- </ol>
- <hr>
- <h2><a name="OSX">Macintosh OS X</a></h2>
- <p>If you have installed the BSDSDK package from the Xcode Developer Tools
- (<i>ie. if you have the</i> "<code>make</code>" <i>utility</i>), 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 from 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>
- <p>If this doesn't work, then it is likely you have an older version of OS X for which
- /usr/local/bin isn't in the default PATH. To fix this, add the following line to your
- ~/.profile settings using a text editor:</p>
- <blockquote><code>export PATH=$PATH:/usr/local/bin</code></blockquote>
- <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/local/bin
- </pre>
- where "<code>##.##</code>" is the version number of the 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 class=lt><b>Notes:</b></p><ul class=lt><li>Both OS X installation techniques outlined above place
- exiftool and its lib directory in /usr/local/bin, while the standard Unix
- "<code>make install</code>" described below puts "<code>exiftool</code>" in
- /usr/local/bin and the individual libraries in /Library/Perl/#.#.#, where "#.#.#" is
- your Perl version. If both sets of libraries exist, /usr/local/bin/lib takes
- precedence for exiftool, but /Library/Perl/#.#.# is the default for any other
- Perl scripts.</li>
- <li>In OS X 10.8 or later, you may see this message when you try to open the install package:
- <blockquote class=red>"ExifTool-##.##.pkg" can't be opened because it is from an
- unidentified developer.</blockquote> The solution is to set "Allow applications downloaded
- from" to "Anywhere" in the General "Security & Privacy" System Preferences.
- (<a href="http://news.softpedia.com/news/Fix-OS-X-Error-Application-Can-t-Be-Opened-Because-it-Is-from-an-Unidentified-Developer-407375.shtml">Read
- here</a> for a full description.)</li></ul>
- <h3>Uninstalling</h3>
- <ol type='i'>
- <li>Launch the "Terminal" application from the Applications Utilities folder.</li>
- <li>Type "<code>open /usr/local/bin</code>" (without the quotes) in the Terminal
- window, then press RETURN. (This opens a folder that you normally can't access
- from OS X.)</li>
- <li>Drag "<code>exiftool</code>" and "<code>lib</code>" into the trash from the
- "<code>bin</code>" folder you opened. You should first confirm that
- "<code>lib</code>" contains only two sub-folders: "<code>File</code>" and
- "<code>Image</code>". If it contains anything else, don't trash it because you
- have the wrong "<code>lib</code>" folder.</li>
- </ol>
- <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><b>Unpack the distribution</b> and <b>make it your current directory</b> by typing:
- <pre class='code'> cd <i><your download directory></i>
- gzip -dc Image-ExifTool-##.##.tar.gz | tar -xf -
- cd Image-ExifTool-##.##
- </pre>
- where "<code>##.##</code>" is the version number of the ExifTool you downloaded.
- <br><span class=lt>(At this point you may run exiftool by typing
- "<code>exiftool <i><image file name></i></code>".)</span></li>
- <li><b>Test and install ExifTool</b> by typing:
- <pre class='code'>
- perl Makefile.PL
- make test
- sudo make install
- </pre>
- <span class=lt>(Note: The "<code>make test</code>" step is not required, but
- useful because it runs a full suite of tests to verify that ExifTool is working
- properly on your system. The "<code>sudo make install</code>" command requires
- that you have su access, and will prompt for your password. This will make
- ExifTool and its documentation accessible to all users on your system. If you
- don't have su access, you can run ExifTool in your own account by moving
- "<code>exiftool</code>" and its "<code>lib</code>" directory to any convienient
- location, preferably somewhere in your PATH.)</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>
- <h3>Uninstalling</h3>
- <ol type='i'>
- <li>Type "<code>sudo make uninstall</code>" from the distribution directory.
- <br><span class=lt>(Note: Unfortunately, newer systems may give an <i>"Uninstall
- is unsafe and deprecated"</i> message even though uninstalling ExifTool is safe
- because it has no dependencies. If this happens, the necessary commands to
- remove the installed files will be listed, and these commands must be run
- manually.)</span></li>
- </ol>
- <hr>
- <p class='lf'><a href="index.html"><-- Back to ExifTool home page</a></p>
- </body>
- </html>
|