exiftool-vendored.exe 12.99.0 → 13.16.0

package/bin/exiftool_files/lib/Image/ExifTool.pod

@@ -5,7 +5,7 @@
 #
 # URL:          https://exiftool.org/
 #
-# Legal:        Copyright (c) 2003-2024, Phil Harvey (philharvey66 at gmail.com)
+# Legal:        Copyright (c) 2003-2025, Phil Harvey (philharvey66 at gmail.com)
 #               This library is free software; you can redistribute it and/or
 #               modify it under the same terms as Perl itself.
 #------------------------------------------------------------------------------
@@ -520,9 +520,9 @@ set to undef to pass through EXIF "ASCII" values without recoding.  Set to
 =item CharsetFileName
 
 External character set used for file names passed to ExifTool functions. 
-When set in Windows, this triggers use of Windows wide-character i/o library
-routines (requires Win32API::File).  Default is undef.  May also be set to
-an empty string to avoid "encoding not specified" warnings on Windows.
+Default is undef but "UTF8" is assumed in Windows if the file name contains
+special characters and is valid UTF8.  May also be set to an empty string to
+avoid "encoding must be specified" warnings on Windows.
 
 =item CharsetID3
 
@@ -613,8 +613,10 @@ different when copying tags with L</SetNewValuesFromFile>.
 Format for printing date/time values.  See C<strftime> in the L<POSIX>
 package and L<https://exiftool.org/filename.html#codes> for details about
 the format string.  If the date can not be converted, the value is left
-unchanged unless the StrictDate option is set.  Timezones are ignored.  The
-inverse conversion (ie. when calling L</SetNewValue>) is performed only if
+unchanged unless the StrictDate option is set.  ExifTool adds a few
+additional format specifiers (C<%f>, C<%s> and C<%z>), see
+L<https://exiftool.org/filename.html#codes> for more details. The inverse
+conversion (ie. when calling L</SetNewValue>) is performed only if
 POSIX::strptime or Time::Piece is installed.  The default setting of undef
 causes date/time values to remain in standard EXIF format (similar to a
 DateFormat of "%Y:%m:%d %H:%M:%S").
@@ -809,8 +811,30 @@ Reference units for writing GPSSpeed when geotagging:
 
 Time shift to apply to all extracted date/time PrintConv values.  Does not
 affect ValueConv values.  Value is a date/time shift string (see
-L<Image::ExifTool::Shift(3pm)|Image::ExifTool::Shift.pl>), with a leading
-'-' for negative shifts.  Default is undef.
+L<Image::ExifTool::Shift(3pm)|Image::ExifTool::Shift.pl>) with a leading
+'-' for negative shifts, or a tag name with option group prefix followed
+by '+' or '-' then the shift string.  Default is undef.
+
+Note: When specifying a number of months and/or years to shift, the tag for
+the starting date should be specified so the number of days can be
+determined unambiguously.  For example:
+
+    'createdate-1:0:0 0:0:0' - shift back by the length of the
+                               year before the CreateDate value
+    'xmp:createdate+0:2:0 0' - shift forward by the length of
+                               the 2 months after XMP:CreateDate
+
+If the starting tag is not specified, or the specified tag isn't available,
+then the shift is calculated based on the first shifted tag.
+
+=item GPSQuadrant
+
+This option is used to specify the GPS quadrant in the case where a warning
+was issued because the GPS quadrant couldn't be determined.  The value is a
+2-character code where the first character is 'N' or 'S' and the second
+character is 'E' or 'W' (case insensitive).  If this option is not set and
+the quadrant is unknown, a warning is issued and the quadrant is assumed to
+be 'NE'.
 
 =item Group#
 
@@ -840,7 +864,7 @@ used.  Set to 0 for absolute offsets.  Default is undef.
 =item IgnoreGroups
 
 Comma-separated list of group names to ignore when reading.  The group names
-are case insensitive and may be preceeded by a family number.  Set to undef
+are case insensitive and may be preceded by a family number.  Set to undef
 to clear the previous IgnoreGroups list.  Default is undef.
 
 =item IgnoreMinorErrors
@@ -865,7 +889,7 @@ to undef to clear the previous IgnoreTags list.  Default is undef.
 
 =item ImageHashType
 
-Sets type of hash algorithem used for the ImageDataHash tag calculation. 
+Sets type of hash algorithm used for the ImageDataHash tag calculation. 
 Supported options are 'MD5', 'SHA256', and 'SHA512'.  Default is 'MD5'.
 
 =item Lang
@@ -981,7 +1005,7 @@ normally.  Currently this feature applies only to GM PDR data (see
 L<Image::ExifTool::TagNames/GM Tags>).  Setting this option automatically
 sets L</IgnoreTags> to "all", and L</ExtractEmbedded> to 1.  Default is
 undef.
-    
+
 =item QuickTimeHandler
 
 Flag set to add an 'mdir' Handler to a newly created Meta box when adding
