exiftool_vendored 11.94.0 → 12.06.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f8d1a45ceed2fce06b008315885667eccd1652c9
-  data.tar.gz: 1d0c0e626deab2d61cd1e3c29e1314ac1817b342
+SHA256:
+  metadata.gz: b6fbacc803486908bf63bd351d8ea3d31bbe0cf1217b6bbab9ef074cde3f0ee3
+  data.tar.gz: fcb3492aae1fbdf6587a73ea5546eed530c09ac20c67fc1a77057becd1e87b0b
 SHA512:
-  metadata.gz: f0699566c7325efa24c989da7db409805a24f487a716ca96a0e4146858f667c72e0b77a429dcad2a06e0e790f5b74a800dc1cf2d576a365fb355c93ede814bba
-  data.tar.gz: aa2d82f8be53730bb76ae38d68fc311c4ea0b68ba138e1f14afd98e2cbf2a801a5806a410516e910d7652899769b7d1fb62044d1ed18a42414de50a1e4f92564
+  metadata.gz: 7101bbb72920052732e86bb2c44b828bbb901f89363768ebc5346d5225db5919e79de5de2ca8b0af2c77ccd6d62a9f2bf677c61479b877d06fecb88bbd8b29f8
+  data.tar.gz: 0d08e16271b5bd6fe9c4f9d154190a799b3d4bd3b3bdd777a42afa4b29786595869a3068fbc213a68135559d275bcfcf07a08f22d9fdc242130770905ca826cc

data/bin/Changes

@@ -4,15 +4,175 @@ ExifTool Version History
 
 RSS feed: https://exiftool.org/rss.xml
 
