File: install.html

package info (click to toggle)
libimage-exiftool-perl 13.25%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 32,600 kB
  • sloc: perl: 297,808; xml: 123; makefile: 22; sh: 15
file content (267 lines) | stat: -rw-r--r-- 14,146 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
<!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 }
div.rt  { float: right; clear: both }
-->
</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, and
if you move the Windows "exiftool(-k).exe" or "exiftool.exe" you must also move the
"exiftool_files" folder.]</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="#MacOS">MacOS</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="https://www.activestate.com/products/perl/">activeperl.com</a> or
<a href="https://strawberryperl.com/">strawberryperl.com</a>.)</p>
<p>If you don't already have Perl, it is easier to install the ExifTool
executable version, but note that this version doesn't include the HTML
documentation or some other files of the full distribution.</p>

<h3>Windows Executable</h3>
<ol>
<li><b>Download</b> the 32-bit or 64-bit <b>Windows Executable</b> from the <a href="index.html">ExifTool home page</a>.
<br><span class=lt>(The file you download should be named "<code>exiftool-13.25_32.zip</code>"
or "<code>exiftool-13.25_64.zip</code>".)</span></li>
<li><b>Extract the "<code>exiftool-13.25_xx</code>" folder</b> from
the "<code>.zip</code>" file, and place it <b>on your Desktop</b>.
<br><span class=lt>(Double-click on "<code>exiftool-13.25_xx.zip</code>" to open
the archive, then drag "<code>exiftool-13.25_xx</code>" folder to your Desktop.)</span></li>
<li>Open the "<code>exiftool-13.25_xx</code>" folder from your Desktop.</li>
</ol>
<p>You can now double-click on "<code>exiftool(-k).exe</code>" in this folder 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=4>
<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>" and the "<code>exiftool_files</code>" folder</b>
to any directory in your PATH (or any other directory of your choosing).</li>
</ol>
<p>You can now run exiftool by typing "<code>exiftool</code>" at the command
prompt (or "<code>c:\path\to\exiftool</code>" if the directory isn't in your
PATH).  <br><span class=lt>(To get to the command prompt, select "Run..." from
the Windows "Start" menu, then type "<code>cmd</code>" and press Return.)</span></p>
<!-- (I think that these notes probably applied only to the old self-extracting version)
<p><b>Notes:</b></p>
<ol type='a'>
<li>In Windows 7, running exiftool may require 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>Windows 10 users have sometimes reported that exiftool hangs when run.
This may be due to Windows Defender blocking or slowing down exiftool. To solve
this, either disable Windows Defender or add an exclusion for exiftool (but note
that exiftool may still run more slowly if you just add an exclusion).</li>
</ol> -->
<p><a name="uninstall_Windows_exe"><b>Uninstalling:</b></a></p>
<ol type='i'>
<li>Drag "<code>exiftool(-k).exe</code>" (or "<code>exiftool.exe</code>" if you renamed
it) and the "<code>exiftool_files</code>" folder into the Recycle bin.</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> or
<a href="https://strawberryperl.com/">strawberryperl.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 should be named "<code>Image-ExifTool-13.25.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 any 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:\path\to\exiftool.pl</code>".</p>
<p><a name="uninstall_Windows_perl"><b>Uninstalling:</b></a></p>
<ol type='i'>
<li>Drag "<code>exiftool.pl</code>" and the
"<code>lib</code>" into the Recycle bin.  You should first confirm
that "<code>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="MacOS"></a><a name="OSX">MacOS</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 MacOS package, or
the full Perl distribution.  Both of the procedures below install the ExifTool
files in the same location.  Installing from the MacOS package is easier, but the
full distribution includes HTML documentation and some other files not included
in the MacOS package.  Both versions run natively on PPC and Intel Macs.</p>

<h3>MacOS Package</h3>
<ol>
<li><b>Download</b> the <b>ExifTool MacOS Package</b> from the <a href="index.html">ExifTool home page</a>.
<br><span class=lt>(The file you download should be named "<code>ExifTool-13.25.pkg</code>".)</span></li>
<li><b>Install</b> as a normal <b>MacOS package</b>.
<br><span class=lt>(Double-click on the install package, and follow the instructions.
See the second item in the Notes section below if you are stopped with an "unidentified developer" message.)
</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 MacOS 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 should be named "<code>Image-ExifTool-13.25.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-13.25.tar.gz
    cd Image-ExifTool-13.25
    sudo cp -r exiftool lib /usr/local/bin
</pre>
<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 MacOS 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 MacOS 10.8 or later, you may see this message when you try to open the install package:
<blockquote class=red>"ExifTool-13.25.pkg" can't be opened because it is from an
unidentified developer.</blockquote> The solution for MacOS 14 or earlier is
to control-click on the pkg then select "Open" from the pop-up menu instead
of just double-clicking.  An alternative is to lower the security settings by
changing "Allow applications downloaded from" to "Anywhere" in the General
"Security &amp; Privacy" System Preferences.
(<a href="https://support.apple.com/en-us/HT202491">Read here</a> or
<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">here</a>
for a full description.)  For MacOS 15, open the "Privacy &amp; Security" settings
and find the "Open Anyway" button in the Security section.
<br><br>Another possibility if you already have another version of ExifTool installed
is to remove the quarantine flag by running this command in a Terminal window,
allowing the installer to be launched:
<blockquote><pre class=code>exiftool -XAttrQuarantine= ExifTool-13.25.pkg</pre></blockquote>
or if you don't already have ExifTool installed, you can do this:
<blockquote><pre class=code>xattr -d com.apple.quarantine ExifTool-13.25.pkg</pre></blockquote>
Note that you should "cd" into the directory containing the package file
before running either of the above commands, or specify the full path name of
the package file.
</li></ul>

<h3><a name="uninstall_MacOS">Uninstalling</a></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 MacOS.)</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 should be named "<code>Image-ExifTool-13.25.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>&lt;your download directory&gt;</i>
    gzip -dc Image-ExifTool-13.25.tar.gz | tar -xf -
    cd Image-ExifTool-13.25
</pre>
<span class=lt>(At this point you may run exiftool by typing
"<code>./exiftool <i>&lt;image file name&gt;</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 convenient
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><a name="uninstall_Unix">Uninstalling</a></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">&lt;-- Back to ExifTool home page</a></p>
</body>
</html>