@@ -1006,7 +1030,7 @@ when written.  According to the QuickTime specification date/time values
 should be UTC, but many digital cameras store local time instead (presumably
 because they don't know the time zone), so the default is to not convert
 these times (except for Canon CR3 files, which always use UTC times).  This
-option also disables the autodetection of incorrect time-zero offsets in
+option also disables the auto-detection of incorrect time-zero offsets in
 QuickTime date/time values, and enforces a time zero of 1904 as per the
 QuickTime specification.
 
@@ -1028,6 +1052,11 @@ current RequestTags list.  Groups are requested by adding a colon after the
 name (eg. "MacOS:").  Names are converted to lower case as they are added to
 the list.  Default is undef.
 
+=item SaveBin
+
+Flag to save binary values of tags, accessible through calls to L</GetValue>
+with a value type of "Bin".
+
 =item SaveFormat
 
 Flag to save EXIF/TIFF format type as the family 6 group name when
@@ -1176,13 +1205,18 @@ details about the tags.  Level 3 adds a hex dump of the tag data, but with
 limits on the number of bytes dumped.  Levels 4 and 5 remove the dump limit
 on tag values and JPEG segment data respectively.
 
+=item WindowsLongPath
+
+Support long path names in Windows.  Enabling this option automatically
+enables the WindowsWideFile feature.  Default is 1.
+
 =item WindowsWideFile
 
-Force the use of wide-character Windows I/O functions when the 
-L</CharsetFileName> option is used.  This may be necessary when files are on
-a network drive and the current directory name contains Unicode characters.
-By default, the wide-character functions are used only if the specified file
-path contains Unicode characters.
+Force the use of wide-character Windows I/O functions.  This may be
+necessary when files are on a network drive and the current directory name
+contains Unicode characters.  Without this option the wide-character
+functions are used only if the specified file path contains Unicode
+characters.
 
 =item WriteMode
 
@@ -1257,8 +1291,9 @@ CharsetPhotoshop, CharsetQuickTime, CharsetRIFF, Composite, ExtendedXMP,
 ExtractEmbedded, FastScan, FixBase, HtmlDump, HtmlDumpBase, IgnoreGroups,
 IgnoreMinorErrors, IgnoreTags, Lang, LargeFileSupport, MakerNotes,
 MDItemTags, NoPDFList, Password, QuickTimeUTC (enforced 1904 time zero),
-RequestAll, RequestTags, SaveFormat, SavePath, ScanForXMP, Struct, TextOut,
-Unknown, Verbose, WindowsWideFile, XAttrTags and XMPAutoConv.
+RequestAll, RequestTags, SaveBin, SaveFormat, SavePath, ScanForXMP, Struct,
+TextOut, Unknown, Verbose, WindowsLongPath, WindowsWideFile, XAttrTags and
+XMPAutoConv.
 
 =item Return Value:
 
@@ -1397,7 +1432,8 @@ The following ExifTool options are effective in the call to L</WriteInfo>:
 
 ByteOrder, Charset, CharsetEXIF, CharsetFileName, CharsetIPTC, Compact,
 Compress, FixBase, IgnoreMinorErrors, NoMultiExif, NoPDFList, Password,
-QuickTimeHandler, QuickTimePad, Verbose, WindowsWideFile and WriteMode.
+QuickTimeHandler, QuickTimePad, Verbose, WindowsLongPath, WindowsWideFile
+and WriteMode.
 
 =head2 GetTagList
 
@@ -1535,14 +1571,15 @@ StrictDate and TimeZone.
 
 1) Tag key, or case-sensitive tag name with optional group prefix(es)
 
-2) [optional] Value type: 'PrintConv', 'ValueConv', 'Both', 'Raw' or
+2) [optional] Value type: 'PrintConv', 'ValueConv', 'Both', 'Raw', 'Bin' or
 'Rational'
 
 The default value type is 'PrintConv' if the PrintConv option is set,
 otherwise the default is 'ValueConv'.  A value type of 'Both' returns both
-ValueConv and PrintConv values as a list.  'Rational' returns the raw
-rational value as a string fraction for rational types, or undef for other
-types.
+ValueConv and PrintConv values as a list.  'Raw' returns the raw decoded tag
+value.  'Bin' returns the original binary data for EXIF tags if the
+L</SaveBin> option was set.  'Rational' returns the raw rational value as a
+string fraction for rational types, or undef for other types.
 
 =item Return Values:
 
@@ -2394,7 +2431,8 @@ Get a list of available API options. (See L</Options> for option details.)
 =item Return Values:
 
 Reference to list of available options.  Each entry in the list is a list