-Note: The most recent production release is Version 11.85. (Other versions are
+Note: The most recent production release is Version 12.00. (Other versions are
 considered development releases, and are not uploaded to CPAN.)
 
-Apr. 17, 2020 - Version 11.94
+(I'll be on vacation from Aug 26 to Sep 3, 2020 so don't expect any
+forum or email responses from me during this time - Phil H.)
+
+Sept. 11, 2020 - Version 12.06
+
+  - Added read support for Lyrics3 metadata (and fixed problem where APE
+    metadata may be ignored if Lyrics3 exists)
+  - Added a new Panasonic VideoBurstMode value (thanks Klaus Homeister)
+  - Added a new Olympus MultipleExposureMode value
+  - Added a new Nikon LensID
+  - Added back conversions for XMP-dwc EventTime that were removed in 12.04 with
+    a patch to allow time-only values
+  - Decode GIF AspectRatio
+  - Decode Olympus FocusBracketStepSize (thanks Karsten)
+  - Extract PNG iDOT chunk in Binary format with the name AppleDataOffsets
+  - Process PNG images which do not start with mandatory IHDR chunk
+
+Aug. 24, 2020 - Version 12.05
+
+  - Added a new Panasonic SelfTimer value (thanks Herb)
+  - Decode a few more DPX tags (thanks Harry Mallon)
+  - Extract AIFF APPL tag as ApplicationData
+  - Fixed bug writing QuickTime ItemList 'gnre' Genre values
+  - Fixed an incorrect value for Panasonic VideoBurstResolution (thanks Herb)
+  - Fixed problem when applying a time shift to some invalid makernote date/time
+    values
+
+Aug. 10, 2020 - Version 12.04
+
+  - Added read support for Zeiss ZISRAW CZI files
+  - Added some new values for a couple of Olympus tags (thanks Sebastian)
+  - Decode a number of new tags for the Sony ILCE-7SM3 (thanks Jos Roost)
+  - Removed formatting restrictions on XMP-dwc:EventTime to allow a time-only
+    value to be written
+  - Moved new QuckTime ItemList tags added in version 12.02 to the proper group
+    (they were incorrectly added to the Keys group)
+  - Improved QuickTime -v3 output to show default language codes
+  - Patched -lang option to work for the values of somet tags with coded
+    translations
+  - Patched the format of a number of QuickTime tags when writing for improved
+    compatibility with iTunes and AtomicParsley
+  - Patched to write a default QuickTime language code of 0x0000 (null) instead
+    of 0x55c4 ('und')
+
+July 29, 2020 - Version 12.03
+
+  - Added family 7 group names to allow tag ID's to be specified when reading
+    and writing
+  - Fixed a couple of typos in tag values (thanks Herb)
+  - API Changes:
+      - Added HexTagIDs option
+      - Enhanced GetNewValue() to allow family 7 groups names to be used
+  - Internal Changes:
+      - Changed Composite tag ID's to use "-" instead of "::" as a separator
 
+July 27, 2020 - Version 12.02
+
+  - Added support for a number of new QuickTime ItemList tags
+  - Added support for writing XMP-xmp:RatingPercent
+  - Added a new Sony LensType (thanks Jos Roost and LibRaw)
+  - Added a new Pentax LensType (thanks James O'Neill)
+  - Decode barcodes from Ricoh APP5 RMETA segment
+  - Decode a few new QuickTime tags written by Ricoh and Garmin cameras
+  - Decode timed GPS from Sony A7R IV MP4 videos
+  - Decode timed GPS from 70mai dashcam videos
+  - Decode a few new Panasonic tags (thanks Klaus Homeister)
+  - Decode altitude and more accurate latitude/longitude from Transcend Driver
+    Pro 230 MP4 videos
+  - Improved decoding of some Canon EOS 1DXmkIII custom functions
+  - Allow integer QuickTime TrackNumber and DiskNumber values
+  - Relax validity check of QuickTime:ContentCreateDate when writing with -n
+  - Removed "Com" from the start of some unknown ItemList tag names
+  - Patched CanonCustom decoding for bug in Canon EOS-1DX firmware
+  - Changed QuickTime CleanAperture tags decode as signed rationals
+
+June 24, 2020 - Version 12.01
+
+  - Added a new NEFCompression value (thanks Warren Hatch)
   - Added a new Sony LensType (thanks Jos Roost)
+  - Decode timed GPS from Rove Stealth 4K dashcam videos
+  - Fixed bug which would corrupt TIFF images with 16-bit image data offsets
+    when writing (these are very rare)
+
+June 11, 2020 - Version 12.00 (production release)
+
+  - Added two new Olympus LensTypes (thanks Don Komarechka for one)
+  - Added two new Sony LensType values (thanks Jos Roost)
+  - Added a few new Nikon LensID's (thanks Mathieu Carbou)
+  - Added support for the Sony ZV-1 (thanks Jos Roost)
+  - Added a new CanonModelID (thanks Jos Roost)
+  - Added missing MimeType values for HEICS and HEIFS files
+  - Added definitions for a number of new XMP-crs tags
+  - Recognize WOFF and WOFF2 font files
+  - Decode streaming GPS from Roadhawk, EEEkit and 360Fly MP4 videos
+  - Decode a number of new tags for the Nikon D6 (thanks Warren Hatch)
+  - Decode a couple more AF tags for the D500/D850
+  - Decode a number of new Panasonic tags
+  - Improved Composite LensID logic (thanks Matt Stancliff)
+  - Enhanced -v option to state when a directory has 0 entries
+  - Removed a couple of incorrect Validate warnings for bilevel TIFF images
+  - Drop ContrastCurve tag when copying from NEF to JPEG
+  - Changed -csv output to add "Unknown" group name to column headings for
+    missing tags when -f and -G options are used
+  - Patched to support new XMP LensID format for Nikon cameras as written by
+    Apple Photos (thanks Mattsta)
+  - Fixed problem extracting metadata from Sigma DP2 Quattro X3F files
+  - Fixed End() and EndDir() functions so they work when writing and when the -v
+    option is used
+  - Fixed problem recognizing some PGM files
+  - Fixed bug in offsets for some Photoshop information in -v3 output
+  - Fixed problem writing a list containing empty elements inside an XMP
+    structure
+  - API Changes:
+      - Added NoMultiExif option
+      - Changed FilterW option to not write tag if $_ is set to undef
+
+May 11, 2020 - Version 11.99
+
+  - Added a new Nikon LensID (thanks Mykyta Kozlov)
+  - Added a new Canon LensType
+  - Added a newn PentaxModelID
+  - Decode a few new QuickTime tags
+  - Decode new ID3 Grouping tag
+  - Decode a few more MinoltaRaw tags (thanks LibRaw)
+  - Fixed runtime warning which could occur when reading corrupted RTF files
+  - Fixed another potential pitfall in M2TS Duration calculation
+  - Fixed problem extracting some unknown QuickTime:Keys tags
+  - Fixed problem decoding Nikon D850 orientation tags
+  - Fixed bug where TIFF image data may not be padded to an even number of bytes
+
+May 1, 2020 - Version 11.98
+
+  - Added a new Nikon LensID (thanks Warren Hatch)
+  - Added a new Sony LensType (thanks LibRaw)
+  - Added a new Canon LensType
+  - Patched to extract EXIF with an "Exif\0\0" header from WebP images
+  - Enhanced -efile option and added to the documentation
+  - Minor tweak to -htmlDump output (disallow locking of empty selection)
+  - Fixed problem determining Duration of some M2TS videos
+
+Apr. 27, 2020 - Version 11.97
+
+  - Added experimental -efile option (undocumented)
+  - Decode NMEA GGA sentence from streaming GPS of some dashcam videos
+
+Apr. 24, 2020 - Version 11.96
+
+  - Decode streaming GPS from Lucas LK-7900 Ace AVI videos
+  - Changed new Exit/ExitDir function names to End/EndDir
+  - Fixed inconsistencies when using "-use mwg" together with the -wm option
+
+Apr. 23, 2020 - Version 11.95
+
+  - Added Exit() and ExitDir() functions for use in -if conditions (NOTE: these
+    function names changed to End() and EndDir() in ExifTool 11.96)
+  - Enhanced -geotag feature to support a more flexible input CSV file format
+  - Enhanced -if and API Filter options to allow access to ExifTool object via
+    $self
+  - Fixed problem reading HEIC Exif with a missing header
+
+Apr. 17, 2020 - Version 11.94
+
+  - Added support for QuickTime ItemList:GPSCoordinates
   - Added additional Validate test for overlapping EXIF values
+  - Added a new Sony LensType (thanks Jos Roost)
   - Added a new Nikon LensID
-  - Added support for QuickTime ItemList:GPSCoordinates
   - Decode a few more Nikon tags (thanks Warren Hatch)
   - Decode Pentax ShutterType
   - Changed color of locked highlighted selection in -htmlDump output

data/bin/MANIFEST

@@ -169,6 +169,7 @@ html/TagNames/Vorbis.html
 html/TagNames/WTV.html
 html/TagNames/XMP.html
 html/TagNames/ZIP.html
+html/TagNames/ZISRAW.html
 html/TagNames/iWork.html
 html/TagNames/index.html
 html/TagNames/style.css
@@ -410,6 +411,7 @@ lib/Image/ExifTool/XMP.pm
 lib/Image/ExifTool/XMP2.pl
 lib/Image/ExifTool/XMPStruct.pl
 lib/Image/ExifTool/ZIP.pm
+lib/Image/ExifTool/ZISRAW.pm
 lib/Image/ExifTool/iWork.pm
 perl-Image-ExifTool.spec
 t/AFCP.t
@@ -915,6 +917,8 @@ t/ZIP_4.out
 t/ZIP_5.out
 t/ZIP_6.out
 t/ZIP_7.out
+t/ZISRAW.t
+t/ZISRAW_2.out
 t/images/AFCP.jpg
 t/images/AIFF.aif
 t/images/APE.ape
@@ -1089,4 +1093,5 @@ t/images/XMP8.xmp
 t/images/XMP9.xmp
 t/images/ZIP.gz
 t/images/ZIP.zip
+t/images/ZISRAW.czi
 t/images/iWork.numbers

data/bin/META.json

@@ -47,5 +47,5 @@
       }
    },
    "release_status" : "stable",
-   "version" : "11.94"
+   "version" : "12.06"
 }

data/bin/META.yml

@@ -28,4 +28,4 @@ recommends:
   Time::HiRes: 0
 requires:
   perl: 5.004
-version: 11.94
+version: 12.06

data/bin/README

@@ -14,35 +14,36 @@ supported by ExifTool (r = read, w = write, c = create):
 
   File Types
   ------------+-------------+-------------+-------------+------------
