72
72
File Types | Meta Information
73
73
--------------------------------------- | --------------------
74
ACR r M4A r PS r/w | EXIF r/w/c
75
AI r MEF r PSD r/w | GPS r/w/c
76
AIFF r MIE r/w/c QTIF r | IPTC r/w/c
77
APE r MIFF r RA r | XMP r/w/c
78
ARW r MNG r/w RAF r | MakerNotes r/w/c
79
ASF r MOS r/w RAM r | Photoshop IRB r/w/c
80
AVI r MOV r RAW r/w | ICC Profile r/w/c
81
BMP r MP3 r RIFF r | MIE r/w/c
82
CR2 r/w MP4 r RM r | JFIF r/w/c
83
CRW r/w MPC r SR2 r | CIFF r/w
84
DCM r MPG r SRF r | AFCP r/w
85
DNG r/w MRW r/w SWF r | DICOM r
86
DOC r NEF r/w THM r/w | FlashPix r
87
EPS r/w OGG r TIFF r/w | GeoTIFF r
88
ERF r/w ORF r/w VRD r/w | PrintIM r
89
FLAC r PBM r/w WAV r | ID3 r
90
FPX r PDF r WDP r/w | Kodak Meta r
91
GIF r/w PEF r/w WMA r | Ricoh RMETA r
92
HTML r PGM r/w WMV r | Picture Info r
93
ICC r/w/c PICT r X3F r | Adobe APP14 r
94
JNG r/w PNG r/w XLS r | APE r
95
JP2 r PPM r/w XMP r/w/c | Vorbis r
96
JPEG r/w PPT r | (and more)</pre>
74
ACR r JP2 r/w PPT r | EXIF r/w/c
75
AI r JPEG r/w PS r/w | GPS r/w/c
76
AIFF r K25 r PSD r/w | IPTC r/w/c
77
APE r M4A r QTIF r | XMP r/w/c
78
ARW r MEF r/w RA r | MakerNotes r/w/c
79
ASF r MIE r/w/c RAF r | Photoshop IRB r/w/c
80
AVI r MIFF r RAM r | ICC Profile r/w/c
81
BMP r MNG r/w RAW r/w | MIE r/w/c
82
BTF r MOS r/w RIFF r | JFIF r/w/c
83
CR2 r/w MOV r RM r | Ducky APP12 r/w/c
84
CRW r/w MP3 r SR2 r | CIFF r/w
85
CS1 r/w MP4 r SRF r | AFCP r/w
86
DCM r MPC r SWF r | DICOM r
87
DCR r MPG r THM r/w | Flash r
88
DNG r/w MRW r/w TIFF r/w | FlashPix r
89
DOC r NEF r/w VRD r/w/c | GeoTIFF r
90
EPS r/w OGG r WAV r | PrintIM r
91
ERF r/w ORF r/w WDP r/w | ID3 r
92
FLAC r PBM r/w WMA r | Kodak Meta r
93
FLV r PDF r WMV r | Ricoh RMETA r
94
FPX r PEF r/w X3F r | Picture Info r
95
GIF r/w PGM r/w XLS r | Adobe APP14 r
96
HTML r PICT r XMP r/w/c | APE r
97
ICC r/w/c PNG r/w | Vorbis r
98
JNG r/w PPM r/w | (and more)</pre>
97
99
<p>Note: If <em>FILE</em> is a directory name, then only file types with recognized
98
100
extensions are processed when reading, and only writable types are written.
99
101
However, the <strong>-ext</strong> option may be used to force processing of files with
148
151
<p>If a group name is not specified for <em>TAG</em>, then the information is written
149
152
to the preferred group, which is the first group in the following list where
150
<em>TAG</em> is valid: 1) EXIF, 2) GPS, 3) IPTC, 4) XMP, 5) MakerNotes.</p>
153
<em>TAG</em> is valid: 1) EXIF, 2) IPTC, 3) XMP, 4) MakerNotes.</p>
153
156
<p>The special <code>All</code> tag may be used in this syntax only if a <em>VALUE</em> is NOT
216
219
<dt><strong><a name="item__2db"><strong>-b</strong></a></strong><br />
219
Output requested data in <strong>b</strong>inary format. Mainly used for extracting
220
embedded images. Suppresses output of tag names and descriptions.
222
Output requested data in <strong>b</strong>inary format without tag names or descriptions.
223
This option is mainly used for extracting embedded images, but it may also
224
be useful in separating values of list-type tags since a newline is used
225
instead of a comma to separate these values in the <strong>-b</strong> output.
223
228
<dt><strong><a name="item__2dc_fmt"><strong>-c</strong> <em>FMT</em></a></strong><br />
399
406
Convert 16-bit Unicode characters in output to Windows <strong>L</strong>atin1 (cp1252)
400
instead of the default UTF-8.
407
instead of the default UTF-8. When writing, -L is used to specify that
408
input text values are Latin1 instead of UTF-8.
403
411
<dt><strong><a name="item__2dlist_2c__2dlistw_2c__2dlistf_2c__2dlistg_5bnum_"><strong>-list</strong>, <strong>-listw</strong>, <strong>-listf</strong>, <strong>-listg</strong>[<em>NUM</em>], <strong>-listd</strong></a></strong><br />
497
505
option should be used instead unless necessary.
500
<dt><strong><a name="item__2dp_fmtfile_or_expr"><strong>-p</strong> <em>FMTFILE</em> or <em>EXPR</em></a></strong><br />
508
<dt><strong><a name="item__2dp_fmtfile_or_str"><strong>-p</strong> <em>FMTFILE</em> or <em>STR</em></a></strong><br />
503
<strong>P</strong>rint output in the format specified by the given file or expression (and
504
ignore other format options). Tag names in the format file begin with a
505
<code>$</code> symbol and may contain an optional group name. Case is not
511
<strong>P</strong>rint output in the format specified by the given file or string (and
512
ignore other format options). Tag names in the format file or string begin
513
with a <code>$</code> symbol and may contain an optional group name. Case is not
506
514
significant. Braces <code>{}</code> may be used around the tag name to separate it
507
515
from subsequent text. Use <code>$$</code> to represent a <code>$</code> symbol. In the file,
508
516
lines beginning with <code>#</code> are ignored. For example, this format file:
556
564
Print tag names instead of descriptions. This is the <strong>s</strong>hort output
557
format. Add up to 3 <strong>-s</strong> options for even shorter formats. Also effective
558
when combined with <strong>-t</strong> or <strong>-h</strong> options.
565
format. Add up to 3 <strong>-s</strong> options for even shorter formats:
569
-s - print tag names instead of descriptions
570
-s -s - no extra spaces to column-align values
571
-s -s -s - print values only</pre>
574
<p>Also effective when combined with <strong>-t</strong> or <strong>-h</strong> options.</p>
561
577
<dt><strong><a name="item__2ds"><strong>-S</strong></a></strong><br />
621
645
"'-<em>SRCTAG</em>-><em>DSTTAG</em>'".</p>
624
<p>An extension of the redirection feature allows expressions involving tag
625
names to be used on the right hand side of the <code><</code> symbol with the
626
syntax "'-<em>DSTTAG</em><<em>EXPR</em>'", where tag names in <em>EXPR</em>
627
are prefixed with a <code>$</code> symbol. See the <strong>-p</strong> option for more details
628
about this syntax. Expressions starting with a <code>=</code> sign must insert a
629
single space after the <code><</code> to avoid confusion with the <code><=</code> syntax
630
which would otherwise attempt to set the tag value from the contents of a
631
file. A single space at the start of an expression is removed if it exists,
632
but all other whitespace is preserved.</p>
648
<p>An extension of the redirection feature allows strings involving tag names
649
to be used on the right hand side of the <code><</code> symbol with the syntax
650
"'-<em>DSTTAG</em><<em>STR</em>'", where tag names in <em>STR</em> are
651
prefixed with a <code>$</code> symbol. See the <strong>-p</strong> option for more details about
652
this syntax. Strings starting with a <code>=</code> sign must insert a single space
653
after the <code><</code> to avoid confusion with the <code><=</code> syntax which would
654
otherwise attempt to set the tag value from the contents of a file. A
655
single space at the start of the string is removed if it exists, but all
656
other whitespace is preserved.</p>
635
659
<p>See <a href="#copying_examples">COPYING EXAMPLES</a> for examples using <strong>-TagsFromFile</strong>.</p>
762
786
-w G%-lc.txt # G.txt, G-b.txt, G-c.txt ...</pre>
765
<p>The format codes may also be modified by 'l' or 'u' to specify lower or
789
<p>All format codes may also be modified by 'l' or 'u' to specify lower or
766
790
upper case respectively (ie. ``%le'' for a lower case file extension). When
767
791
used to modify the copy number, the numbers are changed to an alphabetical
768
792
base (ie. as with ``%lc'' in the last example above).</p>
901
925
Extract image resolution from EXIF IFD1 information (thumbnail image IFD).
904
<dt><strong><a name="item_exiftool__2dxmp__2db_a_2ejpg__3e_xmp_2eout">exiftool -xmp -b a.jpg > xmp.out</a></strong><br />
928
<dt><strong><a name="item_exiftool__2dxmp__2db_a_2ejpg__3e_out_2exmp">exiftool -xmp -b a.jpg > out.xmp</a></strong><br />
907
931
Extract complete XMP data record intact from <code>a.jpg</code> and write it to
908
<code>xmp.out</code> using the special <code>XMP</code> tag (see the Extra tags in
932
<code>out.xmp</code> using the special <code>XMP</code> tag (see the Extra tags in
909
933
<a href="TagNames/index.html">Image::ExifTool::TagNames</a>).
936
<dt><strong><a name="item_exiftool__2dicc_profile__2db__2dw_icc_image_2ejpg">exiftool -icc_profile -b -w icc image.jpg</a></strong><br />
939
Save complete ICC_Profile from an image to an output file with the same name
940
and an extension of <code>.icc</code>.
912
943
<dt><strong><a name="item_exiftool__2dhtmldump__2dw_tmp_2f_25f__25e_2ehtml_t">exiftool -htmldump -w tmp/%f_%e.html t/images</a></strong><br />
1027
1058
via a single tag.)
1030
<dt><strong><a name="item_exiftool__2dxmp_3acity_3dkingston_dst_2ejpg">exiftool -xmp:city=Kingston dst.jpg</a></strong><br />
1061
<dt><strong><a name="item_exiftool__2dxmp_3acity_3dkingston_image1_2ejpg_ima">exiftool -xmp:city=Kingston image1.jpg image2.nef</a></strong><br />
1033
Write a tag to the XMP group (otherwise in this case the tag would get
1034
written to the IPTC group since <code>City</code> exists in both, and IPTC has
1064
Write a tag to the XMP group of two images. (Without the <code>xmp:</code> this tag
1065
would get written to the IPTC group since <code>City</code> exists in both, and IPTC
1066
is preferred by default.)
1038
1069
<dt><strong><a name="item_unknown">exiftool -LightSource-='Unknown (0)' dst.tiff</a></strong><br />
added
removed
html/exiftool_pod.html