-reference with 3 items: 0=Option name, 1=Default value, 2=Description.
+reference with 4 items: 0=Option name, 1=Default value, 2=Description,
+3=flag set if option is undocumented.
 
     my $opts = Image::ExifTool::<b>AvailableOptions</b>();
     foreach (@$opts) {
@@ -2513,58 +2551,62 @@ Here is a complete list of groups for each of these families:
 
 AAC, AFCP, AIFF, APE, APP0, APP1, APP11, APP12, APP13, APP14, APP15, APP2,
 APP3, APP4, APP5, APP6, APP7, APP8, APP9, ASF, Audible, Canon, CanonVRD,
-Composite, DICOM, DNG, DV, DjVu, Ducky, EXE, EXIF, ExifTool, FITS, FLAC,
-FLIR, File, Flash, FlashPix, Font, FotoStation, GIF, GIMP, GM, GeoTiff,
-GoPro, H264, HTML, ICC_Profile, ID3, IPTC, ISO, ITC, JFIF, JPEG, JSON,
-JUMBF, Jpeg2000, LNK, Leaf, Lytro, M2TS, MIE, MIFF, MISB, MNG, MOI, MPC,
-MPEG, MPF, MXF, MakerNotes, Matroska, Meta, Ogg, OpenEXR, Opus, PDF, PICT,
-PLIST, PNG, PSP, Palm, PanasonicRaw, Parrot, PhotoCD, PhotoMechanic,
-Photoshop, PostScript, PrintIM, QuickTime, RAF, RIFF, RSRC, RTF, Radiance,
-Rawzor, Real, Red, SVG, SigmaRaw, Sony, Stim, Theora, Torrent, Trailer,
+Composite, DICOM, DjVu, DNG, Ducky, DV, EXE, EXIF, ExifTool, File, FITS,
+FLAC, Flash, FlashPix, FLIR, Font, FotoStation, GeoTiff, GIF, GIMP, GM,
+GoPro, H264, HTML, ICC_Profile, ID3, IPTC, ISO, ITC, JFIF, JPEG, Jpeg2000,
+JSON, JUMBF, Leaf, LNK, Lytro, M2TS, MakerNotes, Matroska, Meta, MIE, MIFF,
+MISB, MNG, MOI, MPC, MPEG, MPF, MXF, Ogg, OpenEXR, Opus, Palm, PanasonicRaw,
+Parrot, PDF, PhotoCD, PhotoMechanic, Photoshop, PICT, PLIST, PNG,
+PostScript, PrintIM, Protobuf, PSP, QuickTime, Radiance, RAF, Rawzor, Real,
+Red, RIFF, RSRC, RTF, SigmaRaw, Sony, Stim, SVG, Theora, Torrent, Trailer,
 VCard, Vorbis, WTV, XML, XMP, ZIP
 
 =item Family 1 (Specific Location):
 
-AAC, AC3, AFCP, AIFF, APE, ASF, AVI1, Adobe, AdobeCM, AdobeDNG, Apple,
-Audible, CBOR, CIFF, CameraIFD, Canon, CanonCustom, CanonDR4, CanonRaw,
-CanonVRD, Casio, Chapter#, Composite, DICOM, DJI, DNG, DV, DjVu, DjVu-Meta,
-Ducky, EPPIM, EXE, EXIF, ExifIFD, ExifTool, FITS, FLAC, FLIR, File, Flash,
-FlashPix, Font, FotoStation, FujiFilm, FujiIFD, GE, GIF, GIMP, GM, GPS,
-GSpherical, Garmin, GeoTiff, GlobParamIFD, GoPro, GraphConv, H264, HP, HTC,
-HTML, HTML-dc, HTML-ncc, HTML-office, HTML-prod, HTML-vw96, HTTP-equiv,
-ICC-chrm, ICC-clrt, ICC-header, ICC-meas, ICC-meta, ICC-view, ICC_Profile,
+AAC, AC3, Adobe, AdobeCM, AdobeDNG, AFCP, AIFF, APE, APP10, APP2, Apple,
+ASF, Audible, AudioItemList, AudioKeys, AudioUserData, AVI1, CameraIFD,
+Canon, CanonCustom, CanonDR4, CanonRaw, CanonVRD, Casio, CBOR, Chapter#,
+CIFF, Composite, DICOM, DJI, DjVu, DjVu-Meta, DNG, Ducky, DV, EPPIM, EXE,
+EXIF, ExifIFD, ExifTool, File, FITS, FLAC, Flash, FlashPix, FLIR, Font,
+FotoStation, FujiFilm, FujiIFD, Garmin, GE, GeoTiff, GIF, GIMP,
+GlobParamIFD, GM, GoPro, GPS, GraphConv, GSpherical, H264, HP, HTC, HTML,
+HTML-dc, HTML-ncc, HTML-office, HTML-prod, HTML-vw96, HTTP-equiv, ICC-chrm,
+ICC-cicp, ICC-clrt, ICC-header, ICC-meas, ICC-meta, ICC-view, ICC_Profile,
 ICC_Profile#, ID3, ID3v1, ID3v1_Enh, ID3v2_2, ID3v2_3, ID3v2_4, IFD0, IFD1,
-IPTC, IPTC#, ISO, ITC, InfiRay, Insta360, InteropIFD, ItemList, JFIF, JFXX,
-JPEG, JPEG-HDR, JPS, JSON, JUMBF, JVC, Jpeg2000, KDC_IFD, Keys, Kodak,
-KodakBordersIFD, KodakEffectsIFD, KodakIFD, KyoceraRaw, LNK, Leaf,
-LeafSubIFD, Leica, Lyrics3, Lytro, M-RAW, M2TS, MAC, MIE-Audio, MIE-Camera,
-MIE-Canon, MIE-Doc, MIE-Extender, MIE-Flash, MIE-GPS, MIE-Geo, MIE-Image,
-MIE-Lens, MIE-Main, MIE-MakerNotes, MIE-Meta, MIE-Orient, MIE-Preview,
-MIE-Thumbnail, MIE-UTM, MIE-Unknown, MIE-Video, MIFF, MISB, MNG, MOBI, MOI,
-MPC, MPEG, MPF0, MPImage, MS-DOC, MXF, MacOS, MakerNotes, MakerUnknown,
-Matroska, MediaJukebox, Meta, MetaIFD, Microsoft, Minolta, MinoltaRaw,
-Motorola, NITF, Nextbase, Nikon, NikonCapture, NikonCustom, NikonScan,
-NikonSettings, NineEdits, Nintendo, Ocad, Ogg, Olympus, OpenEXR, Opus, PDF,
-PICT, PNG, PNG-cICP, PNG-pHYs, PSP, Palm, Panasonic, PanasonicRaw, Parrot,
-Pentax, PhaseOne, PhotoCD, PhotoMechanic, Photoshop, PictureInfo,
-PostScript, PreviewIFD, PrintIM, ProfileIFD, Qualcomm, QuickTime, RAF, RAF2,
-RIFF, RMETA, RSRC, RTF, Radiance, Rawzor, Real, Real-CONT, Real-MDPR,
-Real-PROP, Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Reconyx, Red, Ricoh,
-SPIFF, SR2, SR2DataIFD, SR2SubIFD, SRF#, SVG, Samsung, Sanyo, Scalado,
-Sigma, SigmaRaw, Sony, SonyIDC, Stim, SubIFD, System, Theora, Torrent,
-Track#, UserData, VCalendar, VCard, VNote, Version0, Vorbis, WTV, XML, XMP,
-XMP-DICOM, XMP-Device, XMP-GAudio, XMP-GCamera, XMP-GCreations, XMP-GDepth,
-XMP-GFocus, XMP-GImage, XMP-GPano, XMP-GSpherical, XMP-LImage, XMP-MP,
-XMP-MP1, XMP-PixelLive, XMP-aas, XMP-acdsee, XMP-album, XMP-apple-fi,
-XMP-ast, XMP-aux, XMP-cc, XMP-cell, XMP-crd, XMP-creatorAtom, XMP-crs,
-XMP-dc, XMP-dex, XMP-digiKam, XMP-drone-dji, XMP-dwc, XMP-et, XMP-exif,
-XMP-exifEX, XMP-expressionmedia, XMP-extensis, XMP-fpv, XMP-getty, XMP-hdr,
-XMP-hdrgm, XMP-ics, XMP-iptcCore, XMP-iptcExt, XMP-lr, XMP-mediapro,
-XMP-microsoft, XMP-mwg-coll, XMP-mwg-kw, XMP-mwg-rs, XMP-nine, XMP-panorama,
-XMP-pdf, XMP-pdfx, XMP-photomech, XMP-photoshop, XMP-plus, XMP-pmi,
-XMP-prism, XMP-prl, XMP-prm, XMP-pur, XMP-rdf, XMP-sdc, XMP-swf, XMP-tiff,
-XMP-x, XMP-xmp, XMP-xmpBJ, XMP-xmpDM, XMP-xmpDSA, XMP-xmpMM, XMP-xmpNote,
-XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg, ZIP, iTunes
+InfiRay, Insta360, InteropIFD, IPTC, IPTC#, ISO, ITC, ItemList, iTunes,
+JFIF, JFXX, JPEG, JPEG-HDR, Jpeg2000, JPS, JSON, JUMBF, JVC, KDC_IFD, Keys,
+Kodak, KodakBordersIFD, KodakEffectsIFD, KodakIFD, KyoceraRaw, Leaf,
+LeafSubIFD, Leica, LNK, Lyrics3, Lytro, M-RAW, M2TS, MAC, MacOS, MakerNotes,
+MakerUnknown, Matroska, MediaJukebox, Meta, MetaIFD, Microsoft, MIE-Audio,
+MIE-Camera, MIE-Canon, MIE-Doc, MIE-Extender, MIE-Flash, MIE-Geo, MIE-GPS,
+MIE-Image, MIE-Lens, MIE-Main, MIE-MakerNotes, MIE-Meta, MIE-Orient,
+MIE-Preview, MIE-Thumbnail, MIE-Unknown, MIE-UTM, MIE-Video, MIFF, Minolta,
+MinoltaRaw, MISB, MNG, MOBI, MOI, Motorola, MPC, MPEG, MPF0, MPImage,
+MS-DOC, MXF, Nextbase, Nikon, NikonCapture, NikonCustom, NikonScan,
+NikonSettings, NineEdits, Nintendo, NITF, Ocad, Ogg, Olympus, OpenEXR, Opus,
+Palm, Panasonic, PanasonicRaw, Parrot, PDF, Pentax, PhaseOne, PhotoCD,
+PhotoMechanic, Photoshop, PICT, PictureInfo, PNG, PNG-cICP, PNG-pHYs,
+PostScript, PreviewIFD, PrintIM, ProfileIFD, PSP, Qualcomm, QuickTime,
+Radiance, RAF, RAF2, Rawzor, Real, Real-CONT, Real-MDPR, Real-PROP,
+Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Reconyx, Red, Ricoh, RIFF, RMETA,
+RSRC, RTF, Samsung, Sanyo, Scalado, SEAL, Sigma, SigmaRaw, Sony, SonyIDC,
+SPIFF, SR2, SR2DataIFD, SR2SubIFD, SRF#, Stim, SubIFD, SVG, System, Theora,
+Torrent, Track#, Track#ItemList, Track#Keys, Track#UserData, UserData,
+VCalendar, VCard, Version0, VideoItemList, VideoKeys, VideoUserData, Vivo,
+VNote, Vorbis, WTV, XML, XMP, XMP-aas, XMP-acdsee, XMP-acdsee-rs, XMP-album,
+XMP-apdi, XMP-apple-fi, XMP-ast, XMP-aux, XMP-cc, XMP-cell, XMP-crd,
+XMP-creatorAtom, XMP-crs, XMP-dc, XMP-Device, XMP-dex, XMP-DICOM,
+XMP-digiKam, XMP-drone-dji, XMP-dwc, XMP-et, XMP-exif, XMP-exifEX,
+XMP-expressionmedia, XMP-extensis, XMP-fpv, XMP-GAudio, XMP-GCamera,
+XMP-GContainer, XMP-GCreations, XMP-GDepth, XMP-getty, XMP-GFocus,
+XMP-GImage, XMP-GPano, XMP-GSpherical, XMP-hdr, XMP-HDRGainMap, XMP-hdrgm,
+XMP-ics, XMP-iptcCore, XMP-iptcExt, XMP-LImage, XMP-lr, XMP-mediapro,
+XMP-microsoft, XMP-MP, XMP-MP1, XMP-mwg-coll, XMP-mwg-kw, XMP-mwg-rs,
+XMP-nine, XMP-panorama, XMP-pdf, XMP-pdfx, XMP-photomech, XMP-photoshop,
+XMP-PixelLive, XMP-plus, XMP-pmi, XMP-prism, XMP-prl, XMP-prm, XMP-pur,
+XMP-rdf, XMP-sdc, XMP-seal, XMP-swf, XMP-tiff, XMP-x, XMP-xmp, XMP-xmpBJ,
+XMP-xmpDM, XMP-xmpDSA, XMP-xmpMM, XMP-xmpNote, XMP-xmpPLUS, XMP-xmpRights,
+XMP-xmpTPg, ZIP
 
 =item Family 2 (Category):
 
@@ -2804,6 +2846,10 @@ for the system.  In Windows this also has the effect of activating Unicode
 filename support via the special Windows wide-character i/o routines if
 Win32API::File is available.
 
+Note that setting the L</WindowsWideFile> or L</WindowsLongPath> option
+causes L</CharsetFileName> to default to 'UTF8' in Windows if not defined,
+and L</WindowsLongPath> is set by default in ExifTool 13.07 and later.
+
 =item Internal Character Sets:
 
 The encodings used to store strings in the various metadata formats.  These
@@ -2987,7 +3033,7 @@ specified by the L</Charset> option.
 
 =head1 AUTHOR
 
-Copyright 2003-2024, Phil Harvey
+Copyright 2003-2025, Phil Harvey
 
 This library is free software; you can redistribute it and/or modify it
 under the same terms as Perl itself.

package/bin/exiftool_files/readme_windows.txt

@@ -1,21 +1,16 @@
-This ExifTool package is intended to avoid problems of the PAR packed original ExifTool for Windows. 
+This readme is for the Windows ExifTool package by Oliver Betz.
+
+This package is intended to avoid problems of the PAR packed original ExifTool for Windows.
 
 It consists of:
 
 * ExifTool by Phil Harvey https://exiftool.org/ resp. https://github.com/exiftool/exiftool
-* Strawberry Perl http://strawberryperl.com/
-* My tiny launcher https://oliverbetz.de/pages/Artikel/ExifTool-for-Windows
-
-Please note that there can be up to three exiftool scripts in the "exiftool_files" directory:
-* exiftool.pl - only this one is called by the launcher
-* exiftool - this is from the original ExifTool distribution
-* windows_exiftool - this is from the original ExifTool distribution
+* Strawberry Perl https://strawberryperl.com/
+* Tiny launcher by Oliver Betz https://oliverbetz.de/pages/Artikel/ExifTool-for-Windows
 
-The small proportion of my own content is licensed under the https://creativecommons.org/publicdomain/zero/1.0/legalcode CC0 license
-See https://exiftool.org/ and http://strawberryperl.com/ for the license of ExifTool and Strawberry Perl.
+See https://exiftool.org/ and https://strawberryperl.com/ for the license of ExifTool and Strawberry Perl.
+The launcher is licensed under the https://creativecommons.org/publicdomain/zero/1.0/legalcode CC0 license
 
 I make no warranties about the package, and disclaim liability for all uses of the package, to the fullest extent permitted by applicable law. 
 
-Please send useful comments to mailto:ppl@oliverbetz.de - especially if you found bugs or improved something.
-
-Oliver Betz
+Oliver Betz

package/bin/exiftool_files/windows_exiftool.txt

@@ -312,8 +312,8 @@ OPTIONS
          Write a new value for the specified tag (eg. "-comment=wow"), or
          delete the tag if no *VALUE* is given (eg. "-comment="). "+=" and
          "-=" are used to add or remove existing entries from a list, or to
-         shift date/time values (see Image::ExifTool::Shift.pl and note 6
-         below for more details). "+=" may also be used to increment
+         shift date/time values (see Image::ExifTool::Shift.pl and notes 6
+         and 7 below for more details). "+=" may also be used to increment
          numerical values (or decrement if *VALUE* is negative), and "-="
          may be used to conditionally delete or replace a tag (see "WRITING
          EXAMPLES" for examples). "^=" is used to write an empty string
@@ -399,6 +399,10 @@ OPTIONS
          copy it to another tag in the same operation, use the
          -globalTimeShift option.
 
+         7) The "+=" operator may not be used to shift a List-type date/time
+         tag (eg. XMP-dc:Date) because "+=" is used to add elements to the
+         list. Instead, the -globalTimeShift option should be used.
+
          Special feature: Integer values may be specified in hexadecimal
          with a leading "0x", and simple rational values may be specified as
          fractions.
@@ -730,6 +734,13 @@ OPTIONS
          API option was used). Multiple databases may be imported in a
          single command.
 