-  3FR   r     | DR4   r/w/c | ITC   r     | ODP   r     | RIFF  r
-  3G2   r/w   | DSS   r     | J2C   r     | ODS   r     | RSRC  r
-  3GP   r/w   | DV    r     | JNG   r/w   | ODT   r     | RTF   r
-  A     r     | DVB   r/w   | JP2   r/w   | OFR   r     | RW2   r/w
-  AA    r     | DVR-MS r    | JPEG  r/w   | OGG   r     | RWL   r/w
-  AAE   r     | DYLIB r     | JSON  r     | OGV   r     | RWZ   r
-  AAX   r/w   | EIP   r     | K25   r     | OPUS  r     | RM    r
-  ACR   r     | EPS   r/w   | KDC   r     | ORF   r/w   | SEQ   r
-  AFM   r     | EPUB  r     | KEY   r     | OTF   r     | SKETCH r
-  AI    r/w   | ERF   r/w   | LA    r     | PAC   r     | SO    r
-  AIFF  r     | EXE   r     | LFP   r     | PAGES r     | SR2   r/w
-  APE   r     | EXIF  r/w/c | LNK   r     | PBM   r/w   | SRF   r
-  ARQ   r/w   | EXR   r     | LRV   r/w   | PCD   r     | SRW   r/w
-  ARW   r/w   | EXV   r/w/c | M2TS  r     | PCX   r     | SVG   r
-  ASF   r     | F4A/V r/w   | M4A/V r/w   | PDB   r     | SWF   r
-  AVI   r     | FFF   r/w   | MAX   r     | PDF   r/w   | THM   r/w
-  AVIF  r/w   | FITS  r     | MEF   r/w   | PEF   r/w   | TIFF  r/w
-  AZW   r     | FLA   r     | MIE   r/w/c | PFA   r     | TORRENT r
-  BMP   r     | FLAC  r     | MIFF  r     | PFB   r     | TTC   r
-  BPG   r     | FLIF  r/w   | MKA   r     | PFM   r     | TTF   r
-  BTF   r     | FLV   r     | MKS   r     | PGF   r     | TXT   r
-  CHM   r     | FPF   r     | MKV   r     | PGM   r/w   | VCF   r
-  COS   r     | FPX   r     | MNG   r/w   | PLIST r     | VRD   r/w/c
-  CR2   r/w   | GIF   r/w   | MOBI  r     | PICT  r     | VSD   r
-  CR3   r/w   | GPR   r/w   | MODD  r     | PMP   r     | WAV   r
-  CRM   r/w   | GZ    r     | MOI   r     | PNG   r/w   | WDP   r/w
-  CRW   r/w   | HDP   r/w   | MOS   r/w   | PPM   r/w   | WEBP  r
-  CS1   r/w   | HDR   r     | MOV   r/w   | PPT   r     | WEBM  r
-  CSV   r     | HEIC  r/w   | MP3   r     | PPTX  r     | WMA   r
+  3FR   r     | DPX   r     | ISO   r     | O     r     | RAW   r/w
+  3G2   r/w   | DR4   r/w/c | ITC   r     | ODP   r     | RIFF  r
+  3GP   r/w   | DSS   r     | J2C   r     | ODS   r     | RSRC  r
+  A     r     | DV    r     | JNG   r/w   | ODT   r     | RTF   r
+  AA    r     | DVB   r/w   | JP2   r/w   | OFR   r     | RW2   r/w
+  AAE   r     | DVR-MS r    | JPEG  r/w   | OGG   r     | RWL   r/w
+  AAX   r/w   | DYLIB r     | JSON  r     | OGV   r     | RWZ   r
+  ACR   r     | EIP   r     | K25   r     | OPUS  r     | RM    r
+  AFM   r     | EPS   r/w   | KDC   r     | ORF   r/w   | SEQ   r
+  AI    r/w   | EPUB  r     | KEY   r     | OTF   r     | SKETCH r
+  AIFF  r     | ERF   r/w   | LA    r     | PAC   r     | SO    r
+  APE   r     | EXE   r     | LFP   r     | PAGES r     | SR2   r/w
+  ARQ   r/w   | EXIF  r/w/c | LNK   r     | PBM   r/w   | SRF   r
+  ARW   r/w   | EXR   r     | LRV   r/w   | PCD   r     | SRW   r/w
+  ASF   r     | EXV   r/w/c | M2TS  r     | PCX   r     | SVG   r
+  AVI   r     | F4A/V r/w   | M4A/V r/w   | PDB   r     | SWF   r
+  AVIF  r/w   | FFF   r/w   | MAX   r     | PDF   r/w   | THM   r/w
+  AZW   r     | FITS  r     | MEF   r/w   | PEF   r/w   | TIFF  r/w
+  BMP   r     | FLA   r     | MIE   r/w/c | PFA   r     | TORRENT r
+  BPG   r     | FLAC  r     | MIFF  r     | PFB   r     | TTC   r
+  BTF   r     | FLIF  r/w   | MKA   r     | PFM   r     | TTF   r
+  CHM   r     | FLV   r     | MKS   r     | PGF   r     | TXT   r
+  COS   r     | FPF   r     | MKV   r     | PGM   r/w   | VCF   r
+  CR2   r/w   | FPX   r     | MNG   r/w   | PLIST r     | VRD   r/w/c
+  CR3   r/w   | GIF   r/w   | MOBI  r     | PICT  r     | VSD   r
+  CRM   r/w   | GPR   r/w   | MODD  r     | PMP   r     | WAV   r
+  CRW   r/w   | GZ    r     | MOI   r     | PNG   r/w   | WDP   r/w
+  CS1   r/w   | HDP   r/w   | MOS   r/w   | PPM   r/w   | WEBP  r
+  CSV   r     | HDR   r     | MOV   r/w   | PPT   r     | WEBM  r
+  CZI   r     | HEIC  r/w   | MP3   r     | PPTX  r     | WMA   r
   DCM   r     | HEIF  r/w   | MP4   r/w   | PS    r/w   | WMV   r
   DCP   r/w   | HTML  r     | MPC   r     | PSB   r/w   | WTV   r
   DCR   r     | ICC   r/w/c | MPG   r     | PSD   r/w   | WV    r
