install.html 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  2. "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
  3. <html>
  4. <head>
  5. <title>Installing ExifTool</title>
  6. <link rel=stylesheet type='text/css' href='style.css' title='Style'>
  7. <style type="text/css">
  8. <!--
  9. li { margin-top: .5em }
  10. .attn { padding: 0.5em; border: 1px solid gray; background: #fee }
  11. -->
  12. </style></head>
  13. <body>
  14. <h1 class='up'>Installing ExifTool</h1>
  15. <blockquote class=attn><b class=red>Note:</b> ExifTool <b>does <u>not</u> need
  16. to be installed</b> to run. Just download and extract either the full Perl
  17. distribution on Mac/Linux, or the Windows EXE version on Windows, and run it
  18. directly. <i class=lt>[But note that if you move the Perl "exiftool"
  19. application, you must also move its "lib" directory to the same location. This
  20. doesn't apply to the Windows version which unpacks the libraries into a
  21. temporary directory.]</i><br><br>However, the benefits of installation are:
  22. <ul><li>Makes ExifTool available to all users.</li>
  23. <li>Saves typing on the command line (by placing "exiftool" in your PATH).</li>
  24. <li>Installs the ExifTool documentation and API libraries (full Perl version only).</li>
  25. </ul></blockquote>
  26. <p>See the appropriate section below with instructions for installing or
  27. uninstalling ExifTool on your specific platform:</p>
  28. <ul>
  29. <li><a href="#Windows">Windows</a></li>
  30. <li><a href="#OSX">Macintosh OS X</a></li>
  31. <li><a href="#Unix">Unix Platforms</a></li>
  32. </ul>
  33. <p>Also see <a href="index.html#running">these instructions</a> for help running
  34. ExifTool.</p>
  35. <hr>
  36. <h2><a name="Windows">Windows</a></h2>
  37. <p>In Windows, there is a choice of two different versions of ExifTool to
  38. install. The Perl distribution requires Perl to be installed on your system.
  39. (A good, free Perl interpreter can be downloaded from
  40. <a href="http://www.activestate.com/activeperl/">activeperl.com</a>.)</p>
  41. <p>If you don't already have Perl, it is easier to install the stand-alone ExifTool
  42. executable, but note that the stand-alone version doesn't include the HTML
  43. documentation or some other files of the full distribution.</p>
  44. <h3>Stand-Alone Executable</h3>
  45. <ol>
  46. <li><b>Download</b> the <b>Windows Executable</b> from the <a href="index.html">ExifTool home page</a>.
  47. <br><span class=lt>(The file you download will have a name like "<code>exiftool-##.##.zip</code>".)</span></li>
  48. <li><b>Extract "<code>exiftool(-k).exe</code>"</b> from the
  49. "<code>.zip</code>" file, and place it <b>on your Desktop</b>.
  50. <br><span class=lt>(Double-click on "<code>exiftool-##.##.zip</code>" to open
  51. the archive, then drag "<code>exiftool(-k).exe</code>" to your Desktop.)</span></li>
  52. </ol>
  53. <p>You can now double-click on "<code>exiftool(-k).exe</code>" to read the
  54. application documentation, or drag-and-drop files and folders to run exiftool on
  55. selected files. To install exiftool for <b>use from the command line</b>,
  56. continue with the following steps:</p>
  57. <ol start=3>
  58. <li><b>Rename</b> "<code>exiftool(-k).exe</code>" to <b>"<code>exiftool.exe</code>"</b>.
  59. <br><span class=lt>(or "<code>exiftool(-k)</code>" to "<code>exiftool</code>" if file name
  60. extensions are hidden on your system)</span></li>
  61. <li><b>Move "<code>exiftool.exe</code>"</b> to the "<code>C:\WINDOWS</code>" directory
  62. (or any other directory in your PATH).</li>
  63. </ol>
  64. <p>You can now run exiftool by typing "<code>exiftool</code>" at the command
  65. prompt. (To get to the command prompt, select "Run..." from the Windows "Start"
  66. menu, then type "<code>cmd</code>" and press Return.)</p>
  67. <p><b>Notes:</b></p>
  68. <ol type='a'>
  69. <li>In Windows 7, running exiftool requires administrator privileges. If
  70. necessary, this may be enabled by right clicking on exiftool, then selecting
  71. <b>"Run this program as administrator"</b> from the Compatibility settings.</li>
  72. <li>Occasionally users have reported that exiftool gives errors when running
  73. this version for this first time. It is possible this may happen if a file gets
  74. corrupted during the download/installation process. In this case, follow the
  75. Uninstalling instructions below then re-install exiftool. Be sure that you have
  76. sufficient disk space in your TEMP directory for exiftool to unpack about 12 MB
  77. of temporary files -- these are the Perl libraries used by the exiftool
  78. application which are unpacked the first time exiftool is run.</li>
  79. </ol>
  80. <p><b>Uninstalling:</b></p>
  81. <ol type='i'>
  82. <li>Drag "<code>exiftool(-k).exe</code>" (or "<code>C:\WINDOWS\exiftool.exe</code>")
  83. into the Recycle bin.</li>
  84. <li>Drag the directory "<code>par-USER</code>" from your temporary directory to
  85. the Recycle bin. Here "<code>USER</code>" is your Windows user name and the
  86. location of the temporary directory depends on the value of the TEMP environment
  87. variable (typically "<code>C:\Documents and Settings\USER\Local Settings\Temp</code>"
  88. for Windows XP, or "<code>C:\Users\USER\AppData\Local\Temp</code>" for Windows 7).</li>
  89. </ol>
  90. <h3>Full Perl Distribution</h3>
  91. <p>You must have Perl installed to use this version. (A free version of Perl
  92. can be downloaded from
  93. <a href="http://www.activestate.com/activeperl/">activeperl.com</a>.)</p>
  94. <ol>
  95. <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
  96. <br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
  97. <li><b>Extract the ExifTool files</b> from the archive.
  98. <br><span class=lt>(The archive is a gzipped tar file, and can be opened with
  99. various Windows utilities, including WinZip.)</span></li>
  100. <li><b>Rename</b> "<code>exiftool</code>" to <b>"<code>exiftool.pl</code>"</b>
  101. in the exiftool distribution.</li>
  102. <li><b>Move "<code>exiftool.pl</code>"</b> and the <b>"<code>lib</code>"</b>
  103. directory from the exiftool distribution to "<code>C:\WINDOWS</code>"
  104. (or any other directory in your PATH).</li>
  105. </ol>
  106. <p>Now, if you have made the proper Windows associations for the
  107. "<code>.pl</code>" extension (an option in the ActivePerl installation), you
  108. can run exiftool by typing "<code>exiftool.pl</code>" at the
  109. "<code>cmd.exe</code>" prompt. Otherwise you should type
  110. "<code>perl c:\windows\exiftool.pl</code>".</p>
  111. <p><b>Uninstalling:</b></p>
  112. <ol type='i'>
  113. <li>Drag "<code>C:\WINDOWS\exiftool.pl</code>" and
  114. "<code>C:\WINDOWS\lib</code>" into the Recycle bin. You should first confirm
  115. that "<code>C:\WINDOWS\lib</code>" contains only the "<code>File</code>"
  116. and "<code>Image</code>" sub-directories. Do not delete it if it
  117. contains anything else.</li>
  118. </ol>
  119. <hr>
  120. <h2><a name="OSX">Macintosh OS X</a></h2>
  121. <p>If you have installed the BSDSDK package from the Xcode Developer Tools
  122. (<i>ie. if you have the</i> "<code>make</code>" <i>utility</i>), you should
  123. follow the install procedure for <a href="#Unix">Unix platforms</a> in the next
  124. section instead of the steps below. The Unix install has the advantage of making
  125. the ExifTool library available for your Perl scripts, as well as installing the
  126. man pages and POD documentation.</p>
  127. <p>Otherwise, you have a choice of two packages to install: The OS X package, or
  128. the full Perl distribution. Both of the procedures below install the ExifTool
  129. files in the same location. Installing from the OS X package is easier, but the
  130. full distribution includes HTML documentation and some other files not included
  131. in the OS X package. Both versions run natively on PPC and Intel Macs.</p>
  132. <h3>OS X Package</h3>
  133. <ol>
  134. <li><b>Download</b> the <b>ExifTool OS X Package</b> from the <a href="index.html">ExifTool home page</a>.
  135. <br><span class=lt>(The file you download will have a name like "<code>ExifTool-##.##.dmg</code>".)</span></li>
  136. <li><b>Install</b> as a normal <b>OS X package</b>.
  137. <br><span class=lt>(Open the disk image, double-click on the install package, and follow the instructions.)
  138. </span></li>
  139. </ol>
  140. <p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
  141. <p>If this doesn't work, then it is likely you have an older version of OS X for which
  142. /usr/local/bin isn't in the default PATH. To fix this, add the following line to your
  143. ~/.profile settings using a text editor:</p>
  144. <blockquote><code>export PATH=$PATH:/usr/local/bin</code></blockquote>
  145. <h3>Full Perl Distribution</h3>
  146. <ol>
  147. <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
  148. to your Desktop.
  149. <br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
  150. <li><b>Launch</b> the <b>Terminal</b> application from the Utilities folder in your Applications folder.</li>
  151. <li>In the Terminal window, <b>type the following</b>:
  152. <pre class='code'> cd ~/Desktop
  153. tar -xzf Image-ExifTool-##.##.tar.gz
  154. cd Image-ExifTool-##.##
  155. sudo cp -r exiftool lib /usr/local/bin
  156. </pre>
  157. where "<code>##.##</code>" is the version number of the ExifTool you downloaded.
  158. <br><span class=lt>(Note: The last step above will require you to enter your
  159. password.)</span></li>
  160. </ol>
  161. <p>You can now run exiftool by typing "<code>exiftool</code>" in a Terminal window.</p>
  162. <p class=lt><b>Notes:</b></p><ul class=lt><li>Both OS X installation techniques outlined above place
  163. exiftool and its lib directory in /usr/local/bin, while the standard Unix
  164. "<code>make install</code>" described below puts "<code>exiftool</code>" in
  165. /usr/local/bin and the individual libraries in /Library/Perl/#.#.#, where "#.#.#" is
  166. your Perl version. If both sets of libraries exist, /usr/local/bin/lib takes
  167. precedence for exiftool, but /Library/Perl/#.#.# is the default for any other
  168. Perl scripts.</li>
  169. <li>In OS X 10.8 or later, you may see this message when you try to open the install package:
  170. <blockquote class=red>"ExifTool-##.##.pkg" can't be opened because it is from an
  171. unidentified developer.</blockquote> The solution is to set "Allow applications downloaded
  172. from" to "Anywhere" in the General "Security &amp; Privacy" System Preferences.
  173. (<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
  174. here</a> for a full description.)</li></ul>
  175. <h3>Uninstalling</h3>
  176. <ol type='i'>
  177. <li>Launch the "Terminal" application from the Applications Utilities folder.</li>
  178. <li>Type "<code>open /usr/local/bin</code>" (without the quotes) in the Terminal
  179. window, then press RETURN. (This opens a folder that you normally can't access
  180. from OS X.)</li>
  181. <li>Drag "<code>exiftool</code>" and "<code>lib</code>" into the trash from the
  182. "<code>bin</code>" folder you opened. You should first confirm that
  183. "<code>lib</code>" contains only two sub-folders: "<code>File</code>" and
  184. "<code>Image</code>". If it contains anything else, don't trash it because you
  185. have the wrong "<code>lib</code>" folder.</li>
  186. </ol>
  187. <hr>
  188. <h2><a name="Unix">Unix Platforms</a></h2>
  189. <ol>
  190. <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
  191. <br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
  192. <li><b>Unpack the distribution</b> and <b>make it your current directory</b> by typing:
  193. <pre class='code'> cd <i>&lt;your download directory&gt;</i>
  194. gzip -dc Image-ExifTool-##.##.tar.gz | tar -xf -
  195. cd Image-ExifTool-##.##
  196. </pre>
  197. where "<code>##.##</code>" is the version number of the ExifTool you downloaded.
  198. <br><span class=lt>(At this point you may run exiftool by typing
  199. "<code>exiftool <i>&lt;image file name&gt;</i></code>".)</span></li>
  200. <li><b>Test and install ExifTool</b> by typing:
  201. <pre class='code'>
  202. perl Makefile.PL
  203. make test
  204. sudo make install
  205. </pre>
  206. <span class=lt>(Note: The "<code>make test</code>" step is not required, but
  207. useful because it runs a full suite of tests to verify that ExifTool is working
  208. properly on your system. The "<code>sudo make install</code>" command requires
  209. that you have su access, and will prompt for your password. This will make
  210. ExifTool and its documentation accessible to all users on your system. If you
  211. don't have su access, you can run ExifTool in your own account by moving
  212. "<code>exiftool</code>" and its "<code>lib</code>" directory to any convienient
  213. location, preferably somewhere in your PATH.)</span></li>
  214. </ol>
  215. <p>You can now run exiftool by typing "<code>exiftool</code>". Also, you can
  216. consult the ExifTool documentation with commands like:</p>
  217. <blockquote><pre class='code'>perldoc exiftool
  218. perldoc Image::ExifTool
  219. perldoc Image::ExifTool::TagNames
  220. </pre></blockquote>
  221. <p>or</p>
  222. <blockquote><pre class='code'>man exiftool
  223. man Image::ExifTool
  224. man Image::ExifTool::TagNames
  225. </pre></blockquote>
  226. <h3>Uninstalling</h3>
  227. <ol type='i'>
  228. <li>Type "<code>sudo make uninstall</code>" from the distribution directory.
  229. <br><span class=lt>(Note: Unfortunately, newer systems may give an <i>"Uninstall
  230. is unsafe and deprecated"</i> message even though uninstalling ExifTool is safe
  231. because it has no dependencies. If this happens, the necessary commands to
  232. remove the installed files will be listed, and these commands must be run
  233. manually.)</span></li>
  234. </ol>
  235. <hr>
  236. <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
  237. </body>
  238. </html>