+         Specific tags may be imported from the CSV database by adding
+         -*TAG* options to the command, or excluded with --*TAG*, with
+         exclusions taking priority. Group names and wildcards are allowed.
+         If no tags are specified, then all except FileName and Directory
+         are used. Tags are imported in the same order as the database
+         entries.
+
          When exporting a CSV file, the -g or -G option adds group names to
          the tag headings. If the -a option is used to allow duplicate tag
          names, the duplicate tags are only included in the CSV output if
@@ -775,18 +786,30 @@ OPTIONS
     -d *FMT* (-dateFormat)
          Set the format for date/time tag values. The *FMT* string may
          contain formatting codes beginning with a percent character ("%")
-         to represent the various components of a date/time value. The
-         specifics of the *FMT* syntax are system dependent -- consult the
-         "strftime" man page on your system for details. The default format
-         is equivalent to "%Y:%m:%d %H:%M:%S". This option has no effect on
-         date-only or time-only tags and ignores timezone information if
-         present. ExifTool adds a %f format code to represent fractional
-         seconds, and supports an optional width to specify the number of
-         digits after the decimal point (eg. %3f would give something like
-         .437), and a minus sign to drop the decimal point (eg. "%-3f" would
-         give 437). Only one -d option may be used per command. Requires
-         POSIX::strptime or Time::Piece for the inversion conversion when
-         writing.
+         to represent the various components of a date/time value. ExifTool
+         implements 3 format codes internally (see below), but other format
+         codes are system dependent -- consult the "strftime" man page on
+         your system for details. The default format is equivalent to
+         "%Y:%m:%d %H:%M:%S". This option has no effect on date-only or
+         time-only tags. Requires POSIX::strptime or Time::Piece for the
+         inversion conversion when writing. Only one -d option may be used
+         per command.
+
+         Additional format codes implemented internally by ExifTool:
+
+         1) %z represents the time zone in "+/-HHMM" format. Adding a colon
+         (ie. %:z) adds a colon separator (eg. "-05:00"). If the date/time
+         value doesn't contain a time zone then %z gives the system time
+         zone for the specified date/time value.
+
+         2) %f represents fractional seconds, and supports an optional width
+         to specify the number of digits after the decimal point (eg. %3f
+         would give something like ".437"). Adding a minus sign drops the
+         decimal point (eg. "%-3f" would give "437").
+
+         3) %s represents the number of seconds since 00:00 UTC Jan 1, 1970,
+         taking into account the specified time zone (or system time zone if
+         not specified).
 
     -D (-decimal)
          Show tag ID number in decimal when extracting information.
