view release on metacpan or  search on metacpan

html/exiftool_pod.html  view on Meta::CPAN

<dd>

<p>This enhanced version of the <b>-w</b> option allows a separate output file to be created for each extracted tag. See the <b>-w</b> option documentation above for details of the basic functionality. Listed here are the differences between <b>-W</b...

<p>1) With <b>-W</b>, a new output file is created for each extracted tag.</p>

<p>2) <b>-W</b> supports four additional format codes: %t, %g and %s represent the tag name, group name, and suggested extension for the output file (based on the format of the data), and %o represents the value of the OriginalRawFileName or Original...

<p>3) The argument for <b>-W</b> is interpreted as a file name if it contains no format codes. (For <b>-w</b>, this would be a file extension.) This change allows a simple file name to be specified, which, when combined with the append feature, provi...

<pre><code># overwriting existing text file
exiftool test.jpg &gt; out.txt     # shell redirection
exiftool test.jpg -W+! out.txt  # equivalent -W option

# append to existing text file
exiftool test.jpg &gt;&gt; out.txt    # shell redirection
exiftool test.jpg -W+ out.txt   # equivalent -W option</code></pre>

<p>4) Adding the <b>-v</b> option to <b>-W</b> sends a list of the tags and output file names to the console instead of giving a verbose dump of the entire file. (Unless appending all output to one file for each source file by using <b>-W+</b> with a...

<p>5) Individual list items are stored in separate files when <b>-W</b> is combined with <b>-b</b>, but note that for separate files to be created %c or %C must be used in <i>FMT</i> to give the files unique names.</p>

</dd>
<dt id="Wext-EXT---Wext-EXT--tagOutExt"><b>-Wext</b> <i>EXT</i>, <b>--Wext</b> <i>EXT</i> (<b>-tagOutExt</b>)</dt>
<dd>

<p>This option is used to specify the type of output file(s) written by the <b>-W</b> option. An output file is written only if the suggested extension matches <i>EXT</i>. Multiple <b>-Wext</b> options may be used to write more than one type of file....

</dd>
<dt id="X--xmlFormat"><b>-X</b> (<b>-xmlFormat</b>)</dt>
<dd>

<p>Use ExifTool-specific RDF/XML formatting for console output. Implies the <b>-a</b> option, so duplicate tags are extracted. The formatting options <b>-b</b>, <b>-D</b>, <b>-H</b>, <b>-l</b>, <b>-s</b>, <b>-sep</b>, <b>-struct</b> and <b>-t</b> may...

<p>By default, <b>-X</b> outputs flattened tags, so <b>-struct</b> should be added if required to preserve XMP structures. List-type tags with multiple values are formatted as an RDF Bag, but they are combined into a single string when <b>-s</b> or <...

<p>Note: This output is NOT the same as XMP because it uses dynamically-generated property names corresponding to the ExifTool tag names with ExifTool family 1 group names as namespaces, and not the standard XMP properties and namespaces. To write XM...

</dd>
</dl>

<h3 id="Processing-control">Processing control</h3>

<dl>

<dt id="a---a--duplicates---duplicates"><b>-a</b>, <b>--a</b> (<b>-duplicates</b>, <b>--duplicates</b>)</dt>
<dd>

<p>Allow (<b>-a</b>) or suppress (<b>--a</b>) duplicate tag names to be extracted. By default, duplicate tags are suppressed when reading unless the <b>-ee</b> or <b>-X</b> options are used or the Duplicates option is enabled in the configuration fil...

</dd>
<dt id="e---composite"><b>-e</b> (<b>--composite</b>)</dt>
<dd>

<p>Extract existing tags only -- don&#39;t generate composite tags.</p>

</dd>
<dt id="ee-NUM--extractEmbedded"><b>-ee</b>[<i>NUM</i>] (<b>-extractEmbedded</b>)</dt>
<dd>

<p>Extract information from embedded documents in EPS files, embedded EPS information and JPEG and Jpeg2000 images in PDF files, embedded MPF images in JPEG and MPO files, streaming metadata in AVCHD videos, and the resource fork of Mac OS files. Imp...