@@ -53,7 +54,6 @@ supported by ExifTool (r = read, w = write, c = create):
   DNG   r/w   | INSP  r/w   | NEF   r/w   | RAF   r/w   | XMP   r/w/c
   DOC   r     | INSV  r     | NRW   r/w   | RAM   r     | ZIP   r
   DOCX  r     | INX   r     | NUMBERS r   | RAR   r     |
-  DPX   r     | ISO   r     | O     r     | RAW   r/w   |
 
   Meta Information
   ----------------------+----------------------+---------------------
@@ -105,8 +105,8 @@ your home directory, then you would type the following commands in a
 terminal window to extract and run ExifTool:
 
   cd ~/Desktop
-  gzip -dc Image-ExifTool-11.94.tar.gz | tar -xf -
-  cd Image-ExifTool-11.94
+  gzip -dc Image-ExifTool-12.06.tar.gz | tar -xf -
+  cd Image-ExifTool-12.06
   ./exiftool t/images/ExifTool.jpg
 
 Note:  These commands extract meta information from one of the test images. 

data/bin/exiftool

@@ -10,7 +10,7 @@
 use strict;
 require 5.004;
 
-my $version = '11.94';
+my $version = '12.06';
 
 # add our 'lib' directory to the include list BEFORE 'use Image::ExifTool'
 my $exeDir;
@@ -90,6 +90,7 @@ my @csvFiles;       # list of files when reading with CSV option (in ExifTool Ch
 my @csvTags;        # order of tags for first file with CSV option (lower case)
 my @delFiles;       # list of files to delete
 my @dynamicFiles;   # list of -tagsFromFile files with dynamic names and -TAG<=FMT pairs
+my @efile;          # files for writing list of error/fail/same file names
 my @exclude;        # list of excluded tags
 my (@echo3, @echo4);# stdout and stderr echo after processing is complete
 my @files;          # list of files and directories to scan
@@ -140,6 +141,7 @@ my $deleteOrig;     # 0=restore original files, 1=delete originals, 2=delete w/o
 my $disableOutput;  # flag to disable normal output
 my $doSetFileName;  # flag set if FileName may be written
 my $doUnzip;        # flag to extract info from .gz and .bz2 files
+my ($end,$endDir);  # flags to end processing
 my $escapeC;        # C-style escape
 my $escapeHTML;     # flag to escape printed values for html
 my $evalWarning;    # warning from eval