@@ -865,18 +888,29 @@ OPTIONS
          as simple strings). The -a option is implied when -json is used,
          but entries with identical JSON names are suppressed in the output.
          (-G4 may be used to ensure that all tags have unique JSON names.)
+
          Adding the -D or -H option changes tag values to JSON objects with
-         "val" and "id" fields, and adding -l adds a "desc" field, and a
-         "num" field if the numerical value is different from the converted
-         "val". The -b option may be added to output binary data, encoded in
-         base64 if necessary (indicated by ASCII "base64:" as the first 7
-         bytes of the value), and -t may be added to include tag table
-         information (see -t for details). The JSON output is UTF-8
-         regardless of any -L or -charset option setting, but the UTF-8
-         validation is disabled if a character set other than UTF-8 is
-         specified. Note that ExifTool quotes JSON values only if they don't
-         look like numbers (regardless of the original storage format or the
-         relevant metadata specification).
+         "val" and "id" fields. Adding -l adds a "desc" field, and a "num"
+         field if the numerical value is different from the converted "val",
+         and "fmt" and "hex" fields for EXIF metadata if the API SaveFormat
+         and SaveBin options are set respectively, and the length of the
+         "hex" output is limited by the API LimitLongValues setting. The -b
+         option may be added to output binary data, encoded in base64 if
+         necessary (indicated by ASCII "base64:" as the first 7 bytes of the
+         value), and -t may be added to include tag table information (see
+         -t for details). The JSON output is UTF-8 regardless of any -L or
+         -charset option setting, but the UTF-8 validation is disabled if a
+         character set other than UTF-8 is specified.
+
+         Note that ExifTool quotes JSON values only if they don't look like
+         numbers (regardless of the original storage format or the relevant
+         metadata specification). This may be a problem when reading the
+         JSON via a strongly typed language. However, the API StructFormat
+         option may be set to "JSONQ" to force quoting of numbers. As well,
+         the -sep option may be used to convert arrays into strings. For
+         example:
+
+             exiftool -j -api structformat=jsonq -sep ", " ...
 
          If *JSONFILE* is specified, the file is imported and the tag
          definitions from the file are used to set tag values on a per-file