<p>When used with <b>-ee</b>, the <b>-p</b> option is evaluated for each embedded document as if it were a separate input file. This allows, for example, generation of GPS track logs from timed metadata in videos. See <a href="https://exiftool.org/ge...

<p>Setting <i>NUM</i> to 2 causes the H264 video stream in MP4 videos to be parsed until the first Supplemental Enhancement Information (SEI) message is decoded, or 3 to parse the entire H624 stream and decode all SEI information. For M2TS videos, a ...

</dd>
<dt id="ext-EXT---ext-EXT--extension"><b>-ext</b>[+] <i>EXT</i>, <b>--ext</b> <i>EXT</i> (<b>-extension</b>)</dt>
<dd>

<p>Process only files with (<b>-ext</b>) or without (<b>--ext</b>) a specified extension. There may be multiple <b>-ext</b> and <b>--ext</b> options. A plus sign may be added (ie. <b>-ext+</b>) to add the specified extension to the normally processed...

<pre><code>exiftool -ext JPG DIR             # process only JPG files
exiftool --ext cr2 --ext dng DIR  # supported files but CR2/DNG
exiftool -ext+ txt DIR            # supported files plus TXT
exiftool -ext &quot;*&quot; DIR             # process all files
exiftool -ext &quot;*&quot; --ext xml DIR   # process all but XML files
exiftool -ext &quot;*&quot; --ext . DIR     # all but those with no ext</code></pre>

<p>Using this option has two main advantages over specifying <code>*.<i>EXT</i></code> on the command line: 1) It applies to files in subdirectories when combined with the <b>-r</b> option. 2) The <b>-ext</b> option is case-insensitive, which is usef...

<p>Note that all files specified on the command line will be processed regardless of extension unless the <b>-ext</b> option is used.</p>

</dd>
<dt id="F-OFFSET--fixBase"><b>-F</b>[<i>OFFSET</i>] (<b>-fixBase</b>)</dt>
<dd>

<p>Fix the base for maker notes offsets. A common problem with some image editors is that offsets in the maker notes are not adjusted properly when the file is modified. This may cause the wrong values to be extracted for some maker note entries when...

<pre><code>exiftool -F -exif:resolutionunit=inches image.jpg</code></pre>

</dd>
<dt id="fast-NUM"><b>-fast</b>[<i>NUM</i>]</dt>
<dd>

<p>Increase speed of extracting information. With <b>-fast</b> (or <b>-fast1</b>), ExifTool will not scan to the end of a JPEG image to check for an AFCP or PreviewImage trailer, or past the first comment in GIF images or the audio/video data in WAV/...

<p>Note that a separate <b>-fast</b> setting may be used for evaluation of a <b>-if</b> condition, or when ordering files with the <b>-fileOrder</b> option. See the <b>-if</b> and <b>-fileOrder</b> options for details.</p>

</dd>
<dt id="fileOrder-NUM---TAG"><b>-fileOrder</b>[<i>NUM</i>] [-]<i>TAG</i></dt>
<dd>

<p>Set file processing order according to the sorted value of the specified <i>TAG</i>. Without this option, files are processed in the order returned by the system, which is commonly by file name, but this is filesystem dependent. For example, to pr...

<pre><code>exiftool -fileOrder DateTimeOriginal DIR</code></pre>

<p>Additional <b>-fileOrder</b> options may be added for secondary sort keys. Numbers are sorted numerically, and all other values are sorted alphabetically. Files missing the specified tag are sorted last. The sort order may be reversed by prefixing...

</dd>
<dt id="i-DIR--ignore"><b>-i</b> <i>DIR</i> (<b>-ignore</b>)</dt>
<dd>

<p>Ignore specified directory name. <i>DIR</i> may be either an individual folder name, or a full path, and is case sensitive. If a full path is specified, it must match the Directory tag exactly to be ignored. Use multiple <b>-i</b> options to ignor...

</dd>
<dt id="if-NUM-EXPR"><b>-if</b>[<i>NUM</i>] <i>EXPR</i></dt>
<dd>

<p>Specify a condition to be evaluated before processing each <i>FILE</i>. <i>EXPR</i> is a Perl-like logic expression containing tag names prefixed by <code>$</code> symbols. It is evaluated with the tags from each <i>FILE</i> in turn, and the file ...