@@ -240,6 +242,8 @@ my %optArgs = (
     '-d' => 1, '-dateformat' => 1,
     '-D' => 0, # necessary to avoid matching lower-case equivalent
     '-echo' => 1, '-echo1' => 1, '-echo2' => 1, '-echo3' => 1, '-echo4' => 1,
+    '-efile' => 1, '-efile1' => 1, '-efile2' => 1, '-efile3' => 1, '-efile4' => 1,
+    '-efile!' => 1, '-efile1!' => 1, '-efile2!' => 1, '-efile3!' => 1, '-efile4!' => 1,
     '-ext' => 1, '--ext' => 1, '-ext+' => 1, '--ext+' => 1,
         '-extension' => 1, '--extension' => 1, '-extension+' => 1, '--extension+' => 1,
     '-fileorder' => 1,
@@ -289,6 +293,10 @@ my %altRecommends = (
 
 my %unescapeChar = ( 't'=>"\t", 'n'=>"\n", 'r'=>"\r" );
 
+# special subroutines used in -if condition
+sub Image::ExifTool::EndDir() { return $endDir = 1 }
+sub Image::ExifTool::End()    { return $end = 1 }
+
 # exit routine
 sub Exit {
     if ($pause) {
@@ -402,6 +410,7 @@ undef @delFiles;
 undef @dynamicFiles;
 undef @echo3;
 undef @echo4;
+undef @efile;
 undef @exclude;
 undef @files;
 undef @newValues;
@@ -435,6 +444,8 @@ undef $deleteOrig;
 undef $disableOutput;
 undef $doSetFileName;
 undef $doUnzip;
+undef $end;
+undef $endDir;
 undef $escapeHTML;
 undef $escapeC;
 undef $evalWarning;
@@ -864,6 +875,15 @@ for (;;) {
         $mt->Options(Duplicates => 1);
         next;
     }
+    if (/^efile(\d)?(!)?$/i) {
+        my $arg = shift;
+        defined $arg or Error("Expecting file name for -$_ option\n"), $badCmd=1, next;
+        $efile[0] = $arg if not $1 or $1 & 0x01;
+        $efile[1] = $arg if $1 and $1 & 0x02;
+        $efile[2] = $arg if $1 and $1 & 0x04;
+        unlink $arg if $2;
+        next;
+    }
     # (-execute handled at top of loop)
     if (/^-?ext(ension)?(\+)?$/i) {
         my $ext = shift;
@@ -1745,6 +1765,8 @@ if (@dbKeys) {
                 if ($verbose and $verbose > 1) {
                     print $vout "Imported entry for '${_}' (full path: '${absPath}')\n";
                 }
+            } elsif ($verbose and $verbose > 1) {
+                print $vout "Imported entry for '${_}' (non-existent file)\n";
             }
         }
     }
@@ -1907,6 +1929,7 @@ sub GetImageInfo($$)
     if (@condition) {
         unless ($file eq '-' or $et->Exists($file)) {
             Warn "Error: File not found - $file\n";
+            EFile($file);
             FileNotFound($file);
             ++$countBad;
             return;
@@ -1932,7 +1955,8 @@ sub GetImageInfo($$)
                     # set package so eval'd functions are in Image::ExifTool namespace
                     package Image::ExifTool;
 
-                    #### eval "-if" condition (%info)
+                    my $self = $et;
+                    #### eval "-if" condition (%info, $self)
                     $result = eval $cond;
 
                     $@ and $evalWarning = $@;
@@ -1951,6 +1975,7 @@ sub GetImageInfo($$)
         }
         unless ($result) {
             $verbose and print $vout "-------- $file (failed condition)$progStr\n";
+            EFile($file, 2);
             ++$countFailed;
             return;
         }
@@ -1971,6 +1996,7 @@ sub GetImageInfo($$)
             ++$countGoodWr;
         } else {
             Warn "Error renaming $original\n";
+            EFile($file);
             ++$countBad;
         }
         return;
@@ -1981,7 +2007,7 @@ sub GetImageInfo($$)
     my ($fp, $outfile, $append);
     if ($textOut and $verbose and not $tagOut) {
         ($fp, $outfile, $append) = OpenOutputFile($orig);
-        $fp or ++$countBad, return;
+        $fp or EFile($file), ++$countBad, return;
         # delete file if we exit prematurely (unless appending)
         $tmpText = $outfile unless $append;
         $et->Options(TextOut => $fp);
@@ -2013,6 +2039,7 @@ sub GetImageInfo($$)
         Warn "Error: File not found - $file\n";
         FileNotFound($file);
         $outfile and close($fp), undef($tmpText), $et->Unlink($outfile);
+        EFile($file);
         ++$countBad;
         return;
     }
@@ -2062,6 +2089,7 @@ sub GetImageInfo($$)
         }
         if ($info->{Error}) {
             Warn "Error: $info->{Error} - $file\n";
+            EFile($file);
             ++$countBad;
             return;
         }
@@ -2072,7 +2100,7 @@ sub GetImageInfo($$)
     # or if there is none of the requested information available
     if ($binaryOutput or not %$info) {
         my $errs = $et->GetInfo('Warning', 'Error');
-        PrintErrors($et, $errs, $file) and $rtnVal = 1;
+        PrintErrors($et, $errs, $file) and EFile($file), $rtnVal = 1;
     } elsif ($et->GetValue('Error') or ($$et{Validate} and $et->GetValue('Warning'))) {
         $rtnVal = 1;
     }
@@ -2080,7 +2108,7 @@ sub GetImageInfo($$)
     # open output file (or stdout if no output file) if not done already
     unless ($outfile or $tagOut) {
         ($fp, $outfile, $append) = OpenOutputFile($orig);
-        $fp or ++$countBad, return;
+        $fp or EFile($file), ++$countBad, return;
         $tmpText = $outfile unless $append;
     }
 
@@ -2139,7 +2167,7 @@ sub GetImageInfo($$)
         }
         delete $printFmt{HEAD} unless $outfile; # print header only once per output file
         my $errs = $et->GetInfo('Warning', 'Error');
-        PrintErrors($et, $errs, $file);
+        PrintErrors($et, $errs, $file) and EFile($file);
     } elsif (not $disableOutput) {
         my ($tag, $line, %noDups, %csvInfo, $bra, $ket, $sep);
         if ($fp) {
@@ -2248,7 +2276,7 @@ TAG:    foreach $tag (@foundTags) {
                 # the same group, and if so suppress this tag instead
                 next if $noDups and $tag =~ /^(.*?) ?\(/ and defined $$info{$1} and
                         $group eq $et->GetGroup($1, $showGroup);
-                $group = 'Unknown' if not $group and ($xml or $json);
+                $group = 'Unknown' if not $group and ($xml or $json or $csv);
                 if ($fp and not ($allGroup or $csv)) {
                     if ($lastGroup ne $group) {
                         if ($html) {
@@ -2631,6 +2659,7 @@ sub SetImageInfo($$$)
             $outfile = FilenameSPrintf($outOpt, $orig);
             if ($outfile eq '') {
                 Warn "Error: Can't create file with zero-length name from $orig\n";
+                EFile($infile);
                 ++$countBadCr;
                 return 0;
             }
@@ -2647,6 +2676,7 @@ sub SetImageInfo($$$)
                 unless (CanCreate($outType)) {
                     my $what = $srcType ? 'other types' : 'scratch';
                     WarnOnce "Error: Can't create $outType files from $what\n";
+                    EFile($infile);
                     ++$countBadCr;
                     return 0;
                 }
@@ -2684,6 +2714,7 @@ sub SetImageInfo($$$)
             $outfile = NextUnusedFilename($outfile);
             if ($et->Exists($outfile) and not $doSetFileName) {
                 Warn "Error: '${outfile}' already exists - $infile\n";
+                EFile($infile);
                 ++$countBadWr;
                 return 0;
             }
@@ -2704,7 +2735,7 @@ sub SetImageInfo($$$)
                     $setTags = $tagsFromSrc || $setTags{$dyFile};
                 } else {
                     $fromFile = FilenameSPrintf($dyFile, $orig);
-                    ++$countBadWr, return 0 unless defined $fromFile;
+                    defined $fromFile or EFile($infile), ++$countBadWr, return 0;
                     $setTags = $setTags{$dyFile};
                 }
                 # do we have multiple -tagsFromFile options with this file?
@@ -2789,7 +2820,7 @@ sub SetImageInfo($$$)
             my $err;
             $err = "You shouldn't write FileName or Directory with TestFile" if defined $newFileName or defined $newDir;
             $err = "The -o option shouldn't be used with TestFile" if defined $outfile;
-            $err and Warn("Error: $err - $infile\n"), ++$countBadWr, return 0;
+            $err and Warn("Error: $err - $infile\n"), EFile($infile), ++$countBadWr, return 0;
             $testName = FilenameSPrintf($testName, $orig);
             $testName = Image::ExifTool::GetNewFileName($file, $testName) if $file ne '';
         }
@@ -2816,6 +2847,7 @@ sub SetImageInfo($$$)
                     $sameFile = $outfile;   # same file, but the name has a different case
                 } else {
                     Warn "Error: '${outfile}' already exists - $infile\n";
+                    EFile($infile);
                     ++$countBadWr;
                     return 0;
                 }
@@ -2835,6 +2867,7 @@ sub SetImageInfo($$$)
                 unless ($numSet) {
                     # no need to write if no tags set
                     print $vout "Nothing changed in $file\n" if defined $verbose;
+                    EFile($infile, 1);
                     ++$countSameWr;
                     return 1;
                 }
@@ -2842,6 +2875,7 @@ sub SetImageInfo($$$)
                 if ($numSet == $numPseudo) {
                     # no need to write if no real tags
                     Warn("Error: Nothing to write - $file\n");
+                    EFile($infile, 1);
                     ++$countBadWr;
                     return 0;
                 }
@@ -2853,6 +2887,7 @@ sub SetImageInfo($$$)
             } else {
                 # file doesn't exist, and we can't create it
                 Warn "Error: File not found - $file\n";
+                EFile($infile);
                 FileNotFound($file);
                 ++$countBadWr;
                 return 0;
@@ -2867,9 +2902,11 @@ sub SetImageInfo($$$)
                 if ($r1 > 0 or $r2 > 0 or $r3 > 0 or $r4 > 0) {
                     ++$countGoodWr;
                 } elsif ($r1 < 0 or $r2 < 0 or $r3 < 0 or $r4 < 0) {
+                    EFile($infile);
                     ++$countBadWr;
                     return 0;
                 } else {
+                    EFile($infile, 1);
                     ++$countSameWr;
                 }
                 if (defined $hardLink or defined $symLink or defined $testName) {
@@ -2883,6 +2920,7 @@ sub SetImageInfo($$$)
                 $outfile = "${file}_exiftool_tmp";
                 if ($et->Exists($outfile)) {
                     Warn("Error: Temporary file already exists: $outfile\n");
+                    EFile($infile);
                     ++$countBadWr;
                     return 0;
                 }
@@ -2979,6 +3017,7 @@ sub SetImageInfo($$$)
                         } else {
                             close(NEW_FILE);
                             Warn "Error opening $file for writing\n";
+                            EFile($infile);
                             $et->Unlink($newFile);
                             ++$countBadWr;
                         }
@@ -2996,11 +3035,13 @@ sub SetImageInfo($$$)
                         # unlink may fail if already renamed or no permission
                         if (not $et->Unlink($file)) {
                             Warn "Error renaming temporary file to $dstFile\n";
+                            EFile($infile);
                             $et->Unlink($newFile);
                             ++$countBadWr;
                         # try renaming again now that the target has been deleted
                         } elsif (not $et->Rename($newFile, $dstFile)) {
                             Warn "Error renaming temporary file to $dstFile\n";
+                            EFile($infile);
                             # (don't delete tmp file now because it is all we have left)
                             ++$countBadWr;
                         } else {
@@ -3022,6 +3063,7 @@ sub SetImageInfo($$$)
             ++$countGoodWr;
         }
     } elsif ($success) {
+        EFile($infile, 1);
         if ($isTemporary) {
             # just erase the temporary file since no changes were made
             $et->Unlink($tmpFile);
@@ -3035,6 +3077,7 @@ sub SetImageInfo($$$)
         }
         print $vout "Nothing changed in $file\n" if defined $verbose;
     } else {
+        EFile($infile);
         $et->Unlink($tmpFile) if defined $tmpFile;
         ++$countBadWr;
     }
@@ -3422,7 +3465,7 @@ sub DoSetFromFile($$$)
         ++$warns while $$info{"Warning ($warns)"};
         $numSet -= $warns;
     }
-    PrintErrors($et, $info, $file) and ++$countBadWr, return 0;
+    PrintErrors($et, $info, $file) and EFile($file), ++$countBadWr, return 0;
     Warn "Warning: No writable tags set from $file\n" unless $numSet;
     return 1;
 }
@@ -3508,9 +3551,11 @@ sub ProcessFiles($;$)
                 push(@$list, $file);
             } else {
                 GetImageInfo($et, $file);
+                $end and Warn("End called - $file\n");
             }
         }
         $et->Options(CharsetFileName => $enc) if $utf8FileName{$file};