@@ -892,6 +926,13 @@ OPTIONS
          -g). Additionally, tag names in the input JSON file may be suffixed
          with a "#" to disable print conversion.
 
+         Specific tags may be imported from the JSON database by adding
+         -*TAG* options to the command, or excluded with --*TAG*, with
+         exclusions taking priority. Group names and wildcards are allowed.
+         If no tags are specified, then all except FileName and Directory
+         are used. Tags are imported in the same order as the database
+         entries.
+
          Unlike CSV import, empty values are not ignored, and will cause an
          empty value to be written if supported by the specific metadata
          type. Tags are deleted by using the -f option and setting the tag
@@ -1035,7 +1076,7 @@ OPTIONS
 
          produces output like this:
 
-             -- Generated by ExifTool 12.99 --
+             -- Generated by ExifTool 13.16 --
              File: a.jpg - 2003:10:31 15:44:19
              (f/5.6, 1/60s, ISO 100)
              File: b.jpg - 2006:05:23 11:57:38
@@ -1052,8 +1093,9 @@ OPTIONS
          (unless the "All" group is also specified, in which case the values
          of all matching tags are joined).
 
-         When -ee (-extractEmbedded) is combined with -p, embedded documents
-         are effectively processed as separate input files.
+         The -p output iterates through the family 3 group names, with each
+         sub-document producing additional output when combined with the -ee
+         (ExtractEmbedded) option.
 
          If a specified tag does not exist, a minor warning is issued and
          the line with the missing tag is not printed. However, the -f
