|
|
|
|
@ -2,7 +2,7 @@
|
|
|
|
|
.\" First parameter, NAME, should be all caps
|
|
|
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
|
|
|
.\" other parameters are allowed: see man(7), man(1)
|
|
|
|
|
.TH EXIV2 1 "August 06, 2021"
|
|
|
|
|
.TH EXIV2 1 "August 09, 2021"
|
|
|
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Some roff macros, for reference:
|
|
|
|
|
@ -136,59 +136,82 @@ encoding of the comment if necessary.
|
|
|
|
|
.SH COMMAND SUMMARY
|
|
|
|
|
.sp 1
|
|
|
|
|
.nf
|
|
|
|
|
exiv2 [ opt [arg] ]+ [ act ] file ...
|
|
|
|
|
.sp 1
|
|
|
|
|
option [arg] long option description
|
|
|
|
|
-a time --adjust Modify time stamps. [+|-]HH[:MM[:SS[.mmm]]]
|
|
|
|
|
-b --binary This option is obsolete and should not be used. Reserved for test suite (with option -pC)
|
|
|
|
|
-c txt --comment JPEG comment string to set in the image ('modify' action). ...
|
|
|
|
|
-d tgt --delete Delete target(s) for the 'delete' action. ...
|
|
|
|
|
-D +-n --days Time adjustment by a positive or negative number of days ...
|
|
|
|
|
-e tgt --extract Extract target(s) for the 'extract' action.
|
|
|
|
|
-f --force Do not prompt before overwriting existing files ...
|
|
|
|
|
-F --Force Do not prompt before renaming files (Force rename) ...
|
|
|
|
|
-g key --grep Only output info for this Exiv2 key
|
|
|
|
|
-h --help Display help and exit.
|
|
|
|
|
-i tgt --insert Insert target(s) for the 'insert' action. ...
|
|
|
|
|
-k --keep Preserve file timestamps when updating files
|
|
|
|
|
-K key --key Report key. Similar to -g (grep) however key must match exactly.
|
|
|
|
|
-l dir --location Location (directory) for files to be inserted or extracted.
|
|
|
|
|
-m cmdfile --modify read commands from cmd-file
|
|
|
|
|
-M cmd --Modify Command line for the 'modify' action. ...
|
|
|
|
|
-n enc --encode Charset to decode Exif Unicode user comments. See: man 3 iconv_open
|
|
|
|
|
-O +-n --months Time adjustment by a positive or negative number of months, ...
|
|
|
|
|
-p mod --print Print report (common reports)
|
|
|
|
|
-P flg --Print Print report (fine grained control)
|
|
|
|
|
-q --quiet Silence warnings and error messages from the Exiv2 library ...
|
|
|
|
|
-Q lvl --log Set the log-level to 'd'(ebug), 'i'(nfo), 'w'(arning), 'e'(rror)
|
|
|
|
|
-r fmt --rename Filename format for the 'rename' action. ...
|
|
|
|
|
-S suf --suffix Use suffix .suf for source files for insert command.
|
|
|
|
|
-t --timestamp Set the file timestamp according to the Exif create timestamp ...
|
|
|
|
|
-T --Timestamp Only set the file timestamp according to Exif create timestamp ...
|
|
|
|
|
-u --unknown Show unknown tags ...
|
|
|
|
|
-v --verbose verbose
|
|
|
|
|
-V --version Show the program version and exit.
|
|
|
|
|
-Y +-n --years Time adjustment by a positive or negative number of years ...
|
|
|
|
|
.sp 1
|
|
|
|
|
act pr | ex | in | rm | ad | mo | mv | fi | fc
|
|
|
|
|
\fBexiv2\fP [ \fIoption\fP [\fIarg\fP] ]+ [ \fIaction\fP ] \fIfile\fP ...
|
|
|
|
|
.sp 1
|
|
|
|
|
Where \fIfile\fP contains image metadata, optionally using a URL prefix (e.g., https://clanmills.com/Stonehenge.jpg) or wildcard pattern (e.g., *.jpg)
|
|
|
|
|
.sp 1
|
|
|
|
|
\fBoption\fP [\fIarg\fP] \fBlong option\fP [\fIarg\fP] Description
|
|
|
|
|
\fB-a\fP \fItime\fP \fB--adjust\fP \fItime\fP Automatically modify metadata time stamps ...
|
|
|
|
|
\fB-b\fP \fB--binary\fP Obsolete and should not be used. Reserved for test suite (with \fB-p\fP\fIC\fP)
|
|
|
|
|
\fB-c\fP \fItxt\fP \fB--comment\fP \fItxt\fP JPEG comment string to set in the image. For the 'modify' action ...
|
|
|
|
|
\fB-d\fP \fItgt1\fP \fB--delete\fP \fItgt1\fP Delete target(s) for the 'delete' action ...
|
|
|
|
|
\fB-D\fP \fI+-n\fP \fB--days\fP \fI+-n\fP Automated adjustment of the days in metadata dates ...
|
|
|
|
|
\fB-e\fP \fItgt3\fP \fB--extract\fP \fItgt3\fP Extract target(s) for the 'extract' action ...
|
|
|
|
|
\fB-f\fP \fB--force\fP Do not prompt before overwriting existing files ...
|
|
|
|
|
\fB-F\fP \fB--Force\fP Do not prompt before renaming files ...
|
|
|
|
|
\fB-g\fP \fIstr\fP \fB--grep\fP \fIstr\fP Only output where \fIstr\fP matches in output text ...
|
|
|
|
|
\fB-h\fP \fB--help\fP Display help and exit
|
|
|
|
|
\fB-i\fP \fItgt2\fP \fB--insert\fP \fItgt2\fP Insert target(s) for the 'insert' action ...
|
|
|
|
|
\fB-k\fP \fB--keep\fP Preserve file timestamps when updating files ...
|
|
|
|
|
\fB-K\fP \fIkey\fP \fB--key\fP \fIkey\fP Report a key. Similar to \fB-g\fP, however \fIkey\fP must match exactly ...
|
|
|
|
|
\fB-l\fP \fIdir\fP \fB--location\fP \fIdir\fP Location (directory) for files to be inserted or extracted ...
|
|
|
|
|
\fB-m\fP \fIcmdfile\fP \fB--modify\fP \fIcmdfile\fP Read commands from a file ...
|
|
|
|
|
\fB-M\fP \fIcmd\fP \fB--Modify\fP \fIcmd\fP Modify the metadata with the command. For the 'modify' action ...
|
|
|
|
|
\fB-n\fP \fIenc\fP \fB--encode\fP \fIenc\fP Charset to decode Exif Unicode user comments ...
|
|
|
|
|
\fB-O\fP \fI+-n\fP \fB--months\fP \fI+-n\fP Automated adjustment of the months in metadata dates ...
|
|
|
|
|
\fB-p\fP \fImod\fP \fB--print\fP \fImod\fP Print report (common reports) ...
|
|
|
|
|
\fB-P\fP \fIflg\fP \fB--Print\fP \fIflg\fP Print report (fine grained control) ...
|
|
|
|
|
\fB-q\fP \fB--quiet\fP Silence warnings and error messages ...
|
|
|
|
|
\fB-Q\fP \fIlvl\fP \fB--log\fP \fIlvl\fP Set the log-level to 'd'(ebug), 'i'(nfo), 'w'(arning), 'e'(rror) ...
|
|
|
|
|
\fB-r\fP \fIfmt\fP \fB--rename\fP \fIfmt\fP Filename format for the 'rename' action ...
|
|
|
|
|
\fB-S\fP \fIsuf\fP \fB--suffix\fP \fIsuf\fP Use suffix for source files when using the 'insert' command ...
|
|
|
|
|
\fB-t\fP \fB--timestamp\fP Set the file timestamp from Exif metadata. For the 'rename' action ...
|
|
|
|
|
\fB-T\fP \fB--Timestamp\fP Only set the file timestamp from Exif metadata. For the 'rename' action ...
|
|
|
|
|
\fB-u\fP \fB--unknown\fP Show unknown tags ...
|
|
|
|
|
\fB-v\fP \fB--verbose\fP Verbose
|
|
|
|
|
\fB-V\fP \fB--version\fP Show the program version and exit ...
|
|
|
|
|
\fB-Y\fP \fI+-n\fP \fB--years\fP \fI+-n\fP Automated adjustment of the years in metadata dates ...
|
|
|
|
|
.sp 1
|
|
|
|
|
\fIaction\fP pr | ex | in | rm | ad | mo | mv | fi | fc
|
|
|
|
|
print, extract, insert, delete, adjust, modify, rename, fixiso, fixcom
|
|
|
|
|
|
|
|
|
|
cmd See "Commands" below.
|
|
|
|
|
\fIcmd\fP \fBset | add | del\fP \fIkey\fP [[\fItype\fP] \fIvalue\fP]
|
|
|
|
|
(see \fBCommand format\fP)
|
|
|
|
|
|
|
|
|
|
flg E | I | X | x | g | k | l | n | y | c | s | v | t | h
|
|
|
|
|
\fIenc\fP Values defined in \fBiconv_open\fP(3) (e.g., UTF-8)
|
|
|
|
|
|
|
|
|
|
\fIflg\fP E | I | X | x | g | k | l | n | y | c | s | v | t | h
|
|
|
|
|
Exif, IPTC, XMP, num, grp, key, label, name, type, count, size, vanilla, translated, hex
|
|
|
|
|
|
|
|
|
|
fmt Default format is %Y%m%d_%H%M%S.
|
|
|
|
|
\fIfmt\fP Default format: %Y%m%d_%H%M%S
|
|
|
|
|
|
|
|
|
|
\fIkey\fP Exiv2 key using the format Family.Group.Tagname (e.g., Exif.Image.Model)
|
|
|
|
|
|
|
|
|
|
lvl d | i | i | w | e
|
|
|
|
|
\fIlvl\fP d | i | w | e
|
|
|
|
|
debug, info, warning, error
|
|
|
|
|
|
|
|
|
|
mod s | a | e | t | v | h | i | x | c | p | i | C | R | S | X
|
|
|
|
|
summary, all, exif, translated, vanilla, hex, iptc, xmp, comment, preview,
|
|
|
|
|
\fImod\fP s | a | e | t | v | h | i | x | c | p | C | R | S | X
|
|
|
|
|
summary, all, Exif, translated, vanilla, hex, IPTC, XMP, comment, preview,
|
|
|
|
|
ICC Profile, Recursive Structure, Simple Structure, raw XMP
|
|
|
|
|
|
|
|
|
|
tgt a | c | e | i | p | t | x | C | X | XX | -
|
|
|
|
|
all, comment, exif, iptc, preview, thumb, xmp, ICC Profile, SideCar, RawXMP, stdin/out
|
|
|
|
|
\fIsuf\fP '.' then the file's extension (e.g., '.txt')
|
|
|
|
|
|
|
|
|
|
\fItime\fP [+|-]HH[:MM[:SS[.mmm]]]
|
|
|
|
|
(Default is \fB+\fP when \fB+\fP/\fB-\fP are missing)
|
|
|
|
|
|
|
|
|
|
\fItgt1\fP a | c | e | i | t | x | C | -
|
|
|
|
|
all, comment, Exif, IPTC, thumbnail, XMP, ICC Profile, stdin/out
|
|
|
|
|
|
|
|
|
|
\fItgt\fP2 a | c | e | i | t | x | C | X | XX | -
|
|
|
|
|
all, comment, Exif, IPTC, thumbnail, XMP, ICC Profile, SideCar, Raw XMP, stdin/out
|
|
|
|
|
|
|
|
|
|
\fItgt3\fP a e | i | p | t | x | C | X | XX | -
|
|
|
|
|
all, Exif, IPTC, preview, thumbnail, XMP, ICC Profile, SideCar, Raw XMP, stdin/out
|
|
|
|
|
|
|
|
|
|
\fItype\fP An Exif, IPTC or XMP tag type (e.g., xmpText). See \fBEXIV2 TAGNAMES AND VALUES\fP
|
|
|
|
|
|
|
|
|
|
\fI+-n\fP The amount to change in the date (e.g., -3). Default is \fB+\fP when \fB+\fP/\fB-\fP are missing
|
|
|
|
|
|
|
|
|
|
.fi
|
|
|
|
|
.ne 40
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
@ -622,7 +645,7 @@ Empty lines and lines starting with \fB#\fP in a command file are
|
|
|
|
|
ignored (comments). Remaining lines are commands as described above.
|
|
|
|
|
.br
|
|
|
|
|
.ne 40
|
|
|
|
|
.SH EXIF TAGNAMES AND VALUES
|
|
|
|
|
.SH EXIV2 TAGNAMES AND VALUES
|
|
|
|
|
Exiv2 displays metadata tags and values.
|
|
|
|
|
.sp 1
|
|
|
|
|
The tag is a triplet of Family.Group.Tagname. The following groups are defined for the family Exif:
|
|
|
|
|
|
postscript-dev
4 years ago