+        last if $end;
     }
 }
 
@@ -3588,6 +3633,7 @@ sub ScanDir($$;$)
             next if $file =~ /^\./ and ($recurse == 1 or $file eq '.' or $file eq '..');
             next if $ignore{$file} or ($ignore{SYMLINKS} and -l $path);
             ScanDir($et, $path, $list);
+            last if $end;
             next;
         }
         # apply rules from -ext options
@@ -3618,6 +3664,7 @@ sub ScanDir($$;$)
         {
             Warn("Not writing $path\n");
             WarnOnce("Use -overwrite_original_in_place to write files with Unicode surrogate characters\n");
+            EFile($file);
             ++$countBad;
             next;
         }
@@ -3626,6 +3673,15 @@ sub ScanDir($$;$)
             push(@$list, $path);
         } else {
             GetImageInfo($et, $path);
+            if ($end) {
+                Warn("End called - $file\n");
+                last;
+            }
+            if ($endDir) {
+                $dir =~ s(/$)();
+                Warn("EndDir called - $path\n");
+                last;
+            }
         }
     }
     ++$countDir;
@@ -3683,6 +3739,7 @@ sub FindFileWindows($$)
         $evalWarning =~ s/ at .*//s;
         Warn "Error: [Win32::FindFile] $evalWarning - $wildfile\n";
         undef @files;
+        EFile($wildfile);
         ++$countBad;
     }
     return @files;
@@ -4009,8 +4066,8 @@ sub CreateDirectory($)
             }
             $dir .= '/';
         }
+        ++$countNewDir if $created;
     }
-    ++$countNewDir if $created;
     return $created;
 }
 
@@ -4197,6 +4254,29 @@ sub ReadStayOpen($)
     }
 }
 
+#------------------------------------------------------------------------------
+# Add new entry to -efile output file
+# Inputs: 0) file name, 1) -efile option number (0=error, 1=same, 2=failed)
+sub EFile($$)
+{
+    my $entry = shift;
+    my $efile = $efile[shift || 0];
+    if (defined $efile and length $entry and $entry ne '-') {
+        my $err;
+        CreateDirectory($efile);
+        if ($mt->Open(\*EFILE_FILE, $efile, '>>')) {
+            print EFILE_FILE $entry, "\n" or Warn("Error writing to $efile\n"), $err = 1;
+            close EFILE_FILE;
+        } else {
+            Warn("Error opening '${efile}' for append\n");
+            $err = 1;
+        }
+        if ($err) {
+            defined $_ and $_ eq $efile and undef $_ foreach @efile;
+        }
+    }
+}
+
 #------------------------------------------------------------------------------
 # Print list of tags
 # Inputs: 0) message, 1-N) list of tag names
@@ -4304,35 +4384,36 @@ supported by ExifTool (r = read, w = write, c = create):
 
   File Types
   ------------+-------------+-------------+-------------+------------