@@ -1147,7 +1189,8 @@ OPTIONS
          tab-delimited on a single line. The -t option may be combined with
          -j, -php or -X to add tag table information ("table", tag "id", and
          "index" for cases where multiple conditional tags exist with the
-         same ID).
+         same ID), which allows the corresponding tag to be located in the
+         -listx output.
 
     -T (-table)
          Output tag values in table form. Equivalent to -t -S -q -f.
@@ -1467,17 +1510,18 @@ OPTIONS
          images or the audio/video data in WAV/AVI files to search for
          additional metadata. These speed benefits are small when reading
          images directly from disk, but can be substantial if piping images
-         through a network connection. For more substantial speed benefits,
-         -fast2 also causes exiftool to avoid extracting any EXIF MakerNote
-         information, and to stop processing at the IDAT chunk of PNG images
-         and the mdat atom of QuickTime-format files (but note that some
-         files may store metadata after this). -fast3 avoids extracting
-         metadata from the file, and returns only pseudo System tags, but
-         still reads the file header to obtain an educated guess at
-         FileType. -fast4 doesn't even read the file header, and returns
-         only System tags and a FileType based on the file extension. -fast5
-         also disables generation of the Composite tags (like -e). Has no
-         effect when writing.
+         through a network connection. Also bypasses CRC validation when
+         writing PNG images which can be very slow. For more substantial
+         speed benefits, -fast2 also causes exiftool to avoid extracting any
+         EXIF MakerNote information, and to stop processing at the IDAT
+         chunk of PNG images and the mdat atom of QuickTime-format files
+         (but note that some files may store metadata after this). -fast3
+         avoids extracting metadata from the file, and returns only pseudo
+         System tags, but still reads the file header to obtain an educated
+         guess at FileType. -fast4 doesn't even read the file header, and
+         returns only System tags and a FileType based on the file
+         extension. -fast5 also disables generation of the Composite tags
+         (like -e). Has no effect when writing.
 
          Note that a separate -fast setting may be used for evaluation of a
          -if condition, or when ordering files with the -fileOrder option.