-  3FR   r     | DR4   r/w/c | ITC   r     | ODP   r     | RIFF  r
-  3G2   r/w   | DSS   r     | J2C   r     | ODS   r     | RSRC  r
-  3GP   r/w   | DV    r     | JNG   r/w   | ODT   r     | RTF   r
-  A     r     | DVB   r/w   | JP2   r/w   | OFR   r     | RW2   r/w
-  AA    r     | DVR-MS r    | JPEG  r/w   | OGG   r     | RWL   r/w
-  AAE   r     | DYLIB r     | JSON  r     | OGV   r     | RWZ   r
-  AAX   r/w   | EIP   r     | K25   r     | OPUS  r     | RM    r
-  ACR   r     | EPS   r/w   | KDC   r     | ORF   r/w   | SEQ   r
-  AFM   r     | EPUB  r     | KEY   r     | OTF   r     | SKETCH r
-  AI    r/w   | ERF   r/w   | LA    r     | PAC   r     | SO    r
-  AIFF  r     | EXE   r     | LFP   r     | PAGES r     | SR2   r/w
-  APE   r     | EXIF  r/w/c | LNK   r     | PBM   r/w   | SRF   r
-  ARQ   r/w   | EXR   r     | LRV   r/w   | PCD   r     | SRW   r/w
-  ARW   r/w   | EXV   r/w/c | M2TS  r     | PCX   r     | SVG   r
-  ASF   r     | F4A/V r/w   | M4A/V r/w   | PDB   r     | SWF   r
-  AVI   r     | FFF   r/w   | MAX   r     | PDF   r/w   | THM   r/w
-  AVIF  r/w   | FITS  r     | MEF   r/w   | PEF   r/w   | TIFF  r/w
-  AZW   r     | FLA   r     | MIE   r/w/c | PFA   r     | TORRENT r
-  BMP   r     | FLAC  r     | MIFF  r     | PFB   r     | TTC   r
-  BPG   r     | FLIF  r/w   | MKA   r     | PFM   r     | TTF   r
-  BTF   r     | FLV   r     | MKS   r     | PGF   r     | TXT   r
-  CHM   r     | FPF   r     | MKV   r     | PGM   r/w   | VCF   r
-  COS   r     | FPX   r     | MNG   r/w   | PLIST r     | VRD   r/w/c
-  CR2   r/w   | GIF   r/w   | MOBI  r     | PICT  r     | VSD   r
-  CR3   r/w   | GPR   r/w   | MODD  r     | PMP   r     | WAV   r
-  CRM   r/w   | GZ    r     | MOI   r     | PNG   r/w   | WDP   r/w
-  CRW   r/w   | HDP   r/w   | MOS   r/w   | PPM   r/w   | WEBP  r
-  CS1   r/w   | HDR   r     | MOV   r/w   | PPT   r     | WEBM  r
-  CSV   r     | HEIC  r/w   | MP3   r     | PPTX  r     | WMA   r
+  3FR   r     | DPX   r     | ISO   r     | O     r     | RAW   r/w
+  3G2   r/w   | DR4   r/w/c | ITC   r     | ODP   r     | RIFF  r
+  3GP   r/w   | DSS   r     | J2C   r     | ODS   r     | RSRC  r
+  A     r     | DV    r     | JNG   r/w   | ODT   r     | RTF   r
+  AA    r     | DVB   r/w   | JP2   r/w   | OFR   r     | RW2   r/w
+  AAE   r     | DVR-MS r    | JPEG  r/w   | OGG   r     | RWL   r/w
+  AAX   r/w   | DYLIB r     | JSON  r     | OGV   r     | RWZ   r
+  ACR   r     | EIP   r     | K25   r     | OPUS  r     | RM    r
+  AFM   r     | EPS   r/w   | KDC   r     | ORF   r/w   | SEQ   r
+  AI    r/w   | EPUB  r     | KEY   r     | OTF   r     | SKETCH r
+  AIFF  r     | ERF   r/w   | LA    r     | PAC   r     | SO    r
+  APE   r     | EXE   r     | LFP   r     | PAGES r     | SR2   r/w
+  ARQ   r/w   | EXIF  r/w/c | LNK   r     | PBM   r/w   | SRF   r
+  ARW   r/w   | EXR   r     | LRV   r/w   | PCD   r     | SRW   r/w
+  ASF   r     | EXV   r/w/c | M2TS  r     | PCX   r     | SVG   r
+  AVI   r     | F4A/V r/w   | M4A/V r/w   | PDB   r     | SWF   r
+  AVIF  r/w   | FFF   r/w   | MAX   r     | PDF   r/w   | THM   r/w
+  AZW   r     | FITS  r     | MEF   r/w   | PEF   r/w   | TIFF  r/w
+  BMP   r     | FLA   r     | MIE   r/w/c | PFA   r     | TORRENT r
+  BPG   r     | FLAC  r     | MIFF  r     | PFB   r     | TTC   r
+  BTF   r     | FLIF  r/w   | MKA   r     | PFM   r     | TTF   r
+  CHM   r     | FLV   r     | MKS   r     | PGF   r     | TXT   r
+  COS   r     | FPF   r     | MKV   r     | PGM   r/w   | VCF   r
+  CR2   r/w   | FPX   r     | MNG   r/w   | PLIST r     | VRD   r/w/c
+  CR3   r/w   | GIF   r/w   | MOBI  r     | PICT  r     | VSD   r
+  CRM   r/w   | GPR   r/w   | MODD  r     | PMP   r     | WAV   r
+  CRW   r/w   | GZ    r     | MOI   r     | PNG   r/w   | WDP   r/w
+  CS1   r/w   | HDP   r/w   | MOS   r/w   | PPM   r/w   | WEBP  r
+  CSV   r     | HDR   r     | MOV   r/w   | PPT   r     | WEBM  r
+  CZI   r     | HEIC  r/w   | MP3   r     | PPTX  r     | WMA   r
   DCM   r     | HEIF  r/w   | MP4   r/w   | PS    r/w   | WMV   r
   DCP   r/w   | HTML  r     | MPC   r     | PSB   r/w   | WTV   r
   DCR   r     | ICC   r/w/c | MPG   r     | PSD   r/w   | WV    r
@@ -4343,7 +4424,6 @@ supported by ExifTool (r = read, w = write, c = create):
   DNG   r/w   | INSP  r/w   | NEF   r/w   | RAF   r/w   | XMP   r/w/c
   DOC   r     | INSV  r     | NRW   r/w   | RAM   r     | ZIP   r
   DOCX  r     | INX   r     | NUMBERS r   | RAR   r     |