@@ -1878,9 +1922,10 @@ OPTIONS
          The -g and -G options may be used to organize the output by the
          specified family of groups, with -G1 being the default. The -a
          option is implied. Adding -v includes a count of the number of tags
-         that are the same in each group. The following text formatting
-         options are valid when -diff is used: -c, -charset, -d, -E, -L,
-         -lang, -n, -s, -sep, -struct and -w.
+         that are the same in each group, and -v2 also indicates when zero
+         tags were the same. The following text formatting options are valid
+         when -diff is used: -c, -charset, -d, -E, -ec, -ex, -L, -lang, -n,
+         -s, -sep, -struct and -w.
 
     -geotag *TRKFILE*
          Geotag images from the specified GPS track log file. Using the
@@ -1895,14 +1940,14 @@ OPTIONS
              exiftool -geotag trk.log image.jpg
              exiftool -geotag trk.log "-Geotime<DateTimeOriginal#" image.jpg
 
-         When the "Geotime" value is converted to UTC, the local system
-         timezone is assumed unless the date/time value contains a timezone.
-         Writing "Geotime" causes the following tags to be written (provided
-         they can be calculated from the track log, and they are supported
-         by the destination metadata format): GPSLatitude, GPSLatitudeRef,
-         GPSLongitude, GPSLongitudeRef, GPSAltitude, GPSAltitudeRef,
-         GPSDateStamp, GPSTimeStamp, GPSDateTime, GPSTrack, GPSTrackRef,
-         GPSSpeed, GPSSpeedRef, GPSImgDirection, GPSImgDirectionRef,
+         If the "Geotime" value does not contain a time zone then the local
+         system timezone is assumed. Writing "Geotime" causes the following
+         tags to be written (provided they can be calculated from the track
+         log, and they are supported by the destination metadata format):
+         GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef,
+         GPSAltitude, GPSAltitudeRef, GPSDateStamp, GPSTimeStamp,
+         GPSDateTime, GPSTrack, GPSTrackRef, GPSSpeed, GPSSpeedRef,
+         GPSImgDirection, GPSImgDirectionRef, GPSMeasureMode, GPSDOP,
          GPSPitch, GPSRoll, GPSCoordinates, AmbientTemperature and
          CameraElevationAngle. By default, in image files tags are created
          in EXIF, and updated in XMP only if they already exist. In
@@ -2369,6 +2414,10 @@ WRITING READ-ONLY FILES
         exiftool -if "$fileattributes !~ /Hidden/" ...
 
 READING EXAMPLES
+    The commands below are appropriate for the Windows cmd shell, which is
+    recommended.  If running in PowerShell, single quotes would be needed
+    instead of double quotes around arguments containing a dollar sign.
+
     exiftool -a -u -g1 a.jpg
          Print all meta information in an image, including duplicate and
          unknown tags, sorted by group (for family 1). For performance
@@ -2435,7 +2484,7 @@ READING EXAMPLES
          Print one line of output containing the file name and
          DateTimeOriginal for each image in directory "dir".
 
-    exiftool -ee3 -p '$gpslatitude, $gpslongitude, $gpstimestamp' a.m2ts
+    exiftool -ee3 -p "$gpslatitude, $gpslongitude, $gpstimestamp" a.m2ts
          Extract all GPS positions from an AVCHD video.
 
     exiftool -icc_profile -b -w icc image.jpg
@@ -2843,7 +2892,7 @@ EXIT STATUS
     the commands if -execute was used).
 
 AUTHOR
-    Copyright 2003-2024, Phil Harvey
+    Copyright 2003-2025, Phil Harvey
 
     This is free software; you can redistribute it and/or modify it under
     the same terms as Perl itself.