-  DPX   r     | ISO   r     | O     r     | RAW   r/w   |
 
   Meta Information
   ----------------------+----------------------+---------------------
@@ -4399,7 +4479,7 @@ L<Input-output text formatting|/Input-output text formatting>
   -f          (-forcePrint)        Force printing of all specified tags
   -g[NUM...]  (-groupHeadings)     Organize output by tag group
   -G[NUM...]  (-groupNames)        Print group name for each tag
-  -h          (-htmlFormat)        Use HMTL formatting for output
+  -h          (-htmlFormat)        Use HTML formatting for output
   -H          (-hex)               Show tag ID numbers in hexadecimal
   -htmlDump[OFFSET]                Generate HTML-format binary dump
   -j[[+]=JSONFILE] (-json)         Export/import tags in JSON format
@@ -4474,6 +4554,7 @@ L<Advanced options|/Advanced options>
   -common_args                     Define common arguments
   -config CFGFILE                  Specify configuration file name
   -echo[NUM] TEXT                  Echo text to stdout or stderr
+  -efile[NUM][!] ERRFILE           Save names of files with errors
   -execute[NUM]                    Execute multiple commands on one line
   -srcfile FMT                     Process a different source file
   -stay_open FLAG                  Keep reading -@ argfile even after EOF
@@ -4544,7 +4625,7 @@ delete or replace a tag (see L</WRITING EXAMPLES> for examples).  C<^=> is
 used to write an empty string instead of deleting the tag when no I<VALUE>
 is given, but otherwise it is equivalent to C<=>.
 
-I<TAG> may contain one or more leading family 0, 1 or 2 group names,
+I<TAG> may contain one or more leading family 0, 1, 2 or 7 group names,
 prefixed by optional family numbers, and separated colons.  If no group name
 is specified, the tag is created in the preferred group, and updated in any
 other location where a same-named tag already exists.  The preferred group
@@ -4599,7 +4680,7 @@ the specified group(s) are removed individually, and in this case is it
 possible to exclude individual tags from a mass delete.  For example,
 C<-time:all --Exif:Time:All> removes all deletable Time tags except those in
 the EXIF.  This difference also applies if family 2 is specified when
-deleting all groups. For example, C<-2all:all=> deletes tags individually,
+deleting all groups.  For example, C<-2all:all=> deletes tags individually,
 while C<-all:all=> deletes entire blocks.
 
 5) The "APP" group names ("APP0" through "APP15") are used to delete JPEG
@@ -4999,13 +5080,13 @@ B<-csv>=I<CSVFILE> feature.
 
 Organize output by tag group.  I<NUM> specifies a group family number, and
 may be 0 (general location), 1 (specific location), 2 (category), 3
-(document number), 4 (instance number), 5 (metadata path) or 6 (EXIF/TIFF
-format).  B<-g0> is assumed if a family number is not specified, and family
-numbers may be added wherever B<-g> is mentioned in the documentation. 
-Multiple families may be specified by separating them with colons.  By
-default the resulting group name is simplified by removing any leading
+(document number), 4 (instance number), 5 (metadata path), 6 (EXIF/TIFF
+format) or 7 (tag ID).  B<-g0> is assumed if a family number is not
+specified.  May be combined with other options to add group names to the
+output.  Multiple families may be specified by separating them with colons. 
+By default the resulting group name is simplified by removing any leading
 C<Main:> and collapsing adjacent identical group names, but this can be
-avoided by placing a colon before the first family number (eg. B<-g:3:1>). 
+avoided by placing a colon before the first family number (eg. B<-g:3:1>).
 Use the B<-listg> option to list group names for a specified family.  The
 SavePath and SaveFormat API options are automatically enabled if the
 respective family 5 or 6 group names are requested.  See the
@@ -5210,7 +5291,7 @@ with this command:
 
 produces output like this:
 
-    -- Generated by ExifTool 11.94 --
+    -- Generated by ExifTool 12.06 --
     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
@@ -5687,6 +5768,14 @@ processing pass is done at the level specified by the B<-fast> option.  For
 example, using B<-if4> is possible if I<EXPR> uses only pseudo System tags,
 and may significantly speed processing if enough files fail the condition.
 
+The expression has access to the current ExifTool object through C<$self>,
+and the following special functions are available to allow short-circuiting
+of the file processing.  Both functions have a return value of 1.  Case is
+significant for function names.
+
+    End()    - end processing after this file
+    EndDir() - end processing of files in this directory
+
 Notes:
 
 1) The B<-n> and B<-b> options also apply to tags used in I<EXPR>.
@@ -6149,6 +6238,17 @@ is output as the command line is parsed, before the processing of any input
 files.  I<NUM> may also be 3 or 4 to output text (to stdout or stderr
 respectively) after processing is complete.
 
+=item B<-efile>[I<NUM>][!] I<ERRFILE>
+
+Save the names of files giving errors (I<NUM> missing or 1), files that were
+unchanged (I<NUM> is 2), files that fail the B<-if> condition (I<NUM> is 4),
+or any combination thereof (by summing I<NUM>, eg. B<-efile3> is the same
+has having both B<-efile> and B<-efile2> options with the same I<ERRFILE>).
+By default, file names are appended to any existing I<ERRFILE>, but
+I<ERRFILE> is overwritten if an exclamation point is added to the option
+(eg. B<-efile!>).  Saves the name of the file specified by the B<-srcfile>
+option if applicable.
+
 =item B<-execute>[I<NUM>]
 
 Execute command for all arguments up to this point on the command line (plus
@@ -6202,7 +6302,7 @@ line (see the B<-@> option for details).
 
 3) Write C<-execute\n> to I<ARGFILE>, where C<\n> represents a newline
 sequence.  (Note: You may need to flush your write buffers here if using
-buffered output.)  Exiftool will then execute the command with the arguments
+buffered output.)  ExifTool will then execute the command with the arguments
 received up to this point, send a "{ready}" message to stdout when done
 (unless the B<-q> or B<-T> option is used), and continue trying to read
 arguments for the next command from I<ARGFILE>.  To aid in command/response